نظرة عامة
استخدمTag للفئات أو الأولويات أو السمات القصيرة الأخرى. احتفظ بتسمية نصية حتى لا يعتمد المعنى على اللون. استخدم الحالة عندما تحتاج إلى مؤشر حالة وملاحظات التحميل.
استخدام
color مطلوب ويقبل لون نسق أو transparent. العنصر الافتراضي يكون دائمًا span، بما في ذلك عند توفير معالج نقر أصلي. أضف أيقونة زخرفية باستخدام startIcon؛ يوفر الملصق معناه المتاح.
الأشكال
soft هو نمط العرض الافتراضي. يبرز solid الملصق، ويضيف outline حدودًا، ويزيل ghost الخلفية. استخدم borderStyle="dashed" مع outline وweight="medium" للحصول على ملصق أقوى.
ألوان
أبقِ التسمية ذات معنى من دون الاعتماد على لونها. يقارن الكتالوج المعالجة الناعمة الافتراضية؛ وتتوفر لوحة الألوان نفسها للأشكال الأخرى.تصفية حسب علامة
render. ضع معالج النقر والسمات الأصلية والمرجع وحالة التعطيل على ذلك المالك. يوفر الزر الحقيقي التركيز والتنشيط بمفتاحَي Enter وSpace. تنتمي حالة التحديد إلى تطبيقك؛ استخدم aria-pressed للتبديل ونمط عرض مرئي للحالة المحددة. للتنقل، اعرض رابطًا مع وجهته، مثل <a href="/records" />. يحتفظ المالكون الأصليون بمظهر Tag.
تسميات طويلة
افتراضيًا، يقومtruncate={true} باقتطاع تسميات السلاسل النصية المقيّدة ويعرض نصها الكامل في تلميح عند التمرير. اضبط truncate={false} للاحتفاظ بالتسمية كاملةً بعرضها الطبيعي من دون تلميح أداة، حتى عندما يكون عنصرها الأصل أضيق. يتولى تخطيط العنصر الأصل الالتفاف والتمرير والاقتصاص.
الإزاحة
تُنشأ الأنواع والقيم الافتراضية من الأنواع العامة للمكوّن. تُقبل أيضًا السمات الأصلية ومعالجات الأحداث."dashed" | "solid"
افتراضي:"solid"
Border style used by the outline variant.
"amber" | "blue" | "bronze" | "brown" | "crimson" | "cyan" | "gold" | "grass" | "gray" | "green" | "iris" | "jade" | "lime" | "mint" | "orange" | "pink" | "plum" | "purple" | "red" | "ruby" | "sky" | "tomato" | "transparent" | "turquoise" | "violet" | "yellow"
مطلوب
Theme color for the tag, or
transparent for an unfilled label.MouseEventHandler<HTMLSpanElement>
Native click handler. Does not change the default span or add keyboard activation.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, TagState>
Replaces the default span. Compose a button or link to provide explicit interaction semantics.
ReactNode
Decorative icon before the label. Hidden from assistive technology.
boolean
افتراضي:"true"
Truncates constrained string labels and exposes the full text in a tooltip. Set to
false to keep the full label at its natural width without a tooltip, even inside a narrower parent."ghost" | "outline" | "soft" | "solid"
افتراضي:"soft"
Visual treatment of the tag background and border.
"medium" | "regular"
افتراضي:"regular"
Font weight of the label.