diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-02 17:20:24 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-02 17:30:20 +0200 |
commit | 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch) | |
tree | 30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/htmltableelement/insertrow/index.md | |
parent | c05efa8d7ae464235cf83d7c0956e42dc6974103 (diff) | |
download | translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2 translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip |
convert content to md
Diffstat (limited to 'files/fr/web/api/htmltableelement/insertrow/index.md')
-rw-r--r-- | files/fr/web/api/htmltableelement/insertrow/index.md | 94 |
1 files changed, 35 insertions, 59 deletions
diff --git a/files/fr/web/api/htmltableelement/insertrow/index.md b/files/fr/web/api/htmltableelement/insertrow/index.md index f07140adda..6309720d21 100644 --- a/files/fr/web/api/htmltableelement/insertrow/index.md +++ b/files/fr/web/api/htmltableelement/insertrow/index.md @@ -10,33 +10,29 @@ tags: - Reference translation_of: Web/API/HTMLTableElement/insertRow --- -<div> -<p>{{APIRef("HTML DOM")}}</p> +{{APIRef("HTML DOM")}} -<p>La méthode <strong><code>HTMLTableElement.insertRow()</code></strong> insère une nouvelle ligne dans la table et retourne une référence à la nouvelle ligne.</p> -</div> +La méthode **`HTMLTableElement.insertRow()`** insère une nouvelle ligne dans la table et retourne une référence à la nouvelle ligne. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <em>ligne</em> = <em>HTMLTableElement</em>.insertRow(<em>optionnel indice = -1</em>);</pre> + var ligne = HTMLTableElement.insertRow(optionnel indice = -1); -<ul> - <li><a href="/en-US/docs/DOM/HTMLTableElement"><code>HTMLTableElement</code></a> est une référence à un élément table HTML.</li> - <li><code>indice</code> est l'indice de ligne de la nouvelle ligne.</li> - <li><code>ligne</code> reçoit la référence à la nouvelle ligne. Une référence à un <a href="/en-US/docs/Web/API/HTMLTableRowElement">HTMLTableRowElement</a>. Si l'indice est -1 ou est égal au nombre de lignes, la ligne est ajoutée comme dernière ligne. Si <code>indice</code> est 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.</li> - <li>Si une table a plusieurs éléments <code>tbody</code>, par défaut, la nouvelle ligne est ajoutée dans le dernier <code>tbody</code>. Pour insérer la ligne dans un <code>tbody</code> particulier :<br> - <code>var <em>tbody_particulier</em></code><code>=document.getElementById(<em>id_tbody</em>);<br> - var <em>ligne</em>=tbody_particulier.</code><code>insertRow(<em>indice</em>)</code></li> -</ul> +- [`HTMLTableElement`](/en-US/docs/DOM/HTMLTableElement) est une référence à un élément table HTML. +- `indice` est l'indice de ligne de la nouvelle ligne. +- `ligne` reçoit la référence à la nouvelle ligne. Une référence à un [HTMLTableRowElement](/en-US/docs/Web/API/HTMLTableRowElement). Si l'indice est -1 ou est égal au nombre de lignes, la ligne est ajoutée comme dernière ligne. Si `indice` est 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 dernier `tbody`. Pour insérer la ligne dans un `tbody` particulier : + ` var tbody_particulier``=document.getElementById(id_tbody); var ligne=tbody_particulier.``insertRow(indice) ` -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:html"><table id="TableA"> -<tr> -<td>Ancienne ligne supérieure</td> -</tr> -</table> -<script type="text/javascript"> +```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 @@ -56,45 +52,25 @@ function ajouteLigne(tableID) { // Appelle ajouteLigne() avec l'ID d'une table ajouteLigne('TableA'); -</script></pre> - -<p>Pour être valide dans un document HTML, un élément TR doit avoir au moins un élément TD.</p> - -<p>Remarquez que <code>insertRow</code> 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 <code><a href="/en-US/docs/DOM/document.createElement">document.createElement()</a></code> avait été utilisé pour créer un nouvel élement TR.</p> - -<h2 id="Spécifications">Spécifications</h2> - -<table> - <tbody> - <tr> - <th>Spécification</th> - <th>Statut</th> - <th>Commentaire</th> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "tables.html#dom-table-insertrow", "HTMLTableElement.insertRow()")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("DOM2 HTML", "html.html#ID-93995626", "HTMLTableElement.insertRow()")}}</td> - <td>{{Spec2("DOM2 HTML")}}</td> - <td>Spécifie plus en détail où la ligne est insérée.</td> - </tr> - <tr> - <td>{{SpecName("DOM1", "level-one-html.html#ID-39872903", "HTMLTableElement.insertRow()")}}</td> - <td>{{Spec2("DOM1")}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +</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()`](/en-US/docs/DOM/document.createElement) avait été utilisé pour créer un nouvel élement TR. + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------ | +| {{SpecName("HTML WHATWG", "tables.html#dom-table-insertrow", "HTMLTableElement.insertRow()")}} | {{Spec2("HTML WHATWG")}} | | +| {{SpecName("DOM2 HTML", "html.html#ID-93995626", "HTMLTableElement.insertRow()")}} | {{Spec2("DOM2 HTML")}} | Spécifie plus en détail où la ligne est insérée. | +| {{SpecName("DOM1", "level-one-html.html#ID-39872903", "HTMLTableElement.insertRow()")}} | {{Spec2("DOM1")}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.HTMLTableElement")}}</p> +{{Compat("api.HTMLTableElement")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("HTMLTableRowElement.insertCell()")}}</li> -</ul> +- {{domxref("HTMLTableRowElement.insertCell()")}} |