From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/htmltablerowelement/index.html | 99 +++++++++++++++++++ .../api/htmltablerowelement/insertcell/index.html | 105 +++++++++++++++++++++ 2 files changed, 204 insertions(+) create mode 100644 files/fr/web/api/htmltablerowelement/index.html create mode 100644 files/fr/web/api/htmltablerowelement/insertcell/index.html (limited to 'files/fr/web/api/htmltablerowelement') diff --git a/files/fr/web/api/htmltablerowelement/index.html b/files/fr/web/api/htmltablerowelement/index.html new file mode 100644 index 0000000000..323cd60902 --- /dev/null +++ b/files/fr/web/api/htmltablerowelement/index.html @@ -0,0 +1,99 @@ +--- +title: HTMLTableRowElement +slug: Web/API/HTMLTableRowElement +tags: + - API + - HTML DOM + - Interface + - Reference + - TopicStub +translation_of: Web/API/HTMLTableRowElement +--- +
{{ APIRef("HTML DOM") }}
+ +

L'interface HTMLTableRowElement fournit des propriétés et des méthodes spéciales (au-delà de l'interface {{domxref("HTMLElement")}} dont elle dispose également par héritage) pour manipuler la mise en page et la présentation des lignes dans un tableau HTML.

+ +

{{InheritanceDiagram(600, 120)}}

+ +

Propriétés

+ +

Hérite des propriétés de son parent, {{domxref("HTMLElement")}}.

+ +
+
{{domxref("HTMLTableRowElement.align")}} {{obsolete_inline}}
+
Est un {{domxref("DOMString")}} contenant une valeur énumérée reflétant l'attribut {{htmlattrxref("align", "tr")}}. Il indique l'alignement du contenu de l'élément par rapport au contexte environnant. Les valeurs possibles sont "left", "right", et "center".
+
{{domxref("HTMLTableRowElement.bgColor")}} {{obsolete_inline}}
+
Est un {{domxref("DOMString")}} contenant la couleur de fond des cellules. Il reflète l'attribut obsolète {{htmlattrxref("bgColor", "tr")}} attribute.
+
{{domxref("HTMLTableRowElement.cells")}} {{readonlyInline}}
+
Renvoie une {{domxref("HTMLCollection")}} en direct contenant les cellules de la ligne. La HTMLCollection est active et est automatiquement mise à jour lorsque des cellules sont ajoutées ou supprimées.
+
{{domxref("HTMLTableRowElement.ch")}} {{obsolete_inline}}
+
Est un {{domxref("DOMString")}} contenant un seul caractère. Ce caractère est celui sur lequel aligner toutes les cellules d'une colonne. Il reflète {{htmlattrxref("char", "tr")}} et par défaut les points décimaux associés à la langue, par exemple '.' pour l'anglais, ou ',' pour le français. Cette propriété était facultative et n'était pas très bien prise en charge.
+
{{domxref("HTMLTableRowElement.chOff")}} {{obsolete_inline}}
+
Est un {{domxref("DOMString")}} contenant un entier indiquant combien de caractère doivent être laissés à droite (pour les scripts de gauche à droite; ou à gauche pour les scripts de droite à gauche) du caractère défini par HTMLTableRowElement.ch. Cette propriété était facultative et n'était pas très bien prise en charge.
+
{{domxref("HTMLTableRowElement.rowIndex")}} {{readonlyInline}}
+
Renvoie une valeur long qui donne la position logique de la ligne dans la table entière. Si la ligne ne fait pas partie d'une table, renvoie -1.
+
{{domxref("HTMLTableRowElement.sectionRowIndex")}} {{readonlyInline}}
+
Renvoie une valeur long qui donne la position logique de la ligne dans la section de table à laquelle elle appartient. Si la ligne ne fait pas partie d'une section, renvoie -1.
+
{{domxref("HTMLTableRowElement.vAlign")}} {{obsolete_inline}}
+
Est un {{domxref("DOMString")}} représentant une valeur énumérée indiquant comment le contenu de la cellule doit être aligné verticalement. Il reflète l'attribut {{htmlattrxref("valign", "tr")}} et peut avoir l'une des valeurs suivantes : "top", "middle", "bottom", ou "baseline".
+
+ +

Méthodes

+ +

Hérite des méthodes de son parent, {{domxref("HTMLElement")}}.

