Interruptor Blazor
O componente Ignite UI for Blazor Switch é um componente de seleção de escolha binária que se comporta de forma semelhante ao componente Switch no iOS.
Blazor Switch Example
Usage
No seu cerne, oIgbSwitch O componente permite alternar entre estados ligado e desligado. O estilo padrão é feito de acordo com a especificação de controles de seleção nas diretrizes de Design de Material.
Antes de usá-losIgbSwitch, você precisa registrá-los da seguinte forma:
// in Program.cs file
builder.Services.AddIgniteUIBlazor(typeof(IgbSwitchModule));
Você também precisará vincular um arquivo CSS adicional para aplicar o estilo aoIgbSwitch componente. O seguinte deve ser colocado no arquivo wwwroot/index.html em um projeto Blazor Web Assembly ou no arquivo Pages/_Host.cshtml em um projeto Blazor Server:
<link href="_content/IgniteUI.Blazor/themes/light/bootstrap.css" rel="stylesheet" />
<IgbSwitch />
[!WARNING] The
IgbSwitchcomponent doesn't work with the standard<form>element. UseForminstead.
Examples
Label
Para fornecer um rótulo significativo para o switch, basta colocar algum texto entre as tags de abertura e fechamento:
<IgbSwitch>Label</IgbSwitch>
Você pode especificar se a etiqueta deve ser posicionada antes ou depois do interruptor definindo oLabelPosition atributo do interruptor. Os valores permitidos sãobefore eafter (padrão):
<IgbSwitch LabelPosition="@ToggleLabelPosition.Before">Label</IgbSwitch>
O switch também pode ser rotulado por elementos externos ao switch. Neste caso, o usuário tem controle total para posicionar e estilizar o rótulo de acordo com suas necessidades.
<span id="switch-label>Label</span>
<IgbSwitch AriaLabelledBy="switch-label" />
Checked
Você pode usar ochecked atributo ao toggle no interruptor.
<IgbSwitch Checked="true" />
Required
Você pode usar orequired atribua marcar o interruptor conforme necessário.
<IgbSwitch Required="true" />
Invalid
Você pode usar oinvalid atributo para marcar a mudança como inválida.
<IgbSwitch Invalid="true" />
Disabled
Você pode usar odisabled atributo para desativar o interruptor.
<IgbSwitch Disabled="true" />
Forms
Você pode usar oname evalue Atributos ao usar o switch comForm.
<IgbSwitch Name="wifi" Value="enabled" />
Styling
OIgbSwitch componente expõe várias partes CSS para te dar controle total sobre seu estilo:
| Nome | Descrição |
|---|---|
base |
O invólucro base do switch. |
control |
O elemento de entrada do interruptor. |
thumb |
O indicador de posição do interruptor. |
label |
O rótulo do interruptor. |
igc-switch::part(thumb) {
background-color: var(--ig-success-500);
box-shadow: none;
}
igc-switch::part(thumb checked) {
background-color: var(--ig-gray-50);
}
igc-switch::part(control checked) {
background-color: var(--ig-success-500);
}