<TH> | NN tous IE tous HTML 3.2
<TH>...</TH> | Balise de fin HTML : Facultatif
L'élément th est le conteneur de tout le contenu d'une cellule d'un élément table dont le format doit distinguer ce contenu comme en-tête de tableau La plupart des navigateurs affichent en gras le contenu de cet élément. Une cellule est constituée de l'intersection d'une ligne et d'une colonne. Les autres éléments relatifs à l'élément th sont les suivants: caption, col, colgroup, table, tbody, td, tfoot, thead et tr. L'élément th ne sert pas uniquement à délimiter le contenu d'une cellule: il définit un certain nombre d'attributs visibles qui s'appliquent à une cellule, souvent pour compenser l'effet d'attributs identiques définis à un niveau plus élevé dans le tableau. Quatre attributs — abbr, axis, headers et scope — ont été inclus dans les spécifications HTML 4 en prévision des futurs navigateurs non visuels, qui offriront des fonctionnalités de synthèse vocale pour décrire le contenu d'une page HTML — en un « affichage oral » , en quelque sorte Ces attributs ne sont décrits brièvement ici que pour des raisons d'exhaustivité: leurs applications dans des navigateurs non visuels débordent le cadre de ce texte sur le DHTML. Consultez les recommandations HTML 4 pour plus de détails.
Exemple
    <TABLE cols="3">
    <THEAD>
    <TR>
    <TH>Time</TH><TH>Event</TH><TH>Location</TH>
    </TR>
    </THEAD>
    <TBODY>
    <TR>
    <TD>7:30am-5:00pm</TD><TD>Registration Open</TD><TD>Main Lobby</TD>
    </TR>
    <TR>
    <TD>9:00am-12:00pm</TD><TD>Keynote Speakers</TD><TD>Cypress Room</TD>
    </TR>
    </TBODY>
    </TABLE>
Référence de modèle d'objet
    [window.]document.getElementById(elementID)
Attributs spécifiques à l'élément
abbr | align | axis | background | bgcolor
bordercolor | bordercolordark | bordercolorlight | ch | char
charoff | choff | colspan | datafld | headers
height | nowrap | rowspan | scope | valign
width |  |  |  |
Attributs du gestionnaire d´événements spécifiques à l´élément
Gestionnaire | NN | IE | HTML
onafterupdate | s.o | 4 | s.o
onbeforeupdate | s.o | 4 | s.o
onrowenter | s.o | 4 | s.o
onrowexit | s.o | 4 | s.o

abbr | NN 6 IE 6 HTML 4
abbr="text" | Facultatif
Chaîne abrégée décrivant le contenu de la cellule. Il s'agit en général d'une brève légende qu'un navigateur non visuel pourrait énoncer à haute voix pour décrire ce que représente le contenu de la cellule. La sélection de Properties pour le menu contextuel de Netscape 6 de cet élément affiche une petite fenêtre qui inclut un lien actif vers l'URL assigné à l'attribut. Les navigateurs de la Version 6 ne proposent aucune autre fonctionnalité pour cet attribut.
Exemple
    <TH abbr="What">Event</TH>
Valeur
Toute chaîne de texte entre guillemets.
Par défaut
Aucune.

align | NN tous IE tous HTML 3.2
align="alignConstant" | Facultatif
Définit les caractéristiques de l'alignement horizontal du contenu de la cellule définie par l'élément th.
Exemple
    <TH align="center">
