You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: Describes the Microsoft.Common.DropDown UI element for Azure portal. Use to select from available options when deploying a managed application.
3
+
description: Describes the Microsoft.Common.DropDown UI element for Azure portal. The element is used to select from the available options when deploying a managed application.
4
4
author: davidsmatlak
5
5
6
6
ms.topic: conceptual
7
-
ms.date: 07/14/2020
7
+
ms.date: 01/27/2023
8
8
ms.author: davidsmatlak
9
9
10
10
---
@@ -15,60 +15,60 @@ A selection control with a dropdown list. You can allow selection of only a sing
15
15
16
16
## UI sample
17
17
18
-
The DropDown element has different options which determine its appearance in the portal.
18
+
The DropDown element has different options that determine its appearance in the portal.
19
19
20
20
When only a single item is allowed for selection, the control appears as:
21
21
22
-
:::image type="content" source="./media/managed-application-elements/microsoft-common-dropdown-1.png" alt-text="Microsoft.Common.DropDown single selection":::
22
+
:::image type="content" source="./media/managed-application-elements/microsoft-common-dropdown-1.png" alt-text="Screenshot of the Microsoft.Common.DropDown single selection.":::
23
23
24
24
When descriptions are included, the control appears as:
25
25
26
-
:::image type="content" source="./media/managed-application-elements/microsoft-common-dropdown-2.png" alt-text="Microsoft.Common.DropDown single selection with descriptions":::
26
+
:::image type="content" source="./media/managed-application-elements/microsoft-common-dropdown-2.png" alt-text="Screenshot of the Microsoft.Common.DropDown single selection with descriptions.":::
27
27
28
28
When multi-select is enabled, the control adds a **Select all** option and checkboxes for selecting more than one item:
:::image type="content" source="./media/managed-application-elements/microsoft-common-dropdown-3.png" alt-text="Screenshot of the Microsoft.Common.DropDown multi-select.":::
31
31
32
32
Descriptions can be included with multi-select enabled.
33
33
34
-
:::image type="content" source="./media/managed-application-elements/microsoft-common-dropdown-4.png" alt-text="Screenshot that shows how descriptions can be included with multi-select enabled":::
34
+
:::image type="content" source="./media/managed-application-elements/microsoft-common-dropdown-4.png" alt-text="Screenshot that shows how descriptions can be included with multi-select enabled.":::
35
35
36
36
When filtering is enabled, the control includes a text box for adding the filtering value.
37
37
38
-
:::image type="content" source="./media/managed-application-elements/microsoft-common-dropdown-5.png" alt-text="Microsoft.Common.DropDown multi-select with descriptions":::
38
+
:::image type="content" source="./media/managed-application-elements/microsoft-common-dropdown-5.png" alt-text="Screenshot of the Microsoft.Common.DropDown multi-select with descriptions.":::
39
39
40
40
## Schema
41
41
42
42
```json
43
43
{
44
-
"name": "element1",
45
-
"type": "Microsoft.Common.DropDown",
46
-
"label": "Example drop down",
47
-
"placeholder": "",
48
-
"defaultValue": ["Value two"],
49
-
"toolTip": "",
50
-
"multiselect": true,
51
-
"selectAll": true,
52
-
"filter": true,
53
-
"filterPlaceholder": "Filter items ...",
54
-
"multiLine": true,
55
-
"defaultDescription": "A value for selection",
56
-
"constraints": {
57
-
"allowedValues": [
58
-
{
59
-
"label": "Value one",
60
-
"description": "The value to select for option 1.",
61
-
"value": "one"
62
-
},
63
-
{
64
-
"label": "Value two",
65
-
"description": "The value to select for option 2.",
66
-
"value": "two"
67
-
}
68
-
],
69
-
"required": true
70
-
},
71
-
"visible": true
44
+
"name": "element1",
45
+
"type": "Microsoft.Common.DropDown",
46
+
"label": "Example drop down",
47
+
"placeholder": "",
48
+
"defaultValue": ["Value two"],
49
+
"toolTip": "",
50
+
"multiselect": true,
51
+
"selectAll": true,
52
+
"filter": true,
53
+
"filterPlaceholder": "Filter items ...",
54
+
"multiLine": true,
55
+
"defaultDescription": "A value for selection",
56
+
"constraints": {
57
+
"allowedValues": [
58
+
{
59
+
"label": "Value one",
60
+
"description": "The value to select for option 1.",
61
+
"value": "one"
62
+
},
63
+
{
64
+
"label": "Value two",
65
+
"description": "The value to select for option 2.",
66
+
"value": "two"
67
+
}
68
+
],
69
+
"required": true
70
+
},
71
+
"visible": true
72
72
}
73
73
```
74
74
@@ -90,7 +90,46 @@ When filtering is enabled, the control includes a text box for adding the filter
90
90
- The `defaultDescription` property is used for items that don't have a description.
91
91
- The `placeholder` property is help text that disappears when the user begins editing. If the `placeholder` and `defaultValue` are both defined, the `defaultValue` takes precedence and is shown.
92
92
93
+
## Example
94
+
95
+
In the following example, the `defaultValue` is defined using the values of the `allowedValues` instead of the labels. The default value can contain multiple values when `multiselect` is enabled.
96
+
97
+
:::image type="content" source="./media/managed-application-elements/microsoft-common-dropdown-6.png" alt-text="Screenshot that shows how multiple default values can be included with multi-select enabled":::
0 commit comments