Composables
Composables
Composables pubblici e interni della libreria @pzeta/vue-components.
Composables
La libreria @pzeta/vue-components espone due categorie di composables:
- Pubblici (sezioni
services/econfig/): importabili direttamente nelle applicazioni Vue 3. - Interni (sezioni
common/,forms/,table/): utilizzati dai componenti della libreria; non destinati all'uso diretto nelle applicazioni.
Servizi (services/)
Composables per interagire con i servizi globali della libreria tramite pattern inject/provide.
| Composable | Descrizione |
|---|---|
useToast | Mostra notifiche toast (info, success, warn, error) |
useConfirm | Dialog di conferma modale |
useConfirmPopup | Popup di conferma ancorato a un elemento |
useThemeColors | Cambia colore primario e varianti via CSS custom properties |
Configurazione (config/)
Composables per leggere e modificare la configurazione globale del plugin.
| Composable | Descrizione |
|---|---|
useConfig | Cambia icon set e lingua a runtime |
useIcons | Legge le icone configurate per i componenti |
useComponentI18n | Accede alle traduzioni interne dei componenti |
useUniqueId | Genera ID univoci per attributi id e aria-* |
Comuni (common/)
Composables interni riutilizzati da piu componenti della libreria.
| Composable | Descrizione |
|---|---|
useClassBuilder | Builder per array di classi CSS con overrides |
useSeverityIcon | Risolve icona e classe per severity (info/success/warn/error) |
useLifeTimer | Timer con pausa/ripresa per auto-dismiss |
useCloseableContent | Visibilita con supporto controlled/uncontrolled e a11y |
useDropdownLifecycle | Apri/chiudi dropdown con click-outside e cleanup |
useDropdownPosition | Posizionamento fixed con flip automatico e scroll tracking |
usePopoverPosition | 12 placement per popover con auto-flip e freccia |
useListNavigation | Navigazione tastiera in liste con skip-disabled e wrap |
useSelectionManager | Selezione singola/multipla con confronto per dataKey |
useReorderList | Riordinamento lista con moveUp/moveDown e canMove computed |
Form (forms/)
Composables interni per i componenti form della libreria.
| Composable | Descrizione |
|---|---|
useFormFieldClasses | Genera classi CSS per campi form con stati e varianti |
useFormFieldEvents | Handler normalizzati per input/change/clear con emit tipizzato |
useFormFieldMethods | Metodi imperativi su input: focus, blur, select, scroll |
useSelectOptions | Normalizza opzioni flat e grouped per Select/MultiSelect |
useAutoCompleteSearch | Debounce e min-length per ricerca autocomplete |
useDropdownField | Aggregatore per dropdown: lifecycle, position, navigation |
useTreeExpansion | Stato espansione nodi TreeSelect/TreeTable |
useTreeSelection | Selezione nodi albero con propagazione cascade checkbox |
useClockDrag | Drag/click SVG per selezione ora nel TimePicker |
useClockPositions | Calcolo trigonometrico posizioni ore e minuti su quadrante |
useClockTime | Parsing, formattazione e validazione orario HH:mm |
useTypeAhead | Ricerca type-ahead con buffer e timeout per dropdown |
Tabella (table/)
Composables interni per DataTable e TreeTable.
| Composable | Descrizione |
|---|---|
useTableCore | Funzionalita core: nested value, row key, CSS classi |
useTableColumns | Estrae definizioni colonne dagli slot Column |
useTableSort | Ordinamento singolo e multi-colonna con dataType |
useTablePagination | Paginazione client-side con navigazione e rows-per-page |
useTableSelection | Selezione righe singola, multipla e checkbox |
useTableFilter | Filtri per-colonna e filtro globale con multi-constraint |
useTableGrouping | Raggruppamento subheader/rowspan con espansione gruppi |
useTableEditing | Editing inline celle e righe con tracking modifiche |
useTableExpansion | Espansione righe con slot di dettaglio |
useTableStatePersistence | Persistenza stato in sessionStorage/localStorage |