HTMLTableRowElement

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.

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

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

HTMLTableRowElement.align Obsolète

Est un DOMString contenant une valeur énumérée reflétant l'attribut align. Il 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

Est un DOMString contenant la couleur de fond des cellules. Il reflète l'attribut obsolète bgColor attribute.

HTMLTableRowElement.cells Lecture seule

Renvoie une HTMLCollection en direct contenant les cellules de la ligne. La HTMLCollection est active et est automatiquement mise à jour lorsque des cellules sont ajoutées ou supprimées.

HTMLTableRowElement.ch Obsolète

Est un DOMString contenant un seul caractère. Ce caractère est celui sur lequel aligner toutes les cellules d'une colonne. Il reflète char et par défaut les points décimaux associés à la langue, par exemple '.' pour l'anglais, ou ',' pour le français. Cette propriété était facultative et n'était pas très bien prise en charge.

HTMLTableRowElement.chOff Obsolète

Est un DOMString contenant un entier indiquant combien de caractère doivent être laissés à droite (pour les scripts de gauche à droite; ou à gauche pour les scripts de droite à gauche) du caractère défini par HTMLTableRowElement.ch. Cette propriété était facultative et n'était pas très bien prise en charge.

HTMLTableRowElement.rowIndex Lecture seule

Renvoie une valeur long qui donne la position logique de la ligne dans la table entière. Si la ligne ne fait pas partie d'une table, renvoie -1.

HTMLTableRowElement.sectionRowIndex Lecture seule

Renvoie une valeur long qui donne la position logique de la ligne dans la section de table à laquelle elle appartient. Si la ligne ne fait pas partie d'une section, renvoie -1.

HTMLTableRowElement.vAlign Obsolète

Est un DOMString représentant une valeur énumérée indiquant comment le contenu de la cellule doit être aligné verticalement. Il reflète l'attribut valign et peut avoir l'une des valeurs suivantes : "top", "middle", "bottom", ou "baseline".

Méthodes

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

HTMLTableRowElement.deleteCell()

Supprime la cellule à la position donnée dans la ligne. Si la position donnée est supérieure (ou égale car elle commence à zéro) au nombre de cellules dans la ligne, ou est inférieure à 0, elle déclenche une DOMException avec la valeur IndexSizeError.

HTMLTableRowElement.insertCell()

Insère une nouvelle cellule juste avant la position donnée dans la ligne. Si la position donnée n'est pas donnée ou est -1, elle ajoute la cellule à la ligne. Si la position donnée est supérieure (ou égale car elle commence à zéro) au nombre de cellules dans la ligne, ou est inférieure à -1, elle déclenche une DOMException avec la valeur IndexSizeError. Renvoie une référence à un HTMLTableCellElement [en-US].

Spécifications

Specification
HTML Standard
# htmltablerowelement

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

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