• 
• 
• Referencia
• 
• Formatos
• 
• PDF
• 
• Celda de encabezado

header-cellDesde: 0.14.0

Requiere la característica a11y-extras

Define explícitamente una celda como celda de encabezado.

Las celdas de encabezado ayudan a los usuarios de tecnologías de asistencia (TA) a entender y navegar tablas complejas. Cuando tu tabla está correctamente marcada con celdas de encabezado, las TA pueden anunciar la información de encabezado relevante a demanda al entrar en una celda.

Por defecto, Typst marcará automáticamente todas las celdas de table.header como celdas de encabezado. Se aplicarán a las columnas que tienen debajo. Podés usar el parámetro level de esa función para que las celdas de encabezado estén etiquetadas por otras celdas de encabezado.

La función pdf.header-cell te permite indicar que una celda es una celda de encabezado en las siguientes situaciones adicionales:

• Tenés una columna de encabezado en la que cada celda se aplica a su fila. En ese caso, pasás "row" como argumento del parámetro scope para indicar que la celda de encabezado se aplica a la fila.
• Tenés una celda en table.header, por ejemplo al comienzo, que etiqueta tanto su fila como su columna. En ese caso, pasás "both" como argumento del parámetro scope.
• Tenés una celda de encabezado en una fila que no contiene otras celdas de encabezado. En ese caso, podés usar esta función para marcarla como celda de encabezado.

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. En una futura versión de Typst, esta funcionalidad podría salir del módulo pdf para que las tablas de otros destinos de exportación puedan contener la misma información.

#show table.cell.where(x: 0): set text(weight: "medium")
#show table.cell.where(y: 0): set text(weight: "bold")

#table(
  columns: 3,
  align: (start, end, end),

  table.header(
    // Top-left cell: Labels both the nutrient rows
    // and the serving size columns.
    pdf.header-cell(scope: "both")[Nutrient],
    [Per 100g],
    [Per Serving],
  ),

  // First column cells are row headers
  pdf.header-cell(scope: "row")[Calories],
  [250 kcal], [375 kcal],
  pdf.header-cell(scope: "row")[Protein],
  [8g], [12g],
  pdf.header-cell(scope: "row")[Fat],
  [12g], [18g],
  pdf.header-cell(scope: "row")[Carbs],
  [30g], [45g],
)

Parámetros

level

int

Por defecto: 1

El nivel de anidamiento de esta celda de encabezado.

scope

str

Por defecto: "column"

A qué pista de la tabla se aplica esta celda de encabezado.

cell

content

ObligatorioPosicional

Los parámetros posicionales se especifican en orden, sin nombres.

La celda de la tabla.

Puede ser contenido o una llamada a table.cell.

Celda de datosPágina anterior

Resumen de tablaPágina siguiente