Valeur
HTML 4 et divers navigateurs implémentent des jeux de valeurs d'attributs différents. Les noms des valeurs center (centré), left (gauche) et right (droite) sont explicites. La valeur justify espace le contenu multiligne afin d'aligner le texte sur les bords gauche et droit à la fois. Avec la valeur char, l'attribut char doit être également défini pour indiquer le caractère utilisé pour l'alignement du contenu. Dans l'exemple des spécifications HTML 4, tout contenu dans lequel ce caractère n'apparaît pas sera aligné à droite par rapport à l'emplacement de ce caractère dans les autres lignes de la même colonne.
Valeur | IE/Windows et NN 4 | IE/Mac et NN 6 | HTML 4
center | √ | √ | √
char | - | - | √
justify | - | √ | √
left | √ | √ | √
right | √ | √ | √
Par défaut
left
Référence de modèle d'objet
    [window.]document.getElementById(elementID).align

axis | NN 6 IE 6 HTML 4
axis="texte" | Facultatif
Chaîne abrégée décrivant la catégorie de la cellule. Il s'agit en général d'une brève légende qu'un navigateur non visuel pourrait énoncer à haute voix pour décrire ce que représente le contenu de la cellule. La sélection de Properties pour le menu contextuel de Netscape 6 de cet élément affiche une petite fenêtre qui inclut un lien actif vers l'URL assigné à l'attribut. Les navigateurs de la version 6 ne proposent aucune autre fonctionnalité pour cet attribut.
Exemple
    <TH axis="event">Events</TH>
Valeur
Toute chaîne de texte entre guillemets.
Par défaut
Aucune.
Référence de modèle d'objet
    [window.]document.getElementById(elementID).axis

background | NN 4 IE 3 HTML s.o.
background="URL" | Facultatif
Indique un fichier image utilisé comme arrière-plan de la cellule. À la différence des images normales, qui sont chargées par le navigateur en tant que contenu, les images d'arrière-plan sont chargées à leur taille originale (sans redimensionnement) et affichées côte à côte pour remplir l'espace disponible dans la cellule. Les images de petite taille sont chargées plus rapidement, mais elles sont évidemment répétées un plus grand nombre de fois pour former la mosaïque d'arrière-plan. Cependant, Navigator 4 exige une taille d'image minimale de 16 x 16 pixels. Les images GIF animées peuvent être utilisées en arrière-plan, mais elles entravent la lecture. Lors du choix d'une image d'arrière-plan, veillez à en prendre une qui soit neutre par rapport au contenu principal, afin que celui-ci ressorte lisiblement. Si elles doivent vraiment être utilisées, les images d'arrière-plan doivent rester extrêmement discrètes.
Exemple
    <TH background="watermark.jpg">
Valeur
Toute adresse URL valide (complète ou relative) d'un fichier image.
Par défaut
Aucune.
Référence de modèle d'objet
    [window.]document.getElementById(elementID).background

bgcolor | NN 6 IE 3 HTML 3.2
bgcolor="colorTripletOrName" | Facultatif
Définit une couleur de remplissage (derrière le texte et autre contenu) pour la cellule définie par l'élément th.
Exemple
    <TH bgcolor="yellow">
Valeur
Triplet de couleurs en hexadécimal ou l'un des noms de couleurs en anglais. Si la valeur de cet attribut n'est pas indiquée, elle sera interprétée comme "#000000" (noir). Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées.
Par défaut
Varie en fonction du système d'exploitation, du navigateur et de sa version.
Référence de modèle d'objet
    [window.]document.getElementById(elementID).bgColor

bordercolor | NN s.o. IE 3 HTML s.o.
bordercolor="colorTripletOrName" | Facultatif
Couleurs utilisées pour afficher une partie des pixels afin de donner l'illusion de bordures autour des cellules et de tout le tableau. Internet Explorer applique la couleur aux quatre lignes de la bordure d'une cellule. Par conséquent, les couleurs de cellules adjacentes ne se touchent pas.
Exemple
    <TH bordercolor="green">
Valeur
Triplet de couleurs en hexadécimal ou l'un des noms de couleurs en anglais. Si la valeur de cet attribut n'est pas indiquée, elle sera interprétée comme "#000000" (noir). Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées.
Par défaut
Varie selon le navigateur et le système d'exploitation.
Référence de modèle d'objet
    [window.]document.getElementById(elementID).borderColor

