Appearance

In this article, you will find information about the styling options and rendering of the Kendo UI Switch.

For a live example, visit the Appearance Demo of the Switch.

Options

The Kendo UI Switch supports the following styling options:

• size—configures the overall size of the component.
• trackRounded—configures the track's border radius.
• thumbRounded—configures the thumb's border radius.

Size

The size option controls how big or small the switch looks. The structure of the class is k-switch-{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 wrapping span element through the k-switch-md class.

The example below shows a basic Switch configuration and how to set the size option:

    <input id="switch" />
    <script>
        $("#switch").kendoSwitch({
            size:"large"
        })
    </script>

The option affects the span.k-switch element:

html

<span class="k-switch k-switch-on k-switch-lg">
</span>

TrackRounded

The trackRounded option controls how much border radius is applied to track of the widget. The structure of the class is k-rounded-{size}.

The following values are available for the trackRounded option:

• sm—small border radius
• md—medium border radius
• lg—large border radius
• full—ellipse-like border radius
• none—unset

The default value is full and it is applied to the wrapping span element that contains the On/Off labels through the k-rounded-full class.

The example below shows a basic Switch configuration and how to set the trackRounded option:

    <input id="switch" />
    <script>
        $("#switch").kendoSwitch({
            trackRounded:"large"
        })
    </script>

The option affects the span element that wraps the On/Off labels:

html

<span class="k-switch-track k-rounded-lg">
</span>

ThumbRounded

The thumbRounded option controls how much border radius is applied to thumb of the widget. The structure of the class is k-rounded-{size}.

The following values are available for the thumbRounded option:

• sm—small border radius
• md—medium border radius
• lg—large border radius
• full—ellipse-like border radius
• none—unset

The default value is full and it is applied to the span element for the thumb through the k-rounded-full class.

The example below shows a basic Switch configuration and how to set the thumbRounded option:

    <input id="switch" />
    <script>
        $("#switch").kendoSwitch({
            thumbRounded:"large"
        })
    </script>

The option affects the span element for the Switch handle:

html

<span class="k-switch-thumb k-rounded-md">
</span>

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.

See Also

• Components Appearance Overview
• Appearance Demo of the Switch
• JavaScript API Reference of the Switch