<th>

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

El elemento HTML <th> define una celda como encabezado de un grupo de celdas en una tabla. La naturaleza exacta de este grupo está definida por los atributos scope y headers.

Categorías de contenido Ninguno
Contenido permitido
Contenido de flujo, pero sin encabezado, pie de página, contenido de seccionamiento, o contenido descendiente de encabezados
Omisión de etiqueta La etiqueta de inicio es obligatoria.
La etiqueta de cierre puede ser omitida si es inmediatamente seguida por el elemento <th> o <td> o si no hay más datos en su elemento padre.
Parents permítidos Un elemento <tr>
Roles permítdos de ARIA Cualquiera
Interfaz DOM HTMLTableHeaderCellElement

Atributos

Este elemento incluye los atributos globales.

abbr Obsoleto in HTML5

Este atributo contiene una breve descripción del contenido de las celdas. Algunos agentes de usuario (e.g., a speech reader) pueden presentar esta descripción antes que el propio contenido.

Nota: No uses este atributo, ya que se ha vuelto obsoleto en el último estandar. Alternativamente, puedes poner la descripción abreviada dentro de la celda y colocarla el largo contenido en el atributo de title.

align Obsoleto in HTML4, Obsoleto in HTML5

Este atributo enumerado especifica cómo se tratará el alineado horizontal de la celda. Los valores posibles son:

  • left: El contenido se alinea a la izquierda de la celda.
  • center: El contenido se centra en la celda.
  • right: El contenido se alinea a la derecha de la celda.
  • justify (solo con texto): El contenido se alarga para ocupar todo el ancho de la celda.
  • char (solo con texto): El contenido es alineado a un caracter dentro de <th> con el offset mínimo. Este caracter esta definido por los atributos char y charoff.

El valor por defecto cuando no se especifica este atributo es left.

Nota: No usar este atributo, ya que está obsoleto en el último estándar.

  • Para lograr el mismo efecto que con los valores left, center, right o justify, aplicar la propiedad CSS text-align al elemento.
  • Para lograr el mismo efecto que con el valor char, dar a la propiedad text-align el mismo valor que usarías para char.
axis Obsoleto in HTML5

Este atributo contiene una lista de cadenas separadas por espacios. Cada cadena es el id de un grupo de celdas a las que se les aplica esta cabecera.

Nota: Este atributo está obsoleto en el último estándar y no debe usarse. Puedes sustituirlo por scope.

bgcolor Non-standard

Este atributo define el color de fondo de cada celda en una columna. Consiste en una código hexadecimal de 6 digitos, con un prefijo '#'. Este atributo puede usarse con uno de los 16 colores predefinidos:

black = "#000000" green = "#008000"
silver = "#C0C0C0" lime = "#00FF00"
gray = "#808080" olive = "#808000"
white = "#FFFFFF" yellow = "#FFFF00"
maroon = "#800000" navy = "#000080"
red = "#FF0000" blue = "#0000FF"
purple = "#800080" teal = "#008080"
fuchsia = "#FF00FF" aqua = "#00FFFF"

Nota: No usar este atributo, ya que no es un estándar y sólo esta implementado en algunas versiones de Microsoft Internet Explorer. El elemento <th> debe estilizarse usando CSS. Para crear un efecto similar usa la propiedad background-color.

char Obsoleto in HTML4, Obsoleto in HTML5

El contenido de la celda se alinea con un caracter en el elemento <th>. Los valores típicos incluyen un punto (.) para alinear números o valores monetarios. Si no se establece align como char, el atributo es ignorado.

Nota: No usar este atributo, ya que no está soportado por el último estándar. Para lograr el mismo efecto, puedes especificar el caracter como el primer valor de la propiedad text-align.

charoff Obsoleto in HTML4, Obsoleto in HTML5

This attribute is used to shift column data to the right of the character specified by the char attribute. Its value specifies the length of this shift.

Nota: No usar este atributo, ya que no está soportado por el último estándar.

colspan

This attribute contains a positive integer value that indicates over how many columns a cell is extended. Its default value is 1. If its value is set to 0, the cell is extended to the last element of the <colgroup>. Values higher than 1000 are clipped down to 1000.

headers

This attribute contains a list of space-separated strings, each corresponding to the id attributes of other <th> elements that relate to this element.

rowspan

This attribute contains a positive integer value that indicates over how many rows a cells is extended. Its default value is 1. If its value is set to 0, the cell is extended to the last element of the table sections (<thead>, <tbody> or <tfoot>). Values higher than 65534 are clipped down to 65534.

scope

This enumerated attribute defines the cells that the header (defined in the <th>) element relates to. It may have the following values:

  • row: The header relates to all cells of the row it belongs to.
  • col: The header relates to all cells of the column it belongs to.
  • rowgroup: The header belongs to a rowgroup and relates to all of its cells. These cells can be placed to the right or the left of the header, depending on the value of the dir attribute in the <table> element.
  • colgroup: The header belongs to a colgroup and relates to all of its cells.
  • auto
valign Obsoleto in HTML4, Obsoleto in HTML5

This attribute specifies how a text is vertically aligned inside a cell. Possible values for this attribute are:

  • baseline: Positions the text near the bottom of the cell and aligns it with the baseline of the characters instead of the bottom. If characters don't descend below the baseline, the baseline value achieves the same effect as bottom.

  • bottom: Positions the text near the bottom of the cell.

  • middle: Centers the text in the cell.

  • and top: Positions the text near the top of the cell.

Nota: Do not use this attribute as it is no longer supported by the latest standard: use the CSS vertical-align property instead.

width Obsoleto in HTML4.01

This attribute is used to define a recommended cell width. Additional space can be added with the cellspacing and cellpadding properties and the width of the <col> element can also create extra width. But, if a column's width is too narrow to show a particular cell properly, it will be widened when displayed.

Nota: Do not use this attribute in the latest standard: use the CSS width property instead.

Examples

See <table> for examples on <th>.

Especificaciones

Specification
HTML Standard
# the-th-element

Compatibilidad con navegadores

BCD tables only load in the browser

See also