Typescript

Base Props

Interfacce base riutilizzabili per componenti form e display — BaseFormControlProps, BaseStyledProps, BaseDropdownProps e altre.

BaseInteractiveProps

export interface BaseInteractiveProps {
  disabled?: boolean;
  loading?: boolean;
}

Props base per tutti i componenti interattivi. Tutte le altre interfacce di props form la estendono.

Campo	Tipo	Default	Descrizione
`disabled`	`boolean`	`false`	Disabilita il componente impedendo interazioni
`loading`	`boolean`	`false`	Mostra stato di caricamento

BaseFormControlProps

export interface BaseFormControlProps extends BaseInteractiveProps {
  readonly?: boolean;
  required?: boolean;
  invalid?: boolean;
  name?: string | null;
  autofocus?: boolean;
}

Props base per tutti i form control. Include gestione degli stati comuni di un campo di input.

Campo	Tipo	Default	Descrizione
`disabled`	`boolean`	`false`	Disabilita il componente
`loading`	`boolean`	`false`	Mostra stato di caricamento
`readonly`	`boolean`	`false`	Campo in sola lettura
`required`	`boolean`	`false`	Campo obbligatorio
`invalid`	`boolean`	`false`	Stato di validazione invalido
`name`	`string \| null`	—	Nome del campo per form nativi
`autofocus`	`boolean`	`false`	Focus automatico al mount

BaseStyledProps

export interface BaseStyledProps {
  severity?: Severity;
  size?: Size;
  rounded?: boolean;
  fluid?: boolean;
}

Props per stile visivo base. Usate da componenti con varianti di colore e dimensione (Button, Badge, Tag, ecc.).

Campo	Tipo	Default	Descrizione
`severity`	`Severity`	—	Severità visiva per colorazione
`size`	`Size`	—	Dimensione del componente
`rounded`	`boolean`	`false`	Bordi arrotondati (pill/circle)
`fluid`	`boolean`	`false`	Occupa tutta la larghezza disponibile

BaseStyledWithVariantProps

export interface BaseStyledWithVariantProps extends BaseStyledProps {
  variant?: FormVariant | null;
}

Estende BaseStyledProps con la prop variant per i form control (outlined/filled).

BaseInputAccessibilityProps

export interface BaseInputAccessibilityProps {
  inputId?: string | null;
  inputClass?: string | null;
  inputStyle?: string | Record<string, string | number> | null;
  ariaLabel?: string | null;
  ariaLabelledby?: string | null;
  tabindex?: number | null;
}

Props per accessibilità degli input. Permettono di configurare attributi ARIA e ID per la corretta associazione con label.

Campo	Tipo	Descrizione
`inputId`	`string \| null`	ID dell'elemento input per accessibilità e label
`inputClass`	`string \| null`	Classe CSS aggiuntiva per l'input interno
`inputStyle`	`string \| object \| null`	Stile inline per l'input interno
`ariaLabel`	`string \| null`	Label ARIA per screen reader
`ariaLabelledby`	`string \| null`	ID dell'elemento che funge da label ARIA
`tabindex`	`number \| null`	Ordine di tabulazione per navigazione tastiera

BaseFieldHelperProps

export interface BaseFieldHelperProps {
  label?: string | null;
  helperText?: string | null;
  error?: string | null;
  placeholder?: string | null;
}

Props per il testo di supporto dei form control. Usate da InputText, Select, MultiSelect e tutti i campi con label e messaggi di errore.

Campo	Tipo	Descrizione
`label`	`string \| null`	Label testuale mostrata sopra il campo
`helperText`	`string \| null`	Testo di aiuto mostrato sotto il campo
`error`	`string \| null`	Messaggio di errore mostrato sotto il campo
`placeholder`	`string \| null`	Testo mostrato quando il campo è vuoto

BaseIconProps

export interface BaseIconProps {
  loadingIcon?: string;
  clearIcon?: string;
}

Props per le icone comuni dei form control.

Campo	Tipo	Default	Descrizione
`loadingIcon`	`string`	`'pi pi-spinner pi-spin'`	Classe CSS dell'icona di caricamento
`clearIcon`	`string`	`'pi pi-times'`	Classe CSS dell'icona di cancellazione

BasePrefixSuffixIconProps

export interface BasePrefixSuffixIconProps {
  prefixIcon?: string | null;
  suffixIcon?: string | null;
}

Props per le icone decorative a sinistra e destra del campo di input.

BaseClearableProps

export interface BaseClearableProps {
  showClear?: boolean;
  clearIcon?: string;
}

Props per la funzionalità di cancellazione del contenuto. Aggiunge un pulsante "X" al campo.

BaseLoadableProps

export interface BaseLoadableProps {
  loading?: boolean;
  loadingIcon?: string;
}

Props per componenti che mostrano uno stato di caricamento con icona personalizzabile.

BaseOverlayProps

export interface BaseOverlayProps {
  modelValue?: boolean;
  closable?: boolean;
  closeIcon?: string;
  closeOnEscape?: boolean;
}

Props base per componenti overlay (Dialog, Drawer, Sidebar, Popover).

Campo	Tipo	Default	Descrizione
`modelValue`	`boolean`	`false`	Stato di visibilità (v-model)
`closable`	`boolean`	`true`	Mostra il pulsante di chiusura
`closeIcon`	`string`	`'pi pi-times'`	Classe CSS dell'icona di chiusura
`closeOnEscape`	`boolean`	`true`	Chiude con il tasto Escape

