Appearance
In this article, you will find information about the styling options and rendering of the Kendo UI Button.
For a live example, visit the Appearance Demo of the Button.
Options
The Kendo UI Button 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 is applied to the button element through the k-button-md
class.
<button class="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:
solid
outline
flat
link
clear
none
The default fillMode value is solid
and is applied to the button element through the k-button-solid
class.
<button class="k-button k-button-solid" >
</button>
ThemeColor
The themeColor
option controls the color that will be applied to the rendered Button. As applying themeColor
is closely related to the fillMode
, the structure of the class name for the themeColor
is composite - k-button-{fillMode}-{themeColor}
.
The following values are available for the themeColor
option:
base
primary
secondary
tertiary
info
success
warning
error
dark
light
inverse
none
The default themeColor
value is base
. A button with default fillMode
and themeColor
will have k-button-solid-base
class applied.
<!-- Button with default fillMode and themeColor -->
<button class="k-button k-button-solid k-button-solid-base" >
</button>
<!-- Button with default fillMode and 'primary' themeColor -->
<button class="k-button k-button-solid k-button-solid-primary" >
</button>
<!-- Button with `flat` fillMode and `primary` themeColor -->
<button class="k-button k-button-flat k-button-flat-primary" >
</button>
Rounded
The rounded
option controls the extent to which 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 circle
pill
-
none
—unset
The default rounded value is medium
and is applied to the button element through the k-rounded-md
class.
<button class="k-button k-rounded-md" >
</button>
Rendering
Starting with version R1 2022, the component has a new rendering. For additional information on the decision behind these changes, visit the Components Rendering Overview article.
To review the latest 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.