Introduce display_class widget property

Author: lenadax

CHANGES.rst

@@ -5,7 +5,9 @@ History
 3.1.2 (unreleased)
 ------------------
 
-- Nothing changed yet.
+- Introduce ``display_class`` widget property. Display renderers will add the
+  given value to the widget class list.
+  [lenadax]
 
 
 3.1.1 (2024-11-08)

src/yafowil/checkbox.py

@@ -87,9 +87,13 @@ def checkbox_display_renderer(widget, data):
         content = vocab[bool(value)]
         if data.tag.translate:
             content = data.tag.translate(content)
+    cssclasses = [
+        attr_value("display_class", widget, data),
+        f'display-{attr_value("class", widget, data) or "generic"}'
+    ]
     attrs = {
         'id': cssid(widget, 'display'),
-        'class_': 'display-{0}'.format(attr_value('class', widget, data))
+        'class_': ' '.join([_ for _ in cssclasses if _ is not None])
     }
     if attr_value('display_proxy', widget, data):
         widget.attrs['type'] = 'hidden'

src/yafowil/common.py

@@ -263,11 +263,13 @@ def generic_display_renderer(widget, data, value=None):
         content = widget.attrs['template'] % value
     else:
         content = widget.attrs['template'] % value
+    cssclasses = [
+        attr_value("display_class", widget, data),
+        f'display-{attr_value("class", widget, data) or "generic"}'
+    ]
     attrs = {
         'id': cssid(widget, 'display'),
-        'class_': 'display-{0}'.format(
-            attr_value('class', widget, data) or 'generic'
-        )
+        'class_': ' '.join([_ for _ in cssclasses if _ is not None])
     }
     attrs.update(as_data_attrs(attr_value('data', widget, data)))
     return data.tag('div', content, **attrs)

src/yafowil/lines.py

@@ -48,9 +48,13 @@ def lines_display_renderer(widget, data):
     value = fetch_value(widget, data)
     if type(value) in ITER_TYPES and not value:
         value = u''
+    cssclasses = [
+        attr_value("display_class", widget, data),
+        f'display-{attr_value("class", widget, data) or "generic"}'
+    ]
     attrs = {
         'id': cssid(widget, 'display'),
-        'class_': 'display-{0}'.format(attr_value('class', widget, data))
+        'class_': ' '.join([_ for _ in cssclasses if _ is not None])
     }
     attrs.update(as_data_attrs(attr_value('data', widget, data)))
     content = u''

src/yafowil/select.py

@@ -244,24 +244,31 @@ def select_edit_renderer(widget, data, custom_attrs={}):
 def select_display_renderer(widget, data):
     value = fetch_value(widget, data)
     if type(value) in ITER_TYPES and not value:
-        value = u''
+        value = attr_value('empty_display_value', widget, data)
+        if not value:
+            value = u''
     multivalued = attr_value('multivalued', widget, data)
     vocab = dict(attr_value('vocabulary', widget, data, []))
     if not multivalued or not value:
         value = vocab.get(value, value)
         if data.tag.translate:
             value = data.tag.translate(value)
         return generic_display_renderer(widget, data, value=value)
+    cssclasses = [
+        attr_value("display_class", widget, data),
+        f'display-{attr_value("class", widget, data) or "generic"}'
+    ]
     attrs = {
         'id': cssid(widget, 'display'),
-        'class_': 'display-{0}'.format(attr_value('class', widget, data))
+        'class_': ' '.join([_ for _ in cssclasses if _ is not None])
     }
     attrs.update(as_data_attrs(attr_value('data', widget, data)))
     content = u''
     if multivalued and isinstance(value, STR_TYPE):
         value = [value]
     for key in value:
-        content += data.tag('li', vocab.get(key, key))
+        content += data.tag('li', vocab.get(key, key),
+                            **{'class_': attr_value("display_item_class", widget, data)})
     return data.tag('ul', content, **attrs)