Skip to content

Commit 911e5df

Browse files
DropDownBox: Add Overview (#7755)
1 parent 8f8b114 commit 911e5df

File tree

5 files changed

+55
-0
lines changed

5 files changed

+55
-0
lines changed
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
---
2+
3+
##### jQuery
4+
5+
DevExtreme DropDownBox is an advanced editor that supports in-depth customization. The component consists of a text field and a drop-down area. The drop-down area can contain custom markup, including other [DevExtreme components](/Documentation/Guide/jQuery_Components/DevExtreme_jQuery_Components/).
6+
7+
##### Angular
8+
9+
DevExtreme DropDownBox is an advanced editor that supports in-depth customization. The component consists of a text field and a drop-down area. The drop-down area can contain custom markup, including other [DevExtreme components](/Documentation/Guide/Angular_Components/DevExtreme_Angular_Components/).
10+
11+
##### Vue
12+
13+
DevExtreme DropDownBox is an advanced editor that supports in-depth customization. The component consists of a text field and a drop-down area. The drop-down area can contain custom markup, including other [DevExtreme components](/Documentation/Guide/Vue_Components/DevExtreme_Vue_Components/).
14+
15+
##### React
16+
17+
DevExtreme DropDownBox is an advanced editor that supports in-depth customization. The component consists of a text field and a drop-down area. The drop-down area can contain custom markup, including other [DevExtreme components](/Documentation/Guide/React_Components/DevExtreme_React_Components/).
18+
19+
---
20+
21+
[important] DevExtreme ships with multiple drop-down editors. To find out which editor best suits your task, refer to the following help topic: [How to Choose a Drop-Down Editor](/Documentation/Guide/UI_Components/Lookup/Choose_a_Drop-Down_Editor/).
22+
23+
This overview highlights DropDownBox elements, key features, and what to explore next.
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
![DropDownBox Elements](/images/DropDownBox/dropdownbox-elements.png)
2+
3+
1. Text Field
4+
2. [Value](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#value)
5+
3. [Clear Button](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#showClearButton)
6+
4. [Placeholder](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#placeholder)
7+
5. [Dropdown Button](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#showDropDownButton)
8+
6. Text Field
9+
7. [Dropdown Content](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#contentTemplate) - [TreeView](/Documentation/Guide/UI_Components/TreeView/Overview/)
10+
8. [Dropdown Content](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#contentTemplate) - [DataGrid](/Documentation/Guide/UI_Components/DataGrid/Overview/)
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
- **Embed DevExtreme Components**
2+
You can embed any DevExtreme component within the DropDownBox. To display data, we recommend the DevExtreme [DataGrid](/Documentation/Guide/UI_Components/DataGrid/Overview/), [TreeView](/Documentation/Guide/UI_Components/TreeView/Overview/), and [CardView](/Documentation/Guide/UI_Components/CardView/Overview/) components.
3+
4+
- **Synchronize with Embedded Component**
5+
To synchronize DropDownBox with its embedded component, refer to the following tutorial: [Synchronize with the Embedded Element](/Documentation/Guide/UI_Components/DropDownBox/Synchronize_with_the_Embedded_Element/)
6+
7+
- **Selection**
8+
You can configure DropDownBox selection to display single or multiple values.
9+
10+
- **Validation**
11+
DropDownBox ships with [data validation capabilities](/Documentation/Guide/UI_Components/Common/UI_Widgets/Data_Validation/). You can implement custom logic to validate the component value and display a [validation status](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#isValid) to users.
12+
13+
- **Text Field Customization**
14+
You can specify a text field [label](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#label) and [placeholder](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#placeholder), as well as configure [custom](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/buttons/) or predefined buttons ([clear](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#showClearButton) and [drop-down](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#showClearButton)). To implement further customizations, you can specify a [text field template](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#fieldTemplate).
15+
16+
- **Accessibility and Keyboard Navigation**
17+
DropDownBox [conforms](/Documentation/Guide/UI_Components/DropDownBox/Accessibility/) to WCAG 2.x, European Accessibility Act (EAA), and Americans with Disabilities Act (ADA) standards. The component supports keyboard navigation and custom key handlers. DropDownBox also ships with right-to-left ([RTL](/Documentation/ApiReference/UI_Components/dxDropDownBox/Configuration/#rtlEnabled)) representation support.
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
- [Getting Started with DropDownBox](/Documentation/Guide/UI_Components/DropDownBox/Getting_Started_with_DropDownBox/)
2+
3+
- [API](/Documentation/ApiReference/UI_Components/dxDropDownBox/)
4+
5+
- [Demos](https://js.devexpress.com/Demos/WidgetsGallery/Demo/DropDownBox/Overview/)
73.3 KB
Loading

0 commit comments

Comments
 (0)