From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/htmltableelement/caption/index.md | 42 +++--- files/fr/web/api/htmltableelement/index.md | 163 ++++++++------------- .../fr/web/api/htmltableelement/insertrow/index.md | 94 +++++------- 3 files changed, 119 insertions(+), 180 deletions(-) (limited to 'files/fr/web/api/htmltableelement') 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 --- -

{{ 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

- \ 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 --- -
- {{ ApiRef() }}
-

Interface de l'élément HTML Table

-

Les objets table exposent l'interface HTMLTableElement (traduction), qui fournit des propriétés et méthodes spécialisées (outre l'interface des objets 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
-
- caption renvoie la légende du tableau.
-
- table.tHead
-
- tHead renvoie l'en-tête du tableau.
-
- table.tFoot
-
- tFoot renvoie le pied du tableau.
-
- table.rows
-
- rows renvoie les lignes du tableau.
-
- table.tBodies
-
- tBodies renvoie les corps du tableau.
-
-
-
- table.align {{ Deprecated_inline() }}
-
- align obtient ou définit l'alignement du tableau.
-
- table.bgColor {{ Deprecated_inline() }}
-
- bgColor obtient ou définit la couleur de fond du tableau.
-
- table.border {{ Deprecated_inline() }}
-
- border obtient ou défini la bordure du tableau.
-
- table.cellPadding
-
- cellPadding obtient ou définit les marges internes ( - - padding - ) des cellules.
-
- table.cellSpacing
-
- cellSpacing obtient ou définit l'espace entre les cellules.
-
- table.frame
-
- frame spécifie les côtés du tableau ayant une bordure.
-
- table.rules
-
- rules spécifie les bordures intérieures visibles.
-
- table.summary
-
- summary obtient ou définit le résumé du tableau.
-
- table.width
-
- width obtient ou définit la largeur du tableau.
-
-

Méthodes

-
-
- table.createTHead
-
- createTHead crée un en-tête de tableau.
-
- table.deleteTHead
-
- deleteTHead retire l'en-tête du tableau.
-
- table.createTFoot
-
- createTFoot crée un pied de tableau.
-
- table.deleteTFoot
-
- deleteTFoot retire un pied de tableau.
-
- table.createCaption
-
- createCaption crée une nouvelle légende pour le tableau.
-
- table.deleteCaption
-
- deleteCaption retire la légende d'un tableau.
-
- table.insertRow
-
- insertRow insère une nouvelle ligne.
-
- table.deleteRow
-
- deleteRow retire une ligne.
-
+{{ 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 --- -
-

{{APIRef("HTML DOM")}}

+{{APIRef("HTML DOM")}} -

La méthode HTMLTableElement.insertRow() insère une nouvelle ligne dans la table et retourne une référence à la nouvelle ligne.

-
+La méthode **`HTMLTableElement.insertRow()`** insère une nouvelle ligne dans la table et retourne une référence à la nouvelle ligne. -

Syntaxe

+## Syntaxe -
var ligne = HTMLTableElement.insertRow(optionnel indice = -1);
+ var ligne = HTMLTableElement.insertRow(optionnel indice = -1); - +- [`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) ` -

Exemple

+## Exemple -
<table id="TableA">
-<tr>
-<td>Ancienne ligne supérieure</td>
-</tr>
-</table>
-<script type="text/javascript">
+```html
+
+
+
+
+
Ancienne ligne supérieure

+
+```
+
+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.                             |
 
-
Compatibilité des navigateurs

+## Compatibilité des navigateurs
 
-
{{Compat("api.HTMLTableElement")}}

+{{Compat("api.HTMLTableElement")}}
 
-
Voir aussi

+## Voir aussi
 
-
+- {{domxref("HTMLTableRowElement.insertCell()")}}
-- 
cgit v1.2.3-54-g00ecf