React Radio & Radio Group
El componente Ignite UI for React Radio permite al usuario seleccionar una única opción de un conjunto de opciones disponibles que aparecen enumeradas una al lado de la otra.
Ignite UI for React Radio Example
Usage
Primero, debes instalar el paquete npm Ignite UI for React correspondiente ejecutando el siguiente comando:
npm install igniteui-react
You will then need to import the IgrRadio and the IgrRadioGroup, its necessary CSS, and register its module, like so:
import { IgrRadio, IgrRadioGroupComponent } from 'igniteui-react';
import 'igniteui-webcomponents/themes/light/bootstrap.css';
<IgrRadioGroup>
<IgrRadio value="apple"><span>Apple</span></IgrRadio>
<IgrRadio value="banana"><span>Banana</span></IgrRadio>
<IgrRadio value="Mango"><span>Mango</span></IgrRadio>
<IgrRadio value="orange"><span>Orange</span></IgrRadio>
</IgrRadioGroup>
[!WARNING] The
IgrRadiocomponent doesn't work with the standard<form>element. UseForminstead.
Examples
Label
Para proporcionar una etiqueta significativa,IgrRadio simplemente coloca algo de texto entre las etiquetas de apertura y cierre:
<IgrRadio><span>Label</span></IgrRadio>
Puedes especificar si la etiqueta debe colocarse antes o después delIgrRadio botón configurando ellabel-position atributo. Los valores permitidos sonbefore yafter (por defecto):
<IgrRadio labelPosition="before"><span>Apple</span></IgrRadio>
TambiénIgrRadio pueden etiquetarse por elementos externos a él. En este caso, el usuario tiene control total para posicionar y estilizar la etiqueta según sus necesidades.
<span id="radio-label">Label</span>
<IgrRadio aria-labelledby="radio-label"></IgrRadio>
Checked
Puedes usar elchecked atributo para activar la radio.
<IgrRadioGroup>
<IgrRadio value="apple"><span>Apple</span></IgrRadio>
<IgrRadio value="banana" checked={true}><span>Banana</span></IgrRadio>
<IgrRadio value="Mango"><span>Mango</span></IgrRadio>
<IgrRadio value="orange"><span>Orange</span></IgrRadio>
</IgrRadioGroup>
Invalid
Puedes usar elinvalid atributo para marcar la radio como inválida.
<IgrRadio invalid={true}></IgrRadio>
Disabled
Puedes usar eldisabled atributo para desactivar la radio.
<IgrRadioGroup>
<IgrRadio value="apple"><span>Apple</span></IgrRadio>
<IgrRadio value="banana" disabled={true}><span>Banana</span></IgrRadio>
<IgrRadio value="Mango"><span>Mango</span></IgrRadio>
<IgrRadio value="orange"><span>Orange</span></IgrRadio>
</IgrRadioGroup>
Group Alignment
PermiteIgrRadioGroup cambiar fácilmente la dirección de colocación de los botones de radio que contiene usando elalignment atributo. Los valores permitidos sonvertical (por defecto) yhorizontal.
<IgrRadioGroup alignment="horizontal">
<IgrRadio value="apple"><span>Apple</span></IgrRadio>
<IgrRadio value="banana" disabled={true}><span>Banana</span></IgrRadio>
<IgrRadio value="Mango"><span>Mango</span></IgrRadio>
<IgrRadio value="orange"><span>Orange</span></IgrRadio>
</IgrRadioGroup>
Forms
Puedes usar losname atributos yvalue cuando usas la radio conForm.
<IgrRadioGroup>
<IgrRadio name="fruit" value="apple"><span>Apple</span></IgrRadio>
<IgrRadio name="fruit" value="banana"><span>Banana</span></IgrRadio>
<IgrRadio name="fruit" value="Mango"><span>Mango</span></IgrRadio>
<IgrRadio name="fruit" value="orange"><span>Orange</span></IgrRadio>
</IgrRadioGroup>
Styling
ElIgrRadio componente expone varias partes CSS (base,control, andlabel) para darte control total sobre su estilo.
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);
}