`table-summary`Desde: 0.14.0
Requiere la característica `a11y-extras`

Un resumen del propósito y la estructura de una tabla compleja.

Estará disponible para las tecnologías de asistencia (TA), como los lectores de pantalla, al exportar a PDF, pero no para los lectores videntes de tu archivo.

Este campo está pensado para instrucciones que ayuden al usuario a navegar la tabla con TA. No es una descripción alternativa, así que no dupliques adentro el contenido de la tabla. Del mismo modo, no lo uses para la conclusión central de la tabla. En cambio, incluila en el texto que rodea la tabla o, mejor aún, en un epígrafe de figura.

Si tenés dudas sobre si tu tabla es lo bastante compleja como para justificar un resumen, inclinate por no incluir uno. Si estás seguro de que tu tabla es lo bastante compleja, considerá si un usuario vidente podría encontrarla difícil. Podría beneficiarse de las instrucciones que pongas acá, así que considerá imprimirlas visiblemente en el documento.

La API de esta característica es temporal. Por lo tanto, llamar a esta función requiere por el momento habilitar el indicador de característica a11y-extras. Aunque esta funcionalidad llegue a estar disponible sin un indicador de característica en el futuro, el resumen seguirá siendo exclusivo de la exportación a PDF.


#figure(
  pdf.table-summary(
    // The summary just provides orientation and structural
    // information for AT users.
    summary: "The first two columns list the names of each participant. The last column contains cells spanning multiple rows for their assigned group.",
    table(
      columns: 3,
      table.header[First Name][Given Name][Group],
      [Mike], [Davis], table.cell(rowspan: 3)[Sales],
      [Anna], [Smith],
      [John], [Johnson],
      [Sara], [Wilkins], table.cell(rowspan: 2)[Operations],
      [Tom], [Brown],
    ),
  ),
  // This is the key takeaway of the table, so we put it in the caption.
  caption: [The Sales org now has a new member],
)