Prezentare generală
Redă un personaj de asistent dintr-o formă de corp, față, culoare din paletă și dimensiune. Componenta afișează valorile furnizate; aplicația ta gestionează selecția și persistența.Utilizare
Opțiuni vizuale
Alege formele independent de expresii și culori.
Corpul și fața folosesc tokenurile de temă ale paletei selectate și urmează tema luminoasă sau întunecată din jur. Setează
size pentru un personaj pătrat. Atributele native, evenimentele, className, style și ref vizează elementul span exterior; stilurile explicite îi suprascriu dimensiunile și valorile implicite ale paletei.
Accesibilitate
Personajul este decorativ atunci când nu are un nume accesibil, ca în exemplul de utilizare etichetat. Pentru un personaj independent, furnizeazăaria-label sau aria-labelledby; elementul rădăcină expune apoi rolul de imagine. Corpul și fața rămân ascunse pentru tehnologiile de asistență, astfel încât personajul să fie anunțat o singură dată.
Setează explicit aria-hidden atunci când trebuie să suprascrii valoarea implicită bazată pe nume, cum ar fi ascunderea unui personaj cu nume lângă un text vizibil echivalent.
Plasează personajul într-un buton sau link cu nume atunci când însoțește o acțiune. Aplicația gestionează controlul, eticheta și comportamentul acestuia.
Proprietăți
Explicitly hides or exposes the character. Takes precedence over the name-based default.
string
Accessible name for a standalone character. Adds the image role; omit it beside a visible name.
string
ID of an element naming a standalone character. Adds the image role.
string
CSS class applied to the span root.
"blue" | "gray" | "green" | "orange" | "pink" | "purple" | "red" | "sky" | "turquoise" | "yellow"
implicit:"blue"
Theme palette used for the body and face. Follows the surrounding light or dark theme.
"default" | "happy" | "love" | "sleepy" | "surprised" | "wink"
implicit:"default"
Expression displayed over the body.
boolean
implicit:"false"
Plays the selected expression’s idle loop. Displays the static expression when the browser prefers reduced motion.
"arch" | "burst" | "circle" | "cloud" | "clover" | "cookie" | "flower" | "gem" | "hexagon" | "pill"
implicit:"circle"
Body shape of the assistant character.
14 | 16 | 20 | 24 | 40
implicit:"24"
Width and height in pixels: 14, 16, 20, 24, or 40.
CSSProperties
Inline styles applied to the root. Explicit styles override its dimensions and palette defaults.