table.insertRow
La méthode HTMLTableElement.insertRow() insère une nouvelle ligne dans la table et retourne une référence à la nouvelle ligne.
Syntaxe
js
var ligne = HTMLTableElement.insertRow(optionnel indice = -1);
- HTMLTableElementest une référence à un élément table HTML.
- indiceest l'indice de ligne de la nouvelle ligne.
- lignereçoit la référence à la nouvelle ligne. Une référence à un HTMLTableRowElement. Si l'indice est -1 ou est égal au nombre de lignes, la ligne est ajoutée comme dernière ligne. Si- indiceest plus grand que le nombre de lignes, une exception IndexSizeError sera générée. Si indice est omis, sa valeur sera -1 par défaut.
- Si une table a plusieurs éléments tbody, par défaut, la nouvelle ligne est ajoutée dans le derniertbody. Pour insérer la ligne dans untbodyparticulier :
js
var tbody_particulier = document.getElementById(id_tbody);
var ligne = tbody_particulier.insertRow(indice)
Exemple
html
<table id="TableA">
<tr>
<td>Ancienne ligne supérieure</td>
</tr>
</table>
<script type="text/javascript">
function ajouteLigne(tableID) {
  // Récupération d'une référence à la table
  var refTable = document.getElementById(tableID);
  // Insère une ligne dans la table à l'indice de ligne 0
  var nouvelleLigne = refTable.insertRow(0);
  // Insère une cellule dans la ligne à l'indice 0
  var nouvelleCellule = nouvelleLigne.insertCell(0);
  // Ajoute un nœud texte à la cellule
  var nouveauTexte = document.createTextNode('Nouvelle ligne supérieure')
  nouvelleCellule.appendChild(nouveauTexte);
}
// Appelle ajouteLigne() avec l'ID d'une table
ajouteLigne('TableA');
</script>
Pour être valide dans un document HTML, un élément TR doit avoir au moins un élément TD.
Remarquez que insertRow insère directement la ligne dans la table et renvoie une référence à la nouvelle ligne. La ligne n'a pas besoin d'être ajoutée séparement comme cela aurait été le cas si document.createElement() avait été utilisé pour créer un nouvel élement TR.
Spécifications
| Specification | 
|---|
| HTML Standard # dom-table-insertrow-dev | 
Compatibilité des navigateurs
BCD tables only load in the browser