## Dropdown Toggleable menu for displaying lists of links and actions. ### Basic usage Hover on the dropdown menu to unfold it for more actions. :::demo The triggering element is rendered by the default `slot`, and the dropdown part is rendered by the `slot` named `dropdown`. By default, dropdown list shows when you hover on the triggering element without having to click it. ```html Dropdown List Action 1 Action 2 Action 3 Action 4 Action 5 ``` ::: ### Triggering element Use the button to trigger the dropdown list. :::demo Use `split-button` to split the triggering element into a button group with the left button being a normal button and right one the actual triggering target. If you wanna insert a separator line between item three and item four, just add a class `divider` to item four. ```html Dropdown List Action 1 Action 2 Action 3 Action 4 Action 5 Dropdown List Action 1 Action 2 Action 3 Action 4 Action 5 ``` ::: ### How to trigger Click the triggering element or hover on it. :::demo Use the attribute `trigger`. By default, it is `hover`. ```html hover to trigger Dropdown List Action 1 Action 2 Action 3 Action 4 Action 5 click to trigger Dropdown List Action 1 Action 2 Action 3 Action 4 Action 5 ``` ::: ### Menu hiding behavior Use `hide-on-click` to define if menu closes on clicking. :::demo By default menu will close when you click on menu items, and it can be turned off by setting hide-on-click to false. ```html Dropdown List Action 1 Action 2 Action 3 Action 4 Action 5 ``` ::: ### Command event Clicking each dropdown item fires an event whose parameter is assigned by each item. :::demo ```html Dropdown List Action 1 Action 2 Action 3 Action 4 Action 5 ``` ::: ### Sizes Besides default size, Dropdown component provides three additional sizes for you to choose among different scenarios. :::demo Use attribute `size` to set additional sizes with `medium`, `small` or `mini`. ```html Default Action 1 Action 2 Action 3 Action 4 Medium Action 1 Action 2 Action 3 Action 4 Small Action 1 Action 2 Action 3 Action 4 Mini Action 1 Action 2 Action 3 Action 4 ``` ::: ### Dropdown Attributes | Attribute | Description | Type | Accepted Values | Default | |------------- |---------------- |---------------- |---------------------- |-------- | | type | menu button type, refer to `Button` Component, only works when `split-button` is true | string | — | — | | size | menu size, also works on the split button | string | medium / small / mini | — | | split-button | whether a button group is displayed | boolean | — | false | | placement | placement of pop menu | string | top/top-start/top-end/bottom/bottom-start/bottom-end | bottom-end | | trigger | how to trigger | string | hover/click | hover | | hide-on-click | whether to hide menu after clicking menu-item | boolean | — | true | | show-timeout | Delay time before show a dropdown | number | — | 250 | | hide-timeout | Delay time before hide a dropdown | number | — | 150 | ### Dropdown Events | Event Name | Description | Parameters | |---------- |-------- |---------- | | click | if `split-button` is `true`, triggers when left button is clicked | — | | command | triggers when a dropdown item is clicked | the command dispatched from the dropdown item | | visible-change | triggers when the dropdown appears/disappears | true when it appears, and false otherwise | ### Dropdown Menu Item Attributes | Attribute | Description | Type | Accepted Values | Default | |------------- |---------------- |---------------- |---------------------- |-------- | | command | a command to be dispatched to Dropdown's `command` callback | string/number/object | — | — | | disabled | whether the item is disabled | boolean | — | false | | divided | whether a divider is displayed | boolean | — | false |