CLarify Dojo widget behavior in React apps

MarkvanMents · MarkvanMents · commit aa9fd1b8fcb2 · 2025-10-24T15:26:40.000+02:00
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,13 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+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.
+
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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,13 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+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.
+
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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,13 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+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.
+
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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,13 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+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.
+
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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,14 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+To upgrade it to the recommended React-compliant widget ([Gallery](/appstore/widgets/gallery/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#migration-guide).
+
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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:
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,13 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+To upgrade it to the recommended React-compliant widget ([Gallery](/appstore/widgets/gallery/)), 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 %}}
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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,14 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+To upgrade it to the recommended React-compliant widget ([Gallery](/appstore/widgets/gallery/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#migration-guide).
+
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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,14 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+To upgrade it to the recommended React-compliant widget ([Gallery](/appstore/widgets/gallery/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#migration-guide).
+
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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,13 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+To upgrade it to the recommended React-compliant widget ([Gallery](/appstore/widgets/gallery/)), see the Mendix React Client's [Migration Guide](/refguide/mendix-client/react/#template-grid).
+
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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,11 +9,12 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
 
-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).
-{{% /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).
 
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /alert %}}
 ## Introduction
 
 A **drop-down** is used to display and, optionally, allow the end-user to edit the value of an attribute or variable of [data type](/refguide/data-types/) *enumeration*.
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,13 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
 
-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).
+
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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,13 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+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).
+
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /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,13 @@ 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. It is not supported in the [React client](/refguide/mendix-client/react/) or on native mobile pages. If you [switch to the React client](/refguide/app-settings/#react-client), the widget will not appear in the **Toolbox**.
+
+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).
 
-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 %}}
+The Dojo client is deprecated and will be removed in a future version of Mendix.
+{{% /alert %}}
 
 ## Introduction
 
