L'interfaceHTMLTableRowElement fournit des propriétés et des méthodes spéciales (au-delà de l'interfaceHTMLElement 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.cellsLecture seule

Retourne une collection (HTMLCollection) dynamique contenant les cellules de la ligne. LaHTMLCollection est dynamique et se met automatiquement à jour lorsque des cellules sont ajoutées ou supprimées.

HTMLTableRowElement.rowIndexLecture 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.sectionRowIndexLecture 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. Siindex vaut-1, la dernière cellule de la ligne est supprimée. Siindex est inférieur à-1 ou supérieur au nombre de cellules dans la collection, uneDOMException avec la valeurIndexSizeError est levée.

HTMLTableRowElement.insertCell()

Retourne un objetHTMLTableCellElement représentant une nouvelle cellule de la ligne. La cellule est insérée dans la collection de cellules juste avant la positionindex donnée dans la ligne. Siindex vaut-1, la nouvelle cellule est ajoutée à la fin de la collection. Siindex est inférieur à-1 ou supérieur au nombre de cellules dans la collection, uneDOMException avec la valeurIndexSizeError est levée.

Propriétés obsolètes

HTMLTableRowElement.alignObsolète

Une chaîne de caractères contenant une valeur énumérée reflétant l'attributalign. Elle indique l'alignement du contenu de l'élément par rapport au contexte environnant. Les valeurs possibles sont"left","right" et"center".

HTMLTableRowElement.bgColorObsolète

Une chaîne de caractères contenant la couleur d'arrière-plan des cellules. Elle reflète l'attribut obsolètebgColor.

HTMLTableRowElement.chObsolè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'attributchar 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.chOffObsolè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 parHTMLTableRowElement.ch. Cette propriété était optionnelle et peu prise en charge.

HTMLTableRowElement.vAlignObsolè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'attributvalign et peut avoir l'une des valeurs suivantes :"top","middle","bottom" ou"baseline".

Spécifications

Compatibilité des navigateurs

Voir aussi

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