HTMLTableRowElement

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 HTMLTableRowElement fournit des propriétés et des méthodes spéciales (au-delà de l'interface HTMLElement dont elle dispose également par héritage) pour manipuler la mise en page et la présentation des lignes dans un tableau HTML.

Propriétés d'instance

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

HTMLTableRowElement.cells Lecture seule: Retourne une collection (HTMLCollection) dynamique contenant les cellules de la ligne. La HTMLCollection est dynamique et se met automatiquement à jour lorsque des cellules sont ajoutées ou supprimées.
HTMLTableRowElement.rowIndex Lecture seule: Retourne un nombre indiquant la position logique de la ligne dans l'ensemble du tableau. Si la ligne ne fait pas partie d'un tableau, retourne -1.
HTMLTableRowElement.sectionRowIndex Lecture seule: Retourne un nombre indiquant la position logique de la ligne dans la section du tableau à laquelle elle appartient. Si la ligne ne fait pas partie d'une section, retourne -1.

Méthodes d'instance

Hérite des méthodes de son parent, HTMLElement.

HTMLTableRowElement.deleteCell(): Supprime la cellule correspondant à index. Si index vaut -1, la dernière cellule de la ligne est supprimée. Si index est inférieur à -1 ou supérieur au nombre de cellules dans la collection, une DOMException avec la valeur IndexSizeError est levée.
HTMLTableRowElement.insertCell(): Retourne un objet HTMLTableCellElement représentant une nouvelle cellule de la ligne. La cellule est insérée dans la collection de cellules juste avant la position index donnée dans la ligne. Si index vaut -1, la nouvelle cellule est ajoutée à la fin de la collection. Si index est inférieur à -1 ou supérieur au nombre de cellules dans la collection, une DOMException avec la valeur IndexSizeError est levée.

Propriétés obsolètes

Attention : Ces propriétés sont obsolètes et ne doivent plus être utilisées. Elles sont documentées principalement pour aider à comprendre d'anciens codes sources.

HTMLTableRowElement.align Obsolète: Une chaîne de caractères contenant une valeur énumérée reflétant l'attribut align. Elle indique l'alignement du contenu de l'élément par rapport au contexte environnant. Les valeurs possibles sont "left", "right" et "center".
HTMLTableRowElement.bgColor Obsolète: Une chaîne de caractères contenant la couleur d'arrière-plan des cellules. Elle reflète l'attribut obsolète bgColor.
HTMLTableRowElement.ch Obsolète: Une chaîne de caractères contenant un seul caractère. Ce caractère sert à aligner toutes les cellules d'une colonne. Elle reflète l'attribut char et prend par défaut le séparateur décimal associé à la langue, par exemple '.' pour l'anglais ou ',' pour le français. Cette propriété était optionnelle et peu prise en charge.
HTMLTableRowElement.chOff Obsolète: Une chaîne de caractères contenant un entier indiquant combien de caractères doivent être laissés à droite (pour les écritures de gauche à droite ; ou à gauche pour les écritures de droite à gauche) du caractère défini par HTMLTableRowElement.ch. Cette propriété était optionnelle et peu prise en charge.
HTMLTableRowElement.vAlign Obsolète: Une chaîne de caractères représentant une valeur énumérée indiquant comment le contenu de la cellule doit être aligné verticalement. Elle reflète l'attribut valign et peut avoir l'une des valeurs suivantes : "top", "middle", "bottom" ou "baseline".

Spécifications

Specification
HTML # htmltablerowelement

Compatibilité des navigateurs

Voir aussi

L'élément HTML implémentant cette interface : <tr>.

Help improve MDN

Learn how to contribute

Cette page a été modifiée le ⁨19 janv. 2026⁩ par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content