Salt la conținutul principal

Prezentare generală

DetailsRow asociază o etichetă cu o valoare într-o listă de descrieri. Adăugați o pictogramă decorativă, mai multe elemente de valoare sau o acțiune furnizată de aplicația dvs.

Utilizare

Plasați fiecare rând direct într-un dl. Transmiteți eticheta prin label și valoarea acesteia prin children. Aplicația gestionează etichetele, localizarea, valorile formatate și substituenții pentru valorile lipsă.

Aliniere și încadrare pe mai multe rânduri

Etichetele și valorile se încadrează pe mai multe rânduri în loc să fie trunchiate. Mai multe elemente de valoare, precum cipurile sau etichetele, se încadrează pe rânduri suplimentare. Rândurile își aliniază conținutul în partea de sus pe măsură ce acesta crește. Coloana etichetei are implicit 7rem și este limitată la 40% din lățimea rândului pentru a lăsa spațiu valorii în containere înguste. Setați aceeași valoare labelWidth pentru rândurile surori pentru a le ajusta alinierea. Numerele utilizează pixeli; sunt acceptate și lungimi CSS precum '8rem'.

Acțiuni

Utilizați action pentru un control lângă valoare. Rândul nu adaugă comportament de editare, clic sau tastatură. Furnizați un control cu un nume accesibil și conectați gestionarul acestuia la comportamentul aplicației.

Compoziție și accesibilitate

Fiecare rând redă o grupare div cu o etichetă dt și un dd care conține valoarea și acțiunea opțională. Apelantul furnizează elementul dl care le încadrează. Furnizați text cu semnificație în etichetă. Elementul opțional startIcon este ascuns pentru tehnologia de asistență, iar apelantul îi controlează dimensiunile. Atributele native, className, style și ref vizează elementul extern div. Când utilizați render cu un înveliș personalizat, păstrați acel div direct în dl și transmiteți mai departe toate proprietățile furnizate și referința. Păstrați acțiunile în slotul lor, astfel încât termenul și definiția să rămână copiii direcți ai rândului. Utilizați MetricRow pentru o metrică cu progres opțional. DetailsRow furnizează doar structura etichetei, a valorii și a acțiunii.

Proprietăți

ReactNode
Optional action content beside the value. The caller supplies controls, accessible names, and handlers.
ReactNode
obligatoriu
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
obligatoriu
Visible label rendered as the description term.
Width<string | number>
implicit:"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.