JSF UI Framework

Listing Widget Types

Updated: July 17, 2023

A series of widget types useful for listings.

Listing widget types usually apply to a PageSelection element, wrapping the  DocumentModel to handle selection information.

Basic widget types can also be used in listings, but this has an impact on field bindings configuration.

For instance, when displaying the document title in a listing layout, here is the corresponding configuration:

<widget name="title" type="text">
  <labels>
    <label mode="any">Title</label>
  </labels>
  <translated>false</translated>
  <fields>
    <field>data['dc']['title']</field>
  </fields>
</widget>

You can see that the "data" binding is mentioned. It will resolve PageSelection#getData method, which resolves to the DocumentModel. Subsequent "dc" and "title" configurations make it resolve the document field named "title" in the "dublincore" schema (defined to use prefix "dc").

Please refer to the section Field Binding and Expressions for more information about field bindings configuration.

Id: listing_title_link

This widget type displays the document title with a link to it. It can also display a download link provided the blob field path in its properties.

View online demo: http://showcase.nuxeo.com/nuxeo/layoutDemo/listing_title_linkWidget

Author

Id: listing_author

This widget type displays the document author/creator first and last name, with its identifier in a tooltip.

View online demo: http://showcase.nuxeo.com/nuxeo/layoutDemo/listing_authorWidget

Last Contributor

Id: listing_last_contributor

This widget type displays the document last contributor first and last names, with its identifier in a tooltip.

View online demo: http://showcase.nuxeo.com/nuxeo/layoutDemo/listing_last_contributorWidget

Big Icon with Type

Id: listing_big_icon_type_link

This widget type displays a big icon (usually 100x100 px) with the document type in a tooltip. The icon can represent the document type, or the attached file type when there is one.

View online demo: http://showcase.nuxeo.com/nuxeo/layoutDemo/listing_big_icon_type_linkWidget

Icon with Type

Id: listing_icon_type

This widget type displays an icon (usually 16x16 px) with the document type in a tooltip. The icon can represent the document type, or the attached file type when there is one.

View online demo: http://showcase.nuxeo.com/nuxeo/layoutDemo/listing_icon_typeWidget

Version

Id: listing_version

This widget type displays the document version.

View online demo: http://showcase.nuxeo.com/nuxeo/layoutDemo/listing_versionWidget

Lifecycle

Id: listing_lifecycle

This widget type displays the document life cycle state.

View online demo: http://showcase.nuxeo.com/nuxeo/layoutDemo/listing_lifecycleWidget