Appearance
In this article, you will find information about the rendering and styling options of the Kendo UI DropDownButton.
For a live example, visit the Appearance Demo of the DropDownButton.
Options
The Kendo UI DropDownButton supports the following styling options:
-
size—Configures the overall size of the component. -
themeColor—Configures what color will be applied to the component. -
fillMode—Configures how the color is applied to the component. -
rounded—Configures the border radius of the component.
Size
The size option controls how big or small the rendered button looks. The structure of the class is k-button-{size}.
The following values are available for the size option:
-
sm—Small size. -
md—Medium size. -
lg—Large size. -
none—Unset.
The default size value is medium and it is applied to the button element through the k-button-md class.
<button id="button" data-role="dropdownbutton" class="k-menu-button k-button k-button-md">
...
</button>
FillMode
The fillMode option controls the way the color is applied to the rendered button. The structure of the class is k-button-{fillMode}.
The following values are available for the fillMode option:
solidoutlineflatlinknone
The default fillMode value is solid and it is applied to the button element through the k-button-solid class.
```html
<button class="k-menu-button k-button k-button-solid" >
...
</button>
```
ThemeColor
As applying themeColor is closely related to the fillMode option, the structure of the class name for themeColor is a composite k-button-{fillMode}-{themeColor} setting.
The following values are available for the themeColor option:
baseprimarysecondarytertiaryinfosuccesswarningerrordarklightinversenone
The default themeColor value is base. A button with default fillMode and themeColor options will have the k-button-solid-base class applied.
<!-- DropDownButton with default fillMode and themeColor -->
<button id="button" data-role="dropdownbutton" class="k-menu-button k-button k-button-md k-rounded-md k-button-solid k-button-solid-base" type="button" aria-haspopup="menu" aria-expanded="false" aria-controls="button_buttonmenu" aria-label="User Settings dropdownbutton">
<span class="k-button-text">User Settings</span>
</button>
<!-- DropDownButton with default fillMode and 'primary' themeColor -->
<button id="button" data-role="dropdownbutton" class="k-menu-button k-button k-button-md k-rounded-md k-button-solid k-button-solid-primary" type="button" aria-haspopup="menu" aria-expanded="false" aria-controls="button_buttonmenu" aria-label="User Settings dropdownbutton">
<span class="k-button-text">User Settings</span>
</button>
<!-- DropDownButton with `flat` fillMode and `primary` themeColor -->
<button id="button" data-role="dropdownbutton" class="k-menu-button k-button k-button-md k-rounded-md k-button-flat k-button-flat-primary" type="button" aria-haspopup="menu" aria-expanded="false" aria-controls="button_buttonmenu" aria-label="User Settings dropdownbutton">
<span class="k-button-text">User Settings</span>
</button>
Rounded
The rounded option controls how much border radius is applied to the rendered button. The structure of the class is k-rounded-{size}.
The following values are available for the rounded option:
-
sm—Small size. -
md—Medium size. -
lg—Large size. circlepill-
none—Unset.
The default rounded value is medium and it is applied to the button element through the k-rounded-md class.
<button id="button" data-role="dropdownbutton" class="k-menu-button k-button k-rounded-md ">
...
</button>
Rendering
To review the rendering of the component, refer to the HTML specifications in the Kendo UI Themes Monorepo. The tests folder of the repository contains the rendering for all flavors of the components, providing a clear reference for how their elements are structured. The rendering information can help you customize a component's appearance and behavior by applying custom CSS or JavaScript to suit specific design or functional requirements.