نظرة عامة
اعرض شخصية مساعد باستخدام شكل الجسم والوجه ولون لوحة الألوان والحجم. يعرض المكوّن القيم المقدّمة؛ ويتولى تطبيقك الاختيار والحفظ.استخدام
الخيارات المرئية
اختر الأشكال بشكل مستقل عن التعابير والألوان.
يستخدم الجسم والوجه رموز النسق الخاصة بلوحة الألوان المحددة ويتبعان النسق الفاتح أو الداكن المحيط. عيّن
size لشخصية مربعة. تستهدف السمات والأحداث الأصلية وclassName وstyle وref عنصر span الخارجي؛ وتتجاوز الأنماط الصريحة أبعاده وإعدادات لوحة الألوان الافتراضية.
إمكانية الوصول
تكون الشخصية زخرفية عندما لا يكون لها اسم متاح، كما في مثال الاستخدام المسمى. بالنسبة إلى شخصية مستقلة، وفّرaria-label أو aria-labelledby؛ وعندها يكشف الجذر عن دور الصورة. يبقى الجسم والوجه مخفيين عن التقنية المساعدة كي يُعلن عن الشخصية مرة واحدة.
عيّن aria-hidden صراحةً عندما تحتاج إلى تجاوز الإعداد الافتراضي المستند إلى الاسم، مثل إخفاء شخصية مسماة بجانب نص مرئي مكافئ.
ضع الشخصية داخل زر أو رابط مسمى عندما ترافق إجراءً ما. يتولى التطبيق عنصر التحكم وتسميته وسلوكه.
الإزاحة
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"
افتراضي:"blue"
Theme palette used for the body and face. Follows the surrounding light or dark theme.
"default" | "happy" | "love" | "sleepy" | "surprised" | "wink"
افتراضي:"default"
Expression displayed over the body.
boolean
افتراضي:"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"
افتراضي:"circle"
Body shape of the assistant character.
14 | 16 | 20 | 24 | 40
افتراضي:"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.