Rádio Blazor e Grupo de Rádio
O componente Ignite UI for Blazor Radio permite que o usuário selecione uma única opção de um conjunto de opções disponíveis listadas lado a lado.
Ignite UI for Blazor Radio Example
Usage
Antes de usar o IgbRadio
e o IgbRadioGroup
, você precisa registrá-los da seguinte forma:
// in Program.cs file
builder.Services.AddIgniteUIBlazor(
typeof(IgbRadioModule),
typeof(IgbRadioGroupModule)
);
Você também precisará vincular um arquivo CSS adicional para aplicar o estilo aos componentes IgbRadio
e IgbRadioGroup
. O seguinte precisa 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" />
<IgbRadioGroup>
<IgbRadio>Apple</IgbRadio>
<IgbRadio>Banana</IgbRadio>
<IgbRadio>Mango</IgbRadio>
<IgbRadio>Orange</IgbRadio>
</IgbRadioGroup>
[!WARNING] The
IgbRadio
component doesn't work with the standard<form>
element. UseForm
instead.
Examples
Label
Para fornecer um rótulo significativo para o IgbRadio
, basta colocar algum texto entre as tags de abertura e fechamento:
<IgbRadio>Apple</IgbRadio>
Você pode especificar se o rótulo deve ser posicionado antes ou depois do botão IgbRadio
definindo o atributo label-position
. Os valores permitidos são before
e after
(padrão):
<IgbRadio LabelPosition="@RadioLabelPosition.Before">Apple</IgbRadio>
O IgbRadio
também pode ser rotulado por elementos externos a ele. Neste caso, o usuário tem controle total para posicionar e estilizar o rótulo de acordo com suas necessidades.
<span id="radio-label">Label</span>
<IgbRadio AriaLabelledBy="radio-label" />
Checked
Você pode usar o atributo checked
para ligar o rádio.
<IgbRadioGroup>
<IgbRadio>Apple</IgbRadio>
<IgbRadio Checked="true">Banana</IgbRadio>
<IgbRadio>Mango</IgbRadio>
<IgbRadio>Orange</IgbRadio>
</IgbRadioGroup>
Invalid
Você pode usar o atributo invalid
para marcar o rádio como inválido.
<IgbRadio Invalid="true" />
Disabled
Você pode usar o atributo disabled
para desabilitar o rádio.
<IgbRadioGroup>
<IgbRadio>Apple</IgbRadio>
<IgbRadio Disabled="true">Banana</IgbRadio>
<IgbRadio>Mango</IgbRadio>
<IgbRadio>Orange</IgbRadio>
</IgbRadioGroup>
Group Alignment
O IgbRadioGroup
permite que você altere facilmente a direcionalidade de posicionamento dos botões de opção que ele contém usando o atributo de alignment
. Os valores permitidos são vertical
(padrão) e horizontal
.
<IgbRadioGroup Alignment="@RadioGroupAlignment.Horizontal">
<IgbRadio>Apple</IgbRadio>
<IgbRadio>Banana</IgbRadio>
<IgbRadio>Mango</IgbRadio>
<IgbRadio>Orange</IgbRadio>
</IgbRadioGroup>
Forms
Você pode usar os atributos name
e value
ao usar o rádio com Form
.
<IgbRadioGroup>
<IgbRadio Name="fruit" Value="apple">Apple</IgbRadio>
<IgbRadio Name="fruit" Value="banana">Banana</IgbRadio>
<IgbRadio Name="fruit" Value="mango">Mango</IgbRadio>
<IgbRadio Name="fruit" Value="orange">Orange</IgbRadio>
</IgbRadioGroup>
Styling
The IgbRadio
component exposes several CSS parts (base
, control
, and label
) to give you full control over its styling.
igc-radio::part(control) {
--size: 18px;
}
igc-radio-group {
padding: 12px;
}
igc-radio::part(checked)::after {
background-color: var(--ig-success-500);
}
igc-radio::part(label) {
color: var(--ig-secondary-800);
}