Una cita extensa, separada en su propio bloque. Pon la URL de la fuente en el atributo cite e indica quién lo dijo fuera de la cita, por ejemplo, en un figcaption.
The best interface is the one the browser already ships.
HTML
<blockquote>
<p>The best interface is the one the browser already ships.</p>
</blockquote>
Una lista de nombres asociados a valores: un glosario, las especificaciones de un producto o los datos de un archivo. Cada dt nombra algo y el dd siguiente lo explica.
El pie de una figura. Colócalo como primer o último elemento hijo de figure.
Two shapes, drawn in SVG.
HTML
<figure>
<img src="shapes.svg" alt="A blue square and a grey circle" width="240" height="120">
<figcaption>Two shapes, drawn in SVG.</figcaption>
</figure>
Envuelve una imagen, un diagrama, un bloque de código o una cita a la que hace referencia el texto, con un pie opcional. Se podría mover a otro lugar de la página sin romper el texto.
Two shapes, drawn in SVG.
HTML
<figure>
<img src="shapes.svg" alt="A blue square and a grey circle" width="240" height="120">
<figcaption>Two shapes, drawn in SVG.</figcaption>
</figure>
Con estilos de elements/text.css, sin clase. LUZ convierte una figure sin clase en una superficie con relleno. El componente .luz-figure añade más estilos.
Una lista de acciones que se pueden realizar, como los botones de una barra de herramientas. Los navegadores la tratan como ul; LUZ la distribuye en una fila.
Texto que se muestra exactamente como se ha escrito, con todos los espacios y saltos de línea, en una fuente de ancho fijo. Para el código, añade la clase .luz-code-block y un elemento code.
Tres formas de usar <dl> con los estilos anteriores. Puedes agrupar cada <dt> con su <dd> en un <div>: es HTML válido y LUZ mantiene el mismo espacio entre grupos.
Metadatos
Datos sobre algo, como un archivo o un pedido. Cada par tiene un nombre y un valor, y va en su propio div para que un script o una regla de estilo pueda seleccionarlo.
Si un nombre tiene varios valores, todos forman un mismo grupo: el lector de pantalla anuncia cada valor por turno.
Glosario
Términos y sus significados. Cada término es un dt con un dfn dentro y tiene un id para que otras páginas puedan enlazar a su entrada.
Design token
A named value, such as a color or a space, that components read.
Color mode
One set of color values for the whole page.
Light, dark and high contrast are the three LUZ ships.
HTML
<dl>
<dt id="term-token"><dfn>Design token</dfn></dt>
<dd>A named value, such as a color or a space, that components read.</dd>
<dt id="term-mode"><dfn>Color mode</dfn></dt>
<dd>One set of color values for the whole page.</dd>
<dd>Light, dark and high contrast are the three LUZ ships.</dd>
</dl>
Enlaza a un término con #term-token. Un término puede tener más de un significado: repite dd.
Antes de usarlo
Mantén el valor predeterminado de display de <dl> y sus grupos. Definir flex o grid en elementos de lista ha hecho que algunas combinaciones de navegador y lector de pantalla pierdan la semántica de lista; consulta Propiedades display de CSS frente a la semántica de HTML. Distribuye los pares en un contenedor que controles y prueba el resultado.
HTML solo permite un <div> dentro de <dl> cuando envuelve un nombre y sus valores. Una fuente que probó un div como contenedor simple detectó problemas con lectores de pantalla en algunos navegadores (Uso de div en dl; no ofrece resultados). LUZ no ha probado el marcado agrupado con NVDA, JAWS, VoiceOver, TalkBack ni Orca.
Para una tabla con muchos valores por fila, usa una tabla, no una lista de descripciones.