Provides a native checkbox input control with enhanced styling, accessibility features, and data binding capabilities. Enables users to make binary choices like accepting terms, toggling settings, or selecting items from lists. Supports three visual states: checked, unchecked, and indeterminate for complex selection scenarios. Includes built-in validation integration, customizable appearance through theme settings, and full keyboard accessibility. Use for single selections, multi-item selection in lists, or hierarchical selection with parent-child relationships.
Definition
Namespace:Telerik.Blazor.Components
Assembly:Telerik.Blazor.dll
Type Parameters:
TValue
The data type for the checkbox value, restricted to boolean types for proper checkbox behavior. Use bool for simple true/false selections where a value is always required. Use nullable boolean to support three-state behavior with checked, unchecked, and null (indeterminate) values.
Syntax:
public class TelerikCheckBox<TValue> : TelerikInputBase<TValue>, IComponent, IHandleEvent, IHandleAfterRender, IDisposableInheritance: objectComponentBaseBaseComponentTelerikInputBase<TValue>TelerikCheckBox<TValue>
Implements:
Inherited Members
Constructors
public TelerikCheckBox()Methods
protected override void BuildRenderTree(RenderTreeBuilder __builder)Overrides:
public override void Dispose()Overrides:
protected override void OnInitialized()Overrides:
public override Task SetParametersAsync(ParameterView parameters)Overrides:
Properties
Provides configuration for WebMCP tools, such as a Name to distinguish this CheckBox from others on the same page.
[Parameter]
public RenderFragment CheckBoxSettings { get; set; }Gets or sets the description used for the data-smart-paste attribute.
[Parameter]
public string DataSmartPasteDescriptionAttribute { get; set; }Enables WebMCP tool registration for this CheckBox.
When true, CheckBox operations are exposed as tools discoverable by AI models through the browser.
Default value is false.
[Parameter]
public bool EnableWebMcpTools { get; set; }Fires when the indeterminate state changes, enabling two-way binding for the Indeterminate property. Use with @bind-Indeterminate syntax for automatic state synchronization in parent-child checkbox scenarios.
[Parameter]
public EventCallback<bool> IndeterminateChanged { get; set; }Controls the corner rounding style of the checkbox. Works with all themes and automatically adapts to the current visual design system.
Specifies the size of the checkbox.