bordercolordark, bordercolorlight | NN s.o. IE 3 HTML s.o.
bordercolordark="colorTripletOrName" bordercolorlight="colorTripletOrName" | Facultatif
L'effet tridimensionnel des bordures d'un tableau dans Internet Explorer est créé par une disposition minutieuse de lignes claires et foncées sur l'arrière-plan ou la couleur par défaut de la page. Vous pouvez contrôler individuellement les couleurs utilisées pour les lignes claires et foncées en affectant des valeurs aux propriétés bordercolordark (bords gauche et supérieur de la cellule) et bordercolorlight (bords droit et inférieur). En général, il est conseillé d'affecter à la paire d'attributs des couleurs complémentaires. Toutefois rien ne vous oblige à définir une couleur foncée pour bordercolordark. Comme les attributs ne contrôlent qu'un jeu de lignes bien défini, vous pouvez aisément déterminer les lignes de bordure qui changeront avec chaque attribut.
Exemple
    <TH bordercolordark="darkred" bordercolorlight="salmon">
Valeur
Triplet de couleurs en hexadécimal ou l'un des noms de couleurs en anglais. Si la valeur de cet attribut n'est pas indiquée, elle sera interprétée comme "#000000" (noir). Reportez-vous à l'annexe A pour connaître les noms de couleurs admises/autorisées.
Par défaut
Varie selon le système d'exploitation.
Référence de modèle d'objet
    [window.]document.getElementById(elementID).borderColorDark
    [window.]document.getElementById(elementID).borderColorLight

char | NN 6 IE s.o. HTML 4
char="character" | Facultatif
L'attribut char définit le caractère utilisé comme point d'alignement dans une cellule. Cet attribut n'est utile que si l'attribut align reçoit la valeur "char". Microsoft documente un attribut ch, qui correspond à l'attribut char reposant sur les standards. Quoi qu'il en soit, le navigateur ne répond à aucun attribut. Netscape 7 ne propose pas encore la prise en charge de l'attribut char.
Exemple
    <TH align="char" char=".">$325.10</TH>
Valeur
Tout caractère alphanumérique unique.
Par défaut
Aucune.

charoff | NN 6 IE s.o. HTML 4
charoff="length" | Facultatif
L'attribut charoff permet de définir le point de décalage spécifique auquel le caractère spécifié par l'attribut char doit apparaître dans chaque cellule. Cet attribut est destiné à résoudre les cas où le positionnement par défaut du navigateur ne correspondrait pas aux objectifs de mise en page du tableau. Microsoft documente un attribut choff, qui correspond à l'attribut charoff reposant sur les standards. Quoi qu'il en soit, le navigateur ne répond à aucun attribut. Netscape 7 ne propose pas encore la prise en charge de l'attribut charoff.
Exemple
    <TH align="char" char="." charoff="80%">
Valeur
Toute valeur en pixels ou en pourcentage de l'espace disponible dans les cellules.
Par défaut
Aucune.

choff |
Voir charoff.

colspan | NN tous IE tous HTML 3.2
colspan="columnCount" | Facultatif
L'attribut colspan spécifie le nombre de colonnes du tableau sur lequel la cellule doit s'étendre. Chaque colonne supplémentaire incluse dans la valeur colspan implique un élément th ou td de moins pour la ligne de tableau. Si vous paramétrez l'attribut align sur center ou sur right, l'alignement est calculé pour toute la largeur de l'élément th sur le nombre de colonnes indiqué. La ligne suivante du tableau retrouve le nombre de colonnes original à moins que vous ayez précisé un attribut rowspan.
Exemple
    <TH colspan="2" align="right">
Valeur
Tout entier positif, généralement égal ou supérieur à deux.
Par défaut
1
Référence de modèle d'objet
    [window.]document.getElementById(elementID).colSpan

