Dom HTML : Objet Tr.insertCell

La méthode javascript insertCell

Définition

La méthode javascript insertCell(index) de l'objet Tr du Document Object Model HTML (DOM HTML) permet de insérer une cellule (td,th) d'une balise HTML ou XHTML TR (de la rangée).

Paramètres de insertCell

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 insertCell

Valeur retournée

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

Exceptions de insertCell

Exception

La méthode javascript insertCell() de l'objet Tr du Document Object Model HTML (DOM HTML) renvoit comme exception :
- INDEX_SIZE_ERR l'index spécifié est supérieur au nombre des cellules, ou l'index est un nombre négatif autre que "-1".

Info Dom Level 1

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