Skip to content

Commit 174a315

Browse files
DropDownButton: Add Overview (#7753) (#8068)
1 parent f9996aa commit 174a315

5 files changed

Lines changed: 39 additions & 0 deletions

File tree

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
DevExtreme DropDownButton is a UI component that can display a list of actions. You can configure the component to trigger actions on button or list item click.
2+
3+
This overview highlights DropDownButton elements, key features, and what to explore next.
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
![DropDownButton Elements](/images/DropDownButton/dropdownbutton-elements.png)
2+
3+
1. [Icon](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#icon)
4+
2. [Text](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#text)
5+
3. [Dropdown arrow](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#showArrowIcon)
6+
4. [Items](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/items/)
7+
5. [Drop-down popup](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#dropDownOptions)
8+
6. [Item badge](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/items/#badge)
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
- **Action Binding**
2+
DropDownButton can trigger actions on button click ([onButtonClick](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#onButtonClick)) or list item click ([onItemClick](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#onItemClick)). You can also specify individual [click handlers](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/items/#onClick) for each item within the component data source.
3+
4+
- **Appearance Settings**
5+
You can specify an [icon](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#icon) and [text](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#text), as well as configure [drop-down arrow](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#showArrowIcon) visibility to customize component appearance.
6+
7+
- **Item Configuration**
8+
You can configure [text](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/items/#text), [icons](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/items/#icon), and [badges](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/items/#badge) to customize drop-down item appearance. The component also allows you to implement unique [click handlers](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/items/#onClick) for each item, as well as [custom templates](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/items/#template).
9+
10+
- **Split Button Support**
11+
DevExtreme DropDownButton supports a [split button](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#splitButton) mode. In this mode, the component separates the action and drop-down buttons.
12+
13+
- **Predefined Styling Modes**
14+
You can choose one of three [styling modes](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#stylingMode) to configure DropDownButton appearance: text only, contained, and outlined (default). The component also includes [four built-in colors](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#type).
15+
16+
- **Selection**
17+
When [selection](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#useSelectMode) is enabled, the component displays the selected item text and icon. You can [handle selection change](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#onSelectionChanged) and process [selected item](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#selectedItemKey) data at runtime.
18+
19+
- **Accessibility and Keyboard Navigation**
20+
DropDownButton [conforms](/Documentation/Guide/UI_Components/DropDownButton/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. TagBox also ships with right-to-left ([RTL](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#rtlEnabled)) representation support.
21+
22+
- **Custom Templates**
23+
DropDownButton supports custom markup for the component [action button](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#template) and the [drop-down content](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#dropDownContentTemplate). You can also specify custom templates for [specific](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/items/#template) drop-down items or a [common template](/Documentation/ApiReference/UI_Components/dxDropDownButton/Configuration/#itemTemplate) for all items.
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
- [Getting Started with DropDownButton](/Documentation/Guide/UI_Components/DropDownButton/Getting_Started_with_DropDownButton/)
2+
3+
- [API](/Documentation/ApiReference/UI_Components/dxDropDownButton/)
4+
5+
- [Demos](https://js.devexpress.com/Demos/WidgetsGallery/Demo/DropDownButton/Overview/)
43.5 KB
Loading

0 commit comments

Comments
 (0)