datafld | NN s.o. IE 4 HTML s.o.
datafld="columnName" | Facultatif
Utilisé avec la fonction de liaison de données de Microsoft Internet Explorer pour associer le nom d'une colonne d'une source de données distante au contenu d'une cellule d'en-tête de tableau. Les attributs datasrc et, éventuellement, datapagesize de l'élément père table doivent être également définis. S'applique uniquement aux sources de données de fichier texte dans IE 5/Mac.
Exemple
    <TABLE datasrc="DBSRC3" datapagesize="5">
    <TR>
      <TH datafld="stockNum"></TH>
      <TH datafld="qtyOnHand"></TH>
    </TR>
    </TABLE>
Valeur
Identifiant sensible à la casse.
Par défaut
Aucune.

headers | NN 6 IE 6 HTML 4
headers="cellIDList" | Facultatif
Pointe sur un ou plusieurs éléments th ou td faisant office d'en-têtes de colonne ou de ligne pour la cellule de tableau actuelle. La valeur affectée à cet attribut est une liste des valeurs des attributs id affectés aux éléments th correspondants; dans la liste, ces identifiants sont séparés par des espaces. On peut imaginer qu'un navigateur non visuel énonce le contenu de l'en-tête avant le contenu de la cellule, afin d'aider les visiteurs à identifier la nature de ce dernier. Si les navigateurs standard de version 6 revendiquent la prise en charge de cet attribut, celle-ci n'est pas encore implémentée.
Exemple
    <TR>
    <TH id="hdr1">Product Number</TH>
    <TH id="hdr2">Description</TH>
    </TR>
    <TR>
    <TH headers="hdr1">0392</TH>
    <TH headers="hdr2">Round widget</TH>
    </TR>
Valeur
Liste des identifiants (sensibles à la casse et séparés par des espaces) des cellules faisant fonction d'en-tête pour la cellule actuelle.
Par défaut
Aucune.

height, width | NN tous IE tous HTML 3.2
height="length" width="length" | Facultatif
Les dimensions rectangulaires d'une cellule, qui peuvent être différentes de la taille par défaut calculée par le navigateur. Lorsque les valeurs de ces attributs sont inférieures à l'espace minimal nécessaire pour afficher le contenu des cellules du tableau, le navigateur n'en tient pas compte et affiche tout le contenu, quitte à ce que du texte soit renvoyé à la ligne suivante. Vous pouvez également étirer les dimensions d'un tableau au-delà des dimensions calculées par le navigateur. Un espace blanc supplémentaire apparaît dans les cellules du tableau pour compenser cette différence. Si vous n'utilisez qu'un seul de ces attributs, le navigateur effectuera les calculs nécessaires pour ajuster automatiquement l'autre dimension. En raison de la nature régulière, par définition, des tableaux, si vous définissez une hauteur précise pour une cellule, toutes les cellules de la même ligne auront la même hauteur; de même, en cas d'affectation d'une largeur précise à une cellule, toutes les cellules de la même colonne auront la même largeur. Les attributs height et width sont délaissés dans HTML 4, au profit des attributs de feuilles de style height et width (qui ne sont pas disponibles pour les cellules de tableaux dans Navigator 4).
Exemple
    <TH width="80%" height="30">
Valeur
Toute valeur en pixels ou en pourcentage de l'espace disponible.
Par défaut
Adaptée à la taille du contenu.
Référence de modèle d'objet
    [window.]document.getElementById(elementID).height
    [window.]document.getElementById(elementID).width

lang | NN 3 IE 4 HTML 4
lang="languageCode" | Facultatif
La langue utilisée pour le contenu et les valeurs d'attributs de l'élément. Un navigateur peut se servir de ces informations pour aider à l'affichage correct du contenu aussi bien que de détails comme le traitement des ligatures (lorsqu'elles sont prises en charge par une police particulière ou requises par une langue écrite), des guillemets et des traits d'union. D'autres applications et moteurs de recherche peuvent se servir de ces informations pour faciliter la sélection des dictionnaires utilisés pour la vérification orthographique et aider la création d'index.
Exemple
    <span lang="de">Deutsche Bundesbahn</span>
