<th>
====

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 (en-US) | 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` (en-US) |

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`. No implementado in CSS3.

`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`, No implementado en CSS3.



`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>` (en-US), `<tbody>` (en-US) or `<tfoot>` (en-US)). 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 (en-US) and cellpadding (en-US) 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 with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* Other table-related HTML Elements: `<caption>`, `<col>`, `<colgroup>`, `<table>`, `<tbody>` (en-US), `<td>`, `<tfoot>` (en-US), `<thead>` (en-US), `<tr>`.