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

نظرة عامة

استخدم ListItemButton لصفوف الإجراءات وأزرار الاختيار المستقلة. يجمع بين تخطيط ListItem وزر أصلي، بما في ذلك التفعيل بمفتاحي Enter وSpace، والتركيز، وسلوك التعطيل. يكون افتراضيًا type="button".

استخدام

الإجراءات وحالة التعطيل

مرر onClick وdisabled مباشرةً. تستخدم الأزرار المعطلة مظهر الصف المطابق، وتمنع التفعيل، وتبقى في ترتيب التنقل بعلامة التبويب.
اضبط focusableWhenDisabled لإبقاء زر معطل قابلاً للتركيز. يستخدم aria-disabled ويستمر في حظر التفعيل. تصل سمات الزر الأصلي وأحداثه وأنماطه وأسماء فئاته ومرجع HTMLButtonElement إلى الزر. تنتشر الأحداث بصورة طبيعية؛ ويوفر المستدعون أي سياسة لـ stopPropagation() أو preventDefault().

الاختيار والمواضع المرئية

يتحكم تطبيقك في الحالات المستقلة active وselected وfocused. استخدم active للصف المفتوح أو الحالي. اقرن selected بالحالة المناسبة لإمكانية الوصول، مثل aria-pressed لزر التبديل. يبرز focused الصف دون نقل تركيز DOM. المؤشرات وتلميحات الاختصارات للزينة؛ يسجل تطبيقك الاختصارات ويتعامل مع التنقل.
استخدم startIcon وendIcon وdescription وdescriptionPlacement للمحتوى الداعم. يحدد color="danger" إجراءً إتلافيًا. يتحكم shortcutJoinLabel في النص بين الاختصارات المتتالية، ويعرض hasSubmenu مؤشر قائمة فرعية.

محتوى داعم متعدد الأسطر

عيّن descriptionPlacement="below" للالتفاف بالنص الداعم أسفل التسمية. تحتفظ التسمية بسلوك اقتطاعها. مرر Text مع truncate أو lineClamp باعتباره description عندما تحتاج إلى معاينة أقصر. يحتفظ الموضعان inline وend بمظهرهما الحالي.
يطبّق active خلفية الصف الحالي. عيّن selectionAppearance="accent" لتعبئة مميزة في الصفوف المحددة مع أي موضع للوصف؛ ويحافظ الإعداد الافتراضي على تنسيق التحديد الحالي المستند إلى المؤشر. يطبّق focused الخلفية المميزة المشتركة؛ ويتبع مخطط التركيز المرئي التركيز الفعلي للوحة المفاتيح. لا تضيف هذه الخصائص حالة قابلة للوصول ولا تنقل التركيز. يبقى سلوك التنشيط والتعطيل الأصلي للزر دون تغيير.

عناصر تحكم مستقلة

أبقِ الأزرار المستقلة ومربعات الاختيار بجانب ListItemButton لكي يحتفظ كل منها بتركيزه وتنشيطه الخاصين. لا تضمّنها داخل فتحات المحتوى أو الأيقونة الخاصة به. لا يحتوي المكون على موضع actions. استخدم ListItem مع جذر div الافتراضي الخاص به لـصف يحتوي على عناصر تحكم مستقلة، ووفّر سلوك التعطيل وانتشار الأحداث لكل عنصر تحكم.
استخدم ListItem للمحتوى السلبي أو الروابط أو المالكين الدلاليين المخصصين. استخدم أجزاء العناصر الموجودة في Dropdown وSelect ضمن مالكي النوافذ المنبثقة الخاصة بها، التي توفر الأدوار والتنقل باستخدام لوحة المفاتيح.

الإزاحة

boolean
Marks the open or current item independently of selection and focus. The caller supplies accessible state.
"danger" | "neutral"
Color of the text and icons. danger marks a destructive action.
ReactNode
Supporting text, placed according to descriptionPlacement.
"below" | "end" | "inline"
Places supporting content inline after the label, at the end, or below it with wrapping. Inline is the default.
boolean
افتراضي:"false"
Disables activation and applies the matching row appearance.
ReactNode
Icon rendered after the content.
boolean
افتراضي:"false"
Keeps a disabled button focusable with aria-disabled while preventing activation.
boolean
Highlights the row without moving DOM focus.
boolean
Displays a decorative submenu indicator.
"check" | "checkbox" | "none"
Selection indicator: a check icon after the content or a checkbox before it.
Ref<HTMLButtonElement>
Ref to the native HTMLButtonElement.
boolean
Applies selected styling and a decorative indicator. The caller supplies selection state and accessible semantics.
"accent" | "default"
Selection styling independent of description placement. default preserves indicator-based styling; accent fills selected rows with the accent background.
ShortcutDefinition
Displays decorative shortcut hints. The caller registers the shortcuts.
string
Text between sequential shortcut steps. Defaults to then; pass an empty string to omit it.
ReactNode
Icon rendered before the content.