diff options
Diffstat (limited to 'files/fr/web/api/htmltableelement')
| -rw-r--r-- | files/fr/web/api/htmltableelement/caption/index.md | 42 | ||||
| -rw-r--r-- | files/fr/web/api/htmltableelement/index.md | 163 | ||||
| -rw-r--r-- | files/fr/web/api/htmltableelement/insertrow/index.md | 94 |
3 files changed, 119 insertions, 180 deletions
diff --git a/files/fr/web/api/htmltableelement/caption/index.md b/files/fr/web/api/htmltableelement/caption/index.md index b7c559b5a8..68308f7596 100644 --- a/files/fr/web/api/htmltableelement/caption/index.md +++ b/files/fr/web/api/htmltableelement/caption/index.md @@ -5,21 +5,27 @@ tags: - Référence_du_DOM_Gecko translation_of: Web/API/HTMLTableElement/caption --- -<p>{{ ApiRef() }}</p> -<h3 id="R.C3.A9sum.C3.A9">Résumé</h3> -<p><b>caption</b> renvoie la légende du tableau.</p> -<h3 id="Syntaxe">Syntaxe</h3> -<pre class="eval"><i>string</i> = table.caption -</pre> -<h3 id="Exemple">Exemple</h3> -<pre class="eval">if (table.caption) { - // On peut alors faire quelque chose avec la légende du tableau -} -</pre> -<h3 id="Notes">Notes</h3> -<p>Cette propriété ne renvoie rien s'il n'y a aucune légende pour le tableau.</p> -<h3 id="Sp.C3.A9cification">Spécification</h3> -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-14594520">DOM Level 2 HTML : caption</a> <small>(<a href="http://www.yoyodesign.org/doc/w3c/dom2-html/html.html#ID-14594520">traduction</a>)</small></li> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-12035137">Interface HTMLTableCaptionElement</a> <small>(<a href="http://www.yoyodesign.org/doc/w3c/dom2-html/html.html#ID-12035137">traduction</a>)</small></li> -</ul>
\ No newline at end of file +{{ ApiRef() }} + +### Résumé + +**caption** renvoie la légende du tableau. + +### Syntaxe + + string = table.caption + +### Exemple + + if (table.caption) { + // On peut alors faire quelque chose avec la légende du tableau + } + +### Notes + +Cette propriété ne renvoie rien s'il n'y a aucune légende pour le tableau. + +### Spécification + +- [DOM Level 2 HTML : caption](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-14594520) ([traduction](http://www.yoyodesign.org/doc/w3c/dom2-html/html.html#ID-14594520)) +- [Interface HTMLTableCaptionElement](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-12035137) ([traduction](http://www.yoyodesign.org/doc/w3c/dom2-html/html.html#ID-12035137)) diff --git a/files/fr/web/api/htmltableelement/index.md b/files/fr/web/api/htmltableelement/index.md index e14d2f1f47..a4bb7c3b3e 100644 --- a/files/fr/web/api/htmltableelement/index.md +++ b/files/fr/web/api/htmltableelement/index.md @@ -5,106 +5,63 @@ tags: - Référence_du_DOM_Gecko translation_of: Web/API/HTMLTableElement --- -<div> - {{ ApiRef() }}</div> -<h2 id="Interface_de_l.27.C3.A9l.C3.A9ment_HTML_Table">Interface de l'élément HTML Table</h2> -<p>Les objets <code>table</code> exposent l'interface <a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-64060425"><code>HTMLTableElement</code></a> <small>(<a href="http://www.yoyodesign.org/doc/w3c/dom2-html/html.html#ID-64060425">traduction</a>)</small>, qui fournit des propriétés et méthodes spécialisées (outre l'interface des objets <a href="/fr/docs/DOM/element">element</a> qu'ils acquièrent également par héritage) pour manipuler la disposition et la présentation des tableaux en HTML.</p> -<h2 id="Propri.C3.A9t.C3.A9s">Propriétés</h2> -<dl> - <dt> - <a href="/fr/docs/DOM/table.caption">table.caption</a></dt> - <dd> - <b>caption</b> renvoie la légende du tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.tHead">table.tHead</a></dt> - <dd> - <b>tHead</b> renvoie l'en-tête du tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.tFoot">table.tFoot</a></dt> - <dd> - <b>tFoot</b> renvoie le pied du tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.rows">table.rows</a></dt> - <dd> - <b>rows</b> renvoie les lignes du tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.tBodies">table.tBodies</a></dt> - <dd> - <b>tBodies</b> renvoie les corps du tableau.</dd> -</dl> -<dl> - <dt> - <a href="/fr/docs/DOM/table.align">table.align</a> {{ Deprecated_inline() }}</dt> - <dd> - <b>align</b> obtient ou définit l'alignement du tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.bgColor">table.bgColor</a> {{ Deprecated_inline() }}</dt> - <dd> - <b>bgColor</b> obtient ou définit la couleur de fond du tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.border">table.border</a> {{ Deprecated_inline() }}</dt> - <dd> - <b>border</b> obtient ou défini la bordure du tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.cellPadding">table.cellPadding</a></dt> - <dd> - <b>cellPadding</b> obtient ou définit les marges internes ( - <i> - padding</i> - ) des cellules.</dd> - <dt> - <a href="/fr/docs/DOM/table.cellSpacing">table.cellSpacing</a></dt> - <dd> - <b>cellSpacing</b> obtient ou définit l'espace entre les cellules.</dd> - <dt> - <a href="/fr/docs/DOM/table.frame">table.frame</a></dt> - <dd> - <b>frame</b> spécifie les côtés du tableau ayant une bordure.</dd> - <dt> - <a href="/fr/docs/DOM/table.rules">table.rules</a></dt> - <dd> - <b>rules</b> spécifie les bordures intérieures visibles.</dd> - <dt> - <a href="/fr/docs/DOM/table.summary">table.summary</a></dt> - <dd> - <b>summary</b> obtient ou définit le résumé du tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.width">table.width</a></dt> - <dd> - <b>width</b> obtient ou définit la largeur du tableau.</dd> -</dl> -<h2 id="M.C3.A9thodes">Méthodes</h2> -<dl> - <dt> - <a href="/fr/docs/DOM/table.createTHead">table.createTHead</a></dt> - <dd> - <b>createTHead</b> crée un en-tête de tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.deleteTHead">table.deleteTHead</a></dt> - <dd> - <b>deleteTHead</b> retire l'en-tête du tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.createTFoot">table.createTFoot</a></dt> - <dd> - <b>createTFoot</b> crée un pied de tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.deleteTFoot">table.deleteTFoot</a></dt> - <dd> - <b>deleteTFoot</b> retire un pied de tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.createCaption">table.createCaption</a></dt> - <dd> - <b>createCaption</b> crée une nouvelle légende pour le tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.deleteCaption">table.deleteCaption</a></dt> - <dd> - <b>deleteCaption</b> retire la légende d'un tableau.</dd> - <dt> - <a href="/fr/docs/DOM/table.insertRow">table.insertRow</a></dt> - <dd> - <b>insertRow</b> insère une nouvelle ligne.</dd> - <dt> - <a href="/fr/docs/DOM/table.deleteRow">table.deleteRow</a></dt> - <dd> - <b>deleteRow</b> retire une ligne.</dd> -</dl> +{{ ApiRef() }} + +## Interface de l'élément HTML Table + +Les objets `table` exposent l'interface [`HTMLTableElement`](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-64060425) ([traduction](http://www.yoyodesign.org/doc/w3c/dom2-html/html.html#ID-64060425)), qui fournit des propriétés et méthodes spécialisées (outre l'interface des objets [element](/fr/docs/DOM/element) qu'ils acquièrent également par héritage) pour manipuler la disposition et la présentation des tableaux en HTML. + +## Propriétés + +- [table.caption](/fr/docs/DOM/table.caption) + - : **caption** renvoie la légende du tableau. +- [table.tHead](/fr/docs/DOM/table.tHead) + - : **tHead** renvoie l'en-tête du tableau. +- [table.tFoot](/fr/docs/DOM/table.tFoot) + - : **tFoot** renvoie le pied du tableau. +- [table.rows](/fr/docs/DOM/table.rows) + - : **rows** renvoie les lignes du tableau. +- [table.tBodies](/fr/docs/DOM/table.tBodies) + - : **tBodies** renvoie les corps du tableau. + +<!----> + +- [table.align](/fr/docs/DOM/table.align) {{ Deprecated_inline() }} + - : **align** obtient ou définit l'alignement du tableau. +- [table.bgColor](/fr/docs/DOM/table.bgColor) {{ Deprecated_inline() }} + - : **bgColor** obtient ou définit la couleur de fond du tableau. +- [table.border](/fr/docs/DOM/table.border) {{ Deprecated_inline() }} + - : **border** obtient ou défini la bordure du tableau. +- [table.cellPadding](/fr/docs/DOM/table.cellPadding) + - : **cellPadding** obtient ou définit les marges internes ( + _padding_ + ) des cellules. +- [table.cellSpacing](/fr/docs/DOM/table.cellSpacing) + - : **cellSpacing** obtient ou définit l'espace entre les cellules. +- [table.frame](/fr/docs/DOM/table.frame) + - : **frame** spécifie les côtés du tableau ayant une bordure. +- [table.rules](/fr/docs/DOM/table.rules) + - : **rules** spécifie les bordures intérieures visibles. +- [table.summary](/fr/docs/DOM/table.summary) + - : **summary** obtient ou définit le résumé du tableau. +- [table.width](/fr/docs/DOM/table.width) + - : **width** obtient ou définit la largeur du tableau. + +## Méthodes + +- [table.createTHead](/fr/docs/DOM/table.createTHead) + - : **createTHead** crée un en-tête de tableau. +- [table.deleteTHead](/fr/docs/DOM/table.deleteTHead) + - : **deleteTHead** retire l'en-tête du tableau. +- [table.createTFoot](/fr/docs/DOM/table.createTFoot) + - : **createTFoot** crée un pied de tableau. +- [table.deleteTFoot](/fr/docs/DOM/table.deleteTFoot) + - : **deleteTFoot** retire un pied de tableau. +- [table.createCaption](/fr/docs/DOM/table.createCaption) + - : **createCaption** crée une nouvelle légende pour le tableau. +- [table.deleteCaption](/fr/docs/DOM/table.deleteCaption) + - : **deleteCaption** retire la légende d'un tableau. +- [table.insertRow](/fr/docs/DOM/table.insertRow) + - : **insertRow** insère une nouvelle ligne. +- [table.deleteRow](/fr/docs/DOM/table.deleteRow) + - : **deleteRow** retire une ligne. 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()")}} |