Nuxeo Server

Default Widget Types Known Limitations

Updated: October 13, 2017 Page Information Edit on GitHub

This page is scheduled for review and update. Check back soon for updated content!

Some widgets have limitations in some specific conditions of use. We maintain a list of known problems here.

  • File widget cannot be used in an Ajax form.
  • You might have some troubles using chain select widgets in Ajax forms or when using lists. This occurs in some very specific conditions, so you have to check if it is ok for your use case first. We plan to rewrite completely this widget to solve this issue.
  • Widgets using Rich Faces suggestion components do not work correctly in a list. Limitation is at lower Rich Faces level, so there is no short term fix planned.
  • Widgets displaying URLs to files/images may misbehave inside of lists. This is because the URL might need information about the complete property XPath, and this variable is not exposed in the context for now (see NXP-10423). Some specific widget templates can be used to workaround this issue, and some of them are available by default:
    • /widgets/extended_subfile_widget.xhtml Displays a link to a file with additional information (icon, PDF export) for a file within a list.
    • /widgets/image_subwidget_template.xhtml Displays an image when within a list (available only from 5.9.3, 5.8.0-HF09, 5.6.0-HF32.These widget templates are specific to this use case, and will not work as expected inside lists of lists, for instance, but custom widget templates can be defined for this behaviour, taking care of the following issues:
    • The URL system may rely on a document to provide the RESTful link, hence the layoutValue variable is used for it: these widget templates will assume that the layout applies to a document
    • The parent widgets field definitions, used to build the document property XPath, can be retrieved using variables widget_0 for instance: this assumes that the widget at the first level of the layout holds the list property path.
    • The widget template needs to know the file/image index, and is relying on variable model.rowData for it: this is only available within a widget of type list.
    • Facelet tags evaluated at build time (like a c:if tag) cannot check elements within the list, because these items are only exposed at render time.


5 days ago manonlumeau NXDOC-1346-FT review screenshot
a year ago Solen Guitter 17
3 years ago Anahide Tchertchian 16 | NXP-3427: remove limitation on file upload inside lists
3 years ago Anahide Tchertchian 15 | NXDOC-286: remove limitations not valid on 7.1 + wording
3 years ago Guillaume Renard 14
3 years ago Solen Guitter 13 | Fixed broken link
4 years ago Solen Guitter 12
4 years ago Anahide Tchertchian 11 | NXDOC-300: Explain how sub files can be managed in widget templates
4 years ago Solen Guitter 10 | Formatting
4 years ago Anahide Tchertchian 9 | mention file widget limitation inside lists
4 years ago Anahide Tchertchian 8
4 years ago Solen Guitter 7
4 years ago Solen Guitter 5
4 years ago Solen Guitter 6 | Added related topics
4 years ago Solen Guitter 4
5 years ago Alain Escaffre 2
5 years ago Alain Escaffre 3
5 years ago Alain Escaffre 1
History: Created by Alain Escaffre