Layout

Toolbar

Barra degli strumenti con tre zone di posizionamento (start, center, end). Supporta varianti visive, dimensioni, arrotondamento, sticky positioning e layout responsive.

Import

import { Toolbar } from '@pzeta/vue-components'

Esempio Base

Props

PropTipoDefaultDescrizione
variant'default' | 'filled' | 'outlined' | 'flat' | 'transparent''default'Variante visiva
size'small' | 'medium' | 'large''medium'Dimensione della toolbar
rounded'none' | 'sm' | 'md' | 'lg' | 'xl' | 'full''lg'Arrotondamento dei bordi
shadowbooleanfalseOmbra esterna
stickybooleanfalsePosizionamento sticky (rimane visibile in scroll)
responsiveHorizontalbooleanfalseLayout orizzontale responsive su schermi piccoli
ariaLabelledbystring | nullnullID dell'elemento che etichetta la toolbar. Insieme ad ariaLabel attiva role="toolbar" con navigazione APG
ariaLabelstring | nullnullNome accessibile della toolbar. Quando valorizzato (o ariaLabelledby) il contenitore assume role="toolbar" con navigazione da tastiera APG (frecce/Home/End + roving tabindex); senza nome resta un contenitore neutro senza role
classstring | object | string[]Classe CSS aggiuntiva
styleobject | stringStile inline aggiuntivo

Emits

Nessun evento emesso.

Slot

SlotScopeDescrizione
startArea sinistra (azioni primarie, logo, pulsanti)
centerArea centrale (titolo, barra di ricerca)
endArea destra (azioni secondarie, pulsante salva)
defaultContenuto semplice quando nessuno dei tre slot nominati è usato

Esempi

Toolbar con azioni e ricerca

Toolbar sticky

Varianti visive

Toolbar con contenuto semplice (slot default)

Accessibilità

Il pattern role="toolbar" (APG) viene attivato solo quando la toolbar ha un nome accessibile, cioè quando si valorizza ariaLabel oppure ariaLabelledby. In quel caso il contenitore espone role="toolbar" con navigazione da tastiera tramite frecce, Home/End e roving tabindex sui control interni. Senza un nome accessibile la toolbar resta un contenitore neutro (nessun role), per evitare di annunciare una toolbar non etichettata agli screen reader.

Assegna sempre ariaLabel (o ariaLabelledby) quando la toolbar raggruppa control operativi: è il prerequisito per il pattern toolbar accessibile.

TypeScript

import type { ToolbarProps, ToolbarSlots, ToolbarVariant, ToolbarSize, ToolbarRounded } from '@pzeta/vue-components'