Elenchi: specifiche
Le liste sono elenchi verticali continui di testo e immagini.
Varianti
Elenchi espressive
Usa la variante espressiva degli elenchi per ottenere uno stile più flessibile, stati di selezione più evidenti e slot personalizzabili.

Elenchi baseline
Gli elenchi baseline sono ancora disponibili, ma non dispongono dello stile visivo, del trattamento della selezione e della funzionalità degli slot più recenti.
Sul web, gli elenchi espressive si basano sugli elenchi baseline.
Consulta le specifiche degli elenchi baseline

| Varianti | M3 | M3 Expressive |
|---|---|---|
| Elenchi (espressive) | -- | Disponibile |
| Elenchi (baseline) | Disponibile | Non consigliate. Usa invece gli elenchi espressive. |
Configurazioni
Stili
Gli stili standard e segmentati sono una scelta visiva e non influiscono sul comportamento dell'elenco.

- Standard
- Segmentato
Selezione degli elenchi
Un elenco può adottare una sola modalità di selezione alla volta. Ad esempio, un elenco ad azione singola può essere trasformata in un elenco a selezione multipla, ma non può usare entrambe le modalità contemporaneamente.




Interazioni degli elenchi
Gli elenchi possono:
Scopri di più sull’accessibilità delle interazioni degli elenchi

| Categoria | Configurazione | M3 | M3 Expressive |
|---|---|---|---|
| Stili | Standard | Disponibile | Disponibile |
| Segmentato | -- | Disponibile | |
| Modalità di selezione | Azione singola, azione multipla, selezione singola, selezione multipla | Disponibile | Disponibile |
| Interazioni | Espansione, swipe\* | Disponibile | Disponibile |
* Le interazioni di scorrimento laterale per rivelare (swipe-to-reveal) sono disponibili solo su Android Views
Token e specifiche
Usa il menu della tabella per selezionare un set di token. Il set common combina i token baseline con le nuove forme e dimensioni espressive. Il set expand contiene i token per l’interazione di espansione. Scopri di più sul token di design
Elenco - Common
Elenco - Expand
Anatomia

Il contenitore e il testo dell’etichetta sono obbligatori; tutti gli altri elementi sono facoltativi:
- Contenitore
- Sovratitolo (overline)
- Testo dell’etichetta
- Testo finale
- Testo di supporto
- Icona finale
- Divisore
- Avatar iniziale
- Icona iniziale
- Contenuto multimediale iniziale - immagine o video
Flessibilità e slot
Il M3 Design Kit include elenchi con slot personalizzati per progettare layout flessibili degli elementi di elenchi. Considera un elenchi personalizzata come un contenitore con tre slot distinti: iniziale, di contenuto e finale. Ogni slot può contenere un elemento diverso.
Accessibilità degli slot
Gli slot non sono accessibili per impostazione predefinita. Considera quanto segue:
- Gli elementi devono seguire le regole, la struttura e i modelli di interazione degli elenchi
- Usa il padding standard degli elementi di elenco
- L’area di tocco (target) deve essere di almeno 48x48dp
- Non aggiungere elementi interattivi all’interno della voce dell’elenco che ne rendano difficile la navigazione, soprattutto per le persone che usano lettori di schermo

- Slot iniziale
- Slot di contenuto
- Slot finale
WARNING
Gli slot richiedono un’implementazione personalizzata del codice, che deve essere creata e mantenuta
Gli slot iniziale e finale devono essere più stretti della sezione contenuto.
1. Gli slot iniziali possono contenere:
- Elementi visivi: avatar, icona, immagine o miniatura video
- Controlli di selezione: casella di controllo (checkbox), pulsante di opzione (pulsante di opzione) o interruttore (interruttore)
- Elementi personalizzati: badge o immagine di dimensioni maggiori
2. Gli slot di contenuto devono essere gli slot più larghi e possono contenere:
- Contenuto predefinito: testo dell’etichetta, testo di supporto
- Componenti aggiuntivi opzionali: badge, icona, etichetta in linea o altri elementi di testo
- Evita righe di testo lunghe per mantenere la leggibilità
3. Gli slot finali possono contenere:
- Elementi di azione o testo: icona, pulsante con icona o testo finale
- Controlli di selezione: casella di controllo (checkbox), pulsante di opzione (pulsante di opzione) o interruttore (interruttore)

Elenchi di selezione
Per gli elenchi di selezione, usa una sola interazione di selezione per ogni elemento degli elenchi.


