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

نظرة عامة

يقترن DetailsRow بتسمية وقيمة في قائمة وصف. أضف أيقونة زخرفية، أو عناصر قيم متعددة، أو إجراءً يوفره تطبيقك.

استخدام

ضع كل صف مباشرةً داخل dl. مرر التسمية عبر label وقيمتها عبر children. يتولى التطبيق مسؤولية التسميات، والتعريب، والقيم المنسقة، والعناصر النائبة للقيم المفقودة.

المحاذاة والالتفاف

تلتف التسميات والقيم بدلاً من اقتطاعها. تلتف عناصر القيم المتعددة، مثل الشرائح أو العلامات، إلى أسطر إضافية. تحاذي الصفوف محتواها عند الأعلى مع ازدياد حجم ذلك المحتوى. يكون العمود الخاص بالتسمية مضبوطًا افتراضيًا على 7rem، ويُحدَّد بحد أقصى يبلغ 40% من عرض الصف لإتاحة مساحة للقيمة في الحاويات الضيقة. عيّن labelWidth نفسه في الصفوف الشقيقة لضبط محاذاتها. تستخدم الأرقام وحدات البكسل؛ كما تُدعم أيضًا أطوال CSS مثل '8rem'.

الإجراءات

استخدم action لعنصر تحكم بجانب القيمة. لا يضيف الصف سلوك التحرير أو النقر أو لوحة المفاتيح. وفّر عنصر تحكم باسم يمكن الوصول إليه، واربط معالجه بسلوك التطبيق.

التركيب وإمكانية الوصول

يعرض كل صف تجميع div مع تسمية dt وdd يحتوي على القيمة والإجراء الاختياري. يوفّر المستدعي عنصر dl المُضمِّن. وفّر نصًا ذا معنى في التسمية. تُخفى startIcon الاختيارية عن التقنية المساعدة، ويتحكم المستدعي في أبعادها. تستهدف السمات الأصلية وclassName وstyle وref عنصر div الخارجي. عند استخدام render مع غلاف مخصص، أبقِ عنصر div هذا مباشرةً داخل dl ومرّر جميع الخصائص الموفَّرة والمرجع. أبقِ الإجراءات داخل موضعها لكي يظل المصطلح والتعريف ابنين مباشرين للصف. استخدم MetricRow لمقياس مع تقدم اختياري. يوفّر DetailsRow تخطيط التسمية والقيمة والإجراء فقط.

الإزاحة

ReactNode
Optional action content beside the value. The caller supplies controls, accessible names, and handlers.
ReactNode
مطلوب
Value content rendered in the description definition. Text and multiple items wrap within the available space.
string
CSS class applied to the row root.
ReactNode
مطلوب
Visible label rendered as the description term.
Width<string | number>
افتراضي:"7rem"
Preferred label column width. Numbers use pixels. The column is capped at 40% of the row width; use the same width for aligned sibling rows.
Ref<HTMLDivElement>
Ref forwarded to the row root div.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Customizes the row root. Preserve a div directly inside a dl and forward its props and ref to retain valid description-list grouping.
ReactNode
Decorative node before the label. The caller controls icon dimensions.
CSSProperties
Inline styles applied to the row root.