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 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 renvoie 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) renvoie 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 renvoie aucune exception.
La balise HTML et XHTML TD définit une cellule du tableau. La balise HTML et XHTML TD est contenu dans la balise HTML et XHTML <TR>. Exemple :<TABLE> ...[Voir]La balise HTML et XHTML TH définit une cellule titre du tableau, généralement située en dans la première ligne ou colonne du tableau. <TH> </TH> La ba...[Voir]La balise HTML et XHTML TR renferme les éléments descriptifs d'une ligne de tableau.<TR> </TR> La balise HTML et XHTML TR contient la balise HTML et ...[Voir]