Обзор
DetailsRow сопоставляет метку со значением в списке описаний. Добавьте декоративный значок, несколько элементов значения или действие, предоставляемое вашим приложением.
Использование
dl. Передавайте метку через label, а её значение — через children. Приложение отвечает за метки, локализацию, форматированные значения и заполнители для отсутствующих значений.
Выравнивание и перенос строк
Метки и значения переносятся на новую строку, а не обрезаются. Несколько элементов значения, таких как чипы или теги, переносятся на дополнительные строки. По мере увеличения содержимого строки выравнивают его по верхнему краю. Ширина столбца меток по умолчанию равна7rem и ограничена 40 % ширины строки, чтобы оставить место для значения в узких контейнерах. Задайте одинаковое значение labelWidth в соседних строках, чтобы настроить их выравнивание. Для чисел используются пиксели; также поддерживаются значения длины CSS, например '8rem'.
Действия
Используйтеaction для элемента управления рядом со значением. Строка не добавляет поведение редактирования, щелчка или клавиатуры. Предоставьте элемент управления с доступным именем и свяжите его обработчик с поведением приложения.
Композиция и доступность
Каждая строка отображает группуdiv с меткой dt и элементом dd, содержащим значение и необязательное действие. Вызывающая сторона предоставляет охватывающий dl. Используйте содержательный текст в метке. Необязательный startIcon скрыт от вспомогательных технологий, а вызывающая сторона управляет его размерами.
Нативные атрибуты, className, style и ref применяются к внешнему div. При использовании render с пользовательской обёрткой сохраняйте этот div непосредственно внутри dl и передавайте все предоставленные свойства и ref. Сохраняйте действия внутри их слота, чтобы термин и определение оставались непосредственными дочерними элементами строки.
Используйте 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.