Toggle
A toggle represents a physical switch that allows someone to choose between two mutually exclusive options. For example, “On/Off”, “Show/Hide”. Choosing an option should produce an immediate result.
Usage
Basic
Text & Label
LabelTemplate
Controlled
Style & Class
Visibility
Visible: [
]
Hidden: [
]
Collapsed: [ ]
Validation
Implementation
BitToggle parameters
Name |
Type |
Default value |
Description |
|---|---|---|---|
| Classes | BittoggleClassStyles? | null | Custom CSS classes for different parts of the BitToggle. |
| DefaultText | string? | null | Default text of the toggle when it is neither ON or OFF. |
| IsInlineLabel | bool | false | Whether the label (not the onText/offText) should be positioned inline with the toggle control. Left (right in RTL) side when on/off text provided VS right (left in RTL) side when there is no on/off text. |
| Label | string? | null | Label of the toggle. |
| LabelTemplate | RenderFragment? | null | Custom label of the toggle. |
| OnChange | EventCallback<bool> | Callback that is called when the checked value has changed. | |
| OffText | string? | null | Text to display when toggle is OFF. |
| OnText | string? | null | Text to display when toggle is ON. |
| Role | string | switch | Denotes role of the toggle, default is switch. |
| Styles | BittoggleClassStyles? | null | Custom CSS styles for different parts of the BitToggle. |
BitInputBase parameters
Name |
Type |
Default value |
Description |
|---|---|---|---|
| DisplayName | string? | null | Gets or sets the display name for this field. |
| InputHtmlAttributes | IReadOnlyDictionary<string, object>? | null | Gets or sets a collection of additional attributes that will be applied to the created element. |
| Value | TValue? | null | Gets or sets the value of the input. This should be used with two-way binding. |
BitComponentBase parameters
Name |
Type |
Default value |
Description |
|---|---|---|---|
| AriaLabel | string? | null | The aria-label of the control for the benefit of screen readers. |
| Class | string? | null | Custom CSS class for the root element of the component. |
| HtmlAttributes | Dictionary<string, object> | new Dictionary<string, object>() | Capture and render additional attributes in addition to the component's parameters. |
| Id | string? | null | Custom id attribute for the root element. if null the UniqueId will be used instead. |
| IsEnabled | bool | true | Whether or not the component is enabled. |
| Style | string? | null | Custom CSS style for the root element of the component. |
| Visibility | BitVisibility | BitVisibility.Visible | Whether the component is visible, hidden or collapsed. |
BitComponentBase public members
Name |
Type |
Default value |
Description |
|---|---|---|---|
| UniqueId | Guid | Guid.NewGuid() | The readonly unique id of the root element. it will be assigned to a new Guid at component instance construction. |
| RootElement | ElementReference | The ElementReference of the root element. |
BitToggleClassStyles properties
Name |
Type |
Default value |
Description |
|---|---|---|---|
| Button | string? | null | Custom CSS classes/styles for the button of the toggle. |
| Checked | string? | null | Custom CSS classes/styles for the checked state of the toggle. |
| Container | string? | null | Custom CSS classes/styles for the container of the toggle. |
| Thumb | string? | null | Custom CSS classes/styles for the thumb of the toggle. |
| Label | string? | null | Custom CSS classes/styles for the label of the toggle. |
| Root | string? | null | Custom CSS classes/styles for the toggle's root element. |
| Text | string? | null | Custom CSS classes/styles for the text of the toggle. |
BitVisibility enum
Name |
Value |
Description |
|---|---|---|
| Visible | 0 | The content of the component is visible. |
| Hidden | 1 | The content of the component is hidden, but the space it takes on the page remains (visibility:hidden). |
| Collapsed | 2 | The component is hidden (display:none). |