Valeur
Code de langue insensible à la casse.
Par défaut
Valeur par défaut du navigateur.
Référence de modèle d'objet
    [window.]document.getElementById(elementID).lang

nowrap | NN tous IE tous HTML 3.2
nowrap | Facultatif
La présence de l'attribut nowrap indique au navigateur qu'il doit élargir la cellule pour permettre l'affichage d'une ligne de texte insécable sur une seule ligne. Il est conseillé de ne pas abuser de cet attribut, car il oblige l'utilisateur à faire défiler horizontalement la page pour en afficher tout le contenu. L'attribut nowrap est délaissé dans HTML 4, qui recommande l'attribut et la valeur CSS white-space:nowrap.
Exemple
    <TH nowrap>
Valeur
La présence de cet attribut définit sa valeur comme true (vrai).
Par défaut
false
Référence de modèle d'objet
    [window.]document.getElementById(elementID).noWrap

rowspan | NN tous IE tous HTML 3.2
rowspan="rowCount" | Facultatif
Nombre de lignes sur lequel la cellule active doit s'étendre vers le bas. Pour chaque ligne supplémentaire incluse dans le compte rowspan, il faut un élément th ou td de moins dans la ligne de tableau suivante, à la position qui correspond à celle de cette cellule dans la colonne.
Exemple
    <TH rowspan="2">
Valeur
Tout entier positif, généralement égal ou supérieur à deux.
Par défaut
1
Référence de modèle d'objet
    [window.]document.getElementById(elementID).rowSpan

scope | NN 6 IE 6 HTML 4
scope="scopeConstant" | Facultatif
La plage de cellules, par rapport à la cellule actuelle, qui se comportent comme si cette dernière était leur en-tête. Dans le cas de tableaux dont la structure est régulière, l'attribut scope permet d'obtenir le même résultat qu'en utilisant l'attribut headers, mais de façon plus simple, sans devoir définir des attributs id pour les cellules de l'en-tête. Si les navigateurs standard de version 6 revendiquent la prise en charge de cet attribut, celle-ci n'est pas encore implémentée.
Exemple
    <TR>
    <TH scope="col">Product Number</TH>
    <TH scope="col">Description</TH>
    </TR>
    <TR>
    <TD>0392</TD>
    <TD>Round widget</TD>
    </TR>
Valeur
L'une des quatre constantes de plage reconnues:
Par défaut
Aucune.

valign | NN tous IE tous HTML 3.2
valign="alignmentConstant" | Facultatif
Détermine l'alignement vertical du texte à l'intérieur de l'élément td. Si vous définissez une valeur pour une cellule individuelle, cette valeur annulera la valeur du même attribut des conteneurs externes, tels que tr et tbody.
Exemple
    <TH valign="bottom">
Valeur
Quatre constantes: top | middle | bottom | baseline. Avec top et bottom, le contenu est aligné sur le haut et le bas de la cellule (ou en est très proche). Avec middle (la valeur par défaut), le contenu est parfaitement centré verticalement dans les cellules. Dans les cas où le contenu d'une cellule pourrait s'étendre sur plusieurs lignes dans les largeurs de fenêtre courantes (dans l'hypothèse d'un tableau de largeur variable), il est conseillé de donner à l'attribut valign la valeur baseline. Ainsi, la ligne de base des caractères de la première (ou de la seule) ligne de texte de la cellule sera alignée sur celle du contenu des autres cellules de la même ligne, ce qui est en général le meilleur compromis sur le plan esthétique.
Par défaut
middle
Référence de modèle d'objet
    [window.]document.getElementById(elementID).vAlign

width |
Voir height.