'/%3e%3cg%20transform='translate(170%20205)%20scale(0.3606)'%20fill='%23111011'%3e%3cpath%20d='M497%20640H359L248%20320%20122%20640H0L256%200z'/%3e%3cpath%20d='M292.43%20640H200.8L248%20522z'/%3e%3cpath%20d='M335%200h138l111%20320L710%200h122L576%20640z'/%3e%3c/g%3e%3c/svg%3e){kind=small}
Formularios
Radio
Una opción de una lista corta: puntos, tarjetas o una fila unida de botones; tres tamaños, relleno u outline; opciones como hijos o items.
import { RadioGroup, Radio } from '@alea/ui';
Ejemplos
Grupo de radios
Una opción; las flechas mueven y seleccionan.
Tarjetas
Cada opción como un mosaico, para planes y modos.
Horizontal
Para dos o tres opciones cortas.
Botones
appearance="buttons" une las opciones en una fila de botones; las flechas siguen moviéndose entre ellas. Para dos a cinco opciones cortas.
Items y tamaños
Pasa las opciones como items; size da tamaño a todas las opciones; variant="outline" en un Radio da un anillo de acento sin relleno.
Configuraciones
Cada valor de cada propiedad, lado a lado. Los números coinciden con la leyenda.
- Appearance
appearance - Orientation
orientation - Size
size - Variant
variant
Estados
Cada estado de interacción, forzado para compararlos, en ambos temas.
Oscuro
Claro
Anatomía
Las partes del componente y la clase que da estilo a cada una.
Tokens
Los tokens de diseño que usa este componente, con su valor en el tema actual. Cambia cualquiera para darle otro estilo.
Color
--alea-accent…--alea-accent-strong…--alea-accent-subtle…--alea-border…--alea-border-strong…--alea-focus…--alea-surface…--alea-surface-hover…--alea-text…--alea-text-muted…
Space
--alea-space-2…--alea-space-3…--alea-space-4…--alea-space-5…--alea-space-6…
Radius
--alea-radius-md…--alea-radius-sm…
Type
--alea-font-size-base…--alea-font-size-sm…--alea-font-weight-medium…
Motion
--alea-motion-duration-fast…
Component
--alea-check-size…
Props
RadioGroup props
Una opción de una lista corta; las flechas se mueven entre opciones.
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
appearance | "cards" | "default" | "buttons" | 'default' | default (puntos), cards (mosaicos con borde, ideales para planes o modos) o buttons (una fila de botones unidos). |
description | ReactNode | - | Texto de ayuda bajo el grupo. |
errorMessage | ReactNode | ((v: ValidationResult) => ReactNode) | - | Texto de error, mostrado cuando el grupo es inválido. |
items | ChoiceOption[] | - | Las opciones como datos, en lugar de hijos Checkbox o Radio. |
label | ReactNode | - | La etiqueta visible del grupo. |
orientation | "horizontal" | "vertical" | 'vertical' | vertical (por defecto) u horizontal. |
size | "sm" | "md" | "lg" | - | sm, md (por defecto) o lg para todas las opciones. |
variant | "filled" | "outline" | - | filled (por defecto) u outline para todas las opciones. |
Radio props
Una opción de un RadioGroup.
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
description | ReactNode | - | Texto de ayuda bajo la etiqueta de la opción. |
labelPosition | "start" | "end" | - | Etiqueta a la derecha (por defecto) o a la izquierda. |
size | "sm" | "md" | "lg" | - | sm, md (por defecto) o lg. Normalmente se define en el RadioGroup. |
variant | "filled" | "outline" | - | filled (por defecto) u outline (un anillo y punto de acento, sin relleno). |
Especificaciones
Generado desde el código: las variantes de los tipos, los estados y tokens del CSS, y los patrones de motion que aplican. Las grillas muestran el componente real en ambos temas; los números se miden en la página.
RadioGroup
- Variantes
appearancecardsdefaultbuttonsorientationhorizontalverticalsizesmmdlgvariantfilledoutline- Estados
- HoverSelectedIndeterminateKeyboard focus
- Oscuro y claro
- Cada color viene de tokens del tema, así que sigue a data-theme (y a presets como Graphite) en la página o en cualquier contenedor. El contraste se revisa en ambos temas.
- Clases para estilos
.alea-choice-group.alea-choice-items- Atributos data
data-orientation=horizontaldata-appearance=cardsdata-size=smdata-size=lgdata-variant=outlinedata-nesteddata-appearance=buttons
Radio
- Variantes
labelPositionstartendsizesmmdlgvariantfilledoutline- Estados
- DisabledHoverSelectedIndeterminateKeyboard focusInvalid
- Motion
- morphmore
- Oscuro y claro
- Cada color viene de tokens del tema, así que sigue a data-theme (y a presets como Graphite) en la página o en cualquier contenedor. El contraste se revisa en ambos temas.
- Clases para estilos
.alea-check.alea-radio.alea-check-box.alea-radio-dot.alea-check-text.alea-check-desc- Atributos data
data-appearance=cardsdata-size=smdata-size=lgdata-label-position=startdata-variant=outlinedata-appearance=buttons
Accesibilidad
- Las flechas se mueven y eligen dentro del grupo; Tab sale de él.
Teclado
| Tecla | Acción |
|---|---|
| Tab | Va a la opción elegida |
| Flechas | Se mueven y eligen |
Qué hacer y qué evitar
Hacer
- Preselecciona la opción más común cuando sea seguro.
Evitar
- No lo uses para más de siete opciones: usa Select.