Vai al contenuto principale

Panoramica

DetailsRow associa un’etichetta a un valore in un elenco di descrizioni. Aggiungi un’icona decorativa, più elementi di valore o un’azione fornita dalla tua applicazione.

Utilizzo

Inserisci ogni riga direttamente all’interno di un dl. Passa l’etichetta tramite label e il relativo valore tramite children. L’applicazione gestisce le etichette, la localizzazione, i valori formattati e i segnaposto per i valori mancanti.

Allineamento e disposizione su più righe

Le etichette e i valori vanno a capo anziché essere troncati. Più elementi di valore, come chip o tag, vanno a capo su righe aggiuntive. Le righe allineano il proprio contenuto in alto man mano che questo cresce. Per impostazione predefinita, la colonna dell’etichetta è 7rem ed è limitata al 40% della larghezza della riga per lasciare spazio al valore in contenitori stretti. Imposta lo stesso labelWidth nelle righe dello stesso livello per regolarne l’allineamento. I numeri usano i pixel; sono supportate anche lunghezze CSS come '8rem'.

Azioni

Usa action per un controllo accanto al valore. La riga non aggiunge comportamenti di modifica, clic o tastiera. Fornisci un controllo con un nome accessibile e collega il relativo gestore al comportamento dell’applicazione.

Composizione e accessibilità

Ogni riga esegue il rendering di un raggruppamento div con un’etichetta dt e un dd contenente il valore e l’azione facoltativa. Il chiamante fornisce il dl contenitore. Fornisci testo significativo nell’etichetta. Il startIcon facoltativo è nascosto alle tecnologie assistive e il chiamante ne controlla le dimensioni. Gli attributi nativi, className, style e ref si applicano al div esterno. Quando usi render con un wrapper personalizzato, mantieni tale div direttamente all’interno del dl e inoltra tutte le props fornite e il ref. Mantieni le azioni nel relativo slot affinché il termine e la definizione rimangano i figli diretti della riga. Usa MetricRow per una metrica con avanzamento facoltativo. DetailsRow fornisce solo il layout di etichetta, valore e azione.

Props

ReactNode
Optional action content beside the value. The caller supplies controls, accessible names, and handlers.
ReactNode
obbligatorio
Value content rendered in the description definition. Text and multiple items wrap within the available space.
string
CSS class applied to the row root.
ReactNode
obbligatorio
Visible label rendered as the description term.
Width<string | number>
predefinito:"7rem"
Preferred label column width. Numbers use pixels. The column is capped at 40% of the row width; use the same width for aligned sibling rows.
Ref<HTMLDivElement>
Ref forwarded to the row root div.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Customizes the row root. Preserve a div directly inside a dl and forward its props and ref to retain valid description-list grouping.
ReactNode
Decorative node before the label. The caller controls icon dimensions.
CSSProperties
Inline styles applied to the row root.