Resumen
DetailsRow combina una etiqueta con un valor en una lista de descripciones. Agregue un icono decorativo, varios elementos de valor o una acción proporcionada por su aplicación.
”Uso”
dl. Pase la etiqueta mediante label y su valor mediante children. La aplicación gestiona las etiquetas, la localización, los valores con formato y los marcadores de posición para valores faltantes.
Alineación y ajuste de línea
Las etiquetas y los valores se ajustan a varias líneas en lugar de truncarse. Varios elementos de valor, como chips o etiquetas, se ajustan a líneas adicionales. Las filas alinean su contenido en la parte superior a medida que este crece. La columna de etiquetas usa7rem de forma predeterminada y está limitada al 40 % del ancho de la fila para dejar espacio para el valor en contenedores estrechos. Establezca el mismo labelWidth en las filas adyacentes para ajustar su alineación. Los números usan píxeles; también se admiten longitudes CSS como '8rem'.
Acciones
Useaction para un control junto al valor. La fila no agrega comportamiento de edición, clic ni teclado. Proporcione un control con un nombre accesible y conecte su controlador al comportamiento de la aplicación.
Composición y accesibilidad
Cada fila representa una agrupacióndiv con una etiqueta dt y un dd que contiene el valor y la acción opcional. Quien realiza la llamada proporciona el dl contenedor. Proporcione texto significativo en la etiqueta. El startIcon opcional está oculto para la tecnología de asistencia, y quien realiza la llamada controla sus dimensiones.
Los atributos nativos, className, style y ref se aplican al div exterior. Al usar render con un contenedor personalizado, conserve ese div directamente dentro del dl y reenvíe todas las props proporcionadas y la ref. Mantenga las acciones dentro de su espacio para que el término y la definición sigan siendo los elementos secundarios directos de la fila.
Use Fila de métricas para una métrica con progreso opcional. DetailsRow proporciona únicamente el diseño de etiqueta, valor y acción.
”Props”
ReactNode
Optional action content beside the value. The caller supplies controls, accessible names, and handlers.
ReactNode
requerido
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
requerido
Visible label rendered as the description term.
Width<string | number>
predeterminado:"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.