Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLTableCellElement

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

L'interface HTMLTableCellElement fournit des propriétés et méthodes particulières (en plus de l'interface HTMLElement dont elle hérite) pour manipuler la disposition et la présentation des cellules de tableau, qu'il s'agisse de cellules d'en-tête (<th>) ou de cellules de données (<td>), dans un document HTML.

EventTarget Node Element HTMLElement HTMLTableCellElement

Propriétés d'instance

Hérite des propriétés de son parent, HTMLElement.

HTMLTableCellElement.abbr

Une chaîne de caractères pouvant être utilisée sur les éléments <th> (et non sur <td>), définissant un libellé alternatif pour la cellule d'en-tête. Ce libellé alternatif peut être utilisé dans d'autres contextes, par exemple lors de la description des en-têtes associés à une cellule de données. Il sert à proposer un terme plus court, notamment pour les lecteurs d'écran ; c'est un outil précieux pour l'accessibilité. Généralement, la valeur de abbr est une abréviation ou un acronyme, mais il peut s'agir de tout texte approprié au contexte.

HTMLTableCellElement.cellIndex Lecture seule

Un nombre représentant la position de la cellule dans le tableau cells de l'élément HTML <tr> auquel la cellule appartient. Si la cellule n'appartient à aucun <tr>, il retourne -1.

HTMLTableCellElement.colSpan

Un nombre positif indiquant le nombre de colonnes que cette cellule doit couvrir ; cela permet à la cellule d'occuper l'espace sur plusieurs colonnes du tableau. Cela reflète l'attribut colspan.

HTMLTableCellElement.headers Lecture seule

Un objet DOMTokenList décrivant une liste d'id des éléments <th> qui représentent les entêtes associés à la cellule. Cela reflète l'attribut headers.

HTMLTableCellElement.rowSpan

Un nombre positif indiquant le nombre de lignes que cette cellule doit couvrir ; cela permet à la cellule d'occuper l'espace sur plusieurs lignes du tableau. Cela reflète l'attribut rowspan.

HTMLTableCellElement.scope

Une chaîne de caractères indiquant la portée d'une cellule <th>. Les valeurs possibles pour scope sont : col, colgroup, row, rowgroup ou la chaîne vide ("").

Méthodes d'instance

Aucune méthode spécifique ; hérite des méthodes de son parent, HTMLElement.

Deprecated properties

Attention : These properties have been deprecated and should no longer be used. They are documented primarily to help understand older code bases.

HTMLTableCellElement.align Obsolète

Une chaîne de caractères contenant la valeur énumérée de l'attribut align. Cette propriété décrit l'alignement du contenu de la cellule compte tenu du contexte ; ses valeurs possibles sont "left", "right", et "center". Utilisez plutôt la propriété CSS text-align.

HTMLTableCellElement.axis Obsolète

Une chaîne de caractères contenant un nom regroupant des cellules de manière virtuelle. C'est une représentation de l'attribut obsolète axis.

HTMLTableCellElement.bgColor Obsolète

Une chaîne de caractères contenant la couleur de fond des cellules. C'est une représentation de l'attribut obsolète bgColor.

HTMLTableCellElement.ch Obsolète

Une chaîne de caractères contenant un unique caractère. Ce caractère est celui utilisé pour l'alignement de toutes les cellules d'une même colonne. Il représente l'attribut char et prend par défaut la valeur du séparateur décimal associé à la langue, par exemple '.' pour l'anglais, ou ',' pour le français. Cette propriété était optionnelle et peu supportée.

HTMLTableCellElement.chOff Obsolète

Une chaîne de caractères contenant un entier indiquant le nombre de caractères devant être laissés à droite (pour les écritures de gauche à droite ; sinon à gauche pour les écritures de droite à gauche) du caractère défini par HTMLTableCellElement.ch. Cette propriété était optionnelle et peu supportée.

HTMLTableCellElement.height Obsolète

Une chaîne de caractères contenant la valeur en pixels de la hauteur de l'empreinte de la cellule. C'est une représentation de l'attribut obsolète height.

HTMLTableCellElement.noWrap Obsolète

Un booléen représentant l'attribut nowrap et indiquant si le contenu de la cellule peut être scindé en plusieurs lignes.

HTMLTableCellElement.vAlign Obsolète

Une chaîne de caractères contenant une valeur énumérée indiquant le type d'alignement vertical attendu du contenu de la cellule. Cette propriété représente l'attribut valign et peut prendre l'une des valeurs suivantes : "top", "middle", "bottom", ou "baseline". Utilisez plutôt la propriété CSS vertical-align.

HTMLTableCellElement.width Obsolète

Une chaîne de caractères contenant la valeur en pixels de la largeur de l'empreinte de la cellule. C'est une représentation de l'attribut obsolète width. Utilisez plutôt la propriété CSS width.

Spécifications

Specification
HTML
# htmltablecellelement

Compatibilité des navigateurs

Voir aussi

  • Les éléments HTML implémentant cette interface : <th> et <td>