+ +
+
{{domxref("HTMLTableRowElement.deleteCell()")}}
+
Supprime la cellule à la position donnée dans la ligne. Si la position donnée est supérieure (ou égale car elle commence à zéro) au nombre de cellules dans la ligne, ou est inférieure à 0, elle déclenche une {{domxref("DOMException")}} avec la valeur IndexSizeError.
+
{{domxref("HTMLTableRowElement.insertCell()")}}
+
Insère une nouvelle cellule juste avant la position donnée dans la ligne. Si la position donnée n'est pas donnée ou est -1, elle ajoute la cellule à la ligne. Si la position donnée est supérieure (ou égale car elle commence à zéro) au nombre de cellules dans la ligne, ou est inférieure à -1, elle déclenche une {{domxref("DOMException")}} avec la valeur IndexSizeError. Renvoie une référence à un HTMLTableCellElement [en-US].
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommantaire
{{SpecName('HTML WHATWG', "#htmltablerowelement", "HTMLTableRowElement")}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', "tabular-data.html#the-tr-element", "HTMLTableRowElement")}}{{Spec2('HTML5 W3C')}}Le paramètre de insertCell est désormais facultatif et vaut par défaut -1.
{{SpecName('DOM2 HTML', 'html.html#ID-6986576', 'HTMLTableRowElement')}}{{Spec2('DOM2 HTML')}}Les propriétés cells, rowIndex, et selectionRowIndex sont désormais en lecture seule.
+ Les méthodes insertCell et deleteCell peuvent déclencher des exceptions.
{{SpecName('DOM1', 'level-one-html.html#ID-6986576', 'HTMLTableRowElement')}}{{Spec2('DOM1')}}Défintion initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.HTMLTableRowElement")}}

+ +

Voir aussi

+ + + +
+
+
diff --git a/files/fr/web/api/htmltablerowelement/insertcell/index.html b/files/fr/web/api/htmltablerowelement/insertcell/index.html new file mode 100644 index 0000000000..e4c064e2cc --- /dev/null +++ b/files/fr/web/api/htmltablerowelement/insertcell/index.html @@ -0,0 +1,105 @@ +--- +title: HTMLTableRowElement.insertCell() +slug: Web/API/HTMLTableRowElement/insertCell +translation_of: Web/API/HTMLTableRowElement/insertCell +--- +
{{APIRef("HTML DOM")}}
+ +

La méthode HTMLTableRowElement.insertCell() insère une nouvelle cellule ({{HtmlElement("td")}}) dans une ligne de tableau ({{HtmlElement("tr")}}) et renvoie une référence sur cette cellule.

+ +
+

Note : insertCell() insère la cellule directement dans la ligne. La cellule n’a pas besoin d’être ajoutée séparément comme cela serait le cas si {{domxref("Document.createElement()")}} avait été utilisé pour créer le nouvel élément <td>.

+
+ +

Syntaxe

+ +
var newCell = HTMLTableRowElement.insertCell(index);
+
+ +

{{domxref("HTMLTableRowElement")}} est une référence sur un élément HTML {{HtmlElement("tr")}}.

+ +

Paramètres

+ +
+
index {{optional_inline}}
+
index est l’index de cellule de la nouvelle cellule. Si index est -1 ou égal au nombre actuel de cellules, la nouvelle cellule est ajoutée à la fin la ligne. Si index est supérieur au nombre de cellules, une exception IndexSizeError sera levée. Si index est omis, la valeur sera -1 par défaut.
+
+ +

Valeur de retour

+ +

newCell est une {{domxref("HTMLTableCellElement")}} qui fait référence à la nouvelle cellule.

+ +

Exemple

+ +

Cet exemple utilise {{domxref("HTMLTableElement.insertRow()")}} pour ajouter une nouvelle ligne à une table.

+ +

Nous utilisons ensuite insertCell(0) pour insérer une nouvelle cellule dans la nouvelle ligne (pour être du HTML valide, un <tr> doit avoir au moins un élément <td>). Enfin, nous ajoutons du texte à la cellule en utilisant {{domxref("Document.createTextNode()")}} et {{domxref("Node.appendChild()")}}.

+ +

HTML

+ +
<table id="my-table">
+  <tr><td>Row 1</td></tr>
+  <tr><td>Row 2</td></tr>
+  <tr><td>Row 3</td></tr>
+</table>
+ +

JavaScript

+ +
function addRow(tableID) {
+  // Obtient une référence sur la table
+  let tableRef = document.getElementById(tableID);
+
+  // Insère une ligne à la fin de la table
+  let newRow = tableRef.insertRow(-1);
+
+  // Insère une cellule dans la ligne à l’index 0
+  let newCell = newRow.insertCell(0);
+
+  // Ajoute un nœud texte à la cellule
+  let newText = document.createTextNode('New bottom row');
+  newCell.appendChild(newText);
+}
+
+// Appelle addRow() avec l’ID de la table
+addRow('my-table');
+ +

Résultat

+ +

{{EmbedLiveSample("Example")}}

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("HTML WHATWG", "tables.html#dom-tr-insertcell", "HTMLTableRowElement.insertCell()")}}{{Spec2("HTML WHATWG")}} 
{{SpecName("DOM2 HTML", "html.html#ID-68927016", "HTMLTableRowElement.insertCell()")}}{{Spec2("DOM2 HTML")}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.HTMLTableRowElement.insertCell")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf