# Blazor Checkbox Overview

The <a href="https://www.telerik.com/blazor-ui/checkbox" target="_blank">Blazor Checkbox component</a> 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](https://www.telerik.com/blazor-ui/documentation/components/checkbox/indeterminate-state) states.

## 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.

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

<demo metaUrl="client/checkbox/overview/" height="420"></demo>

## 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](https://www.telerik.com/blazor-ui/documentation/components/checkbox/indeterminate-state).

## Appearance

The Checkbox component provides size and border settings to control its appearance. [Read more about the Blazor Checkbox appearance settings](https://www.telerik.com/blazor-ui/documentation/components/checkbox/appearance).

> tip To learn more about the appearance, anatomy, and accessibility of the CheckBox, visit the [Progress Design System Kit documentation](https://www.telerik.com/design-system/docs/components/checkbox/)—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](https://www.telerik.com/blazor-ui/documentation/components/checkbox/events).

## Checkbox Parameters

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

<style>
    .article table {
        table-layout: auto;
        word-break: normal;
    }
</style>

| Parameter       | Type            | Description                                                                                                                                                                                                             |
| --------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Class`         | `string`        | Renders a custom CSS class to the `<input class="k-checkbox">` element.                                                                                                                                                 |
| `Enabled`       | `bool`          | Whether the component is enabled.                                                                                                                                                                                       |
| `Id`            | `string`        | Renders as the `id` attribute on the `<input />` element, so you can attach a `<label for="">` to it.                                                                                                                   |
| `Indeterminate` | `bool`          | Puts the CheckBox in its third state - Indeterminate. See the [Indeterminate state](https://www.telerik.com/blazor-ui/documentation/components/checkbox/indeterminate-state) article for more information and examples. |
| `TabIndex`      | `Nullable<int>` | The `tabindex` attribute rendered on the CheckBox.                                                                                                                                                                      |
| `Value`         | `bool`          | Mapped to the `Checked` property of the normal HTML checkbox.                                                                                                                                                           |

See also the [Input Validation](https://www.telerik.com/blazor-ui/documentation/common-features/input-validation) article.

## Common Example

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

<demo metaUrl="client/checkbox/common-example/" height="420"></demo>

## Next Steps

* [Explore the CheckBox Indeterminate State](https://www.telerik.com/blazor-ui/documentation/components/checkbox/indeterminate-state)

* [Handle the CheckBox Events](https://www.telerik.com/blazor-ui/documentation/components/checkbox/events)

## See Also

* [Live CheckBox Demos](https://demos.telerik.com/blazor-ui/checkbox/overview)
* [CheckBox API Reference](https://www.telerik.com/blazor-ui/documentation/api/telerik.blazor.components.telerikcheckbox-1)
