Salt la conținutul principal

Prezentare generală

MetricRow aliniază o etichetă, o pictogramă opțională și o valoare preformatată. Un ProgressRing opțional folosește eticheta vizibilă drept nume accesibil.

Utilizare

Transmiteți o etichetă de text nevidă ca elemente copil obligatorii și valoarea formatată prin value. Adăugați progress atunci când metrica are un procent cunoscut. Aplicația gestionează calculele, unitățile, formatarea numerelor și semnificația metricii. progressColor acceptă o culoare CSS pentru arcul umplut.

Valori fără progres

Omiteți progress pentru a afișa o valoare simplă. Zero numeric este afișat ca 0; conținutul nu este niciodată înlocuit cu un substituent. Furnizați propriul substituent atunci când datele nu sunt disponibile.

Compoziție și accesibilitate

Conținutul etichetei acceptă noduri. Textul său accesibil denumește inelul de progres prin aria-labelledby, inclusiv textul imbricat. Furnizați o etichetă vizibilă semnificativă. O valoare șir nevidă este, de asemenea, expusă ca text al valorii accesibile. Pentru conținutul valorii formatate, furnizați progressValueText atunci când un procentaj nu descrie complet metrica. Acest text înlocuiește valoarea de rezervă a șirului. Fără acesta, alt conținut păstrează textul valorii procentuale a inelului. Un progressValueText gol utilizează, de asemenea, procentajul, inclusiv atunci când value este un șir. Nodul opțional startIcon este decorativ. Apelantul îi controlează dimensiunile și conturul.
Înlocuiți startIcon={IconDatabase} cu startIcon={<IconDatabase size={14} />}. Valorile rămân preformatate de aplicație. Atributele native, className, style și ref vizează rândul exterior. render poate înlocui acel element. Progresul rămâne controlat și limitat între 0 și 100, cu același comportament pentru mișcare redusă ca ProgressRing.

Proprietăți

ReactNode
obligatoriu
Label content whose accessible text also names the optional progress ring.
string
CSS class applied to the row root.
number
Optional controlled progress from 0 to 100. Omitting it displays the value without a ring.
string
CSS color of the filled arc when progress is provided.
string
Accessible value text for the progress ring. Nonempty text overrides the string value fallback; an empty string uses the ring percentage. Supply it when formatted content needs more context than a percentage.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Replaces the row root element while preserving its contents.
ReactNode
Decorative node content before the label. The caller controls icon geometry.
CSSProperties
Inline styles applied to the row root.
ReactNode
obligatoriu
Preformatted value displayed at the end of the row. Nonempty string values also supply the progress ring accessible value text.