الانتقال إلى المحتوى الرئيسي

نظرة عامة

استخدم Chip للإشارات المضغوطة إلى الأشخاص أو السجلات أو الملفات. استخدم علامة للفئات الملوّنة وحالة لحالات سير العمل.

استخدام

تقبل العناصر التابعة نصًا أو عُقدًا. يقبل startElement وendElement صورًا رمزية أو أيقونات أو محتوى آخر. يضيف endElementDivider فاصلاً قبل المحتوى اللاحق. الشريحة الافتراضية هي div؛ ويمكن أن تحتوي فتحاتها على إجراء منفصل بينما تظل الشريحة نفسها للعرض فقط. لا تُدرج Chip تسمية أبدًا. وفّر نصًا احتياطيًا مترجمًا من تطبيقك عند الحاجة. احذف العناصر الفرعية للمحتوى المُنشأ بالكامل من الفتحات. تحتاج الشريحة التفاعلية التي تحتوي على أيقونة فقط إلى اسم متاح يوفّره المستدعي.

المظهر

يقبل size القيمتين sm أو md، بارتفاعين إجماليين قدرهما 20px و24px. يقبل variant القيم ghost أو soft أو solid أو plain أو outline؛ والقيمة ghost هي الافتراضية. لا تحتوي شرائح plain على تعبئة في حالة السكون أو حشو بادئ. تحتوي شرائح outline على حد قوي بسماكة 1px، وتعبئة أخف في حالة السكون، وحشوة داخلية بمقدار 8px على كل جانب، مع الارتفاع الإجمالي نفسه للمتغيرات الأخرى. تستخدم شرائح plain وoutline القابلة للنقر خلفيات ghost عند التمرير والضغط، ومؤشرًا على شكل يد، وحلقة تركيز. استخدم shape="round" لشكل كبسولة، وweight="medium" للتأكيد، وcolor="secondary" للنص الثانوي.

الأزرار والروابط

يؤدي توفير onClick إلى الإبقاء على div الافتراضي. استخدم render لتكوين زر أصلي صريح، أو رابط ارتساء، أو رابط موجّه، أو عنصر مناسب آخر. تصل السمات الأصلية والمعالجات والأنماط ومرجع الجذر إلى ذلك العنصر. يوفر الزر الأصلي التفعيل بلوحة المفاتيح وسلوك التعطيل. تتعرف Chip على حالة التعطيل الأصلية وaria-disabled للمظهر؛ ولا يمنع aria-disabled وحده التفعيل. يتحكم clickable في مظهر التمرير والمؤشر، ويكون افتراضيًا بحسب ما إذا كان onClick مُوفّرًا. عيّنه صراحةً لرابط من دون معالج نقر. لا تُضمّن أزرارًا أو روابط داخل شريحة تفاعلية بحد ذاتها.
يبقى نص عنوان URL نصًا عاديًا. تنتمي الروابط المقصودة إلى محتوى المستدعي أو إلى تكوين الجذر الصريح.

الاقتطاع وتلميحات الأدوات

maxWidth يقيّد عرض الشريحة المعروضة بالبكسل، بما في ذلك الحشو وأي حد للمخطط الخارجي. ينطبق الحد نفسه على الشرائح العادية ذات الحشوة غير المتماثلة. يُقتطع المحتوى بعلامة حذف افتراضيًا؛ ويترك truncate={false} المحتوى دون قيود بسبب الاقتطاع. توفر العناصر الفرعية النصية نص تلميح الأداة الخاص بها. عيّن tooltipContent للنص المخصص أو محتوى العقدة، وtooltipDelay لتأخير الفتح، وisTooltipMultiline للحفاظ على فواصل الأسطر. يُفعّل alwaysShowTooltip أيضًا تلميح الأداة عندما يكون المحتوى ملائمًا. تتبع هذه الخيارات OverflowingTextWithTooltip. أبقِ المعلومات الأساسية متاحة دون الاعتماد على التمرير.

الترحيل

استبدل emptyLabel بعناصر فرعية احتياطية يوفرها المستدعي، واستبدل forceEmptyText أو isLabelHidden بعناصر فرعية محذوفة. احتفظ بالنصوص الاحتياطية المترجمة للمنتج في التطبيق. استبدل tooltipLabel بـ tooltipContent. انقل disabled إلى العنصر التفاعلي الصريح وأزل nativeButton. أضف زرًا أصليًا أو رابطًا عبر render حيثما كانت الشريحة تعتمد سابقًا على onClick لاختيار عنصرها. استبدل تجاوزات الحشوة البادئة بـ variant="plain". أبقِ clickable مفعّلًا للروابط والأزرار الأصلية التي تحتاج إلى تغذية راجعة عند التمرير والضغط.

الخصائص

تُنشأ الأنواع والقيم الافتراضية من أنواع المكونات العامة. تُقبل أيضًا السمات الأصلية ومعالجات الأحداث.
boolean
افتراضي:"false"
Shows the content tooltip even when the content is not truncated.
ReactNode
Caller-owned content. Missing or empty children add no fallback label.
boolean
افتراضي:"isDefined(onClick)"
Enables hover and pointer styling. Defaults to whether onClick is supplied; does not change the default div or add keyboard behavior.
"primary" | "secondary"
افتراضي:"primary"
Primary or secondary text color.
ReactNode
Content after the label. Avoid interactive content when the chip itself is a button or link.
boolean
افتراضي:"false"
Adds a divider before endElement when that slot has content.
boolean
Preserves line breaks in the tooltip text.
number
Maximum rendered chip width in pixels, including its leading and trailing padding and any outline border.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Replaces the default div. Compose a native button or link explicitly; that owner supplies disabled and native interaction behavior.
"round" | "square"
افتراضي:"square"
Square or round corners.
"md" | "sm"
افتراضي:"sm"
Visual size of the chip.
ReactNode
Content before the label, such as an avatar or icon.
string
Tooltip text. Defaults to string children. Supply text explicitly for node content.
number
Delay in milliseconds before the tooltip opens.
"bottom" | "inline-end" | "inline-start" | "left" | "right" | "top"
Position of the content tooltip.
boolean
افتراضي:"true"
Truncates overflowing content with an ellipsis. Defaults to true.
"ghost" | "outline" | "plain" | "soft" | "solid"
افتراضي:"ghost"
Background and border treatment. Outline has a strong border, lighter resting fill and 8px inline padding. Plain has no resting fill or leading padding. Both use ghost hover and pressed feedback when clickable.
"medium" | "regular"
افتراضي:"regular"
Font weight of the content.