Salt la conținutul principal

Prezentare generală

Badge afișează informații compacte în linie, inclusiv etichete scurte și numărători. Folosiți Tag pentru categorii, Chip pentru controale compacte sau Status pentru o stare denumită cu un indicator.

Utilizare

Transmiteți text, numere sau noduri ca elemente copil. Badge afișează conținutul pe care îl furnizați și nu adaugă nicio formatare pentru numărare sau reguli de vizibilitate. Elementul implicit este un span neinteractiv.

Cu o pictogramă

Pictogramele sunt noduri copil obișnuite. Atribuiți pictogramelor decorative aria-hidden și păstrați o etichetă vizibilă pentru a explica conținutul.

Aspect

size acceptă xs, sm sau md. color acceptă tertiary, inherit, primary, secondary sau accent. Stilul accent asociază o umplere accent-tertiary cu text accent11 în ambele teme. Tratamentul solid primary își păstrează umplerea albastră și textul pentru accent. shape acceptă pill sau circle. Valorile implicite sunt sm, tertiary și pill. Varianta circulară are o lățime fixă egală cu înălțimea sa. Utilizați pill pentru conținut mai lung, inclusiv pentru numărători abreviate.

Numărători și vizibilitate

Aplicația dvs. gestionează formatarea numerelor, abrevierile, limitarea, vizibilitatea valorii zero și etichetele traduse. Includeți semnificația completă în numele accesibil al controlului înconjurător atunci când numărătoarea sa compactă este decorativă. Un Badge independent poate utiliza atribute accesibile native, inclusiv aria-label sau aria-labelledby.

Compoziție nativă

Atributele native, gestionarii de evenimente, className, style și ref vizează elementul rădăcină efectiv. render acceptă un element sau un callback prin compoziția Base UI. Alegeți un element gazdă nativ adecvat pentru conținut interactiv:
Componenta Button redată gestionează comportamentul de navigare și semantica linkului. Badge își păstrează valoarea implicită de prezentare și nu deduce interacțiunea din conținutul său.

Proprietăți

Tipurile și valorile implicite sunt generate din tipul public BadgeProps. Sunt acceptate și atributele native și gestionarii de evenimente.
ReactNode
Caller-provided text, numbers, icons, or other inline content.
"accent" | "inherit" | "primary" | "secondary" | "tertiary"
implicit:"tertiary"
Neutral tertiary, inherited text, solid primary accent, soft accent tint, or secondary treatment.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Replaces the default span. Native props, handlers, and the ref target the rendered element.
"circle" | "pill"
implicit:"pill"
Rounded pill label or fixed circle with width equal to its height. Use pill for longer content.
"md" | "sm" | "xs"
implicit:"sm"
Compact height, font size, and spacing: xs, sm, or md.