'/%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
TreeSelect
Un select cuyas opciones son un árbol, simple o múltiple.
import { TreeSelect } from '@alea/ui';
Ejemplos
TreeSelect
Una opción simple o múltiple de un árbol.
Featured
Show in the menu
Configuraciones
Cada valor de cada propiedad, lado a lado. Los números coinciden con la leyenda.
- Selection Mode
selectionMode
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.
Props
TreeSelect props
Un select cuyas opciones son un árbol: categorías, carpetas, organigramas.
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
nodesobligatoria | TreeSelectNode[] | - | El árbol: id, label, children. |
defaultValue | Key[] | - | El id seleccionado al inicio. |
isDisabled | boolean | - | Deshabilita todas sus partes. |
label | ReactNode | - | La etiqueta visible. |
motion | MotionProp | - | Cómo entra y sale el popup: un preset (fade, scale, pop, slide-down, blur...), false para ninguno, u opciones. |
onChange | ((keys: Key[]) => void) | - | Se llama con el id seleccionado. |
placeholder | string | - | Se muestra mientras no hay valor. |
selectionMode | "single" | "multiple" | 'single' | single (por defecto) o multiple. |
value | Key[] | - | El id seleccionado (controlado). |
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.
- Variantes
selectionModesinglemultiple- Motion
- morphnudgeAcepta una prop motion para su entrada y salida.
- 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-treeselect.alea-select-trigger.alea-select-value.alea-select-chevron.alea-select-popover.alea-treeselect-dialog
Accesibilidad
- Las opciones son una grilla de árbol: las flechas abren y cierran ramas.
Teclado
| Tecla | Acción |
|---|---|
| Enter o Espacio | Abre el árbol |
| Flechas | Se mueven; Derecha abre, Izquierda cierra |
| Enter | Elige el elemento |
| Escape | Cierra |
Qué hacer y qué evitar
Hacer
- Úsalo para elegir una carpeta o categoría de un árbol.
- Abre la ruta hasta el valor actual al abrirlo.
Evitar
- No lo uses para listas planas: usa Select.
- No ocultes los padres del elemento elegido.