HTMLTableRowElement

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 This is an obsolete API and is no longer guaranteed to work.

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 This is an obsolete API and is no longer guaranteed to work.

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 This is an obsolete API and is no longer guaranteed to work.

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 This is an obsolete API and is no longer guaranteed to work.

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 (en-US) 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 This is an obsolete API and is no longer guaranteed to work.

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

Spécification Statut Commantaire
HTML Living Standard
La définition de 'HTMLTableRowElement' dans cette spécification.
Standard évolutif
HTML5
La définition de 'HTMLTableRowElement' dans cette spécification.
Recommendation Le paramètre de insertCell est désormais facultatif et vaut par défaut -1.
Document Object Model (DOM) Level 2 HTML Specification
La définition de 'HTMLTableRowElement' dans cette spécification.
Obsolete Les propriétés cells, rowIndex, et selectionRowIndex sont désormais en lecture seule. Les méthodes insertCell et deleteCell peuvent déclencher des exceptions.
Document Object Model (DOM) Level 1 Specification
La définition de 'HTMLTableRowElement' dans cette spécification.
Obsolete Défintion initiale.

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

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