Blazor Checkbox Overview

The Blazor Checkbox component allows you to add more customizable checkboxes to your application. It maintains the behavior of the standard HTML checkbox and provides checked, unchecked and indeterminate states.

ninja-iconThe Checkbox component is part of Telerik UI for Blazor, a professional grade UI library with 110+ native components for building modern and feature-rich applications. To try it out sign up for a free 30-day trial.Start Free Trial

Creating Blazor Checkbox

  1. Add the TelerikCheckBox tag to a Razor file.

  2. Set the Value parameter to a bool object. It supports one-way and two-way binding.

  3. (optional) Set the Id parameter to attach a <label> to the checkbox.

Basic setup of the Telerik CheckBox using two-way data binding.

@*Basic setup of the Telerik CheckBox Component*@

<TelerikCheckBox Id="myCheckBox" @bind-Value="@isSelected" />
<label for="myCheckBox">@( isSelected ? "Selected" : "Not selected" )</label>

@code {
    private bool isSelected { get; set; }
}

Indeterminate State

In addition to basic checked and unchecked states, the Blazor CheckBox has a third state - indeterminate. Read more about the Blazor Checkbox indeterminate state.

Appearance

The Checkbox component provides size and border settings to control its appearance. Read more about the Blazor Checkbox appearance settings.

To learn more about the appearance, anatomy, and accessibility of the CheckBox, visit the Progress Design System Kit documentation—an information portal offering rich component usage guidelines, descriptions of the available style variables, and globalization support details.

Events

The Blazor Checkbox fires value change, focus and state change events that you can handle and further customize its behavior. Read more about the Blazor Checkbox events.

Checkbox Parameters

The Blazor CheckBox provides various parameters that allow you to configure the component:

ParameterTypeDescription
ClassstringRenders a custom CSS class to the <input class="k-checkbox"> element.
EnabledboolWhether the component is enabled.
IdstringRenders as the id attribute on the <input /> element, so you can attach a <label for=""> to it.
IndeterminateboolPuts the CheckBox in its third state - Indeterminate. See the Indeterminate state article for more information and examples.
TabIndexNullable<int>The tabindex attribute rendered on the CheckBox.
ValueboolMapped to the Checked property of the normal HTML checkbox.

See also the Input Validation article.

Common Example

Example that showcases the "I agree to the terms and conditions" basic scenario.

@if (hasAgreed)
{
    <div class="alert alert-success w-50">
        Thank you for agreeing to our terms and conditions!
    </div>
}
else
{
    <p class="w-50 text-justify">
        Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris mi lectus, ultrices sed libero et, tempor rutrum mauris. Praesent sit amet suscipit leo, ut hendrerit lacus. Mauris posuere, mi in elementum pretium, sem elit maximus mauris, ac tempus turpis nunc sed orci. Nunc velit lacus, rutrum et dui mattis, condimentum fermentum velit. Pellentesque et elit rhoncus, sodales nibh ac, faucibus tellus. Vestibulum vitae tempor tellus. Sed maximus sem quis est posuere, efficitur porttitor augue tincidunt. Sed viverra dapibus ullamcorper. Vestibulum ex arcu, molestie sed quam vulputate, aliquet cursus lectus. Aenean sollicitudin condimentum fringilla. Integer arcu justo, sollicitudin ut libero ut, posuere finibus sapien. Suspendisse hendrerit convallis urna.
        Donec eu sodales dui, et consequat massa. Integer vitae euismod dui, id rhoncus tellus. Ut luctus leo eget sapien eleifend facilisis. Duis sed maximus tortor. Ut nunc nibh, pulvinar a enim eget, mattis sagittis sem. Mauris odio nibh, aliquet a erat sit amet.
    </p>
}

<TelerikCheckBox Id="myCheckBox" @bind-Value="@hasAgreed" />
<label for="myCheckBox">I agree to the terms and conditions</label>

@code {
    private bool hasAgreed { get; set; }
}

Next Steps

See Also