BaseModalOverlayProps

export interface BaseModalOverlayProps extends BaseOverlayProps {
  dismissableMask?: boolean;
  blockScroll?: boolean;
  showHeader?: boolean;
}

Estende BaseOverlayProps con configurazioni specifiche per overlay modali con mask.

Campo	Tipo	Default	Descrizione
`dismissableMask`	`boolean`	`false`	Chiude al click sull'overlay/mask
`blockScroll`	`boolean`	`true`	Blocca lo scroll del body quando aperto
`showHeader`	`boolean`	`true`	Mostra la sezione header

BaseOverlayHeaderProps

export interface BaseOverlayHeaderProps {
  header?: string | null;
  icon?: string | null;
}

Props per l'header degli overlay (titolo e icona).

BaseDropdownProps

export interface BaseDropdownProps extends BaseInteractiveProps {
  appendTo?: 'body' | 'self' | null;
  scrollHeight?: string;
  virtualScrollerOptions?: Record<string, unknown> | null;
  filter?: boolean;
  filterPlaceholder?: string | null;
  showClear?: boolean;
  size?: Size;
  variant?: FormVariant | null;
}

Props base per tutti i componenti dropdown (Select, Autocomplete, MultiSelect, TreeSelect).

Campo	Tipo	Default	Descrizione
`appendTo`	`'body' \| 'self' \| null`	`null`	Elemento a cui appendere il dropdown
`scrollHeight`	`string`	`'200px'`	Altezza massima del dropdown con scroll
`virtualScrollerOptions`	`object \| null`	—	Opzioni per lo scroll virtuale
`filter`	`boolean`	`false`	Abilita il filtro di ricerca nelle opzioni
`filterPlaceholder`	`string \| null`	—	Placeholder del campo filtro
`showClear`	`boolean`	`false`	Mostra pulsante per cancellare la selezione
`size`	`Size`	—	Dimensione del componente
`variant`	`FormVariant \| null`	—	Variante visiva del campo

BaseDropdownBehaviorProps

export interface BaseDropdownBehaviorProps {
  autoOptionFocus?: boolean;
  focusOnHover?: boolean;
  selectOnFocus?: boolean;
  checkmark?: boolean;
  highlightOnSelect?: boolean;
}

Props per il comportamento interattivo del dropdown.

Campo	Tipo	Default	Descrizione
`autoOptionFocus`	`boolean`	`false`	Sposta il focus sulla prima opzione all'apertura
`focusOnHover`	`boolean`	`true`	Sposta il focus sull'opzione al passaggio del mouse
`selectOnFocus`	`boolean`	`false`	Seleziona automaticamente l'opzione al focus
`checkmark`	`boolean`	`false`	Mostra un checkmark accanto all'opzione selezionata
`highlightOnSelect`	`boolean`	`true`	Evidenzia l'opzione selezionata nella lista

BaseDropdownFilterProps

export interface BaseDropdownFilterProps {
  filter?: boolean;
  filterPlaceholder?: string | null;
  filterLocale?: string | null;
  filterFields?: string[] | null;
  resetFilterOnHide?: boolean;
  autoFilterFocus?: boolean;
}

Props per la funzionalità di filtro/ricerca nel dropdown.

Campo	Tipo	Default	Descrizione
`filter`	`boolean`	`false`	Abilita il filtro di ricerca
`filterPlaceholder`	`string \| null`	—	Placeholder del campo filtro
`filterLocale`	`string \| null`	—	Locale per il confronto stringhe nel filtro
`filterFields`	`string[] \| null`	—	Campi da includere nella ricerca
`resetFilterOnHide`	`boolean`	`false`	Resetta il filtro alla chiusura
`autoFilterFocus`	`boolean`	`true`	Sposta il focus sul filtro all'apertura

BaseOptionsConfigProps

export interface BaseOptionsConfigProps<T = Record<string, unknown>> {
  options?: T[] | null;
  optionLabel?: string | ((option: T) => string) | null;
  optionValue?: string | ((option: T) => unknown) | null;
  optionDisabled?: string | ((option: T) => boolean) | null;
  dataKey?: string | null;
}

Props per la configurazione delle opzioni nei componenti di selezione. Generica sul tipo T delle opzioni.

Campo	Tipo	Default	Descrizione
`options`	`T[] \| null`	—	Array di opzioni da visualizzare
`optionLabel`	`string \| Function \| null`	`'label'`	Proprietà o funzione per il testo visualizzato
`optionValue`	`string \| Function \| null`	`'value'`	Proprietà o funzione per il valore dell'opzione
`optionDisabled`	`string \| Function \| null`	`'disabled'`	Proprietà o funzione per opzione disabilitata
`dataKey`	`string \| null`	—	Proprietà usata come chiave univoca

BaseOptionGroupProps

export interface BaseOptionGroupProps<T = Record<string, unknown>> {
  optionGroupLabel?: string | ((option: T) => string) | null;
  optionGroupChildren?: string | ((option: T) => T[]) | null;
}

Props per la gestione di gruppi di opzioni nel dropdown.

Primitive Types

Tipi primitivi di @pzeta/vue-components — Severity, Size, SizeExtended, FormVariant, OptionValue.

Base Emits

Interfacce emit comuni condivise tra componenti simili — BaseFocusEmits, BaseKeyboardEmits, BaseOverlayEmits e altre.