Toolbar
Agrupar controles relacionados. Una sola parada de Tab. Flechas entre todos los controles.
NuevoInstalación
Copia y pega el siguiente código en tu proyecto.
Actualiza las rutas de importación para que coincidan con la estructura de tu proyecto.
Anatomía
Composición
Utiliza la siguiente composición para construir un
Toolbar:Solo las piezas de arriba participan de la navegación con flechas. Un
button común dentro del toolbar sigue siendo una parada de Tab aparte.Para sumar otro control, envolvelo en
Toolbar.Item asChild. El hijo conserva sus props y recibe el manejo de foco del toolbar, por ejemplo un select:El select se sigue abriendo con
ArrowDown, porque el toolbar solo escucha las flechas que van a lo largo de él.Teclado
Todo el toolbar es una sola parada de Tab. La primera vez, Tab cae en el primer control habilitado. Después vuelve al último control que usaste.
| Tecla | Acción |
|---|---|
Tab, Shift+Tab | Entra al toolbar o sale de él |
ArrowRight, ArrowLeft | Va al control siguiente o anterior. Se invierten en RTL |
ArrowDown, ArrowUp | Lo mismo, con orientation="vertical" |
Home, End | Salta al primer o al último control |
Espacio, Enter | Activa el control enfocado |
Los controles deshabilitados se saltean. Dentro de un campo de texto registrado con
Toolbar.Item, las flechas izquierda y derecha, Home y End mueven el cursor.Accesibilidad
- La raíz tiene
role="toolbar"yaria-orientation. Dale siempre unaria-labeloaria-labelledby, porque una página suele tener más de un toolbar. - Un
ToggleGroupanidado conserva surole="group"y su propia etiqueta, así los lectores de pantalla siguen anunciando el grupo, pero sus items comparten la única parada de Tab del toolbar. Toolbar.Separatores unrole="separator"con la orientación opuesta: vertical en un toolbar horizontal.- La dirección sale de
dir, de unDirectionProvidero de la dirección CSS calculada, así las flechas coinciden con el layout en RTL.
Referencia de API
Toolbar
Acepta también todos los atributos de
div.| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
aria-label | string | - | Nombra el toolbar. En la práctica, obligatorio |
orientation | 'horizontal' | 'vertical' | 'horizontal' | Disposición y qué flechas mueven el foco |
dir | 'ltr' | 'rtl' | Heredado | Dirección del texto para el layout y las flechas |
loop | boolean | true | Pasa el foco del último control al primero |
className | string | - | Clases CSS adicionales |
Toolbar.Button
Un botón ghost de 32px de alto. Acepta todos los atributos de
button.Toolbar.Toggle
Un Toggle con
size="sm" por defecto. Recibe las mismas props: pressed, defaultPressed, onPressedChange, variant, size y disabled.Toolbar.Link
Un
a con el estilo de un botón del toolbar. Acepta todos los atributos de un enlace.Toolbar.Item
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
asChild | boolean | false | Registra el elemento hijo en lugar de renderizar un button |
disabled | boolean | false | Saltea el control. Con asChild también cuenta el disabled del hijo |
className | string | - | Clases CSS adicionales, combinadas con las del hijo |
Toolbar.Separator
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
className | string | - | Clases CSS adicionales |
¿Encontraste algo que mejorar?
¿Notaste un error, tipografía o detalle faltante en esta página? Ayúdanos a mejorar la documentación abriendo un issue en GitHub.