Colore
I valori di colore sono implementati tramite token di design. Per i designer, questo significa lavorare con valori di colore corrispondenti ai token; nell’implementazione, ogni valore di colore è un token che fa riferimento a un valore. Scopri di più sul token di design

Ruoli colore degli elenchi usati per temi chiari e scuri:
- Superficie
- Variante su superficie
- Su superficie
- Variante su superficie
- Variante su superficie
- Variante su superficie
- Variante di contorno
- Contenitore primario
- Su contenitore primario
- Variante su superficie
Stati
Gli stati sono rappresentazioni visive usate per comunicare lo stato di un componente o di un elemento interattivo. Scopri di più sugli stati di interazione
Scopri di più sullo stato di focus degli elenchi
Elementi di elenco predefiniti

- Abilitato
- Disabilitato
- Hover
- Focus
- Premuto
- Trascinato
Elementi di elenco selezionati

- Abilitato
- Disabilitato
- Hover
- Focus
- Premuto
- Trascinato
Misure

Trasformazione delle forme
Quando un elemento di elenco è selezionato, la forma degli angoli cambia per evidenziare l’elemento attivo:
- Raggio degli angoli dell’elemento non selezionato: 4dp interno, 16dp esterno
- Raggio degli angoli dell’elemento selezionato: 16dp


Elenco (baseline)
La variante baseline dell'elenco è disponibile e continua a funzionare nei prodotti esistenti. Tuttavia, per i nuovi design è consigliata la elenco espressiva.
Token e specifiche
I token dell'elenco baseline sono nel set di token common.
TIP
Questo set include anche diversi token espressivi.
Colore
I valori di colore sono implementati tramite token di design. Per i designer, questo significa lavorare con valori di colore corrispondenti ai token; nell’implementazione, ogni valore di colore è un token che fa riferimento a un valore. Scopri di più sul token di design

Ruoli colore degli elenchi usati per temi chiari e scuri:
- Superficie
- Su superficie
- Variante su superficie
- Variante su superficie
- Variante su superficie
- Variante di contorno
- Contenitore primario
- Su contenitore primario
- Variante su superficie
Stati
Gli stati sono rappresentazioni visive usate per comunicare lo stato di un componente o di un elemento interattivo.

- Abilitato
- Disabilitato
- Hover
- Focus
- Premuto
- Trascinato
Layout
Elenchi a una riga


Elenchi a due righe


Elenchi a tre righe


| Attributo | Valore |
|---|---|
| Allineamento dell’etichetta | Al centro |
| Allineamento dell’etichetta quando l’altezza è pari o superiore a 88dp | In alto |
| Padding a sinistra dell’etichetta | 16dp |
| Allineamento verticale dell’elemento iniziale | Al centro |
| Allineamento verticale dell’elemento iniziale quando l’altezza è pari o superiore a 88dp | In alto |
| Padding a sinistra dell’elemento iniziale | 16dp |
| Allineamento verticale dell’icona iniziale | In alto |
| Padding in alto dell’icona iniziale | 8dp |
| Padding in alto dell’icona iniziale quando l’altezza è pari o superiore a 88dp | 12dp |
| Allineamento verticale dell’elemento finale | Al centro |
| Allineamento verticale dell’elemento finale quando l’altezza è pari o superiore a 88dp | In alto |
| Padding a sinistra dell’elemento finale | 16dp |
| Padding a destra dell’elemento finale | 24dp |
| Padding superiore e inferiore del divisore | 0dp |
| Aree di tocco (target) | 48dp |
| Divisore a larghezza completa | 100% |
| Padding a sinistra del divisore con rientro | 16dp |
| Padding a destra del divisore con rientro | 24dp |
Configurazioni
Avatar iniziale

- Con avatar iniziale
- Con avatar iniziale e checkbox finale
Immagine o miniatura iniziale

- Con immagine iniziale
- Con immagine iniziale e checkbox finale
Video iniziale

- Con video iniziale
- Con video iniziale e checkbox finale
Icona iniziale

- Con icona iniziale
- Con icona iniziale e checkbox finale
Solo testo

- Con solo testo
- Con testo e checkbox finale
Checkbox iniziale

- Con checkbox iniziale
- Con checkbox iniziale e testo finale
Pulsante di opzione iniziale

- Con pulsante di opzione iniziale
- Con pulsante di opzione iniziale e testo finale
Interruttore finale

- Con interruttore finale
- Con icona iniziale e interruttore finale