Appearance
In this article, you will find information about the rendering and styling options of the Kendo UI SplitButton.
For a live example, visit the Appearance Demo of the SplitButton.
Options
The Kendo UI SplitButton 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.
<div id="splitButton_wrapper" class="k-split-button k-button-group k-rounded-md">
<button type="button" id="splitButton" data-role="splitbutton" class="k-button k-button-md k-rounded-md k-button-solid k-button-solid-base" aria-label="Plus splitbutton">
<span class="k-icon k-i-plus k-button-icon"></span>
<span class="k-button-text">Plus</span>
</button>
<button tabindex="-1" aria-label="arrow-button" class="k-split-button-arrow k-button k-button-md k-rounded-md k-button-solid k-button-solid-base k-icon-button" type="button">
<span class="k-icon k-i-arrow-s k-button-icon"></span>
</button>
</div>
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.
<div id="splitButton_wrapper" class="k-split-button k-button-group k-rounded-md">
<button class="k-button k-button-solid" >
...
</button>
<button tabindex="-1" aria-label="arrow-button" class="k-split-button-arrow k-button-solid k-button-solid-base k-icon-button" type="button">
...
</button>
</div>
ThemeColor
As applying themeColor is closely related to the fillMode, the structure of the class name for the 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 will have the k-button-solid-base class applied.
<!-- SplitButton with default fillMode and themeColor -->
<div id="splitButton_wrapper" class="k-split-button k-button-group k-rounded-md">
<button id="button" data-role="splitbutton" class="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="Button splitbutton">
<span class="k-icon k-i-paste k-button-icon"></span>
<span class="k-button-text">Button</span>
</button>
<button tabindex="-1" aria-label="arrow-button" class="k-split-button-arrow k-button k-button-md k-rounded-md k-button-solid k-button-solid-base k-icon-button" type="button">
<span class="k-icon k-i-arrow-s k-button-icon"></span>
</button>
</div>
<!-- SplitButton with default fillMode and 'primary' themeColor -->
<div id="splitButton_wrapper" class="k-split-button k-button-group k-rounded-md">
<button id="button" data-role="splitbutton" class="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="Button splitbutton">
<span class="k-icon k-i-paste k-button-icon"></span>
<span class="k-button-text">Button</span>
</button>
<button tabindex="-1" aria-label="arrow-button" class="k-split-button-arrow k-button k-icon-button k-button-md k-rounded-md k-button-solid k-button-solid-primary" type="button">
<span class="k-icon k-i-arrow-s k-button-icon"></span>
</button>
</div>
<!-- SplitButton with `flat` fillMode and `primary` themeColor -->
<div id="splitButton_wrapper" class="k-split-button k-button-group k-rounded-md">
<button id="button" data-role="splitbutton" class="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="Button splitbutton">
<span class="k-icon k-i-paste k-button-icon"></span>
<span class="k-button-text">Button</span>
</button>
<button tabindex="-1" aria-label="arrow-button" class="k-split-button-arrow k-button k-icon-button k-button-md k-rounded-md k-button-flat k-button-flat-primary" type="button">
<span class="k-icon k-i-arrow-s k-button-icon"></span>
</button>
</div>
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.
<div id="splitButton_wrapper" class="k-split-button k-button-group k-rounded-md">
<button id="button" data-role="splitbutton" class="k-button k-rounded-md">
...
</button>
<button class="k-split-button-arrow k-button k-icon-button k-rounded-md" type="button">
...
</button>
</div>
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.