Merge pull request #10275 from mendix/MvM-ReactToolBox

MarkvanMents · web-flow · commit fe0990f3543f · 2025-11-05T10:05:42.000+01:00
Clarify Dojo widget behavior in React apps
diff --git a/content/en/docs/refguide/modeling/pages/authentication-widgets/login-id-text-box.md b/content/en/docs/refguide/modeling/pages/authentication-widgets/login-id-text-box.md
@@ -4,7 +4,19 @@ url: /refguide/login-id-text-box/
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
-{{% alert color="warning" %}}The **Login ID text box** widget is not supported on native mobile pages.{{% /alert %}}
+{{% alert color="warning" %}}
+The **login ID text box** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages.
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/).
+
+Upgrade it to the normal input and action widgets as shown in the Atlas login page template. See the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#sign-in-widgets) for more information.
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
 
 ## Introduction
 
diff --git a/content/en/docs/refguide/modeling/pages/authentication-widgets/password-text-box.md b/content/en/docs/refguide/modeling/pages/authentication-widgets/password-text-box.md
@@ -4,7 +4,19 @@ url: /refguide/password-text-box/
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
-{{% alert color="warning" %}}The **Password text box** widget is not supported on native mobile pages.{{% /alert %}}
+{{% alert color="warning" %}}
+The **password text box** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages.
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/).
+
+Upgrade it to the normal input and action widgets as shown in the Atlas login page template. See the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#sign-in-widgets) for more information.
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
 
 ## Introduction
 
diff --git a/content/en/docs/refguide/modeling/pages/authentication-widgets/sign-in-button.md b/content/en/docs/refguide/modeling/pages/authentication-widgets/sign-in-button.md
@@ -4,7 +4,19 @@ url: /refguide/sign-in-button/
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
-{{% alert color="warning" %}}The **Sign-in button** is not supported on native mobile pages.{{% /alert %}}
+{{% alert color="warning" %}}
+The **sign-in button** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages.
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/).
+
+Upgrade it to the normal input and action widgets as shown in the Atlas login page template. See the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#sign-in-widgets) for more information.
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
 
 ## Introduction
 
diff --git a/content/en/docs/refguide/modeling/pages/authentication-widgets/validation-message.md b/content/en/docs/refguide/modeling/pages/authentication-widgets/validation-message.md
@@ -4,7 +4,19 @@ url: /refguide/validation-message/
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
-{{% alert color="warning" %}}The validation message widget is not supported on native mobile pages.{{% /alert %}}
+{{% alert color="warning" %}}
+The **validation message** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages.
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/).
+
+Upgrade it to the normal input and action widgets as shown in the Atlas login page template. See the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#sign-in-widgets) for more information.
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
 
 ## Introduction
 
