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
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
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
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
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
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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
HTMLTableRowElementChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
align
ObsolèteNon-standard
Chrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
bgColor
ObsolèteNon-standard
Chrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
cellsChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
ch
Obsolète
Chrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
chOff
Obsolète
Chrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
deleteCellChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
insertCellChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
rowIndexChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
sectionRowIndexChrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
vAlign
ObsolèteNon-standard
Chrome Support complet OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.

Voir aussi

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