Dom HTML : Objet TableSection.insertRow

La méthode javascript insertRow

Définition

La méthode javascript insertRow(index) de l'objet TableSection du Document Object Model HTML (DOM HTML) permet de d'insérer une ligne (tr) dans d'une balise HTML ou XHTML THEAD, TFOOT, et TBODY.

Paramètres de insertRow

Paramètre

La méthode javascript insertCell(index) de l'objet Tr du Document Object Model HTML (DOM HTML) accepte comme paramètre :
- index valeur de type Number qui correspond à l'index (position) où l'on veut insérer la nouvelle cellule.
Si index vaut "-1" ou est égal au nombre de cellules, la nouvelle cellule s'ajoute à la fin.

Valeurs retournées de insertRow

Valeur retournée

La méthode javascript insertRow(index) de l'objet TableSection renvoit comme valeur un objet Tr qui correspond à la nouvelle ligne crée.

Exceptions de insertRow

Exception

La méthode javascript insertRow() de l'objet TableSection du Document Object Model HTML (DOM HTML) renvoit comme exception :
- INDEX_SIZE_ERR index est supérieur au nombre de rangées, ou si index est un numéro négatif autre que "-1".

Info Dom Level 1

Dans le Document Object Model Level 1, La méthode javascript insertRow() de l'objet TableSection renvoit aucune exception.