diff --git a/content/en/docs/refguide/modeling/pages/data-widgets/grids/control-bar.md b/content/en/docs/refguide/modeling/pages/data-widgets/grids/control-bar.md
@@ -26,6 +26,18 @@ aliases:
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
+{{% alert color="warning" %}}
+The **control bar** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages. Mendix recommends that you use the [Gallery](/appstore/widgets/gallery/) or [List View](/refguide/list-view/) instead to display data. See the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#data-grid).
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/). To upgrade it to the recommended React widget ([Data Grid 2](/appstore/modules/data-grid-2/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#data-grid).
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
+
 ## Introduction
 
 A control bar of a [template grid](/refguide/template-grid/), [data grid](/refguide/data-grid/), and [reference set selector](/refguide/reference-set-selector/) allows you to manipulate the objects displayed by means of buttons. By default, both grids will be created with [Search](#search-button), [New](#create-button), [Edit](#grid-action-button), and [Delete](#grid-action-button) buttons in the control bar:
@@ -40,7 +52,7 @@ Most properties of control bar buttons are the same as properties of buttons. Fo
 
 To add additional buttons to the control bar, do the following:
 
-1. Right-click on the control bar while it is highlighed.
+1. Right-click on the control bar while it is highlighted.
 1. Select **Add button**.
 1. Select the new type of button.
 1. Double-click on the new button to customize.
diff --git a/content/en/docs/refguide/modeling/pages/data-widgets/grids/data-grid/_index.md b/content/en/docs/refguide/modeling/pages/data-widgets/grids/data-grid/_index.md
@@ -5,9 +5,17 @@ weight: 10
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
-{{% alert color="warning" %}}The data grid widget is not supported on native mobile pages.{{% /alert %}}
+{{% alert color="warning" %}}
+The **data grid** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages. Mendix recommends that you use the [Gallery](/appstore/widgets/gallery/) or [List View](/refguide/list-view/) instead to display data. See the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#data-grid).
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/). To upgrade it to the recommended React widget ([Data Grid 2](/appstore/modules/data-grid-2/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#data-grid).
 
-{{% alert color="warning" %}}The data grid widget is not supported when using the [React client](/refguide/mendix-client/react/). Please use the [data grid 2 widget](/appstore/modules/data-grid-2/) instead. It is possible to convert existing data grid widgets to data grid 2 as explained in the [React Migration Guide](/refguide/mendix-client/react/#data-grid){{% /alert %}}
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
 
 ## Introduction
 
diff --git a/content/en/docs/refguide/modeling/pages/data-widgets/grids/search-bar.md b/content/en/docs/refguide/modeling/pages/data-widgets/grids/search-bar.md
@@ -12,6 +12,18 @@ aliases:
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
+{{% alert color="warning" %}}
+The **search bar** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages. Mendix recommends that you use the [Gallery](/appstore/widgets/gallery/) or [List View](/refguide/list-view/) instead to display data. See the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#data-grid).
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/). To upgrade it to the recommended React widget ([Data Grid 2](/appstore/modules/data-grid-2/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#data-grid).
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
+
 ## Introduction
 
 The search bar contains search fields that allow the end-user to quickly find the information they need in a [data grid](/refguide/data-grid/) or [template grid](/refguide/template-grid/).
diff --git a/content/en/docs/refguide/modeling/pages/data-widgets/grids/sort-bar.md b/content/en/docs/refguide/modeling/pages/data-widgets/grids/sort-bar.md
@@ -10,6 +10,18 @@ aliases:
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
+{{% alert color="warning" %}}
+The **sort bar** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages. Mendix recommends that you use the [Gallery](/appstore/widgets/gallery/) or [List View](/refguide/list-view/) instead to display data. See the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#data-grid).
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/). To upgrade it to the recommended React widget ([Data Grid 2](/appstore/modules/data-grid-2/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#data-grid).
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
+
 ## Introduction
 
 A sort order allows you to sort items in a [data grid](/refguide/data-grid/), [template grid](/refguide/template-grid/), [list view](/refguide/list-view/) or a [reference set selector](/refguide/reference-set-selector/).
diff --git a/content/en/docs/refguide/modeling/pages/data-widgets/grids/template-grid.md b/content/en/docs/refguide/modeling/pages/data-widgets/grids/template-grid.md
@@ -5,7 +5,17 @@ weight: 20
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
-{{% alert color="warning" %}}The template grid widget is not supported on native mobile pages.{{% /alert %}}
+{{% alert color="warning" %}}
+The **template grid** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages. Mendix recommends that you use the [Gallery](/appstore/widgets/gallery/) or [List View](/refguide/list-view/) instead to display data. See the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#data-grid).
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/). To upgrade it to the recommended React widget ([Data Grid 2](/appstore/modules/data-grid-2/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#data-grid).
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
 
 ## Introduction
 
diff --git a/content/en/docs/refguide/modeling/pages/input-widgets/drop-down.md b/content/en/docs/refguide/modeling/pages/input-widgets/drop-down.md
@@ -9,9 +9,17 @@ aliases:
 ---
 
 {{% alert color="warning" %}}
-The drop-down widget is not compatible with the modern version of the Mendix React Client. Depending on your app version, you may wish to convert the widget to a combo box widget using the context menu in Studio Pro. 
+The **drop-down** widget is a Dojo widget.
 
-For more information on converting a drop-down widget into its more modern combo box counterpart, see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#migration-guide).
+This widget is not supported on native mobile pages.
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/).
+
+To upgrade it to the recommended React-compliant widget ([Combo Box](/appstore/widgets/combobox/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#reference-selectors-drop-down).
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
 {{% /alert %}}
 
 ## Introduction
diff --git a/content/en/docs/refguide/modeling/pages/input-widgets/input-reference-set-selector.md b/content/en/docs/refguide/modeling/pages/input-widgets/input-reference-set-selector.md
@@ -5,9 +5,19 @@ weight: 90
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
-{{% alert color="warning" %}}The **input reference set selector** widget is not supported on native mobile pages. 
+{{% alert color="warning" %}}
+The **input reference set selector** widget is a Dojo widget.
 
-To upgrade it to a React-compliant widget which works on a native page, see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#migration-guide).{{% /alert %}}
+This widget is not supported on native mobile pages.
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/).
+
+To upgrade it to the recommended React-compliant widget ([Combo Box](/appstore/widgets/combobox/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#reference-selectors-drop-down).
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
 
 ## Introduction
 
diff --git a/content/en/docs/refguide/modeling/pages/input-widgets/reference-selector.md b/content/en/docs/refguide/modeling/pages/input-widgets/reference-selector.md
@@ -5,7 +5,19 @@ weight: 70
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
-{{% alert color="warning" %}}The **reference selector** widget is not supported by React. To upgrade it to a React-compliant widget, see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#migration-guide).{{% /alert %}}
+{{% alert color="warning" %}}
+The **reference selector** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages.
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/).
+
+To upgrade it to the recommended React-compliant widget ([Combo Box](/appstore/widgets/combobox/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#reference-selectors-drop-down).
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
 
 ## Introduction
 
diff --git a/content/en/docs/refguide/modeling/pages/input-widgets/reference-set-selector.md b/content/en/docs/refguide/modeling/pages/input-widgets/reference-set-selector.md
@@ -5,9 +5,19 @@ weight: 80
 #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
 ---
 
-{{% alert color="warning" %}}The **reference set selector** widget is not supported on native mobile pages. 
+{{% alert color="warning" %}}
+The **reference set selector** widget is a Dojo widget.
+
+This widget is not supported on native mobile pages.
+
+This widget is not supported in the [React client](/refguide/mendix-client/react/).
 
-To upgrade it to a React-compliant widget which works on a native page, see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#migration-guide).{{% /alert %}}
+To upgrade it to the recommended React-compliant widget ([Combo Box](/appstore/widgets/combobox/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#reference-selectors-drop-down).
+
+If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+The Dojo client is deprecated and will be removed in Mendix 12. It continues receiving security and stability updates until the end of support of Mendix 11.24.
+{{% /alert %}}
 
 ## Introduction
 
