Skip to content

update data widgets documentation - #12087

Open
gjulivan wants to merge 3 commits into
mendix:developmentfrom
gjulivan:development
Open

gjulivan wants to merge 3 commits into
mendix:developmentfrom
gjulivan:development

Conversation

@gjulivan

@gjulivan gjulivan commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Updates the Data Widgets module documentation to match the current widgets (Data Widgets 3.x, Data Grid 2 3.11). Property names, defaults, and visibility conditions were checked against the widget XML and editor configuration in mendix/web-widgets.

Changes

Data Grid 2

  • Data Grid 2 – Properties: reorganized by Studio Pro tab and documented all current properties, including their defaults and when each property is shown.
  • Show number of rows: describes the "20 of 150" counter and notes the initial-load cost on large datasets.
  • Filters placeholder: also holds other widgets, such as action buttons. The note on grid-wide filtering being removed in 3.0.0 is now an alert instead of a heading.
  • Data Grid 2:
    • Aligned the Auto/Custom explanation and the On change event descriptions for the text, number, date, and drop-down filters.
    • Renamed "header" to "filters placeholder" in the selection and action button sections and in troubleshooting.
  • Removed outdated content: the Performance section (Data Widgets 1.x) and the Atlas v2 troubleshooting.

Filter widgets (text, number, date, drop-down)

  • Aligned property names, defaults, and visibility rules with the widgets.
  • Saved attribute: explains that the saved value is not applied automatically and must be used in the Default value expression. This applies to the text, number, and date filters.
  • Number filter: clarified Filter attributes (Auto works only in a Data Grid 2 column; use Custom in a filters placeholder), and made property descriptions start with a verb, like the other filter pages.
  • Drop-down filter: uses "Drop-Down Filter" and "drop-down" consistently, following the terminology guide.

Gallery

  • Updated pagination, selection, and filtering sections. Removed the Advanced Options section, which no longer exists in the widget.
  • Added a note that the pagination status text and screen reader labels of the paging buttons are not yet translatable.
  • Clarified that the Selection Helper only selects and deselects items on the current page.
  • Removed first-person wording and four images that are no longer used.

Selection Helper

  • Clarified that the helper acts on the current page only. Items selected on other pages stay selected when Keep selection is set to Yes.
  • Uses "filters placeholder" instead of "header".

Tree Node

  • Named the Infinite tree node mode consistently and explained that it is used when Parent association is set.
  • Clarified that Has children is hidden in that mode.

Data Widgets module

  • Updated the widget list and link names.

Verification

  • Behavior that the old docs described incorrectly (Selection Helper scope, drop-down filter saved attribute) was checked in a test app with Data Widgets 3.11.7.
  • No anchors that other pages link to were removed.

@gjulivan
gjulivan marked this pull request as ready for review October 21, 2026 08:33

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants