Passa al contenuto principale

Widget Index

Il widget Index è un elenco di navigazione guidato dai record: una riga per record, chip opzionali di conteggio e badge, indentazione ad albero opzionale e link a pagine di dettaglio o modifica. Usalo quando l'interfaccia deve sembrare una sidebar o un navigatore di sezioni piuttosto che una tabella dati completa.

Scenari tipici:

  • un albero di cartelle o categorie nella barra sinistra accanto a una pagina di dettaglio;
  • un elenco di ticket aperti con badge di stato e conteggi non letti;
  • un sommario per record gerarchici (padre → figli).

Preferisci una griglia quando gli operatori servono molte colonne, task di massa, UI di ordinamento o export CSV. Preferisci un Index quando ogni riga è soprattutto un'etichetta da cliccare per navigare. Abbinalo alla sidebar della pagina per layout master–detail classici.

Come creare un Index​

  1. Trascina un widget Index su una pagina e scegli l'oggetto da elencare.
  2. Imposta il campo Label — il testo mostrato su ogni riga (obbligatorio).
  3. Opzionalmente imposta i campi Count, Badge e Parent (vedi sotto).
  4. Opzionalmente imposta Link to verso una pagina dettaglio/modifica (o :view / :edit per creare la pagina figlia), e se il link si apre in popup.

Opzioni​

  • Filter / conditions e sort — quali record compaiono e in quale ordine.
  • Label — campo mostrato come testo della riga.
  • Count — numero o testo opzionale mostrato come badge di conteggio a destra.
  • Badge — campo opzionale Text, Choice, Multiple Text o Multiple Choice. I campi multi-valore renderizzano un chip per valore. Per Choice / Multiple Choice, i colori dei chip arrivano dal colore per valore nella definizione del campo.
  • Parent — Reference opzionale allo stesso oggetto. Quando padre e figlio compaiono entrambi nell'elenco, i figli sono indentati sotto il padre.
  • Link to / Open in popup — dove naviga ogni riga.
  • No records — messaggio quando l'elenco è vuoto.
  • Width e visibility — come gli altri widget (la width vale nella colonna principale; in sidebar il widget riempie la barra).

L'elenco carica fino a qualche centinaio di record corrispondenti (poi usa filtri/ordinamento per tenerlo utile).

Regole di visualizzazione​

Le display rule dell'Index offrono un insieme ridotto di azioni:

  • Hide — omette la riga
  • Set color / Set background color — stilizza l'etichetta o la riga
  • Select — segna la riga come selezione corrente (aria-current), tipicamente con un filtro come “ID is the current page record”
suggerimento

Metti l'Index nella sidebar della pagina e collega ogni riga a una pagina di dettaglio figlia per un pattern di navigazione master–detail familiare.