New to Kendo UI for Vue? Start a free 30-day trial

Represents the Kendo UI for Vue DropDownButton component. Accepts properties of type DropDownButtonProps. Use the DropDownButton to show a list of actions in a popup when the user clicks a button.

Definition

Package:@progress/kendo-vue-buttons

Properties Interface:DropDownButtonProps

Syntax:

vue
<DropDownButton :text="'Export'" :items="['PDF', 'Excel', 'CSV']" />

Properties

Sets the accesskey attribute of the main button. Users press this key to focus the main button.

Sets the aria-label attribute of the main button. If you do not set it and the main button shows an icon, the DropDownButton uses Menu.

Sets the CSS class of the main button.

dir?

string

Sets the direction of the DropDownButton. Accepts ltr or rtl.

disabled?

boolean

Sets whether the DropDownButton is disabled (see example).

endIcon?

string

Sets the name of a font icon to render after the DropDownButton text. Use it with icon or svgIcon to show icons on both sides of the text.

Sets the SVGIcon to render after the DropDownButton text. Use it with icon or svgIcon to show icons on both sides of the text.

fillMode?

"solid" | "outline" | "flat" | "link"

Sets the fill style of the main button.

The available options are:

  • solid
  • outline
  • flat
  • link
Default:

undefined

icon?

string

Sets the name of a font icon that the DropDownButton renders next to the text of the main button (see example).

Sets a CSS class for a custom icon that the DropDownButton renders next to the text of the main button (see example).

imageUrl?

string

Sets the URL of an image that the DropDownButton shows next to the text of the main button (see example).

Sets a custom template for each item (see example). Accepts a slot name, a render function, or a Vue component. The default template renders an icon, an image, and text.

Sets a custom template for each item. Use it to change the default look of the items. If you do not set the item property, itemRender works like item. This keeps backward compatibility with versions before 4.2.0.

items?

any[]

Sets the items of the popup list (see example).

Default:

[]

Fires when the DropDownButton loses the focus (see example). The event name is blur.

Parameters:eventDropDownButtonBlurEvent

Fires when the popup with the items closes (see example). The event name is close.

Parameters:eventDropDownButtonCloseEvent

Fires when the DropDownButton gets the focus (see example). The event name is focus.

Parameters:eventDropDownButtonFocusEvent

Fires when the user clicks an item (see example). The event name is itemclick.

Fires when the popup with the items opens (see example). The event name is open.

Parameters:eventDropDownButtonOpenEvent

opened?

boolean

Sets whether the popup of the DropDownButton is open. When you set it, you control the open state.

Sets the settings of the popup (see example).

rounded?

"small" | "medium" | "large" | "none" | "full"

Sets the border radius of the main button.

The available options are:

  • none
  • small
  • medium
  • large
  • circle
  • full
Default:

undefined

size?

"xs" | "small" | "medium" | "large"

Sets the size of the main button.

The available options are:

  • xs
  • small
  • medium
  • large
Default:

undefined

svgIcon?

SVGIcon

Sets the SVGIcon that the DropDownButton renders next to the text of the main button.

tabIndex?

number

Sets the tabindex attribute of the main button.

Sets the text of the main button (see example).

Sets the field of the data item that provides the text of each item. Use it together with the items property (see example).

themeColor?

"base" | "primary" | "secondary" | "tertiary" | "info" | "success" | "warning" | "error" | "inverse"

Sets the theme color of the main button.

The available options are:

  • base
  • primary
  • secondary
  • tertiary
  • info
  • success
  • warning
  • error
  • inverse
Default:

undefined