<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 atributoschar
ycharoff
.
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
ojustify
, aplicar la propiedad CSStext-align
al elemento. - Para lograr el mismo efecto que con el valor
char
, dar a la propiedadtext-align
el mismo valor que usarías parachar
.
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 propiedadbackground-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 establecealign
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 to0
, 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 to0
, 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 thedir
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 asbottom
. -
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