Empty List Placeholder
Pluggable widget to show a placeholder when:
- a listview or templateview has no data to display
- a listview or templateview has data to display.
Typical usage scenario
Using this widget a placeholder can be displayed when a listview or templateview is empty or, the other way around, when a listview or templateview is not empty.
The placeholder can be a simple text, but also (for example) a call to action with an image, a text and a microflow button, to invite the user to add new items to the list. This can greatly improve the user experience of the app. From the developer perspective, this prevents the use of helper objects to keep track of the fact that a list is empty or not.
Features and limitations
Display a placeholder when a listview or templateview is empty or, the other way around, when a listview or templateview is not empty. The placeholder can consist of anything that is available in pluggable widgets. The mode (showing the content when empty or not empty) can be configured in the widget.
The widget listens to listviews or templateviews with a specified classname. When multiple elements on the page are using the same classname, the widget will respond to the first element .
Using a boolean flag, it is possible to replace the listview/template view with the placeholder or alternatively, the parent of the listview/templateview (including all its child elements). This way, it is possible to not only hide the listview/templateview itself, but also additional UI elements, such as a listview header.
Add the widget to the page and configure.
- Set an enumeration to
- show widget content when list is empty
- show widget content when list is not empty
- Add a classname to the listview or templateview the widget should listen to
- Configure the widget with the specified classname
- Set the boolean to include the parent
No known bugs.
Responsive web only, no support for native.