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/document | |
| 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/document')
111 files changed, 4243 insertions, 5982 deletions
diff --git a/files/fr/web/api/document/activeelement/index.md b/files/fr/web/api/document/activeelement/index.md index 2b09fac218..89a9f037c9 100644 --- a/files/fr/web/api/document/activeelement/index.md +++ b/files/fr/web/api/document/activeelement/index.md @@ -7,15 +7,20 @@ translation_of: Web/API/DocumentOrShadowRoot/activeElement translation_of_original: Web/API/Document/activeElement original_slug: Web/API/DocumentOrShadowRoot/activeElement --- -<p>{{ ApiRef() }}</p> -<h3 id="R.C3.A9sum.C3.A9">Résumé</h3> -<p>Renvoie l'élément qui dispose actuellement du focus.</p> -<p>{{ Note("Cet attribut fait partie de la spécification HTML 5 encore en développement.") }}</p> -<h3 id="Syntaxe">Syntaxe</h3> -<pre class="eval">var elemCourant = document.activeElement; -</pre> -<h3 id="Exemple">Exemple</h3> -<h3 id="Sp.C3.A9cification">Spécification</h3> -<ul> - <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#focus-management">Focus management</a> (brouillon de travail HTML 5)</li> -</ul>
\ No newline at end of file +{{ ApiRef() }} + +### Résumé + +Renvoie l'élément qui dispose actuellement du focus. + +{{ Note("Cet attribut fait partie de la spécification HTML 5 encore en développement.") }} + +### Syntaxe + + var elemCourant = document.activeElement; + +### Exemple + +### Spécification + +- [Focus management](http://www.whatwg.org/specs/web-apps/current-work/#focus-management) (brouillon de travail HTML 5) diff --git a/files/fr/web/api/document/adoptnode/index.md b/files/fr/web/api/document/adoptnode/index.md index 3c5270aa80..e4070ea67c 100644 --- a/files/fr/web/api/document/adoptnode/index.md +++ b/files/fr/web/api/document/adoptnode/index.md @@ -10,59 +10,50 @@ tags: - Propriétaire translation_of: Web/API/Document/adoptNode --- -<div>{{ ApiRef("DOM") }}</div> +{{ ApiRef("DOM") }} -<div> </div> +Adopte un noeud. Le noeud (et son sous-arbre) est supprimé du document dans lequel il se trouve (le cas échéant) et son [`ownerDocument`](/fr/docs/Web/API/Node/ownerDocument) (_document propriétaire_) est remplacé par le document en cours. Le noeud peut ensuite être inséré dans le document en cours. -<p>Adopte un noeud. Le noeud (et son sous-arbre) est supprimé du document dans lequel il se trouve (le cas échéant) et son <code><a href="/fr/docs/Web/API/Node/ownerDocument">ownerDocument</a></code> (<em>document propriétaire</em>) est remplacé par le document en cours. Le noeud peut ensuite être inséré dans le document en cours.</p> +**Pris en charge depuis Gecko 1.9 (Firefox 3)** -<p><strong>Pris en charge depuis Gecko 1.9 (Firefox 3)</strong></p> +## Syntaxe -<h2 id="Syntax">Syntaxe</h2> + node = document.adoptNode(externalNode); -<pre><var>node</var> = <em>document</em>.adoptNode(<var>externalNode</var>); -</pre> +- ` node` + - : est le noeud adopté qui a maintenant ce document en tant que son [`ownerDocument`](/en-US/docs/DOM/Node.ownerDocument) (_document propriétaire_). Le [`parentNode`](/en-US/docs/DOM/Node.parentNode) du noeud est `null`, car il n'a pas encore été inséré dans l'arborescence du document. Notez que `node` et `externalNode` sont le même objet après cet appel. +- `externalNode` + - : est le noeud à adopter existant dans un autre document. -<dl> - <dt><code> node</code></dt> - <dd>est le noeud adopté qui a maintenant ce document en tant que son <code><a href="/en-US/docs/DOM/Node.ownerDocument">ownerDocument</a></code> (<em>document propriétaire</em>). Le <a href="/en-US/docs/DOM/Node.parentNode"><code>parentNode</code></a> du noeud est <code>null</code>, car il n'a pas encore été inséré dans l'arborescence du document. Notez que <code>node</code> et <code>externalNode</code> sont le même objet après cet appel. </dd> - <dt><code>externalNode</code></dt> - <dd>est le noeud à adopter existant dans un autre document.</dd> -</dl> +## Exemple -<h2 id="Example">Exemple</h2> - -<pre class="brush: js">var iframe = document.getElementById('my-iframe'); +```js +var iframe = document.getElementById('my-iframe'); var iframeImages = iframe.contentDocument.getElementsByTagName('img'); var newParent = document.getElementByTagName('images'); -for (var i = 0; i < iframeImages.length; i++) { +for (var i = 0; i < iframeImages.length; i++) { newParent.appendChild(document.adoptNode(iframeImages[i])); } -</pre> - -<h2 id="Notes">Notes</h2> +``` -<p>En général l'appel de <code>adoptNode</code> peut échouer en raison du nœud source provenant d'une implémentation différente, mais cela ne devrait pas poser de problème avec les implémentations du navigateur.</p> +## Notes -<p></p><p>Les nœuds provenant de documents externes doivent être clonés à l'aide de <a href="/fr/docs/Web/API/Document/importNode"><code>document.importNode()</code></a> (ou adoptés avec - <a href="/fr/docs/Web/API/Document/adoptNode"><code>document.adoptNode()</code></a>) avant de pouvoir être insérés dans le document courant. Pour en savoir plus sur les problèmes - de <a href="/fr/docs/Web/API/Node/ownerDocument"><code>Node.ownerDocument</code></a>, consultez la <a href="http://www.w3.org/DOM/faq.html#ownerdoc" rel="noopener">FAQ DOM du W3C</a> (en anglais).</p> +En général l'appel de `adoptNode` peut échouer en raison du nœud source provenant d'une implémentation différente, mais cela ne devrait pas poser de problème avec les implémentations du navigateur. - <p>Gecko n'obligeait pas à utiliser <a href="/fr/docs/Web/API/Document/importNode"><code>document.importNode()</code></a> et <a href="/fr/docs/Web/API/Document/adoptNode"><code>document.adoptNode()</code></a> avant sa version 1.9. Depuis les versions 1.9 - alphas, si un nœud n'est pas adopté ou importé avant d'être utilisé dans un autre document, l'exception - <code>WRONG_DOCUMENT_ERR</code> est déclenchée (<code>NS_ERROR_DOM_WRONG_DOCUMENT_ERR</code>). implémentation dans le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=47903" rel="noopener">bug 47903</a>.</p><p></p> +Les nœuds provenant de documents externes doivent être clonés à l'aide de [`document.importNode()`](/fr/docs/Web/API/Document/importNode) (ou adoptés avec +[`document.adoptNode()`](/fr/docs/Web/API/Document/adoptNode)) avant de pouvoir être insérés dans le document courant. Pour en savoir plus sur les problèmes +de [`Node.ownerDocument`](/fr/docs/Web/API/Node/ownerDocument), consultez la [FAQ DOM du W3C](http://www.w3.org/DOM/faq.html#ownerdoc) (en anglais). +Gecko n'obligeait pas à utiliser [`document.importNode()`](/fr/docs/Web/API/Document/importNode) et [`document.adoptNode()`](/fr/docs/Web/API/Document/adoptNode) avant sa version 1.9. Depuis les versions 1.9 +alphas, si un nœud n'est pas adopté ou importé avant d'être utilisé dans un autre document, l'exception +`WRONG_DOCUMENT_ERR` est déclenchée (`NS_ERROR_DOM_WRONG_DOCUMENT_ERR`). implémentation dans le [bug 47903](https://bugzilla.mozilla.org/show_bug.cgi?id=47903). -<h2 id="Specification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#Document3-adoptNode">DOM Level 3 Core: Document.adoptNode</a></li> -</ul> +- [DOM Level 3 Core: Document.adoptNode](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Document3-adoptNode) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/en-US/docs/DOM/document.importNode">document.importNode</a></li> -</ul> +- [document.importNode](/en-US/docs/DOM/document.importNode) diff --git a/files/fr/web/api/document/alinkcolor/index.md b/files/fr/web/api/document/alinkcolor/index.md index 5f8b845548..fcec44ba01 100644 --- a/files/fr/web/api/document/alinkcolor/index.md +++ b/files/fr/web/api/document/alinkcolor/index.md @@ -9,28 +9,27 @@ tags: - Reference translation_of: Web/API/Document/alinkColor --- -<div>{{APIRef("DOM")}}{{Deprecated_header}}</div> +{{APIRef("DOM")}}{{Deprecated_header}} -<p>Retourne ou définit la couleur d'un lien actif dans le corps du document. Un lien hypertexte est actif durant le temps entre les événements <code>mousedown</code> et <code>mouseup</code>.</p> +Retourne ou définit la couleur d'un lien actif dans le corps du document. Un lien hypertexte est actif durant le temps entre les événements `mousedown` et `mouseup`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <var>color</var> = <var>document</var>.alinkColor; -<var>document</var>.alinkColor = <var>color</var>; -</pre> + var color = document.alinkColor; + document.alinkColor = color; -<p><var>color</var> est un echaîne de caractère contenant le nom de la couleur en anglais(exemple., <code>blue</code> pour bleu, <code>darkblue</code> pour bleu foncé, etc.) ou la valeur hexadécimal de la couleur (exemple, <code>#0000FF</code>)</p> +*color* est un echaîne de caractère contenant le nom de la couleur en anglais(exemple., `blue` pour bleu, `darkblue` pour bleu foncé, etc.) ou la valeur hexadécimal de la couleur (exemple, `#0000FF`) -<h2 id="Notes">Notes</h2> +## Notes -<p>La valeur par défaut pour cette propriété est rouge (<code>#ee000</code> en hexadécimal) sur Mozilla Firefox.</p> +La valeur par défaut pour cette propriété est rouge (`#ee000` en hexadécimal) sur Mozilla Firefox. -<p><code>document.alinkColor</code> est obsolète dans <a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268">DOM Level 2 HTML</a> (lien en anglais). Une alternative est le sélecteur CSS {{Cssxref(":active")}}.</p> +`document.alinkColor` est obsolète dans [DOM Level 2 HTML](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268) (lien en anglais). Une alternative est le sélecteur CSS {{Cssxref(":active")}}. -<p>Une autre alternative est <code>document.body.aLink</code>, même si elle est <a href="http://www.w3.org/TR/html401/struct/global.html#adef-alink">obsolète dans HTML 4.01</a> (lien en anglais) en faveur de l'alternative CSS ci-dessus.</p> +Une autre alternative est `document.body.aLink`, même si elle est [obsolète dans HTML 4.01](http://www.w3.org/TR/html401/struct/global.html#adef-alink) (lien en anglais) en faveur de l'alternative CSS ci-dessus. -<p><a href="/fr/docs/Mozilla/Gecko">Gecko </a>supporte <code>alinkColor</code>/<code>:active</code> et {{Cssxref(":focus")}}. Internet Explorer 6 et 7 supportent <code>alinkColor</code>/<code>:active</code> seulement pour la <a href="/fr/docs/Web/HTML/Element/a">balise HTML des liens (<a>)</a> et le comportement est le même que <code>:focus</code> sur Gecko. Il n'y a pas de support pour <code>:focus</code> sur IE.</p> +[Gecko ](/fr/docs/Mozilla/Gecko)supporte `alinkColor`/`:active` et {{Cssxref(":focus")}}. Internet Explorer 6 et 7 supportent `alinkColor`/`:active` seulement pour la [balise HTML des liens (\<a>)](/fr/docs/Web/HTML/Element/a) et le comportement est le même que `:focus` sur Gecko. Il n'y a pas de support pour `:focus` sur IE. -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.alinkColor")}}</p> +{{Compat("api.Document.alinkColor")}} diff --git a/files/fr/web/api/document/anchors/index.md b/files/fr/web/api/document/anchors/index.md index ea16e0f96f..dca923de8e 100644 --- a/files/fr/web/api/document/anchors/index.md +++ b/files/fr/web/api/document/anchors/index.md @@ -4,35 +4,36 @@ slug: Web/API/Document/anchors translation_of: Web/API/Document/anchors original_slug: Web/API/Document/Document.anchors --- -<div>{{APIRef("DOM")}} {{deprecated_header()}}</div> +{{APIRef("DOM")}} {{deprecated_header()}} -<p><code>anchors</code> retourne une liste de toutes les ancres du document.</p> +`anchors` retourne une liste de toutes les ancres du document. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>nodeList</var> = document.anchors; -</pre> + nodeList = document.anchors; -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:js">if ( document.anchors.length >= 5 ) { +```js +if ( document.anchors.length >= 5 ) { dump("Trop d'ancres trouvées !"); window.location = "http://www.google.com"; } -</pre> +``` -<p>L'exemple suivant remplit un tableau avec chaque ancre présente sur la page :</p> +L'exemple suivant remplit un tableau avec chaque ancre présente sur la page : -<pre class="brush:html"><!DOCTYPE html> -<html lang="en"> -<head> -<meta charset="UTF-8" /> -<title>Test</title> -<script> +```html +<!DOCTYPE html> +<html lang="en"> +<head> +<meta charset="UTF-8" /> +<title>Test</title> +<script> function init() { var toc = document.getElementById("toc"); var i, li, newAnchor; - for (i = 0; i < document.anchors.length; i++) { + for (i = 0; i < document.anchors.length; i++) { li = document.createElement("li"); newAnchor = document.createElement('a'); newAnchor.href = "#" + document.anchors[i].name; @@ -41,41 +42,39 @@ function init() { toc.appendChild(li); } } -</script> +</script> -</head> -<body onload="init()"> +</head> +<body onload="init()"> -<h1>Title</h1> -<h2><a name="contents">Contents</a></h2> -<ul id="toc"></ul> +<h1>Title</h1> +<h2><a name="contents">Contents</a></h2> +<ul id="toc"></ul> -<h2><a name="plants">Plants</a></h2> -<ol> - <li>Apples</li> - <li>Oranges</li> - <li>Pears</li> -</ol> +<h2><a name="plants">Plants</a></h2> +<ol> + <li>Apples</li> + <li>Oranges</li> + <li>Pears</li> +</ol> -<h2><a name="veggies">Veggies</a></h2> -<ol> - <li>Carrots</li> - <li>Celery</li> - <li>Beats</li> -</ol> +<h2><a name="veggies">Veggies</a></h2> +<ol> + <li>Carrots</li> + <li>Celery</li> + <li>Beats</li> +</ol> -</body> -</html> -</pre> +</body> +</html> +``` -<p><a href="https://jsfiddle.net/S4yNp">Voir dans JSFiddle</a></p> +[Voir dans JSFiddle](https://jsfiddle.net/S4yNp) -<h2 id="Notes">Notes</h2> +## Notes -<p>Pour des raisons de rétrocompatibilité, la liste d'ancres retournée contient seulement les ancres créées avec l'attribut <code>name</code>, pas celles créées avec l'attribut <code>id</code>.</p> +Pour des raisons de rétrocompatibilité, la liste d'ancres retournée contient seulement les ancres créées avec l'attribut `name`, pas celles créées avec l'attribut `id`. -<h2 id="Specification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-7577272">DOM Level 2 HTML: anchors</a></li> -</ul> +- [DOM Level 2 HTML: anchors](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-7577272) diff --git a/files/fr/web/api/document/applets/index.md b/files/fr/web/api/document/applets/index.md index ea763af9a4..5fbbb3d003 100644 --- a/files/fr/web/api/document/applets/index.md +++ b/files/fr/web/api/document/applets/index.md @@ -3,15 +3,19 @@ title: Document.applets slug: Web/API/Document/applets translation_of: Web/API/Document/applets --- -<p>{{ ApiRef() }}</p> +{{ ApiRef() }} -<p><code>applets</code> retourne une liste ordonnée des applets contenus dans un document.</p> -<h3 id="Syntax">Syntaxe</h3> -<pre class="eval"><em>nodeList</em> = document.applets -</pre> -<h3 id="Example">Exemple</h3> -<pre class="eval">// ( Si vous savez que le second applet est celui que vous voulez ) -my_java_app = document.applets[1]; -</pre> -<h3 id="Specification">Spécification</h3> -<p><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-85113862">DOM Level 2 HTML: applets</a></p> +`applets` retourne une liste ordonnée des applets contenus dans un document. + +### Syntaxe + + nodeList = document.applets + +### Exemple + + // ( Si vous savez que le second applet est celui que vous voulez ) + my_java_app = document.applets[1]; + +### Spécification + +[DOM Level 2 HTML: applets](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-85113862) diff --git a/files/fr/web/api/document/bgcolor/index.md b/files/fr/web/api/document/bgcolor/index.md index b379774259..2969fbf7ed 100644 --- a/files/fr/web/api/document/bgcolor/index.md +++ b/files/fr/web/api/document/bgcolor/index.md @@ -3,33 +3,29 @@ title: Document.bgColor slug: Web/API/Document/bgColor translation_of: Web/API/Document/bgColor --- -<p>{{APIRef("DOM")}} {{ Deprecated_header() }}</p> +{{APIRef("DOM")}} {{ Deprecated_header() }} -<p>La propriété obsolète <code>bgColor</code> renvoie ou déinit la couleur de fond (background-color) du document courant.</p> +La propriété obsolète `bgColor` renvoie ou déinit la couleur de fond (background-color) du document courant. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>color</em> = document.bgColor -document.bgColor =<em>color</em> -</pre> + color = document.bgColor + document.bgColor =color -<h3 id="Parametres">Parametres</h3> +### Parametres -<ul> - <li><code>color</code> est une chaîne de caractères représentant la couleur comme un mot (e.g., "red") ou une valeur hexadécimale (e.g., "<code>#ff0000</code>").</li> -</ul> +- `color` est une chaîne de caractères représentant la couleur comme un mot (e.g., "red") ou une valeur hexadécimale (e.g., "`#ff0000`"). -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="eval">document.bgColor = "darkblue"; -</pre> + document.bgColor = "darkblue"; -<h2 id="Notes">Notes</h2> +## Notes -<p>La valeur par défaut pour cette propriété sur Firefox est le blanc (<code>#ffffff</code> en hexadécimal).</p> +La valeur par défaut pour cette propriété sur Firefox est le blanc (`#ffffff` en hexadécimal). -<p><code>document.bgColor</code> est obsolète dans le <a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268">DOM Niveau 2 HTML</a>. L'alternative recommandée est l'utilisation du style CSS {{Cssxref("background-color")}} qui peut être accessible via le DOM avec <code>document.body.style.backgroundColor</code>. Une autre alternative est <code>document.body.bgColor</code>, mais c'est aussi obsolète dans HTML 4.01 en faveur de l'alternative CSS.</p> +`document.bgColor` est obsolète dans le [DOM Niveau 2 HTML](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268). L'alternative recommandée est l'utilisation du style CSS {{Cssxref("background-color")}} qui peut être accessible via le DOM avec `document.body.style.backgroundColor`. Une autre alternative est `document.body.bgColor`, mais c'est aussi obsolète dans HTML 4.01 en faveur de l'alternative CSS. -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.bgColor")}}</p> +{{Compat("api.Document.bgColor")}} diff --git a/files/fr/web/api/document/body/index.md b/files/fr/web/api/document/body/index.md index 57a6cdfe79..572e90d1ea 100644 --- a/files/fr/web/api/document/body/index.md +++ b/files/fr/web/api/document/body/index.md @@ -6,14 +6,19 @@ tags: - Référence_du_DOM_Gecko translation_of: Web/API/Document/body --- -<div> - {{ApiRef}}</div> -<p>Retourne l'élément <code><body></code> ou <code><frameset></code> du document courant.</p> -<h2 id="Syntax">Syntaxe</h2> -<pre class="syntaxbox"><em>var objRef</em> = document.body; -document.body = <em>objRef;</em></pre> -<h2 id="Example">Exemple</h2> -<pre class="brush:js">// dans le HTML: <body id="ancienElementBody"></body> +{{ApiRef}} + +Retourne l'élément `<body>` ou `<frameset>` du document courant. + +## Syntaxe + + var objRef = document.body; + document.body = objRef; + +## Exemple + +```js +// dans le HTML: <body id="ancienElementBody"></body> alert(document.body.id); // "ancienElementBody" var unNouvelElementBody = document.createElement("body"); @@ -21,11 +26,14 @@ var unNouvelElementBody = document.createElement("body"); unNouvelElementBody .id = "nouvelElementBody"; document.body = unNouvelElementBody ; alert(document.body.id); // "nouvelElementBody" -</pre> -<h2 id="Notes">Notes</h2> -<p><code>document.body</code> est l'élément dans lequel le contenu du document est situé. Dans les documents avec un élément <code><body></code> celui-ci est retourné, et dans les documents de type frameset l'élément <code><frameset></code> le plus extérieur est retourné.</p> -<p>Même si body est modifiable, lui affecter une nouvelle valeur retire tous les éléments enfants du <code><body></code> existant.</p> -<h2 id="Specification">Spécification</h2> -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-56360201">DOM Level 2 HTML: HTMLDocument.body</a></li> -</ul> +``` + +## Notes + +`document.body` est l'élément dans lequel le contenu du document est situé. Dans les documents avec un élément `<body>` celui-ci est retourné, et dans les documents de type frameset l'élément `<frameset>` le plus extérieur est retourné. + +Même si body est modifiable, lui affecter une nouvelle valeur retire tous les éléments enfants du `<body>` existant. + +## Spécification + +- [DOM Level 2 HTML: HTMLDocument.body](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-56360201) diff --git a/files/fr/web/api/document/caretrangefrompoint/index.md b/files/fr/web/api/document/caretrangefrompoint/index.md index ed72fe6bd7..a0e0d2282c 100644 --- a/files/fr/web/api/document/caretrangefrompoint/index.md +++ b/files/fr/web/api/document/caretrangefrompoint/index.md @@ -9,47 +9,47 @@ tags: - Méthode translation_of: Web/API/Document/caretRangeFromPoint --- -<p>{{APIRef("DOM")}}{{Non-standard_header}} </p> +{{APIRef("DOM")}}{{Non-standard_header}} -<p>La méthode <code><strong>caretRangeFromPoint()</strong></code> de l'interface {{domxref("Document")}} renvoie un objet "Range" (<em>chaîne</em>) pour le fragment de document aux coordonnées spécifiées.</p> +La méthode **`caretRangeFromPoint()`** de l'interface {{domxref("Document")}} renvoie un objet "Range" (_chaîne_) pour le fragment de document aux coordonnées spécifiées. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var <em>range</em> = <em>document</em>.caretRangeFromPoint(float <em>x</em>, float <em>y</em>); -</pre> +```js +var range = document.caretRangeFromPoint(float x, float y); +``` -<h3 id="Retourne">Retourne</h3> +### Retourne -<p>Une des réponses suivantes :</p> +Une des réponses suivantes : -<ul> - <li>Un {{domxref("Range")}}.</li> - <li><code>Null</code> si <strong>x</strong> ou <strong>y</strong> sont négatifs, hors de la fenêtre, ou s'il n'y a pas de noeud d'entrée de texte.</li> -</ul> +- Un {{domxref("Range")}}. +- `Null` si **x** ou **y** sont négatifs, hors de la fenêtre, ou s'il n'y a pas de noeud d'entrée de texte. -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt>x</dt> - <dd>Une position horizontale dans la fenêtre courante.</dd> - <dt>y</dt> - <dd>Une position verticale dans la fenêtre courante.</dd> -</dl> +- x + - : Une position horizontale dans la fenêtre courante. +- y + - : Une position verticale dans la fenêtre courante. -<h2 id="Example">Exemple</h2> +## Exemple -<p>Démonstration de base : lorsque vous cliquez dans un paragraphe, insérez un saut de ligne à la position du curseur :</p> +Démonstration de base : lorsque vous cliquez dans un paragraphe, insérez un saut de ligne à la position du curseur : -<h3 id="Contenu_HTML">Contenu HTML</h3> +### Contenu HTML -<pre class="brush: html"><p>Lorem ipsum dolor sit amet, consetetur sadipscing elitr, +```html +<p>Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. -Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.</p></pre> +Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.</p> +``` -<h3 id="Contenu_JavaScript">Contenu JavaScript</h3> +### Contenu JavaScript -<pre class="brush: js">function insertBreakAtPoint(e) { +```js +function insertBreakAtPoint(e) { var range; var textNode; @@ -66,8 +66,8 @@ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit ame offset = range.startOffset; } - // divise seulement les TEXT_NODE (<em>noeuds texte</em>) - if (textNode && textNode.nodeType == 3) { + // divise seulement les TEXT_NODE (noeuds texte) + if (textNode && textNode.nodeType == 3) { var replacement = textNode.splitText(offset); var br = document.createElement('br'); textNode.parentNode.insertBefore(br, replacement); @@ -75,12 +75,13 @@ Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit ame } var paragraphs = document.getElementsByTagName("p"); -for (i=0 ; i < paragraphs.length; i++) { +for (i=0 ; i < paragraphs.length; i++) { paragraphs[i].addEventListener("click", insertBreakAtPoint, false); -}</pre> +} +``` -<p>{{ EmbedLiveSample('Example', '', '', '', 'Web/API/Document/caretRangeFromPoint') }}</p> +{{ EmbedLiveSample('Example', '', '', '', 'Web/API/Document/caretRangeFromPoint') }} -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.caretRangeFromPoint")}}</p> +{{Compat("api.Document.caretRangeFromPoint")}} diff --git a/files/fr/web/api/document/characterset/index.md b/files/fr/web/api/document/characterset/index.md index d43772b7fb..c5d756cac1 100644 --- a/files/fr/web/api/document/characterset/index.md +++ b/files/fr/web/api/document/characterset/index.md @@ -10,45 +10,33 @@ tags: - Reference translation_of: Web/API/Document/characterSet --- -<p>{{ApiRef("DOM")}}</p> +{{ApiRef("DOM")}} -<p><code><strong>Document.characterSet</strong></code> propriété en lecture seule, renvoie l'encodage du document en cours. Un encodage décrit l'ensemble des caractères possibles et la façon de décoder les octets en ces caractères.</p> +**`Document.characterSet`** propriété en lecture seule, renvoie l'encodage du document en cours. Un encodage décrit l'ensemble des caractères possibles et la façon de décoder les octets en ces caractères. -<div class="note"> -<p><strong>Note :</strong> La propriété <code>document.charset</code> et <code>document.inputEncoding</code> sont les alias de <code>document.characterSet</code>. Ne plus les utiliser.</p> -</div> +> **Note :** La propriété `document.charset` et `document.inputEncoding` sont les alias de `document.characterSet`. Ne plus les utiliser. -<p>Les utilisateurs peuvent surcharger l'encodage indiqué pour le document (transmis par l'en-tête {{HTTPHeader("Content-Type")}} ou via le {{HTMLElement("meta")}} : <code><meta charset="utf-8"></code>) grâce au menu <kbd>Affichage → Encodage du texte</kbd>. Cela peut notamment permettre de corriger le comportement d'un document dont l'encodage indiqué est incorrect.</p> +Les utilisateurs peuvent surcharger l'encodage indiqué pour le document (transmis par l'en-tête {{HTTPHeader("Content-Type")}} ou via le {{HTMLElement("meta")}} : `<meta charset="utf-8">`) grâce au menu <kbd>Affichage → Encodage du texte</kbd>. Cela peut notamment permettre de corriger le comportement d'un document dont l'encodage indiqué est incorrect. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <em>string</em> = document.characterSet</pre> + var string = document.characterSet -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: html"><button onclick="console.log(document.characterSet);"> +```html +<button onclick="console.log(document.characterSet);"> Affiche le jeu de caractère -</button> -<!-- logs document's character set, such as "ISO-8859-1" or "UTF-8" --> -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th>Specification</th> - <th>Etat</th> - <th>Commentaires</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-document-characterset', 'characterSet')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.characterSet")}}</p> +</button> +<!-- logs document's character set, such as "ISO-8859-1" or "UTF-8" --> +``` + +## Spécifications + +| Specification | Etat | Commentaires | +| ------------------------------------------------------------------------------------------------ | -------------------------------- | -------------------- | +| {{SpecName('DOM WHATWG', '#dom-document-characterset', 'characterSet')}} | {{Spec2('DOM WHATWG')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Document.characterSet")}} diff --git a/files/fr/web/api/document/clear/index.md b/files/fr/web/api/document/clear/index.md index 24fab67361..e2ccc567e9 100644 --- a/files/fr/web/api/document/clear/index.md +++ b/files/fr/web/api/document/clear/index.md @@ -13,25 +13,20 @@ tags: - Reference translation_of: Web/API/Document/clear --- -<p>{{APIRef("DOM")}}{{ Deprecated_header() }}</p> +{{APIRef("DOM")}}{{ Deprecated_header() }} -<p>Cette méthode est utilisée pour effacer entièrement le document visé dans les anciennes versions (pre-1.0) de Mozilla.</p> +Cette méthode est utilisée pour effacer entièrement le document visé dans les anciennes versions (pre-1.0) de Mozilla. -<p>Dans les versions récentes des applications basées sur Mozilla ainsi que sur Internet Explorer et Netscape 4, cette méthode ne fait rien.</p> +Dans les versions récentes des applications basées sur Mozilla ainsi que sur Internet Explorer et Netscape 4, cette méthode ne fait rien. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="eval">document.clear() -</pre> + document.clear() -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<ul> - <li><a href="http://www.whatwg.org/html/#dom-document-clear">HTML5</a></li> -</ul> +- [HTML5](http://www.whatwg.org/html/#dom-document-clear) -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs - - -<p>{{Compat("api.Document.clear")}}</p> +{{Compat("api.Document.clear")}} diff --git a/files/fr/web/api/document/compatmode/index.md b/files/fr/web/api/document/compatmode/index.md index fd984565fe..e0a238c8fd 100644 --- a/files/fr/web/api/document/compatmode/index.md +++ b/files/fr/web/api/document/compatmode/index.md @@ -8,46 +8,37 @@ tags: - Reference translation_of: Web/API/Document/compatMode --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>Indique si le document est affiché en mode dégradé (<a href="/fr/docs/Mode_quirks_de_Mozilla">Quirks mode</a>) ou dans le respect des standards.</p> +Indique si le document est affiché en mode dégradé ([Quirks mode](/fr/docs/Mode_quirks_de_Mozilla)) ou dans le respect des standards. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>mode</em> = document.compatMode -</pre> + mode = document.compatMode -<h2 id="Valeurs">Valeurs</h2> +## Valeurs -<ul> - <li><code>"BackCompat"</code> si le document est a ffiché en mode "quirks" ; </li> -</ul> +- `"BackCompat"` si le document est a ffiché en mode "quirks" ; -<dl> - <dt>mode</dt> - <dd>est une valeur énumérée qui peut être :</dd> -</dl> +<!----> -<ul> - <li><code>"CSS1Compat"</code> si le document est affiché en mode "no-quirks" (aussi connu sous le nom de mode "standard") ou "limited-quirks" (mo de "proche du standard").</li> -</ul> +- mode + - : est une valeur énumérée qui peut être : -<dl> -</dl> +<!----> -<div class="note"> -<p><strong>Note :</strong> tous ces modes sont maintenant définis dans les normes, de sorte que les anciens «standards» et «presque standards» sont absurdes et ne sont plus utilisés dans les normes.</p> -</div> +- `"CSS1Compat"` si le document est affiché en mode "no-quirks" (aussi connu sous le nom de mode "standard") ou "limited-quirks" (mo de "proche du standard"). -<h2 id="Example">Exemple</h2> +<!----> -<pre class="eval">if (document.compatMode == "BackCompat") { - // en mode Quirks -} -</pre> +> **Note :** tous ces modes sont maintenant définis dans les normes, de sorte que les anciens «standards» et «presque standards» sont absurdes et ne sont plus utilisés dans les normes. -<h2 id="Specification">Spécifications</h2> +## Exemple -<ul> - <li><a href="http://dom.spec.whatwg.org/#dom-document-compatmode">DOM: Document.compatMode</a></li> -</ul> + if (document.compatMode == "BackCompat") { + // en mode Quirks + } + +## Spécifications + +- [DOM: Document.compatMode](http://dom.spec.whatwg.org/#dom-document-compatmode) diff --git a/files/fr/web/api/document/contenttype/index.md b/files/fr/web/api/document/contenttype/index.md index 32d072bbae..21309bbf71 100644 --- a/files/fr/web/api/document/contenttype/index.md +++ b/files/fr/web/api/document/contenttype/index.md @@ -10,21 +10,20 @@ tags: - Rendu translation_of: Web/API/Document/contentType --- -<p>{{ ApiRef("DOM") }}{{Non-standard_header}}</p> +{{ ApiRef("DOM") }}{{Non-standard_header}} -<p>Renvoie le type MIME dans lequel le document est rendu. Il peut provenir d'en-têtes HTTP ou d'autres sources d'informations MIME et peut être affecté par les conversions automatiques de type effectuées par le navigateur ou les extensions.</p> +Renvoie le type MIME dans lequel le document est rendu. Il peut provenir d'en-têtes HTTP ou d'autres sources d'informations MIME et peut être affecté par les conversions automatiques de type effectuées par le navigateur ou les extensions. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval"><var>contentType</var> = <var>document</var>.contentType; -</pre> + contentType = document.contentType; -<p><code>contentType</code> est une propriété en lecture seule.</p> +`contentType` est une propriété en lecture seule. -<h2 id="Notes">Notes</h2> +## Notes -<p>La propriété n'est pas affectée par les balises META.</p> +La propriété n'est pas affectée par les balises META. -<h2 id="Specification">Spécifications</h2> +## Spécifications -<p>{{SpecName('DOM WHATWG','#dom-document-contenttype','Document.contenttype')}}</p> +{{SpecName('DOM WHATWG','#dom-document-contenttype','Document.contenttype')}} diff --git a/files/fr/web/api/document/createattribute/index.md b/files/fr/web/api/document/createattribute/index.md index bfec33bfa2..42bd4f5991 100644 --- a/files/fr/web/api/document/createattribute/index.md +++ b/files/fr/web/api/document/createattribute/index.md @@ -8,84 +8,51 @@ tags: - Reference translation_of: Web/API/Document/createAttribute --- -<p>{{ApiRef("DOM")}}</p> +{{ApiRef("DOM")}} -<p>La méthode <code><strong>Document.createAttribute()</strong></code> crée un nouveau nœud d'attribut et le renvoie. L'objet a créé un noeud implémentant l'interface {{domxref("Attr")}}. Le DOM n'impose pas le type d'attribut à ajouter à un élément particulier de cette manière. </p> +La méthode **`Document.createAttribute()`** crée un nouveau nœud d'attribut et le renvoie. L'objet a créé un noeud implémentant l'interface {{domxref("Attr")}}. Le DOM n'impose pas le type d'attribut à ajouter à un élément particulier de cette manière. -<div class="note"> -<p><strong>Note :</strong> La chaîne de caractères donnée dans le paramètre est convertie en minuscules.</p> -</div> +> **Note :** La chaîne de caractères donnée dans le paramètre est convertie en minuscules. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>attribut</em> = document.createAttribute(nom) -</pre> + attribut = document.createAttribute(nom) -<h3 id="Param.C3.A8tres">Paramètres</h3> +### Paramètres -<ul> - <li><code>nom</code> est une chaîne de caractères contenant le nom de l'attribut.</li> -</ul> +- `nom` est une chaîne de caractères contenant le nom de l'attribut. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un nœud {{domxref("Attr")}}.</p> +Un nœud {{domxref("Attr")}}. -<h3 id="Exceptions_levées">Exceptions levées</h3> +### Exceptions levées -<ul> - <li><code>INVALID_CHARACTER_ERR</code> si le paramètre contient un caractère invalide pour un attribut XML.</li> -</ul> +- `INVALID_CHARACTER_ERR` si le paramètre contient un caractère invalide pour un attribut XML. -<h2 id="Exemples">Exemples</h2> +## Exemples - -<pre class="brush:js">var node = document.getElementById("div1"); +```js +var node = document.getElementById("div1"); var a = document.createAttribute("my_attrib"); a.value = "newVal"; node.setAttributeNode(a); console.log(node.getAttribute("my_attrib")); // "newVal" -</pre> -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('DOM WHATWG','#dom-document-createattribute','Document.createAttribute()')}}</td> - <td>{{Spec2("DOM WHATWG")}}</td> - <td> Comportement précis avec des caractères majuscules. </td> - </tr> - <tr> - <td>{{SpecName('DOM3 Core','core.html#ID-1084891198','Document.createAttribute()')}}</td> - <td>{{Spec2('DOM3 Core')}}</td> - <td>Pas de modification.</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Core','core.html#ID-1084891198','Document.createAttribute()')}}</td> - <td>{{Spec2('DOM2 Core')}}</td> - <td>Pas de modification.</td> - </tr> - <tr> - <td>{{SpecName('DOM1','level-one-core.html#ID-1084891198','Document.createAttribute()')}}</td> - <td>{{Spec2('DOM1')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.createAttribute")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("Document.createElement()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------- | +| {{SpecName('DOM WHATWG','#dom-document-createattribute','Document.createAttribute()')}} | {{Spec2("DOM WHATWG")}} | Comportement précis avec des caractères majuscules. | +| {{SpecName('DOM3 Core','core.html#ID-1084891198','Document.createAttribute()')}} | {{Spec2('DOM3 Core')}} | Pas de modification. | +| {{SpecName('DOM2 Core','core.html#ID-1084891198','Document.createAttribute()')}} | {{Spec2('DOM2 Core')}} | Pas de modification. | +| {{SpecName('DOM1','level-one-core.html#ID-1084891198','Document.createAttribute()')}} | {{Spec2('DOM1')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Document.createAttribute")}} + +## Voir aussi + +- {{domxref("Document.createElement()")}} diff --git a/files/fr/web/api/document/createcdatasection/index.md b/files/fr/web/api/document/createcdatasection/index.md index f1a44c9a07..3ee0e113a7 100644 --- a/files/fr/web/api/document/createcdatasection/index.md +++ b/files/fr/web/api/document/createcdatasection/index.md @@ -12,41 +12,35 @@ tags: - données translation_of: Web/API/Document/createCDATASection --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p><code>createCDATASection()</code> crée un nouveau noeud de section CDATA et le renvoie.</p> +`createCDATASection()` crée un nouveau noeud de section CDATA et le renvoie. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>CDATASectionNode</var> = document.createCDATASection(data) -</pre> + CDATASectionNode = document.createCDATASection(data) -<ul> - <li><code>CDATASectionNode</code> est un noeud de <a href="/fr/docs/Web/API/CDATASection">Section CDATA</a>.</li> - <li><code>data</code> est une string (<em>chaîne de caractères</em>) contenant les données à ajouter à la section CDATA.</li> -</ul> +- `CDATASectionNode` est un noeud de [Section CDATA](/fr/docs/Web/API/CDATASection). +- `data` est une string (_chaîne de caractères_) contenant les données à ajouter à la section CDATA. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:js">var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml") +```js +var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml") -var cdata = docu.createCDATASection('Some <CDATA> data & then some'); +var cdata = docu.createCDATASection('Some <CDATA> data & then some'); docu.getElementsByTagName('xml')[0].appendChild(cdata); alert(new XMLSerializer().serializeToString(docu)); -// Affiche : <xml><![CDATA[Some <CDATA> data & then some]]></xml> -</pre> +// Affiche : <xml><![CDATA[Some <CDATA> data & then some]]></xml> +``` -<h2 id="Notes">Notes</h2> +## Notes -<ul> - <li>Cela fonctionnera uniquement avec XML, pas avec les documents HTML (car les documents HTML ne supportent pas les sections CDATA) ; le tenter sur un document HTML va lancer une exception <code>NOT_SUPPORTED_ERR</code>.</li> - <li>Va lancer une exception <code>NS_ERROR_DOM_INVALID_CHARACTER_ERR</code> si on essaye de soumettre la séquence CDATA de fermeture ("]]>") en tant que partie des données ; les données fournies par l'utilisateur non échappées, ne peuvent pas être utilisées en toute sécurité sans qu'avec cette méthode on obtienne cette exception (<code><a href="/en-US/docs/DOM/document.createTextNode">createTextNode()</a></code> peut souvent être utilisé à sa place).</li> -</ul> +- Cela fonctionnera uniquement avec XML, pas avec les documents HTML (car les documents HTML ne supportent pas les sections CDATA) ; le tenter sur un document HTML va lancer une exception `NOT_SUPPORTED_ERR`. +- Va lancer une exception `NS_ERROR_DOM_INVALID_CHARACTER_ERR` si on essaye de soumettre la séquence CDATA de fermeture ("]]>") en tant que partie des données ; les données fournies par l'utilisateur non échappées, ne peuvent pas être utilisées en toute sécurité sans qu'avec cette méthode on obtienne cette exception ([`createTextNode()`](/en-US/docs/DOM/document.createTextNode) peut souvent être utilisé à sa place). -<h2 id="Specification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-createCDATASection">createCDATASection</a></li> -</ul> +- [createCDATASection](http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-createCDATASection) diff --git a/files/fr/web/api/document/createcomment/index.md b/files/fr/web/api/document/createcomment/index.md index 5e16be2ecb..d2553c1327 100644 --- a/files/fr/web/api/document/createcomment/index.md +++ b/files/fr/web/api/document/createcomment/index.md @@ -8,34 +8,31 @@ tags: - Reference translation_of: Web/API/Document/createComment --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p><code>createComment()</code> crée et retourne un nouveau noeud de type commentaire.</p> +`createComment()` crée et retourne un nouveau noeud de type commentaire. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>CommentNode</em> = document.createComment(data) -</pre> + CommentNode = document.createComment(data) -<h3 id="Parameters">Paramètres</h3> +### Paramètres -<dl> - <dt><code>data</code></dt> - <dd>Une chaîne de caractères représentant le contenu du commentaire.</dd> -</dl> +- `data` + - : Une chaîne de caractères représentant le contenu du commentaire. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:js">var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml"); +```js +var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml"); var comment = docu.createComment('Voici un commentaire pas très bien caché'); docu.getElementsByTagName('xml')[0].appendChild(comment); alert(new XMLSerializer().serializeToString(docu)); -// Affiche: <xml><!--Voici un commentaire pas très bien caché--></xml></pre> +// Affiche: <xml><!--Voici un commentaire pas très bien caché--></xml> +``` -<h2 id="Spécification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-createComment">createComment</a></li> -</ul> +- [createComment](http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-createComment) diff --git a/files/fr/web/api/document/createdocumentfragment/index.md b/files/fr/web/api/document/createdocumentfragment/index.md index 629d26ed27..d4bf794671 100644 --- a/files/fr/web/api/document/createdocumentfragment/index.md +++ b/files/fr/web/api/document/createdocumentfragment/index.md @@ -10,35 +10,37 @@ tags: - Reference translation_of: Web/API/Document/createDocumentFragment --- -<div>{{ApiRef("DOM")}}</div> +{{ApiRef("DOM")}} -<p>Crée un nouvel objet vide de type {{domxref("DocumentFragment")}}.</p> +Crée un nouvel objet vide de type {{domxref("DocumentFragment")}}. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <var>fragment</var> = document.createDocumentFragment(); -</pre> + var fragment = document.createDocumentFragment(); -<p><code>fragment</code> est une référence vers un objet vide de type {{domxref("DocumentFragment")}} .</p> +`fragment` est une référence vers un objet vide de type {{domxref("DocumentFragment")}} . -<h2 id="Description">Description</h2> +## Description -<p>Les objets <code>DocumentFragments</code> sont analogues à des nœuds du DOM, mais ne font jamais partie de l'arbre DOM. Le cas d'usage le plus courant consiste à créer un fragment pour y stocker des éléments, puis à ajouter en une seule opération le fragment à l'arbre DOM, ce qui a pour effet de le remplacer par tous ses éléments enfants.</p> +Les objets `DocumentFragments` sont analogues à des nœuds du DOM, mais ne font jamais partie de l'arbre DOM. Le cas d'usage le plus courant consiste à créer un fragment pour y stocker des éléments, puis à ajouter en une seule opération le fragment à l'arbre DOM, ce qui a pour effet de le remplacer par tous ses éléments enfants. -<p>Le principal avantage de cette méthode de mise à jour du DOM vient du fait que le fragment est stocké en mémoire, et pas dans l'arbre DOM lui-même, de sorte que le modifier ne déclenche pas de <a href="http://code.google.com/speed/articles/reflow.html">reflow</a> (le calcul des positions et de la géométrie de chacun des éléments de la page affichée). Par conséquent, l´utilisation de fragments pour effectuer des mises à jour du DOM donne souvent lieu à une <a href="http://ejohn.org/blog/dom-documentfragments/">amélioration des performance</a>s.</p> +Le principal avantage de cette méthode de mise à jour du DOM vient du fait que le fragment est stocké en mémoire, et pas dans l'arbre DOM lui-même, de sorte que le modifier ne déclenche pas de [reflow](http://code.google.com/speed/articles/reflow.html) (le calcul des positions et de la géométrie de chacun des éléments de la page affichée). Par conséquent, l´utilisation de fragments pour effectuer des mises à jour du DOM donne souvent lieu à une [amélioration des performance](http://ejohn.org/blog/dom-documentfragments/)s. -<h2 id="Example">Exemple</h2> +## Exemple -<p>Cet exemple crée une liste des principaux navigateurs du web.</p> +Cet exemple crée une liste des principaux navigateurs du web. -<h3 id="HTML">HTML</h3> +### HTML -<pre class="brush: html"><ul id="ul"> -</ul></pre> +```html +<ul id="ul"> +</ul> +``` -<h3 id="JavaScript">JavaScript</h3> +### JavaScript -<pre class="brush: js">var element = document.getElementById('ul'); // en supposant qu'ul existe +```js +var element = document.getElementById('ul'); // en supposant qu'ul existe var fragment = document.createDocumentFragment(); var browsers = ['Firefox', 'Chrome', 'Opera', 'Safari', 'Internet Explorer']; @@ -49,39 +51,24 @@ browsers.forEach(function(browser) { fragment.appendChild(li); }); -element.appendChild(fragment);</pre> +element.appendChild(fragment); +``` -<h3 id="Résultat">Résultat</h3> +### Résultat -<p>{{EmbedLiveSample("Example", 600, 140)}}</p> +{{EmbedLiveSample("Example", 600, 140)}} -<h2 id="Spécification">Spécification</h2> +## Spécification -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-document-createdocumentfragment', 'Document.createDocumentFragment()')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Définition initiale dans la spécification DOM 1.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------ | +| {{SpecName('DOM WHATWG', '#dom-document-createdocumentfragment', 'Document.createDocumentFragment()')}} | {{Spec2('DOM WHATWG')}} | Définition initiale dans la spécification DOM 1. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.createDocumentFragment")}}</p> +{{Compat("api.Document.createDocumentFragment")}} -<h2 id="Voir_aussi">Voir aussi</h2> -</div> +## Voir aussi -<ul> - <li>{{domxref("DOMImplementation.createDocument", "document.implementation.createDocument()")}}</li> - <li>{{domxref("documentFragment")}}</li> -</ul> +- {{domxref("DOMImplementation.createDocument", "document.implementation.createDocument()")}} +- {{domxref("documentFragment")}} diff --git a/files/fr/web/api/document/createelement/index.md b/files/fr/web/api/document/createelement/index.md index aaf9bf831b..e68fb79530 100644 --- a/files/fr/web/api/document/createelement/index.md +++ b/files/fr/web/api/document/createelement/index.md @@ -10,50 +10,49 @@ tags: - Méthodes translation_of: Web/API/Document/createElement --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>Dans un document <a href="/fr/docs/Web/HTML">HTML</a>, la méthode <strong><code>document.createElement()</code></strong> crée un élément HTML du type spécifié par <code>tagName</code> ou un {{domxref("HTMLUnknownElement")}} si <code>tagName</code> n’est pas reconnu.</p> +Dans un document [HTML](/fr/docs/Web/HTML), la méthode **`document.createElement()`** crée un élément HTML du type spécifié par `tagName` ou un {{domxref("HTMLUnknownElement")}} si `tagName` n’est pas reconnu. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var element = document.createElement(tagName[, options]);</pre> + var element = document.createElement(tagName[, options]); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt>tagName</dt> - <dd>Une chaîne de caractères ({{domxref("DOMString")}}) spécifiant le type d’élément à créer. Le {{domxref("Node.nodeName", "nodeName")}} (<em>nom du noeud</em>) de l’élément créé est initialisé avec la valeur de <code>tagName</code>. N’utilisez pas le nom qualifié (comme <code>"html:a"</code>) avec cette méthode. Quand elle est appelée sur un document HTML, <code>createElement()</code> convertit <code>tagName</code> en minuscules avant de créer l’élément. Dans Firefox, Opera et Chrome, <code>createElement(null)</code> fonctionne comme <code>createElement("null")</code>.</dd> - <dt>options{{optional_inline}}</dt> - <dd> - <p>Un objet <code>ElementCreationOptions</code> facultatif contenant une seule propriété nommée <code>is</code> dont la valeur est le nom de balise d’un élément personnalisé précédemment défini avec <code>customElements.define()</code>. Voir {{anch("Web component example")}} pour plus de détails.</p> - </dd> -</dl> +- tagName + - : Une chaîne de caractères ({{domxref("DOMString")}}) spécifiant le type d’élément à créer. Le {{domxref("Node.nodeName", "nodeName")}} (_nom du noeud_) de l’élément créé est initialisé avec la valeur de `tagName`. N’utilisez pas le nom qualifié (comme `"html:a"`) avec cette méthode. Quand elle est appelée sur un document HTML, `createElement()` convertit `tagName` en minuscules avant de créer l’élément. Dans Firefox, Opera et Chrome, `createElement(null)` fonctionne comme `createElement("null")`. +- options{{optional_inline}} + - : Un objet `ElementCreationOptions` facultatif contenant une seule propriété nommée `is` dont la valeur est le nom de balise d’un élément personnalisé précédemment défini avec `customElements.define()`. Voir {{anch("Web component example")}} pour plus de détails. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>L’objet {{domxref("Element")}} créé.</p> +L’objet {{domxref("Element")}} créé. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Exemple_de_base">Exemple de base</h3> +### Exemple de base -<p>Ici est créé un nouveau <code><div></code> qui est inséré avant l’élément avec l’identifiant <code>"div1"</code>.</p> +Ici est créé un nouveau `<div>` qui est inséré avant l’élément avec l’identifiant `"div1"`. -<h4 id="HTML">HTML</h4> +#### HTML -<pre class="brush: html"><!DOCTYPE html> -<html> -<head> - <title>||Working with elements||</title> -</head> -<body> - <div id="div1">The text above has been created dynamically.</div> -</body> -</html></pre> +```html +<!DOCTYPE html> +<html> +<head> + <title>||Working with elements||</title> +</head> +<body> + <div id="div1">The text above has been created dynamically.</div> +</body> +</html> +``` -<h4 id="JavaScript">JavaScript</h4> +#### JavaScript -<pre class="brush: js">document.body.onload = addElement; +```js +document.body.onload = addElement; function addElement () { // crée un nouvel élément div @@ -66,15 +65,17 @@ function addElement () { // ajoute le nouvel élément créé et son contenu dans le DOM var currentDiv = document.getElementById('div1'); document.body.insertBefore(newDiv, currentDiv); -}</pre> +} +``` -<p>{{EmbedLiveSample("Basic_example", 500, 50)}}</p> +{{EmbedLiveSample("Basic_example", 500, 50)}} -<h3 id="Exemple_de_composant_web">Exemple de composant web</h3> +### Exemple de composant web -<p>L’exemple de fragment suivant est extrait de notre exemple expanding-list-web-component (voir aussi en direct). Dans ce cas, notre élément personnalisé étend la {{domxref("HTMLUListElement")}} qui représente l’élément {{htmlelement("ul")}}.</p> +L’exemple de fragment suivant est extrait de notre exemple expanding-list-web-component (voir aussi en direct). Dans ce cas, notre élément personnalisé étend la {{domxref("HTMLUListElement")}} qui représente l’élément {{htmlelement("ul")}}. -<pre class="brush: js">// Crée une classe pour l’élément +```js +// Crée une classe pour l’élément class ExpandingList extends HTMLUListElement { constructor() { // Toujours appeler « super » en premier dans le constructeur @@ -86,52 +87,38 @@ class ExpandingList extends HTMLUListElement { } // Définit le nouvel élément -customElements.define('expanding-list', ExpandingList, { extends: 'ul' });</pre> +customElements.define('expanding-list', ExpandingList, { extends: 'ul' }); +``` -<p>Si nous cherchons à créer une instance de cet élément par programmation, nous devons utiliser un appel tel que montré dans la ligne suivante :</p> +Si nous cherchons à créer une instance de cet élément par programmation, nous devons utiliser un appel tel que montré dans la ligne suivante : -<pre class="brush: js">let expandingList = document.createElement('ul', { is : 'expanding-list' })</pre> +```js +let expandingList = document.createElement('ul', { is : 'expanding-list' }) +``` -<p>Le nouvel élément donnera un attribut <code><a href="/docs/Web/HTML/Global_attributes/is">is</a></code> dont la valeur est la balise de nom de l’élément personnalisé.</p> +Le nouvel élément donnera un attribut [`is`](/docs/Web/HTML/Global_attributes/is) dont la valeur est la balise de nom de l’élément personnalisé. -<div class="note"> -<p><strong>Note :</strong> Pour la rétrocompatibilité avec les versions précédentes de la <a href="https://www.w3.org/TR/custom-elements/">spécification des éléments personnalisés</a>, quelques navigateurs permettent de passer une chaîne de caractères ici, à la place d’un objet, dont la valeur est la balise de nom de l’élément personnalisé.</p> -</div> +> **Note :** Pour la rétrocompatibilité avec les versions précédentes de la [spécification des éléments personnalisés](https://www.w3.org/TR/custom-elements/), quelques navigateurs permettent de passer une chaîne de caractères ici, à la place d’un objet, dont la valeur est la balise de nom de l’élément personnalisé. -<h2 id="Spécification">Spécification</h2> +## Spécification -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', "#dom-document-createelement", "Document.createElement")}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td> </td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName('DOM WHATWG', "#dom-document-createelement", "Document.createElement")}} | {{Spec2('DOM WHATWG')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.createElement")}}</p> +{{Compat("api.Document.createElement")}} -<h3 id="Notes_CSS_Quantum">Notes CSS Quantum</h3> +### Notes CSS Quantum -<ul> - <li>Dans Gecko, quand vous voulez créer un sous-arbre détaché (par exemple, un {{htmlelement("div")}} créé avec <code>createElement()</code> qui n’est pas encore inséré dans le DOM), l’élément racine du sous-arbre est défini comme un élément de niveau bloc. Dans le nouveau moteur CSS parallèle de Firefox (aussi connu comme <a href="https://wiki.mozilla.org/Quantum">Quantum CSS</a> ou <a href="https://wiki.mozilla.org/Quantum/Stylo">Stylo</a>, prévu pour être publié dans Firefox 57), il est défini comme "inline", ({{bug(1374994)}}) selon la spécification.</li> -</ul> +- Dans Gecko, quand vous voulez créer un sous-arbre détaché (par exemple, un {{htmlelement("div")}} créé avec `createElement()` qui n’est pas encore inséré dans le DOM), l’élément racine du sous-arbre est défini comme un élément de niveau bloc. Dans le nouveau moteur CSS parallèle de Firefox (aussi connu comme [Quantum CSS](https://wiki.mozilla.org/Quantum) ou [Stylo](https://wiki.mozilla.org/Quantum/Stylo), prévu pour être publié dans Firefox 57), il est défini comme "inline", ({{bug(1374994)}}) selon la spécification. -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Node.removeChild()")}}</li> - <li>{{domxref("Node.replaceChild()")}}</li> - <li>{{domxref("Node.appendChild()")}}</li> - <li>{{domxref("Node.insertBefore()")}}</li> - <li>{{domxref("Node.hasChildNodes()")}}</li> - <li>{{domxref("document.createElementNS()")}} — pour spécifier explicitement l’URI de l’espace de noms de l’élément.</li> -</ul> +- {{domxref("Node.removeChild()")}} +- {{domxref("Node.replaceChild()")}} +- {{domxref("Node.appendChild()")}} +- {{domxref("Node.insertBefore()")}} +- {{domxref("Node.hasChildNodes()")}} +- {{domxref("document.createElementNS()")}} — pour spécifier explicitement l’URI de l’espace de noms de l’élément. diff --git a/files/fr/web/api/document/createelementns/index.md b/files/fr/web/api/document/createelementns/index.md index 4949f5203e..7957b59245 100644 --- a/files/fr/web/api/document/createelementns/index.md +++ b/files/fr/web/api/document/createelementns/index.md @@ -11,51 +11,50 @@ tags: - URI translation_of: Web/API/Document/createElementNS --- -<div>{{ApiRef("DOM")}}</div> +{{ApiRef("DOM")}} -<p>Crée un élément avec l'URI de l'espace de noms spécifié et un nom qualifié.</p> +Crée un élément avec l'URI de l'espace de noms spécifié et un nom qualifié. -<p>Pour créer un élément sans spécifier d'URI d'espace de noms, utilisez la méthode <a href="/fr/docs/Web/API/Document/createElement">createElement </a><a href="/fr/docs/Web/API/Document/createElement"> </a>.</p> +Pour créer un élément sans spécifier d'URI d'espace de noms, utilisez la méthode [createElement ](/fr/docs/Web/API/Document/createElement)[](/fr/docs/Web/API/Document/createElement). -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var element = document.createElementNS(namespaceURI, qualifiedName[, options]);</pre> +```js +var element = document.createElementNS(namespaceURI, qualifiedName[, options]); +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>namespaceURI</code></dt> - <dd>est une chaîne de caractères qui spécifie <a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/glossary.html#dt-namespaceURI">l'URI de l'espace de noms</a> à associer à l'élément. La propriété <a href="/fr/docs/Web/API/Node/namespaceURI">namespaceURI</a> de l'élément créé est initialisée avec la valeur de <code>namespaceURI</code>. voir <a href="#URI_d'espaces_de_nom_valides">URI d'espaces de nom valides</a></dd> - <dt><code>qualifiedName</code></dt> - <dd>est une chaîne de caractères qui spécifie le type de l'élément à créer. La propriété <a href="/fr/docs/Web/API/Node/nodeName">nodeName</a> de l'élément créé est initialisée avec la valeur de <code>qualifiedName</code></dd> - <dt><code>Options </code>Facultatif</dt> - <dd><p>Un objet facultatif <code>ElementCreationOptions</code> contient une propriété unique nommée <code>is</code>, dont la valeur est le nom de la balise pour un élément personnalisé défini précédemment à l'aide de <code>customElements.define()</code> . Pour la rétro-compatibilité avec les versions précédentes de la <a href="https://www.w3.org/TR/custom-elements/">spécification des éléments personnalisés</a>, quelques navigateurs vous permettront de passer ici une chaîne de caractères à la place d'un objet, pour laquelle la valeur est un nom d'élément personnalisé. Voir <a href="https://developers.google.com/web/fundamentals/primers/customelements/#extendhtml">Extending native HTML elements</a> pour plus d'informations sur la façon d'utiliser ce paramètre. Le nouvel élément recevra un attribut <code>is</code> dont la valeur est le nom de la balise de l'élément personnalisé. Les éléments personnalisés sont une fonctionnalité expérimentale disponible uniquement dans certains navigateurs.</p></dd> -</dl> +- `namespaceURI` + - : est une chaîne de caractères qui spécifie [l'URI de l'espace de noms](http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/glossary.html#dt-namespaceURI) à associer à l'élément. La propriété [namespaceURI](/fr/docs/Web/API/Node/namespaceURI) de l'élément créé est initialisée avec la valeur de `namespaceURI`. voir [URI d'espaces de nom valides](#URI_d'espaces_de_nom_valides) +- `qualifiedName` + - : est une chaîne de caractères qui spécifie le type de l'élément à créer. La propriété [nodeName](/fr/docs/Web/API/Node/nodeName) de l'élément créé est initialisée avec la valeur de `qualifiedName` +- `Options `Facultatif + - : Un objet facultatif `ElementCreationOptions` contient une propriété unique nommée `is`, dont la valeur est le nom de la balise pour un élément personnalisé défini précédemment à l'aide de `customElements.define()` . Pour la rétro-compatibilité avec les versions précédentes de la [spécification des éléments personnalisés](https://www.w3.org/TR/custom-elements/), quelques navigateurs vous permettront de passer ici une chaîne de caractères à la place d'un objet, pour laquelle la valeur est un nom d'élément personnalisé. Voir [Extending native HTML elements](https://developers.google.com/web/fundamentals/primers/customelements/#extendhtml) pour plus d'informations sur la façon d'utiliser ce paramètre. Le nouvel élément recevra un attribut `is` dont la valeur est le nom de la balise de l'élément personnalisé. Les éléments personnalisés sont une fonctionnalité expérimentale disponible uniquement dans certains navigateurs. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Le nouvel <code><a href="/fr/docs/Web/API/Element">element</a></code>.</p> +Le nouvel [`element`](/fr/docs/Web/API/Element). -<h2 id="Example">URI d'espaces de nom valides</h2> +## URI d'espaces de nom valides -<ul> - <li>HTML - Utiliser <code>http://www.w3.org/1999/xhtml</code></li> - <li>SVG - Utiliser <code>http://www.w3.org/2000/svg</code></li> - <li>XBL - Utiliser <code>http://www.mozilla.org/xbl</code></li> - <li>XUL - Utiliser <code>http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</code></li> -</ul> +- HTML - Utiliser `http://www.w3.org/1999/xhtml` +- SVG - Utiliser `http://www.w3.org/2000/svg` +- XBL - Utiliser `http://www.mozilla.org/xbl` +- XUL - Utiliser `http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul` -<h2 id="Example">Exemple</h2> +## Exemple -<p>Cet exemple crée un nouvel élément <div> dans l'espace de noms <a href="/fr/docs/XHTML">XHTML</a> et l'ajoute à l'élément vbox. Bien que ce ne soit pas un document <a href="/fr/docs/Mozilla/Tech/XUL">XUL</a> très utile, cela montre l'utilisation d'éléments de deux espaces de noms différents au sein d'un même document :</p> +Cet exemple crée un nouvel élément \<div> dans l'espace de noms [XHTML](/fr/docs/XHTML) et l'ajoute à l'élément vbox. Bien que ce ne soit pas un document [XUL](/fr/docs/Mozilla/Tech/XUL) très utile, cela montre l'utilisation d'éléments de deux espaces de noms différents au sein d'un même document : -<pre class="brush:xml"><?xml version="1.0"?> -<page xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" +```xml +<?xml version="1.0"?> +<page xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" xmlns:html="http://www.w3.org/1999/xhtml" title="||Working with elements||" - onload="init()"> + onload="init()"> -<script type="text/javascript"><![CDATA[ +<script type="text/javascript"><![CDATA[ var container; var newdiv; var txtnode; @@ -68,46 +67,32 @@ translation_of: Web/API/Document/createElementNS container.appendChild(newdiv); } -]]></script> +]]></script> - <vbox id='ContainerBox' flex='1'> - <html:div> + <vbox id='ContainerBox' flex='1'> + <html:div> Le script sur cette page ajoutera du contenu dynamique ci-dessous : - </html:div> - </vbox> - -</page></pre> - -<div class="note"> -<p><strong>Note :</strong> Cet exemple utilise un script interne, ce qui n'est pas recommandé dans les documents XHTML. Cet exemple particulier est en fait un document XUL intégrant du XHTML. Cependant, la recommandation s'applique quand même.</p> -</div> - -<h2 id="Specification">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', "#dom-document-createelementns", "Document.createElement")}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.createElementNS")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="document.createElement">document.createElement</a></li> - <li><a href="document.createTextNode">document.createTextNode</a></li> - <li><a href="/fr/docs/Web/API/Node/namespaceURI">Node.namespaceURI</a></li> - <li><a href="http://www.w3.org/TR/1999/REC-xml-names-19990114">Namespaces in XML</a></li> -</ul> + </html:div> + </vbox> + +</page> +``` + +> **Note :** Cet exemple utilise un script interne, ce qui n'est pas recommandé dans les documents XHTML. Cet exemple particulier est en fait un document XUL intégrant du XHTML. Cependant, la recommandation s'applique quand même. + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName('DOM WHATWG', "#dom-document-createelementns", "Document.createElement")}} | {{Spec2('DOM WHATWG')}} | | + +## Compatibilité des navigateurs + +{{Compat("api.Document.createElementNS")}} + +## Voir aussi + +- [document.createElement](document.createElement) +- [document.createTextNode](document.createTextNode) +- [Node.namespaceURI](/fr/docs/Web/API/Node/namespaceURI) +- [Namespaces in XML](http://www.w3.org/TR/1999/REC-xml-names-19990114) diff --git a/files/fr/web/api/document/createentityreference/index.md b/files/fr/web/api/document/createentityreference/index.md index 46269f94bc..3dfdecf2dc 100644 --- a/files/fr/web/api/document/createentityreference/index.md +++ b/files/fr/web/api/document/createentityreference/index.md @@ -3,12 +3,12 @@ title: Document.createEntityReference() slug: Web/API/Document/createEntityReference translation_of: Web/API/Document/createEntityReference --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>{{ obsolete_header("7.0") }}</p> +{{ obsolete_header("7.0") }} -<p>Avant {{ gecko("7.0") }} cette méthode apparaissait présente mais en raison du bogue {{bug("9850")}}, elle renvoyait toujours uniquement "null". La seule solution consiste à créer un noeud de texte, une section CDATA, une valeur de noeud d'attribut, etc., qui ont la valeur référencée par l'entité, en utilisant <a href="/fr/docs/Web/JavaScript/Guide/Types_et_grammaire#Les_caract%C3%A8res_d%27%C3%A9chappement">Les caractères d'échappement</a> ou <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/String/fromCharCode">fromCharCode()</a> si nécessaire.</p> +Avant {{ gecko("7.0") }} cette méthode apparaissait présente mais en raison du bogue {{bug("9850")}}, elle renvoyait toujours uniquement "null". La seule solution consiste à créer un noeud de texte, une section CDATA, une valeur de noeud d'attribut, etc., qui ont la valeur référencée par l'entité, en utilisant [Les caractères d'échappement](/fr/docs/Web/JavaScript/Guide/Types_et_grammaire#Les_caract%C3%A8res_d%27%C3%A9chappement) ou [fromCharCode()](/fr/docs/Web/JavaScript/Reference/Objets_globaux/String/fromCharCode) si nécessaire. -<h2 id="Specification">Spécifications</h2> +## Spécifications -<p><a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-392B75AE">createEntityReference</a></p> +[createEntityReference](http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-392B75AE) diff --git a/files/fr/web/api/document/createevent/index.md b/files/fr/web/api/document/createevent/index.md index 3cccde91e3..8696602672 100644 --- a/files/fr/web/api/document/createevent/index.md +++ b/files/fr/web/api/document/createevent/index.md @@ -8,81 +8,71 @@ tags: - Reference translation_of: Web/API/Document/createEvent --- -<div class="warning"> -<p><strong>Attention :</strong> De nombreuses méthodes utilisées avec <code>createEvent</code>, tels que <code>initCustomEvent</code>, sont obsolètes. Utilisez le <a href="/fr/docs/Web/API/CustomEvent">constructeur d'événement </a><a href="/fr/docs/Web/API/CustomEvent"> </a>à la place.</p> -</div> +> **Attention :** De nombreuses méthodes utilisées avec `createEvent`, tels que `initCustomEvent`, sont obsolètes. Utilisez le [constructeur d'événement ](/fr/docs/Web/API/CustomEvent)[](/fr/docs/Web/API/CustomEvent)à la place. -<div>{{ ApiRef("DOM") }}</div> +{{ ApiRef("DOM") }} -<p>Crée un <a href="/en-US/docs/DOM/event">event</a> du type spécifié. L'objet retourné doit être intialisé et peut être passé ensuite à <a href="/en-US/docs/DOM/element.dispatchEvent">element.dispatchEvent</a>.</p> +Crée un [event](/en-US/docs/DOM/event) du type spécifié. L'objet retourné doit être intialisé et peut être passé ensuite à [element.dispatchEvent](/en-US/docs/DOM/element.dispatchEvent). -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <em>event</em> = <em>document</em>.createEvent(<em>type</em>); -</pre> + var event = document.createEvent(type); -<ul> - <li><code>event</code> est l'objet <a href="/en-US/docs/DOM/event">Event</a> créé.</li> - <li><code>type</code> est une chaîne de caractères qui représente le type d'événement à créer. Les types possibles d'événement incluent <code>"UIEvents"</code>, <code>"MouseEvents"</code>, <code>"MutationEvents"</code> et <code>"HTMLEvents"</code>. Voir la section {{Anch("Notes")}} pour plus de détails.</li> -</ul> +- `event` est l'objet [Event](/en-US/docs/DOM/event) créé. +- `type` est une chaîne de caractères qui représente le type d'événement à créer. Les types possibles d'événement incluent `"UIEvents"`, `"MouseEvents"`, `"MutationEvents"` et `"HTMLEvents"`. Voir la section {{Anch("Notes")}} pour plus de détails. -<h2 id="Example">Exemple</h2> +## Exemple -<pre>// Crée l'événement. -var event = document.createEvent('Event'); + // Crée l'événement. + var event = document.createEvent('Event'); -// Nomme l'événement 'build'. -event.initEvent('build', true, true); + // Nomme l'événement 'build'. + event.initEvent('build', true, true); -// Écoute l'événement. -elem.addEventListener('build', function (e) { - // e.target correspond à elem -}, false); + // Écoute l'événement. + elem.addEventListener('build', function (e) { + // e.target correspond à elem + }, false); -// target peut être tout Element ou autre EventTarget. -elem.dispatchEvent(event); -</pre> + // target peut être tout Element ou autre EventTarget. + elem.dispatchEvent(event); -<h3 id="Notes">Notes</h3> +### Notes -<p>Les chaînes de type d'événement appropriées pour passer à <code>createEvent ()</code> sont répertoriées dans la norme DOM - voir le tableau à l'étape 2. Gardez à l'esprit que la plupart des objets événement ont maintenant des constructeurs, qui sont la méthode recommandée pour créer des occurrences d'objet événement.</p> +Les chaînes de type d'événement appropriées pour passer à `createEvent ()` sont répertoriées dans la norme DOM - voir le tableau à l'étape 2. Gardez à l'esprit que la plupart des objets événement ont maintenant des constructeurs, qui sont la méthode recommandée pour créer des occurrences d'objet événement. -<p>Gecko prend en charge certains alias d'objet événement non standard, répertoriés ci-dessous :</p> +Gecko prend en charge certains alias d'objet événement non standard, répertoriés ci-dessous : <table class="fullwidth-table"> - <tbody> - <tr> - <th>Event Module</th> - <th>Standard event object</th> - <th>Gecko also supports</th> - </tr> - <tr> - <td>Text event module</td> - <td><code>TextEvent</code></td> - <td><code>TextEvents</code></td> - </tr> - <tr> - <td>Keyboard event module</td> - <td><code>KeyboardEvent</code></td> - <td><code>KeyEvents</code></td> - </tr> - <tr> - <td>Basic events module</td> - <td><code>Event</code></td> - <td><code>Events</code></td> - </tr> - </tbody> + <tbody> + <tr> + <th>Event Module</th> + <th>Standard event object</th> + <th>Gecko also supports</th> + </tr> + <tr> + <td>Text event module</td> + <td><code>TextEvent</code></td> + <td><code>TextEvents</code></td> + </tr> + <tr> + <td>Keyboard event module</td> + <td><code>KeyboardEvent</code></td> + <td><code>KeyEvents</code></td> + </tr> + <tr> + <td>Basic events module</td> + <td><code>Event</code></td> + <td><code>Events</code></td> + </tr> + </tbody> </table> -<h2 id="Spécification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-DocumentEvent-createEvent">DOM Level 2 Events: createEvent</a></li> - <li><a href="http://www.w3.org/TR/DOM-Level-3-Events/#events-Events-DocumentEvent-createEvent">DOM Level 3 Events: createEvent</a></li> -</ul> +- [DOM Level 2 Events: createEvent](http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-DocumentEvent-createEvent) +- [DOM Level 3 Events: createEvent](http://www.w3.org/TR/DOM-Level-3-Events/#events-Events-DocumentEvent-createEvent) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/Guide/DOM/Events/Creating_and_triggering_events">Création et déclenchement d'événements</a></li> -</ul> +- [Création et déclenchement d'événements](/fr/docs/Web/Guide/DOM/Events/Creating_and_triggering_events) diff --git a/files/fr/web/api/document/createexpression/index.md b/files/fr/web/api/document/createexpression/index.md index 778ef4bdd4..ecef9fd21d 100644 --- a/files/fr/web/api/document/createexpression/index.md +++ b/files/fr/web/api/document/createexpression/index.md @@ -8,24 +8,21 @@ tags: - XPath translation_of: Web/API/Document/createExpression --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>Cette méthode compile une <code><a href="/fr/docs/Web/API/XPathExpression">XPathExpression</a></code> qui peut ensuite être utilisée pour des évaluations (répétées).</p> +Cette méthode compile une [`XPathExpression`](/fr/docs/Web/API/XPathExpression) qui peut ensuite être utilisée pour des évaluations (répétées). -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>xpathExpr</em> = <em>document</em>.createExpression(<em>xpathText</em>, <em>namespaceURLMapper</em>); -</pre> + xpathExpr = document.createExpression(xpathText, namespaceURLMapper); -<h3 id="Arguments">Paramètres</h3> +### Paramètres -<ul> - <li>String (<em>chaîne de caractères</em>) <code>xpathText</code> (l'expression XPath à compiler)</li> - <li>Fonction <code>namespaceURLMapper</code> (mappe un préfixe d'espace de noms à une URL d'espace de noms (ou null si aucun n'est nécessaire)).</li> -</ul> +- String (_chaîne de caractères_) `xpathText` (l'expression XPath à compiler) +- Fonction `namespaceURLMapper` (mappe un préfixe d'espace de noms à une URL d'espace de noms (ou null si aucun n'est nécessaire)). -<p>{{ Fx_minversion_note(3, "Avant Firefox 3, vous pouviez appeler cette méthode sur des documents autres que celui que vous aviez prévu d'exécuter avec XPath. Sous Firefox 3, vous devez l'appeler sur le même document.") }}</p> +{{ Fx_minversion_note(3, "Avant Firefox 3, vous pouviez appeler cette méthode sur des documents autres que celui que vous aviez prévu d'exécuter avec XPath. Sous Firefox 3, vous devez l'appeler sur le même document.") }} -<h3 id="Return">Valeur retournée</h3> +### Valeur retournée -<p><a href="/fr/docs/Web/API/XPathExpression">XPathExpression</a></p> +[XPathExpression](/fr/docs/Web/API/XPathExpression) diff --git a/files/fr/web/api/document/createnodeiterator/index.md b/files/fr/web/api/document/createnodeiterator/index.md index 7183969144..c89db358cf 100644 --- a/files/fr/web/api/document/createnodeiterator/index.md +++ b/files/fr/web/api/document/createnodeiterator/index.md @@ -7,108 +7,146 @@ tags: - Méthodes translation_of: Web/API/Document/createNodeIterator --- -<p>{{APIRef("DOM")}}</p> - -<p>Renvoie un nouvel objet <a href="/fr/docs/Web/API/NodeIterator"><code>NodeIterator</code></a>.</p> - -<h2 id="Syntax">Syntaxe</h2> - -<pre class="brush: js">var nodeIterator = document.createNodeIterator(root, whatToShow, filter); -</pre> - -<h3 id="Valeurs">Valeurs</h3> - -<dl> - <dt><code>root</code></dt> - <dd>Le noeud racine à partir duquel commencer la traversée de {{domxref("NodeIterator")}}.</dd> - <dt><code>whatToShow</code> {{ optional_inline() }}</dt> - <dd>Est un <code>unsigned long</code> (<em>long non signé</em>) facultatif représentant un masque de bits créé par la combinaison des constantes de la propriété <code><a href="http://www.w3.org/TR/DOM-Level-2-Traversal-Range/traversal.html#Traversal-NodeFilter">NodeFilter</a></code>. C'est un moyen pratique de filtrage pour certains types de noeuds. Il est par défaut <code>0xFFFFFFFF</code> représentant la constante <code>SHOW_ALL</code>. - <table class="standard-table"> - <tbody> - <tr> - <td class="header">Constante</td> - <td class="header">Valeur numérique</td> - <td class="header">Description</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ALL</code></td> - <td><code>-1</code> (c'est la valeur numérique maximale du <code>unsigned long</code> (<em>non signé long</em>))</td> - <td>Affiche tous les noeuds.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ATTRIBUTE</code> {{deprecated_inline}}</td> - <td><code>2</code></td> - <td>Affiche l'attribut {{domxref("Attr")}} des noeuds. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{domxref("Attr")}} comme racine ; dans ce cas, cela signifie que le nœud d'attribut apparaîtra dans la première position de l'itération ou de la traversée. Comme les attributs ne sont jamais des enfants d'autres nœuds, ils n'apparaissent pas lors de la traversée de l'arbre du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_CDATA_SECTION</code> {{deprecated_inline}}</td> - <td><code>8</code></td> - <td>Affiche les noeuds {{domxref("CDATASection")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_COMMENT</code></td> - <td><code>128</code></td> - <td>Affiche les noeuds {{domxref("Comment")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT</code></td> - <td><code>256</code></td> - <td>Affiche les noeuds {{domxref("Document")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT_FRAGMENT</code></td> - <td><code>1024</code></td> - <td>Affiche les noeuds {{domxref("DocumentFragment")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT_TYPE</code></td> - <td><code>512</code></td> - <td>Affiche les noeuds {{domxref("DocumentType")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ELEMENT</code></td> - <td><code>1</code></td> - <td>Affiche les noeuds {{domxref("Element")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ENTITY</code> {{deprecated_inline}}</td> - <td><code>32</code></td> - <td>Affiche les noeuds {{domxref("Entity")}}. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{ domxref("Entity") }} comme racine ; dans ce cas, il signifie que le noeud d'entité {{domxref("Entity") }} apparaîtra à la première position de la traversée. Étant donné que les entités ne font pas partie de l'arborescence du document, elles n'apparaissent pas lors de la traversée de l'arborescence du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ENTITY_REFERENCE</code> {{deprecated_inline}}</td> - <td><code>16</code></td> - <td>Affiche les noeuds {{domxref("EntityReference")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_NOTATION</code> {{deprecated_inline}}</td> - <td><code>2048</code></td> - <td>Affiche les noeuds {{domxref("Notation")}}. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{domxref("Notation")}} comme racine ; dans ce cas, il signifie que le noeud {{domxref("Notation")}} apparaîtra à la première position de la traversée. Étant donné que les entités ne font pas partie de l'arborescence du document, elles n'apparaissent pas lors de la traversée de l'arborescence du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_PROCESSING_INSTRUCTION</code></td> - <td><code>64</code></td> - <td>Affiche les noeuds {{domxref("ProcessingInstruction")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_TEXT</code></td> - <td><code>4</code></td> - <td>Affiche les noeuds {{domxref("Text")}}.</td> - </tr> - </tbody> - </table> - </dd> - <dt><code>filter</code> {{ optional_inline() }}</dt> - <dd>Un objet implémentant l'interface {{ domxref("NodeFilter") }} ; sa méthode <code>acceptNode()</code> sera appelée pour chaque nœud du sous-arbre basé à la racine qui est accepté comme inclus par l'indicateur whatToShow pour déterminer s'il faut ou non l'inclure dans la liste des nœuds iterables (une simple fonction de rappel peut également être utilisée à la place). La méthode devrait retourner l'un des <code>NodeFilter.FILTER_ACCEPT</code>, <code>NodeFilter.FILTER_REJECT</code> ou <code>NodeFilter.FILTER_SKIP</code>. Voir l'{{anch("Exemple")}}.</dd> -</dl> - -<div class="note"> - <p><strong>Note :</strong> Avant Gecko 12.0 {{geckoRelease("12.0")}}, cette méthode acceptait un quatrième paramètre facultatif (<code>entityReferenceExpansion</code>). Cela ne faisait pas partie de la spécification DOM4 et a donc été supprimé. Ce paramètre indiquait si les enfants des nœuds de référence d'entité étaient visibles ou non par l'itérateur. Puisque de tels noeuds n'ont jamais été créés dans les navigateurs, ce paramètre n'a eu aucun effet.</p> -</div> - -<h2>Exemple</h2> - -<pre class="brush: js">var nodeIterator = document.createNodeIterator( +{{APIRef("DOM")}} + +Renvoie un nouvel objet [`NodeIterator`](/fr/docs/Web/API/NodeIterator). + +## Syntaxe + +```js +var nodeIterator = document.createNodeIterator(root, whatToShow, filter); +``` + +### Valeurs + +- `root` + - : Le noeud racine à partir duquel commencer la traversée de {{domxref("NodeIterator")}}. +- `whatToShow` {{ optional_inline() }} + + - : Est un `unsigned long` (_long non signé_) facultatif représentant un masque de bits créé par la combinaison des constantes de la propriété [`NodeFilter`](http://www.w3.org/TR/DOM-Level-2-Traversal-Range/traversal.html#Traversal-NodeFilter). C'est un moyen pratique de filtrage pour certains types de noeuds. Il est par défaut `0xFFFFFFFF` représentant la constante `SHOW_ALL`. + + <table class="standard-table"> + <tbody> + <tr> + <td class="header">Constante</td> + <td class="header">Valeur numérique</td> + <td class="header">Description</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ALL</code></td> + <td> + <code>-1</code> (c'est la valeur numérique maximale du + <code>unsigned long</code> (<em>non signé long</em>)) + </td> + <td>Affiche tous les noeuds.</td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_ATTRIBUTE</code> {{deprecated_inline}} + </td> + <td><code>2</code></td> + <td> + Affiche l'attribut {{domxref("Attr")}} des noeuds. Cela n'a de sens + que lors de la création d'un {{domxref("TreeWalker")}} avec un + noeud {{domxref("Attr")}} comme racine ; dans ce cas, cela signifie + que le nœud d'attribut apparaîtra dans la première position de + l'itération ou de la traversée. Comme les attributs ne sont jamais des + enfants d'autres nœuds, ils n'apparaissent pas lors de la traversée de + l'arbre du document. + </td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_CDATA_SECTION</code> {{deprecated_inline}} + </td> + <td><code>8</code></td> + <td>Affiche les noeuds {{domxref("CDATASection")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_COMMENT</code></td> + <td><code>128</code></td> + <td>Affiche les noeuds {{domxref("Comment")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT</code></td> + <td><code>256</code></td> + <td>Affiche les noeuds {{domxref("Document")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT_FRAGMENT</code></td> + <td><code>1024</code></td> + <td>Affiche les noeuds {{domxref("DocumentFragment")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT_TYPE</code></td> + <td><code>512</code></td> + <td>Affiche les noeuds {{domxref("DocumentType")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ELEMENT</code></td> + <td><code>1</code></td> + <td>Affiche les noeuds {{domxref("Element")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ENTITY</code> {{deprecated_inline}}</td> + <td><code>32</code></td> + <td> + Affiche les noeuds {{domxref("Entity")}}. Cela n'a de sens que + lors de la création d'un {{domxref("TreeWalker")}} avec un noeud + {{ domxref("Entity") }} comme racine ; dans ce cas, il signifie + que le noeud d'entité {{domxref("Entity") }} apparaîtra à la + première position de la traversée. Étant donné que les entités ne font + pas partie de l'arborescence du document, elles n'apparaissent pas lors + de la traversée de l'arborescence du document. + </td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_ENTITY_REFERENCE</code> + {{deprecated_inline}} + </td> + <td><code>16</code></td> + <td>Affiche les noeuds {{domxref("EntityReference")}}.</td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_NOTATION</code> {{deprecated_inline}} + </td> + <td><code>2048</code></td> + <td> + Affiche les noeuds {{domxref("Notation")}}. Cela n'a de sens + que lors de la création d'un {{domxref("TreeWalker")}} avec un + noeud {{domxref("Notation")}} comme racine ; dans ce cas, il + signifie que le noeud {{domxref("Notation")}} apparaîtra à la + première position de la traversée. Étant donné que les entités ne font + pas partie de l'arborescence du document, elles n'apparaissent pas lors + de la traversée de l'arborescence du document. + </td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_PROCESSING_INSTRUCTION</code></td> + <td><code>64</code></td> + <td> + Affiche les noeuds {{domxref("ProcessingInstruction")}}. + </td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_TEXT</code></td> + <td><code>4</code></td> + <td>Affiche les noeuds {{domxref("Text")}}.</td> + </tr> + </tbody> + </table> + +- `filter` {{ optional_inline() }} + - : Un objet implémentant l'interface {{ domxref("NodeFilter") }} ; sa méthode `acceptNode()` sera appelée pour chaque nœud du sous-arbre basé à la racine qui est accepté comme inclus par l'indicateur whatToShow pour déterminer s'il faut ou non l'inclure dans la liste des nœuds iterables (une simple fonction de rappel peut également être utilisée à la place). La méthode devrait retourner l'un des `NodeFilter.FILTER_ACCEPT`, `NodeFilter.FILTER_REJECT` ou `NodeFilter.FILTER_SKIP`. Voir l'{{anch("Exemple")}}. + +> **Note :** Avant Gecko 12.0 {{geckoRelease("12.0")}}, cette méthode acceptait un quatrième paramètre facultatif (`entityReferenceExpansion`). Cela ne faisait pas partie de la spécification DOM4 et a donc été supprimé. Ce paramètre indiquait si les enfants des nœuds de référence d'entité étaient visibles ou non par l'itérateur. Puisque de tels noeuds n'ont jamais été créés dans les navigateurs, ce paramètre n'a eu aucun effet. + +## Exemple + +```js +var nodeIterator = document.createNodeIterator( document.body, NodeFilter.SHOW_ELEMENT, function(node) { @@ -121,19 +159,16 @@ var currentNode; while (currentNode = nodeIterator.nextNode()) { pars.push(currentNode); } +``` -</pre> +### Compatibilité des navigateurs -<h3 id="Specification">Compatibilité des navigateurs</h3> +Pris en charge dans FF 3.5+, Chrome 1+, Opera 9+, Safari 3+, IE9+, Edge -<p>Pris en charge dans FF 3.5+, Chrome 1+, Opera 9+, Safari 3+, IE9+, Edge</p> +## Voir aussi -<h2 id="Specification">Voir aussi</h2> +- [createNodeIterator sur MDN](/fr/docs/Web/API/Document/createNodeIterator) -<ul> - <li><a href="/fr/docs/Web/API/Document/createNodeIterator">createNodeIterator sur MDN</a></li> -</ul> +## Spécifications -<h2 id="Specification">Spécifications</h2> - -<p><a href="http://www.w3.org/TR/DOM-Level-2-Traversal-Range/traversal.html#Traversal-NodeIterator">DOM Level 2 Traversal : NodeIterator</a></p> +[DOM Level 2 Traversal : NodeIterator](http://www.w3.org/TR/DOM-Level-2-Traversal-Range/traversal.html#Traversal-NodeIterator) diff --git a/files/fr/web/api/document/creatensresolver/index.md b/files/fr/web/api/document/creatensresolver/index.md index 1311c87a86..b4284bf5c7 100644 --- a/files/fr/web/api/document/creatensresolver/index.md +++ b/files/fr/web/api/document/creatensresolver/index.md @@ -8,42 +8,35 @@ tags: - XPath translation_of: Web/API/Document/createNSResolver --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>Crée un <code>XPathNSResolver</code> qui résout les espaces de noms en respectant les définitions dans la portée pour un noeud spécifié.</p> +Crée un `XPathNSResolver` qui résout les espaces de noms en respectant les définitions dans la portée pour un noeud spécifié. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>nsResolver</em> = document.createNSResolver(<em>node</em>); -</pre> + nsResolver = document.createNSResolver(node); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<ul> - <li><code>node</code> est un noeud à utiliser comme contexte pour la résolution de l'espace de noms.</li> -</ul> +- `node` est un noeud à utiliser comme contexte pour la résolution de l'espace de noms. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<ul> - <li><code>nsResolver</code> est un objet XPathNSResolver.</li> -</ul> +- `nsResolver` est un objet XPathNSResolver. -<h2 id="Notes">Notes</h2> +## Notes -<p>Adapte n'importe quel noeud DOM pour résoudre les espaces de noms afin qu'une expression <a href="/fr/docs/XPath">XPath</a> puisse être facilement évaluée par rapport au contexte du nœud et son emplacement dans le document. Cet adaptateur fonctionne comme la méthode <code>lookupNamespaceURI</code> du DOM de niveau 3 sur les noeuds lors de la résolution de <code>namespaceURI</code> à partir d'un préfixe donné en utilisant l'information disponible dans la hiérarchie des noeuds au moment de l'appel de <code>lookupNamespaceURI</code>. Résout aussi correctement le préfixe implicite <code>xml</code>.</p> +Adapte n'importe quel noeud DOM pour résoudre les espaces de noms afin qu'une expression [XPath](/fr/docs/XPath) puisse être facilement évaluée par rapport au contexte du nœud et son emplacement dans le document. Cet adaptateur fonctionne comme la méthode `lookupNamespaceURI` du DOM de niveau 3 sur les noeuds lors de la résolution de `namespaceURI` à partir d'un préfixe donné en utilisant l'information disponible dans la hiérarchie des noeuds au moment de l'appel de `lookupNamespaceURI`. Résout aussi correctement le préfixe implicite `xml`. -<p>Notez que XPath définit QNames sans préfixe pour correspondre uniquement aux éléments d'un espace de noms null. XPath n'a aucun moyen de récupérer l'espace de noms par défaut tel qu'il est appliqué à une référence d'élément régulier (par exemple, <code>p[@id='_myid'</code>] pour <code>xmlns='http://www.w3.org/1999/xhtml'</code>). Pour faire correspondre les éléments par défaut dans un espace de noms non nul, vous devez soit faire référence à un élément particulier en utilisant un format tel que <code>*namespace-uri()=http://www.w3.org/1999/xhtml and name()=p[@id='_myid']</code> (<a href="/fr/docs/Web/JavaScript/Introduction_%C3%A0_l_utilisation_de_XPath_avec_JavaScript#Using_XPath_functions_to_reference_elements_with_its_default_namespace">cette approche</a> fonctionne bien pour les expressions XPath dynamiques dans lesquelles les espaces de noms pourraient ne pas être connus), soit utiliser des tests de noms préfixés et créer un résolveur d'espace de nom mappant le préfixe à l'espace de nom. Pour en savoir plus sur <a href="/fr/docs/Web/JavaScript/Introduction_%C3%A0_l_utilisation_de_XPath_avec_JavaScript#Impl%C3%A9mentation_d%27un_r%C3%A9solveur">comment créer un résolveur d'espace de nom défini par l'utilisateur</a> si vous souhaitez adopter cette dernière approche.</p> +Notez que XPath définit QNames sans préfixe pour correspondre uniquement aux éléments d'un espace de noms null. XPath n'a aucun moyen de récupérer l'espace de noms par défaut tel qu'il est appliqué à une référence d'élément régulier (par exemple, `p[@id='_myid'`] pour `xmlns='http://www.w3.org/1999/xhtml'`). Pour faire correspondre les éléments par défaut dans un espace de noms non nul, vous devez soit faire référence à un élément particulier en utilisant un format tel que `*namespace-uri()=http://www.w3.org/1999/xhtml and name()=p[@id='_myid']` ([cette approche](/fr/docs/Web/JavaScript/Introduction_%C3%A0_l_utilisation_de_XPath_avec_JavaScript#Using_XPath_functions_to_reference_elements_with_its_default_namespace) fonctionne bien pour les expressions XPath dynamiques dans lesquelles les espaces de noms pourraient ne pas être connus), soit utiliser des tests de noms préfixés et créer un résolveur d'espace de nom mappant le préfixe à l'espace de nom. Pour en savoir plus sur [comment créer un résolveur d'espace de nom défini par l'utilisateur](/fr/docs/Web/JavaScript/Introduction_%C3%A0_l_utilisation_de_XPath_avec_JavaScript#Impl%C3%A9mentation_d%27un_r%C3%A9solveur) si vous souhaitez adopter cette dernière approche. -<p><code>createNSResolver</code> a été introduit dans DOM Niveau 3.</p> +`createNSResolver` a été introduit dans DOM Niveau 3. -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/en/DOM/document.evaluate">document.evaluate</a></li> - <li><a href="/fr/docs/Web/JavaScript/Introduction_%C3%A0_l_utilisation_de_XPath_avec_JavaScript">Introduction à l'utilisation de XPath avec JavaScript</a></li> -</ul> +- [document.evaluate](/en/DOM/document.evaluate) +- [Introduction à l'utilisation de XPath avec JavaScript](/fr/docs/Web/JavaScript/Introduction_%C3%A0_l_utilisation_de_XPath_avec_JavaScript) -<h2 id="Specification">Spécifications</h2> +## Spécifications -<p><a href="http://www.w3.org/TR/DOM-Level-3-XPath/xpath.html#XPathEvaluator-createNSResolver">DOM Level 3 XPath Specification : createNSResolver</a></p> +[DOM Level 3 XPath Specification : createNSResolver](http://www.w3.org/TR/DOM-Level-3-XPath/xpath.html#XPathEvaluator-createNSResolver) diff --git a/files/fr/web/api/document/createprocessinginstruction/index.md b/files/fr/web/api/document/createprocessinginstruction/index.md index 0bdd5ee83f..48fd8b5010 100644 --- a/files/fr/web/api/document/createprocessinginstruction/index.md +++ b/files/fr/web/api/document/createprocessinginstruction/index.md @@ -12,44 +12,38 @@ tags: - instructions translation_of: Web/API/Document/createProcessingInstruction --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p><code>createProcessingInstruction()</code> crée un nouveau noeud d'instruction de traitement et le renvoie.</p> +`createProcessingInstruction()` crée un nouveau noeud d'instruction de traitement et le renvoie. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>Processing instruction node</em> = document.createProcessingInstruction(target, data) -</pre> + Processing instruction node = document.createProcessingInstruction(target, data) -<h3 id="Parameters">Paramètres</h3> +### Paramètres -<ul> - <li><code>Processing Instruction node</code> est un noeud {{domxref("ProcessingInstruction")}}.</li> - <li><code>target</code> fait référence à la partie cible du noeud d'instructions de traitement (par exemple, <?<em>target</em> ... ?>).</li> - <li><code>data</code> est une string (<em>chaîne de caractères</em>) contenant les données à ajouter aux données du noeud.</li> -</ul> +- `Processing Instruction node` est un noeud {{domxref("ProcessingInstruction")}}. +- `target` fait référence à la partie cible du noeud d'instructions de traitement (par exemple, \<?_target_ ... ?>). +- `data` est une string (_chaîne de caractères_) contenant les données à ajouter aux données du noeud. -<h3 id="Notes">Exceptions</h3> +### Exceptions -<dl> - <dt><code>NOT_SUPPORTED_ERR</code></dt> - <dd>Lancée si vous tentez de créer un noeud d'instructions de traitement sur un document HTML dans Gecko 9 {{ geckoRelease("9.0") }} ou antérieurs. Dans Gecko 10.0 {{ geckoRelease("10.0") }} et ultérieurs, vous pouvez utiliser cette méthode sur des documents HTML.</dd> - <dt><code>DOM_INVALID_CHARACTER</code></dt> - <dd>Lancée si vous essayez d'ajouter une cible d'instruction de traitement invalide (ce devrait être le cas avec le nom XML et toutes les combinaisons des lettres "xml"), ou si la séquence d'instructions de traitement de fermeture ("?>") est ajoutée aux données. Les données fournies par l'utilisateur ne peuvent donc pas être utilisées en toute sécurité sans échappement ou autres moyens de faire face à de telles situations.</dd> -</dl> +- `NOT_SUPPORTED_ERR` + - : Lancée si vous tentez de créer un noeud d'instructions de traitement sur un document HTML dans Gecko 9 {{ geckoRelease("9.0") }} ou antérieurs. Dans Gecko 10.0 {{ geckoRelease("10.0") }} et ultérieurs, vous pouvez utiliser cette méthode sur des documents HTML. +- `DOM_INVALID_CHARACTER` + - : Lancée si vous essayez d'ajouter une cible d'instruction de traitement invalide (ce devrait être le cas avec le nom XML et toutes les combinaisons des lettres "xml"), ou si la séquence d'instructions de traitement de fermeture ("?>") est ajoutée aux données. Les données fournies par l'utilisateur ne peuvent donc pas être utilisées en toute sécurité sans échappement ou autres moyens de faire face à de telles situations. -<h2 id="Example">Exemple</h2> +## Exemple -<pre>var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml") + var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml") -var pi = docu.createProcessingInstruction('xml-stylesheet', 'href="mycss.css" type="text/css"'); + var pi = docu.createProcessingInstruction('xml-stylesheet', 'href="mycss.css" type="text/css"'); -docu.insertBefore(pi, docu.firstChild); + docu.insertBefore(pi, docu.firstChild); -alert(new XMLSerializer().serializeToString(docu)); -// Affiche: <?xml-stylesheet href="mycss.css" type="text/css"?><xml/> -</pre> + alert(new XMLSerializer().serializeToString(docu)); + // Affiche: <?xml-stylesheet href="mycss.css" type="text/css"?><xml/> -<h2 id="Specification">Spécifications</h2> +## Spécifications -<p><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-createprocessinginstruction">DOM 4: createProcessingInstruction</a></p> +[DOM 4: createProcessingInstruction](http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-createprocessinginstruction) diff --git a/files/fr/web/api/document/createrange/index.md b/files/fr/web/api/document/createrange/index.md index 9ef3bffc27..c40f105f7f 100644 --- a/files/fr/web/api/document/createrange/index.md +++ b/files/fr/web/api/document/createrange/index.md @@ -8,31 +8,29 @@ tags: - Méthodes translation_of: Web/API/Document/createRange --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>Retourne un objet {{domxref("Range")}}.</p> +Retourne un objet {{domxref("Range")}}. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">range = document.createRange(); -</pre> + range = document.createRange(); -<p><code>range</code> devient un objet {{domxref("Range")}}.</p> +`range` devient un objet {{domxref("Range")}}. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:js">var range = document.createRange(); +```js +var range = document.createRange(); range.setStart(startNode, startOffset); range.setEnd(endNode, endOffset); -</pre> +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>Une fois un objet <code>Range</code> créé, il est nécessaire de spécifier les limites de départ et de fin avant de pouvoir utiliser la plupart des méthodes.</p> +Une fois un objet `Range` créé, il est nécessaire de spécifier les limites de départ et de fin avant de pouvoir utiliser la plupart des méthodes. -<h2 id="Specification">Spécification</h2> +## Spécification -<ul> - <li><a href="https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113/ranges.html#Level-2-DocumentRange-idl">DOM Level 2 Range: DocumentRange.createRange</a></li> -</ul> +- [DOM Level 2 Range: DocumentRange.createRange](https://www.w3.org/TR/2000/REC-DOM-Level-2-Traversal-Range-20001113/ranges.html#Level-2-DocumentRange-idl) diff --git a/files/fr/web/api/document/createtextnode/index.md b/files/fr/web/api/document/createtextnode/index.md index 7fc4bfe701..805d83081f 100644 --- a/files/fr/web/api/document/createtextnode/index.md +++ b/files/fr/web/api/document/createtextnode/index.md @@ -8,71 +8,53 @@ tags: - Reference translation_of: Web/API/Document/createTextNode --- -<p>{{APIRef("DOM")}}</p> +{{APIRef("DOM")}} -<p>Crée un nouveau nœud de texte.</p> +Crée un nouveau nœud de texte. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>var text</var> = document.createTextNode(<var>données</var>); -</pre> + var text = document.createTextNode(données); -<ul> - <li><code>texte</code> est un nœud de texte.</li> - <li><code>donnees</code> est une chaîne contenant les données à placer dans le nœud de texte.</li> -</ul> +- `texte` est un nœud de texte. +- `donnees` est une chaîne contenant les données à placer dans le nœud de texte. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: html"><!DOCTYPE html> -<html lang="en"> -<head> -<title>createTextNode example</title> -<script> +```html +<!DOCTYPE html> +<html lang="en"> +<head> +<title>createTextNode example</title> +<script> function addTextNode(text) { var newtext = document.createTextNode(text), p1 = document.getElementById("p1"); p1.appendChild(newtext); } -</script> -</head> +</script> +</head> -<body> - <button onclick="addTextNode('YES! ');">YES!</button> - <button onclick="addTextNode('NO! ');">NO!</button> - <button onclick="addTextNode('WE CAN! ');">WE CAN!</button> +<body> + <button onclick="addTextNode('YES! ');">YES!</button> + <button onclick="addTextNode('NO! ');">NO!</button> + <button onclick="addTextNode('WE CAN! ');">WE CAN!</button> - <hr /> + <hr /> - <p id="p1">First line of paragraph.</p> -</body> -</html></pre> + <p id="p1">First line of paragraph.</p> +</body> +</html> +``` -<h2 id="Sp.C3.A9cification">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("DOM3 Core", "core.html#ID-1975348127", "Document.createTextNode()")}}</td> - <td>{{Spec2("DOM3 Core")}}</td> - <td>Pas de changement</td> - </tr> - <tr> - <td>{{SpecName("DOM2 Core", "core.html#ID-1975348127", "Document.createTextNode()")}}</td> - <td>{{Spec2("DOM2 Core")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ------------------- | +| {{SpecName("DOM3 Core", "core.html#ID-1975348127", "Document.createTextNode()")}} | {{Spec2("DOM3 Core")}} | Pas de changement | +| {{SpecName("DOM2 Core", "core.html#ID-1975348127", "Document.createTextNode()")}} | {{Spec2("DOM2 Core")}} | Définition initiale | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.createTextNode")}}</p> +{{Compat("api.Document.createTextNode")}} diff --git a/files/fr/web/api/document/createtreewalker/index.md b/files/fr/web/api/document/createtreewalker/index.md index 66c736285f..d3380d78bb 100644 --- a/files/fr/web/api/document/createtreewalker/index.md +++ b/files/fr/web/api/document/createtreewalker/index.md @@ -11,108 +11,146 @@ tags: - Noeuds translation_of: Web/API/Document/createTreeWalker --- -<div>{{ApiRef("Document")}}</div> - -<p>La méthode de création <strong><code>Document.createTreeWalker()</code></strong> renvoie un nouvel objet {{domxref("TreeWalker")}}.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="syntaxbox"><em>treeWalker</em> = <em>document</em>.createTreeWalker(<em>root</em>, <em>whatToShow</em>, <em>filter</em>, <em>entityReferenceExpansion</em>); -</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><em>root </em></dt> - <dd>est le {{domxref("Node")}} (<em>noeud</em>) racine du {{domxref("TreeWalker")}} à traverser. Généralement, ce sera un élément appartenant au document.</dd> - <dt><em>whatToShow {{optional_inline}}</em></dt> - <dd>est un <code>unsigned long</code> (<em>long non signé</em>) facultatif représentant un masque de bits créé par combinaison des propriétés de constante de <code><a href="http://www.w3.org/TR/DOM-Level-2-Traversal-Range/traversal.html#Traversal-NodeFilter">NodeFilter</a></code>. C'est un moyen pratique de filtrage pour certains types de nœuds. Par défaut <code>0xFFFFFFFF</code> représentant la constante <code>SHOW_ALL</code>. - <table class="standard-table"> - <tbody> - <tr> - <td class="header">Constante</td> - <td class="header">Valeur numérique</td> - <td class="header">Description</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ALL</code></td> - <td><code>-1</code> (c'est la valeur numérique maximale du <code>unsigned long</code> (<em>non signé long</em>))</td> - <td>Affiche tous les noeuds.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ATTRIBUTE</code> {{deprecated_inline}}</td> - <td><code>2</code></td> - <td>Affiche l'attribut {{domxref("Attr")}} des noeuds. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{domxref("Attr")}} comme racine ; dans ce cas, cela signifie que le nœud d'attribut apparaîtra dans la première position de l'itération ou de la traversée. Comme les attributs ne sont jamais des enfants d'autres nœuds, ils n'apparaissent pas lors de la traversée de l'arbre du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_CDATA_SECTION</code> {{deprecated_inline}}</td> - <td><code>8</code></td> - <td>Affiche les noeuds {{domxref("CDATASection")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_COMMENT</code></td> - <td><code>128</code></td> - <td>Affiche les noeuds {{domxref("Comment")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT</code></td> - <td><code>256</code></td> - <td>Affiche les noeuds {{domxref("Document")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT_FRAGMENT</code></td> - <td><code>1024</code></td> - <td>Affiche les noeuds {{domxref("DocumentFragment")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT_TYPE</code></td> - <td><code>512</code></td> - <td>Affiche les noeuds {{domxref("DocumentType")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ELEMENT</code></td> - <td><code>1</code></td> - <td>Affiche les noeuds {{domxref("Element")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ENTITY</code> {{deprecated_inline}}</td> - <td><code>32</code></td> - <td>Affiche les noeuds {{domxref("Entity")}}. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{ domxref("Entity") }} comme racine ; dans ce cas, il signifie que le noeud d'entité {{domxref("Entity") }} apparaîtra à la première position de la traversée. Étant donné que les entités ne font pas partie de l'arborescence du document, elles n'apparaissent pas lors de la traversée de l'arborescence du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ENTITY_REFERENCE</code> {{deprecated_inline}}</td> - <td><code>16</code></td> - <td>Affiche les noeuds {{domxref("EntityReference")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_NOTATION</code> {{deprecated_inline}}</td> - <td><code>2048</code></td> - <td>Affiche les noeuds {{domxref("Notation")}}. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{domxref("Notation")}} comme racine ; dans ce cas, il signifie que le noeud {{domxref("Notation")}} apparaîtra à la première position de la traversée. Étant donné que les entités ne font pas partie de l'arborescence du document, elles n'apparaissent pas lors de la traversée de l'arborescence du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_PROCESSING_INSTRUCTION</code></td> - <td><code>64</code></td> - <td>Affiche les noeuds {{domxref("ProcessingInstruction")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_TEXT</code></td> - <td><code>4</code></td> - <td>Affiche les noeuds {{domxref("Text")}}.</td> - </tr> - </tbody> - </table> - </dd> - <dt><em>filter <em>{{optional_inline}}</em></em></dt> - <dd>est un {{domxref("NodeFilter")}} (<em>filtre de noeud</em>) facultatif, c'est à dire un objet avec une méthode <code>acceptNode</code> appelé par {{domxref("TreeWalker")}} pour déterminer s'il doit accepter ou non un nœud qui a passé le test <code>whatToShow</code>.</dd> - <dt><em>entityReferenceExpansion<em> {{optional_inline}}</em></em> <em>{{obsolete_inline}}</em></dt> - <dd>est un {{domxref("Boolean")}} (<em>booléen</em>) indiquant si, lors de la suppression d'une {{domxref("EntityReference")}}, son sous-arbre doit être supprimé en même temps.</dd> -</dl> - -<h2 id="Exemple">Exemple</h2> - -<p>L'exemple suivant passe à travers tous les noeuds du "body" (<em>corps du document</em>), réduit l'ensemble des noeuds aux éléments, passe simplement à travers chaque noeud acceptable (à la place, il pourrait réduire l'ensemble dans la méthode <code>acceptNode()</code>), puis utilise l'itérateur de traversée de l'arbre créé pour avancer à travers les nœuds (maintenant tous les éléments) et les écrire dans un tableau.</p> - -<pre class="brush: js">var treeWalker = document.createTreeWalker( +{{ApiRef("Document")}} + +La méthode de création **`Document.createTreeWalker()`** renvoie un nouvel objet {{domxref("TreeWalker")}}. + +## Syntaxe + + treeWalker = document.createTreeWalker(root, whatToShow, filter, entityReferenceExpansion); + +### Paramètres + +- _root_ + - : est le {{domxref("Node")}} (_noeud_) racine du {{domxref("TreeWalker")}} à traverser. Généralement, ce sera un élément appartenant au document. +- _whatToShow {{optional_inline}}_ + + - : est un `unsigned long` (_long non signé_) facultatif représentant un masque de bits créé par combinaison des propriétés de constante de [`NodeFilter`](http://www.w3.org/TR/DOM-Level-2-Traversal-Range/traversal.html#Traversal-NodeFilter). C'est un moyen pratique de filtrage pour certains types de nœuds. Par défaut `0xFFFFFFFF` représentant la constante `SHOW_ALL`. + + <table class="standard-table"> + <tbody> + <tr> + <td class="header">Constante</td> + <td class="header">Valeur numérique</td> + <td class="header">Description</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ALL</code></td> + <td> + <code>-1</code> (c'est la valeur numérique maximale du + <code>unsigned long</code> (<em>non signé long</em>)) + </td> + <td>Affiche tous les noeuds.</td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_ATTRIBUTE</code> {{deprecated_inline}} + </td> + <td><code>2</code></td> + <td> + Affiche l'attribut {{domxref("Attr")}} des noeuds. Cela n'a de sens + que lors de la création d'un {{domxref("TreeWalker")}} avec un + noeud {{domxref("Attr")}} comme racine ; dans ce cas, cela signifie + que le nœud d'attribut apparaîtra dans la première position de + l'itération ou de la traversée. Comme les attributs ne sont jamais des + enfants d'autres nœuds, ils n'apparaissent pas lors de la traversée de + l'arbre du document. + </td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_CDATA_SECTION</code> {{deprecated_inline}} + </td> + <td><code>8</code></td> + <td>Affiche les noeuds {{domxref("CDATASection")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_COMMENT</code></td> + <td><code>128</code></td> + <td>Affiche les noeuds {{domxref("Comment")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT</code></td> + <td><code>256</code></td> + <td>Affiche les noeuds {{domxref("Document")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT_FRAGMENT</code></td> + <td><code>1024</code></td> + <td>Affiche les noeuds {{domxref("DocumentFragment")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT_TYPE</code></td> + <td><code>512</code></td> + <td>Affiche les noeuds {{domxref("DocumentType")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ELEMENT</code></td> + <td><code>1</code></td> + <td>Affiche les noeuds {{domxref("Element")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ENTITY</code> {{deprecated_inline}}</td> + <td><code>32</code></td> + <td> + Affiche les noeuds {{domxref("Entity")}}. Cela n'a de sens que + lors de la création d'un {{domxref("TreeWalker")}} avec un noeud + {{ domxref("Entity") }} comme racine ; dans ce cas, il signifie + que le noeud d'entité {{domxref("Entity") }} apparaîtra à la + première position de la traversée. Étant donné que les entités ne font + pas partie de l'arborescence du document, elles n'apparaissent pas lors + de la traversée de l'arborescence du document. + </td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_ENTITY_REFERENCE</code> + {{deprecated_inline}} + </td> + <td><code>16</code></td> + <td>Affiche les noeuds {{domxref("EntityReference")}}.</td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_NOTATION</code> {{deprecated_inline}} + </td> + <td><code>2048</code></td> + <td> + Affiche les noeuds {{domxref("Notation")}}. Cela n'a de sens + que lors de la création d'un {{domxref("TreeWalker")}} avec un + noeud {{domxref("Notation")}} comme racine ; dans ce cas, il + signifie que le noeud {{domxref("Notation")}} apparaîtra à la + première position de la traversée. Étant donné que les entités ne font + pas partie de l'arborescence du document, elles n'apparaissent pas lors + de la traversée de l'arborescence du document. + </td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_PROCESSING_INSTRUCTION</code></td> + <td><code>64</code></td> + <td> + Affiche les noeuds {{domxref("ProcessingInstruction")}}. + </td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_TEXT</code></td> + <td><code>4</code></td> + <td>Affiche les noeuds {{domxref("Text")}}.</td> + </tr> + </tbody> + </table> + +- _filter _{{optional_inline}}\*\* + - : est un {{domxref("NodeFilter")}} (_filtre de noeud_) facultatif, c'est à dire un objet avec une méthode `acceptNode` appelé par {{domxref("TreeWalker")}} pour déterminer s'il doit accepter ou non un nœud qui a passé le test `whatToShow`. +- _entityReferenceExpansion _{{optional_inline}}\*\* _{{obsolete_inline}}_ + - : est un {{domxref("Boolean")}} (_booléen_) indiquant si, lors de la suppression d'une {{domxref("EntityReference")}}, son sous-arbre doit être supprimé en même temps. + +## Exemple + +L'exemple suivant passe à travers tous les noeuds du "body" (_corps du document_), réduit l'ensemble des noeuds aux éléments, passe simplement à travers chaque noeud acceptable (à la place, il pourrait réduire l'ensemble dans la méthode `acceptNode()`), puis utilise l'itérateur de traversée de l'arbre créé pour avancer à travers les nœuds (maintenant tous les éléments) et les écrire dans un tableau. + +```js +var treeWalker = document.createTreeWalker( document.body, NodeFilter.SHOW_ELEMENT, { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, @@ -122,36 +160,19 @@ translation_of: Web/API/Document/createTreeWalker var nodeList = []; while(treeWalker.nextNode()) nodeList.push(treeWalker.currentNode); -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-document-createtreewalker', 'Document.createTreeWalker')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Suppression du paramètre <code>expandEntityReferences</code>. Les paramètres facultatifs <code>whatToShow</code> et <code>filter</code> .</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Traversal_Range', 'traversal.html#NodeIteratorFactory-createTreeWalker', 'Document.createTreeWalker')}}</td> - <td>{{Spec2('DOM2 Traversal_Range')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.createTreeWalker")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface de l'objet qu'il crée : {{domxref("TreeWalker")}}.</li> -</ul> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | --------------------------------------------------------------------------------------------------------- | +| {{SpecName('DOM WHATWG', '#dom-document-createtreewalker', 'Document.createTreeWalker')}} | {{Spec2('DOM WHATWG')}} | Suppression du paramètre `expandEntityReferences`. Les paramètres facultatifs `whatToShow` et `filter` . | +| {{SpecName('DOM2 Traversal_Range', 'traversal.html#NodeIteratorFactory-createTreeWalker', 'Document.createTreeWalker')}} | {{Spec2('DOM2 Traversal_Range')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Document.createTreeWalker")}} + +## Voir aussi + +- L'interface de l'objet qu'il crée : {{domxref("TreeWalker")}}. diff --git a/files/fr/web/api/document/currentscript/index.md b/files/fr/web/api/document/currentscript/index.md index d0758e6c1e..175c277f60 100644 --- a/files/fr/web/api/document/currentscript/index.md +++ b/files/fr/web/api/document/currentscript/index.md @@ -9,58 +9,44 @@ tags: - Script translation_of: Web/API/Document/currentScript --- -<div>{{ApiRef("DOM")}}</div> +{{ApiRef("DOM")}} -<p>Retourne l'élément {{HTMLElement("script")}} dont le script est en cours de traitement.</p> +Retourne l'élément {{HTMLElement("script")}} dont le script est en cours de traitement. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <var>curScriptElement</var> = document.currentScript; -</pre> + var curScriptElement = document.currentScript; -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Cet exemple vérifie si le script s'exécute de manière asynchrone :</p> +Cet exemple vérifie si le script s'exécute de manière asynchrone : -<pre class="brush:js">if (document.currentScript.async) { +```js +if (document.currentScript.async) { console.log("Exécution asynchrone"); } else { console.log("Exécution synchrone"); -}</pre> +} +``` -<p><a href="/samples/html/currentScript.html">Voir l'exemple sur une page</a></p> +[Voir l'exemple sur une page](/samples/html/currentScript.html) -<h2 id="Notes">Notes</h2> +## Notes -<p>Il est important de noter que l'élément {{HTMLElement("script")}} ne sera pas référencé si le code dans le script est appelé par une fonction de rappel ou par un gestionnaire d'événements ; seul sera référencé l'élément alors qu'il est initialement en cours d'exécution.</p> +Il est important de noter que l'élément {{HTMLElement("script")}} ne sera pas référencé si le code dans le script est appelé par une fonction de rappel ou par un gestionnaire d'événements ; seul sera référencé l'élément alors qu'il est initialement en cours d'exécution. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("HTML WHATWG", "dom.html#dom-document-currentscript", "Document.currentScript")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("HTML WHATWG", "dom.html#dom-document-currentscript", "Document.currentScript")}} | {{Spec2("HTML WHATWG")}} | Définition initiale | -<h2 id="Compatibilité_navigateur">Compatibilité navigateur</h2> +## Compatibilité navigateur -<div>{{Compat("api.Document.currentScript")}}</div> +{{Compat("api.Document.currentScript")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{HTMLElement("script")}}</li> - <li>{{domxref("document.onafterscriptexecute")}}</li> - <li>{{domxref("document.onbeforescriptexecute")}}</li> -</ul> +- {{HTMLElement("script")}} +- {{domxref("document.onafterscriptexecute")}} +- {{domxref("document.onbeforescriptexecute")}} diff --git a/files/fr/web/api/document/defaultview/index.md b/files/fr/web/api/document/defaultview/index.md index fce4d88134..6816203fef 100644 --- a/files/fr/web/api/document/defaultview/index.md +++ b/files/fr/web/api/document/defaultview/index.md @@ -3,15 +3,20 @@ title: document.defaultView slug: Web/API/Document/defaultView translation_of: Web/API/Document/defaultView --- -<p>Dans les navigateurs, cette propriété renvoie l'objet <a href="/en-US/docs/DOM/window">window</a> associé au document ou <code>null</code> si non disponible.</p> -<h2 id="Syntax">Syntaxe</h2> -<pre class="syntaxbox">var win = document.defaultView;</pre> -<p>Cette propriété est en lecture seule.</p> -<h2 id="Notes">Notes</h2> -<p>D'après <a href="http://www.quirksmode.org/dom/w3c_html.html">quirksmode</a>, <code>defaultView</code> n'est pas supporté dans les versions d'IE inférieures à 9.</p> -<h2 id="Specification">Spécification</h2> -<ul> - <li><a href="/en-US/docs/HTML/HTML5">HTML5: defaultView</a></li> - <li><a href="http://www.w3.org/TR/DOM-Level-2-Views/views.html#Views-DocumentView-defaultView">DOM Level 2 Views: defaultView</a></li> - <li><a href="http://www.w3.org/TR/DOM-Level-3-Views/">DOM Level 3 Views</a> (Seulement développé en Working Group Note mais pas implémenté)</li> -</ul> +Dans les navigateurs, cette propriété renvoie l'objet [window](/en-US/docs/DOM/window) associé au document ou `null` si non disponible. + +## Syntaxe + + var win = document.defaultView; + +Cette propriété est en lecture seule. + +## Notes + +D'après [quirksmode](http://www.quirksmode.org/dom/w3c_html.html), `defaultView` n'est pas supporté dans les versions d'IE inférieures à 9. + +## Spécification + +- [HTML5: defaultView](/en-US/docs/HTML/HTML5) +- [DOM Level 2 Views: defaultView](http://www.w3.org/TR/DOM-Level-2-Views/views.html#Views-DocumentView-defaultView) +- [DOM Level 3 Views](http://www.w3.org/TR/DOM-Level-3-Views/) (Seulement développé en Working Group Note mais pas implémenté) diff --git a/files/fr/web/api/document/designmode/index.md b/files/fr/web/api/document/designmode/index.md index 0a4edb5920..78cc51a2e2 100644 --- a/files/fr/web/api/document/designmode/index.md +++ b/files/fr/web/api/document/designmode/index.md @@ -3,49 +3,35 @@ title: Document.designMode slug: Web/API/Document/designMode translation_of: Web/API/Document/designMode --- -<div>{{ ApiRef() }}</div> +{{ ApiRef() }} -<p>document.designMode contrôle si l'ensemble du document est modifiable. Les valeurs valides sont "on" et "off". Conformément à la spécification, cette propriété est par défaut sur "off". Firefox suit cette norme. Les versions antérieures de Chrome et IE ont par défaut la valeur "<code>inherit</code>". Pour les versions entre IE6-10, la valeur est en majuscule.</p> +document.designMode contrôle si l'ensemble du document est modifiable. Les valeurs valides sont "on" et "off". Conformément à la spécification, cette propriété est par défaut sur "off". Firefox suit cette norme. Les versions antérieures de Chrome et IE ont par défaut la valeur "`inherit`". Pour les versions entre IE6-10, la valeur est en majuscule. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var mode = document.designMode; +```js +var mode = document.designMode; document.designMode = "on"; -document.designMode = "off";</pre> +document.designMode = "off"; +``` -<h2 id="Example">Exemple</h2> +## Exemple -<p>Rendre un document {{HTMLElement("iframe")}} éditable</p> +Rendre un document {{HTMLElement("iframe")}} éditable -<pre>iframe_node.contentDocument.designMode = "on"; -</pre> + iframe_node.contentDocument.designMode = "on"; -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', '#making-entire-documents-editable:-the-designmode-idl-attribute', 'designMode')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | -------------------- | +| {{SpecName('HTML WHATWG', '#making-entire-documents-editable:-the-designmode-idl-attribute', 'designMode')}} | {{Spec2('HTML WHATWG')}} | Définition initiale. | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.designMode")}}</p> +{{Compat("api.Document.designMode")}} -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/Guide/HTML/Editable_content/Rich-Text_Editing_in_Mozilla">Rich-Text Editing in Mozilla</a></li> - <li>{{domxref("HTMLElement.contentEditable")}}</li> -</ul> +- [Rich-Text Editing in Mozilla](/fr/docs/Web/Guide/HTML/Editable_content/Rich-Text_Editing_in_Mozilla) +- {{domxref("HTMLElement.contentEditable")}} diff --git a/files/fr/web/api/document/dir/index.md b/files/fr/web/api/document/dir/index.md index 03e94f3230..d7f32ff364 100644 --- a/files/fr/web/api/document/dir/index.md +++ b/files/fr/web/api/document/dir/index.md @@ -8,35 +8,21 @@ tags: - Reference translation_of: Web/API/Document/dir --- -<p>{{ApiRef("")}}</p> +{{ApiRef("")}} -<p>La propriété <code><strong>Document.dir</strong></code> est une chaîne de caractères {{domxref("DOMString")}} représentant la direction du texte du document : de gauche à droite (par défaut) ou de droite à gauche. Les valeurs possibles sont <code>'rtl'</code>, droite vers gauche, et <code>'ltr'</code>, gauche vers droite.</p> +La propriété **`Document.dir`** est une chaîne de caractères {{domxref("DOMString")}} représentant la direction du texte du document : de gauche à droite (par défaut) ou de droite à gauche. Les valeurs possibles sont `'rtl'`, droite vers gauche, et `'ltr'`, gauche vers droite. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>dirStr</em> = <em>document.</em>dir; -<em>document.dir</em> = <em>dirStr;</em> -</pre> + dirStr = document.dir; + document.dir = dirStr; -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("HTML WHATWG", "#dom-document-dir", "Document.dir")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------ | -------------------------------- | -------------------- | +| {{SpecName("HTML WHATWG", "#dom-document-dir", "Document.dir")}} | {{Spec2("HTML WHATWG")}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.dir")}}</p> +{{Compat("api.Document.dir")}} diff --git a/files/fr/web/api/document/doctype/index.md b/files/fr/web/api/document/doctype/index.md index 980447cc3c..15f950a836 100644 --- a/files/fr/web/api/document/doctype/index.md +++ b/files/fr/web/api/document/doctype/index.md @@ -10,56 +10,38 @@ tags: - Type translation_of: Web/API/Document/doctype --- -<div>{{ApiRef("DOM")}}</div> +{{ApiRef("DOM")}} -<p>Renvoie la "Document Type Declaration (DTD)" (<em>déclaration de type de document</em>) associée avec le document actuel. L'objet renvoyé implémente l'interface {{domxref("DocumentType")}}. Utilisez {{domxref("DOMImplementation.createDocumentType()")}} pour créer un <code>DocumentType</code>.</p> +Renvoie la "Document Type Declaration (DTD)" (_déclaration de type de document_) associée avec le document actuel. L'objet renvoyé implémente l'interface {{domxref("DocumentType")}}. Utilisez {{domxref("DOMImplementation.createDocumentType()")}} pour créer un `DocumentType`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>doctype</var> = <var>document</var>.doctype; -</pre> + doctype = document.doctype; -<ul> - <li><code>doctype</code> est une propriété en lecture seule.</li> -</ul> +- `doctype` est une propriété en lecture seule. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush:js">var doctypeObj = document.doctype; +```js +var doctypeObj = document.doctype; console.log( "doctypeObj.name: " + doctypeObj.name + "\n" + "doctypeObj.internalSubset: " + doctypeObj.internalSubset + "\n" + "doctypeObj.publicId: " + doctypeObj.publicId + "\n" + "doctypeObj.systemId: " + doctypeObj.systemId -);</pre> +); +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>La propriété renvoie <code>null</code> si aucune DTD n'est associée au document en cours.</p> +La propriété renvoie `null` si aucune DTD n'est associée au document en cours. -<p>DOM level 2 ne prend pas en charge l'édition de la déclaration de type de document (DTD).</p> +DOM level 2 ne prend pas en charge l'édition de la déclaration de type de document (DTD). -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("DOM3 Core", "core.html#ID-B63ED1A31", "Document.doctype")}}</td> - <td>{{Spec2("DOM3 Core")}}</td> - <td>Valeur de retour modifiée pour les documents HTML avec absence d'élément {{HTMLElement("html")}}. Définit que le type de document peut être modifié.</td> - </tr> - <tr> - <td>{{SpecName("DOM2 Core", "core.html#ID-B63ED1A31", "Document.doctype")}}</td> - <td>{{Spec2("DOM2 Core")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| {{SpecName("DOM3 Core", "core.html#ID-B63ED1A31", "Document.doctype")}} | {{Spec2("DOM3 Core")}} | Valeur de retour modifiée pour les documents HTML avec absence d'élément {{HTMLElement("html")}}. Définit que le type de document peut être modifié. | +| {{SpecName("DOM2 Core", "core.html#ID-B63ED1A31", "Document.doctype")}} | {{Spec2("DOM2 Core")}} | Définition initiale | diff --git a/files/fr/web/api/document/document/index.md b/files/fr/web/api/document/document/index.md index 7b0e3c2501..05f3e52b50 100644 --- a/files/fr/web/api/document/document/index.md +++ b/files/fr/web/api/document/document/index.md @@ -9,35 +9,24 @@ tags: - Reference translation_of: Web/API/Document/Document --- -<p>{{APIRef}}</p> +{{APIRef}} -<p>Le constructeur <code><strong>Document</strong></code> crée un nouvel objet de {{domxref("Document")}}, lequel c'est la référence de la page courante dans le navigateur et servant comme point d'entrer aux contenus de la page.</p> +Le constructeur **`Document`** crée un nouvel objet de {{domxref("Document")}}, lequel c'est la référence de la page courante dans le navigateur et servant comme point d'entrer aux contenus de la page. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <em>document</em> = new Document()</pre> + var document = new Document() -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>None.</p> +None. -<p>Spécifications</p> +Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG','#interface-document','Document')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> +| Specification | Status | Comment | +| -------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName('DOM WHATWG','#interface-document','Document')}} | {{Spec2('DOM WHATWG')}} | Initial definition. | -<h2 id="Compatibilité_Navigateurs">Compatibilité Navigateurs</h2> +## Compatibilité Navigateurs -<div>{{Compat("api.Document.Document")}}</div> +{{Compat("api.Document.Document")}} diff --git a/files/fr/web/api/document/documentelement/index.md b/files/fr/web/api/document/documentelement/index.md index 84e62d8bea..cd9cfbe64a 100644 --- a/files/fr/web/api/document/documentelement/index.md +++ b/files/fr/web/api/document/documentelement/index.md @@ -10,63 +10,37 @@ tags: - Reference translation_of: Web/API/Document/documentElement --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p><code><strong>Document.documentElement</strong></code>renvoie l'<code><a href="/fr/docs/Web/API/element">Element</a></code> qui est l'élément racine du <a href="/fr/docs/Web/API/document">document</a> (par exemple, l'élément <code><html></code> pour les documents HTML).</p> +**`Document.documentElement`**renvoie l'[`Element`](/fr/docs/Web/API/element) qui est l'élément racine du [document](/fr/docs/Web/API/document) (par exemple, l'élément `<html>` pour les documents HTML). -<h3 id="Syntaxe">Syntaxe</h3> +### Syntaxe -<pre class="eval">var<em> element</em> = document.documentElement; -</pre> + var element = document.documentElement; -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="eval">var racine = document.documentElement; -var premierNiveau = racine.childNodes; -// premierNiveau est une NodeList des enfants directs de l'élément racine -for (var i = 0; i < premierNiveau.length; i++) { - // fait quelque chose avec chaque enfant direct de l'élément racine - // en tant que premierNiveau[i] -} -</pre> + var racine = document.documentElement; + var premierNiveau = racine.childNodes; + // premierNiveau est une NodeList des enfants directs de l'élément racine + for (var i = 0; i < premierNiveau.length; i++) { + // fait quelque chose avec chaque enfant direct de l'élément racine + // en tant que premierNiveau[i] + } -<h2 id="Notes">Notes</h2> +## Notes -<p>Pour tout document HTML non vide, <code>document.documentElement</code> sera toujours un élément {{HTMLElement ("html")}}. Pour tout document XML non vide, <code>document.documentElement</code> sera toujours l'élément racine du document.</p> +Pour tout document HTML non vide, `document.documentElement` sera toujours un élément {{HTMLElement ("html")}}. Pour tout document XML non vide, `document.documentElement` sera toujours l'élément racine du document. -<h2 id="Sp.C3.A9cification">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('DOM2 Core','core.html#ID-87CD092','Document.documentElement')}}</td> - <td>{{Spec2('DOM2 Core')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('DOM3 Core','core.html#ID-87CD092','Document.documentElement')}}</td> - <td>{{Spec2('DOM3 Core')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('DOM4','#dom-document-documentelement','Document.documentElement')}}</td> - <td>{{Spec2('DOM4')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG','#dom-document-documentelement','Document.documentElement')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName('DOM2 Core','core.html#ID-87CD092','Document.documentElement')}} | {{Spec2('DOM2 Core')}} | | +| {{SpecName('DOM3 Core','core.html#ID-87CD092','Document.documentElement')}} | {{Spec2('DOM3 Core')}} | | +| {{SpecName('DOM4','#dom-document-documentelement','Document.documentElement')}} | {{Spec2('DOM4')}} | | +| {{SpecName('DOM WHATWG','#dom-document-documentelement','Document.documentElement')}} | {{Spec2('DOM WHATWG')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs - - -<p>{{Compat("api.Document.documentElement")}}</p> +{{Compat("api.Document.documentElement")}} diff --git a/files/fr/web/api/document/documenturi/index.md b/files/fr/web/api/document/documenturi/index.md index 31e15a16be..b3ee14255f 100644 --- a/files/fr/web/api/document/documenturi/index.md +++ b/files/fr/web/api/document/documenturi/index.md @@ -9,46 +9,27 @@ tags: - URI translation_of: Web/API/Document/documentURI --- -<div>{{ApiRef("DOM")}}</div> +{{ApiRef("DOM")}} -<p>La propriété <code><strong>documentURI</strong></code> de l'interface {{domxref("Document")}} renvoie l'emplacement du document sous forme "string" (<em>chaîne de caractères</em>).</p> +La propriété **`documentURI`** de l'interface {{domxref("Document")}} renvoie l'emplacement du document sous forme "string" (_chaîne de caractères_). -<p>Initialement, la spécification DOM3 définissait cet attribut en lecture/écriture. Dans la norme actuelle DOM, il est en lecture seule.</p> +Initialement, la spécification DOM3 définissait cet attribut en lecture/écriture. Dans la norme actuelle DOM, il est en lecture seule. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <var>string</var> = document.documentURI; -</pre> + var string = document.documentURI; -<h2 id="Notes">Notes</h2> +## Notes -<p>Les documents HTML ont une propriété {{domxref("document.URL")}} qui renvoie la même valeur. Contrairement à l'<code>URL</code>, <code>documentURI</code> est disponible pour tous les types de documents.</p> +Les documents HTML ont une propriété {{domxref("document.URL")}} qui renvoie la même valeur. Contrairement à l'`URL`, `documentURI` est disponible pour tous les types de documents. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-document-documenturi','documentURI')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('DOM3 Core', '#Document3-documentURI', 'documentURI')}}</td> - <td>{{Spec2('DOM3 Core')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName('DOM WHATWG', '#dom-document-documenturi','documentURI')}} | {{Spec2('DOM WHATWG')}} | | +| {{SpecName('DOM3 Core', '#Document3-documentURI', 'documentURI')}} | {{Spec2('DOM3 Core')}} | Définition initiale | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs - - - -<p>{{Compat("api.Document.documentURI")}}</p> +{{Compat("api.Document.documentURI")}} diff --git a/files/fr/web/api/document/documenturiobject/index.md b/files/fr/web/api/document/documenturiobject/index.md index cc5030a977..88c81d247b 100644 --- a/files/fr/web/api/document/documenturiobject/index.md +++ b/files/fr/web/api/document/documenturiobject/index.md @@ -8,31 +8,32 @@ tags: - Reference translation_of: Web/API/Document/documentURIObject --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>La propriété en lecture seule <code><strong>Document.documentURIObject</strong></code> renvoie un objet {{ Interface("nsIURI") }} représentant l'URI du <a href="/fr/docs/Web/API/document">document</a>.</p> +La propriété en lecture seule **`Document.documentURIObject`** renvoie un objet {{ Interface("nsIURI") }} représentant l'URI du [document](/fr/docs/Web/API/document). -<p>Cette propriété fonctionne uniquement pour les scripts privilégiés (UniversalXPConnect), comme le code des extensions. Pour le contenu Web, elle n'a aucune signification particulière et peut être utilisée comme n'importe quelle propriété personnalisée.</p> +Cette propriété fonctionne uniquement pour les scripts privilégiés (UniversalXPConnect), comme le code des extensions. Pour le contenu Web, elle n'a aucune signification particulière et peut être utilisée comme n'importe quelle propriété personnalisée. -<p>Dans le cas d'un code privilégié, il convient de faire attention à ne pas essayer d'obtenir ou modifier cette propriété sur un objet de contenu non enveloppé (par exemple sur l'objet <code>wrappedJSObject</code> d'un <code><a href="/fr/docs/Mozilla/Tech/Xray_vision">XPCNativeWrapper</a></code>). Consultez les commentaires du {{ Bug(324464) }} pour plus de détails.</p> +Dans le cas d'un code privilégié, il convient de faire attention à ne pas essayer d'obtenir ou modifier cette propriété sur un objet de contenu non enveloppé (par exemple sur l'objet `wrappedJSObject` d'un [`XPCNativeWrapper`](/fr/docs/Mozilla/Tech/Xray_vision)). Consultez les commentaires du {{ Bug(324464) }} pour plus de détails. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var uri = doc.documentURIObject;</pre> +```js +var uri = doc.documentURIObject; +``` -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="eval">// Vérifie que le schéma d'URI pour l'onglet courant dans Firefox est « http », -// en supposant que ce code s'exécute dans le contexte de browser.xul + // Vérifie que le schéma d'URI pour l'onglet courant dans Firefox est « http », + // en supposant que ce code s'exécute dans le contexte de browser.xul -var uriObj = content.document.documentURIObject; -var uriPort = uriObj.port; + var uriObj = content.document.documentURIObject; + var uriPort = uriObj.port; -if (uriObj.schemeIs('http')) { - ... -} -</pre> + if (uriObj.schemeIs('http')) { + ... + } -<h2 id="Sp.C3.A9cification">Spécifications</h2> +## Spécifications -<p>Ne fait partie d'aucune spécification.</p> +Ne fait partie d'aucune spécification. diff --git a/files/fr/web/api/document/domain/index.md b/files/fr/web/api/document/domain/index.md index 94575c1b4b..0f050e51e7 100644 --- a/files/fr/web/api/document/domain/index.md +++ b/files/fr/web/api/document/domain/index.md @@ -12,48 +12,46 @@ tags: - Reference translation_of: Web/API/Document/domain --- -<div>{{ApiRef}}</div> +{{ApiRef}} -<p>Retourne/définit la partie domaine de l'origine du document courant, telle qu'utilisée par la <a href="/fr/docs/Web/JavaScript/Same_origin_policy_for_JavaScript">politique d'origine identique</a>.</p> +Retourne/définit la partie domaine de l'origine du document courant, telle qu'utilisée par la [politique d'origine identique](/fr/docs/Web/JavaScript/Same_origin_policy_for_JavaScript). -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <var>chaineDomaine</var> = document.domain; document.domain = <em>chaine</em>; -</pre> + var chaineDomaine = document.domain; document.domain = chaine; -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:js">// Pour le document www.example.xxx/good.html, +```js +// Pour le document www.example.xxx/good.html, // ce script ferme la fenêtre var mauvaisDomaine = "www.example.xxx"; if (document.domain == mauvaisDomaine ) - window.close(); // juste un exemple - window.close() n'a parfois aucun effet.</pre> + window.close(); // juste un exemple - window.close() n'a parfois aucun effet. +``` -<pre class="brush:js">// Pour l'URI https://developer.mozilla.org/en-US/docs/Web, ce qui +```js +// Pour l'URI https://developer.mozilla.org/en-US/docs/Web, ce qui // suit définit le domaine comme étant la chaîne "developer.mozilla.org" var domaine = document.domain; -</pre> +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>Cette propriété retourne <code>null</code> si le domaine du document ne peut pas être identifié.</p> +Cette propriété retourne `null` si le domaine du document ne peut pas être identifié. -<p>Mozilla vous laissera la définir à un superdomaine de la valeur courante, contraint par son <a href="/en-US/docs/XPCOM_Interface_Reference/nsIEffectiveTLDService#getBaseDomain.28.29">domaine de base</a>. Par exemple, sur developer.mozilla.org, il est possible de la définir à "mozilla.org" mais pas à "mozilla.com" ou "org".</p> +Mozilla vous laissera la définir à un superdomaine de la valeur courante, contraint par son [domaine de base](/en-US/docs/XPCOM_Interface_Reference/nsIEffectiveTLDService#getBaseDomain.28.29). Par exemple, sur developer.mozilla.org, il est possible de la définir à "mozilla.org" mais pas à "mozilla.com" ou "org". -<p>Si cette propriété est définie avec succès, la partie "port" de l'origine est également définie à null.</p> +Si cette propriété est définie avec succès, la partie "port" de l'origine est également définie à null. -<p>Mozilla fait la distinction entre la propriété d'un <code>document.domain</code> qui n'a jamais été modifiée d'une explicitement définie avec le même domaine que l'URL du document, même si la propriété renvoie la même valeur dans les deux cas. Un document est autorisé à accéder à un autre si il ont tous deux défini <code>document.domain</code> à la même valeur, indiquant leur intention de coopérer, ou si aucun des deux n'a défini <code>document.domain</code> et que les domaines dans les URLs sont les mêmes (<a href="https://mxr.mozilla.org/mozilla-central/source/caps/nsPrincipal.cpp?rev=ecb7068b07a1&mark=199-215#199">implementation</a>). Sans cette politique spéciale, chaque site serait sujet au Cross-Site-Scripting (XSS) depuis ses sous-domaines (par exemple, <a href="https://bugzilla.mozilla.org">https://bugzilla.mozilla.org</a> pourrait être attaqué par des pièces jointes de bugs sur <a href="https://bug*.bugzilla.mozilla.org">https://bug*.bugzilla.mozilla.org</a>).</p> +Mozilla fait la distinction entre la propriété d'un `document.domain` qui n'a jamais été modifiée d'une explicitement définie avec le même domaine que l'URL du document, même si la propriété renvoie la même valeur dans les deux cas. Un document est autorisé à accéder à un autre si il ont tous deux défini `document.domain` à la même valeur, indiquant leur intention de coopérer, ou si aucun des deux n'a défini `document.domain` et que les domaines dans les URLs sont les mêmes ([implementation](https://mxr.mozilla.org/mozilla-central/source/caps/nsPrincipal.cpp?rev=ecb7068b07a1&mark=199-215#199)). Sans cette politique spéciale, chaque site serait sujet au Cross-Site-Scripting (XSS) depuis ses sous-domaines (par exemple, <https://bugzilla.mozilla.org> pourrait être attaqué par des pièces jointes de bugs sur <https://bug*.bugzilla.mozilla.org>). -<h2 id="Specification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-2250147">DOM Level 2 HTML: document.domain</a> (le décrit comme étant en lecture-seule)</li> - <li><a href="https://html.spec.whatwg.org/multipage/browsers.html#relaxing-the-same-origin-restriction">HTML5: document.domain</a> (décrit un comportement similaire à celui de Mozilla)</li> -</ul> +- [DOM Level 2 HTML: document.domain](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-2250147) (le décrit comme étant en lecture-seule) +- [HTML5: document.domain](https://html.spec.whatwg.org/multipage/browsers.html#relaxing-the-same-origin-restriction) (décrit un comportement similaire à celui de Mozilla) -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/JavaScript/Same_origin_policy_for_JavaScript">Politique de même origine pour JavaScriptHTML</a></li> -</ul> +- [Politique de même origine pour JavaScriptHTML](/fr/docs/Web/JavaScript/Same_origin_policy_for_JavaScript) diff --git a/files/fr/web/api/document/domcontentloaded_event/index.md b/files/fr/web/api/document/domcontentloaded_event/index.md index 516c713b20..5fa9889813 100644 --- a/files/fr/web/api/document/domcontentloaded_event/index.md +++ b/files/fr/web/api/document/domcontentloaded_event/index.md @@ -3,62 +3,65 @@ title: 'Document: DOMContentLoaded event' slug: Web/API/Document/DOMContentLoaded_event translation_of: Web/API/Document/DOMContentLoaded_event --- -<div>{{APIRef}}</div> +{{APIRef}} -<p>L'évènement <strong><code>DOMContentLoaded</code></strong> est déclenché quand le document HTML initiale est complètement chargé et analysé, sans attendre la fin du chargement des feuilles de styles, images et sous-document.</p> +L'évènement **`DOMContentLoaded`** est déclenché quand le document HTML initiale est complètement chargé et analysé, sans attendre la fin du chargement des feuilles de styles, images et sous-document. <table class="properties"> - <tbody> - <tr> - <th scope="row">Bouillonne</th> - <td>Oui</td> - </tr> - <tr> - <th scope="row">Annulable</th> - <td>Oui (bien que spécifié comme évènement simple non annulable)</td> - </tr> - <tr> - <th scope="row">Interface</th> - <td>{{domxref("Event")}}</td> - </tr> - <tr> - <th scope="row">Propriété de gestion de l’évènement</th> - <td>Aucune</td> - </tr> - </tbody> + <tbody> + <tr> + <th scope="row">Bouillonne</th> + <td>Oui</td> + </tr> + <tr> + <th scope="row">Annulable</th> + <td>Oui (bien que spécifié comme évènement simple non annulable)</td> + </tr> + <tr> + <th scope="row">Interface</th> + <td>{{domxref("Event")}}</td> + </tr> + <tr> + <th scope="row">Propriété de gestion de l’évènement</th> + <td>Aucune</td> + </tr> + </tbody> </table> -<p>Un évènement différent, {{domxref("Window/load_event", "load")}} doit être utilisé pour détecter que la page entière est chargée. On utilise couramment à tord <code>load</code> là où <code>DOMContentLoaded</code> serait plus approprié.</p> +Un évènement différent, {{domxref("Window/load_event", "load")}} doit être utilisé pour détecter que la page entière est chargée. On utilise couramment à tord `load` là où `DOMContentLoaded` serait plus approprié. -<p>Du code JavaScript synchrone va mettre en pause la création du DOM. Si vous voulez charger le DOM le plus rapidement possible, vous pouvez faire votre code <a href="/en-US/docs/Web/API/XMLHttpRequest/Synchronous_and_Asynchronous_Requests">(en) JavaScript asynchrone</a> et <a href="https://developers.google.com/speed/docs/insights/OptimizeCSSDelivery">(en) optimiser le chargement des feuilles de styles</a>. Si vous chargez comme d'habitude, les feuilles de styles vont ralentir la création du DOM comme si elles étaient chargées en parallèle, en «volant» le trafique du document principale HTML.</p> +Du code JavaScript synchrone va mettre en pause la création du DOM. Si vous voulez charger le DOM le plus rapidement possible, vous pouvez faire votre code [(en) JavaScript asynchrone](/en-US/docs/Web/API/XMLHttpRequest/Synchronous_and_Asynchronous_Requests) et [(en) optimiser le chargement des feuilles de styles](https://developers.google.com/speed/docs/insights/OptimizeCSSDelivery). Si vous chargez comme d'habitude, les feuilles de styles vont ralentir la création du DOM comme si elles étaient chargées en parallèle, en «volant» le trafique du document principale HTML. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Usage_simple">Usage simple</h3> +### Usage simple -<pre class="brush: js">document.addEventListener('DOMContentLoaded', (event) => { +```js +document.addEventListener('DOMContentLoaded', (event) => { console.log('DOM fully loaded and parsed'); }); -</pre> +``` -<h3 id="Retarde_DOMContentLoaded">Retarde DOMContentLoaded</h3> +### Retarde DOMContentLoaded -<pre class="brush: html"><script> - document.addEventListener('DOMContentLoaded', (event) => { +```html +<script> + document.addEventListener('DOMContentLoaded', (event) => { console.log('DOM fully loaded and parsed'); }); -for( let i = 0; i < 1000000000; i++) +for( let i = 0; i < 1000000000; i++) {} // This synchronous script is going to delay parsing of the DOM, // so the DOMContentLoaded event is going to launch later. -</script> -</pre> +</script> +``` -<h3 id="Vérifie_que_le_contenu_si_le_chargement_est_déjà_fini">Vérifie que le contenu si le chargement est déjà fini</h3> +### Vérifie que le contenu si le chargement est déjà fini -<p>L'évènement <code>DOMContentLoaded</code> peut-être déclenché avant que le script soit exécuté, donc il vaut mieux vérifier avant d'ajouter un écouteur d'évènement.</p> +L'évènement `DOMContentLoaded` peut-être déclenché avant que le script soit exécuté, donc il vaut mieux vérifier avant d'ajouter un écouteur d'évènement. -<pre class="brush: js">function doSomething() { +```js +function doSomething() { console.info('DOM loaded'); } @@ -67,22 +70,25 @@ if (document.readyState === 'loading') { // Loading hasn't finished yet } else { // `DOMContentLoaded` has already fired doSomething(); } -</pre> +``` -<h3 id="Démonstration">Démonstration</h3> +### Démonstration -<h4 id="HTML">HTML</h4> +#### HTML -<pre class="brush: html"><div class="controls"> - <button id="reload" type="button">Reload</button> -</div> +```html +<div class="controls"> + <button id="reload" type="button">Reload</button> +</div> -<div class="event-log"> - <label>Event log:</label> - <textarea readonly class="event-log-contents" rows="8" cols="30"></textarea> -</div></pre> +<div class="event-log"> + <label>Event log:</label> + <textarea readonly class="event-log-contents" rows="8" cols="30"></textarea> +</div> +``` -<pre class="brush: css hidden">body { +```css hidden +body { display: grid; grid-template-areas: "control log"; } @@ -109,72 +115,50 @@ label, button { #reload { height: 2rem; } +``` -</pre> +#### JS -<h4 id="JS">JS</h4> - -<pre class="brush: js">const log = document.querySelector('.event-log-contents'); +```js +const log = document.querySelector('.event-log-contents'); const reload = document.querySelector('#reload'); -reload.addEventListener('click', () => { +reload.addEventListener('click', () => { log.textContent =''; - window.setTimeout(() => { + window.setTimeout(() => { window.location.reload(true); }, 200); }); -window.addEventListener('load', (event) => { +window.addEventListener('load', (event) => { log.textContent = log.textContent + 'load\n'; }); -document.addEventListener('readystatechange', (event) => { +document.addEventListener('readystatechange', (event) => { log.textContent = log.textContent + `readystate: ${document.readyState}\n`; }); -document.addEventListener('DOMContentLoaded', (event) => { +document.addEventListener('DOMContentLoaded', (event) => { log.textContent = log.textContent + `DOMContentLoaded\n`; }); +``` -</pre> - -<h4 id="Résultat">Résultat</h4> - -<p>{{ EmbedLiveSample('Live_example', '100%', '160px') }}</p> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Status</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', 'parsing.html#the-end:event-domcontentloaded', 'DOMContentLoaded')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td></td> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML5 W3C', 'syntax.html#the-end', 'DOMContentLoaded')}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td></td> - </tr> - </tbody> -</table> +#### Résultat + +{{ EmbedLiveSample('Live_example', '100%', '160px') }} -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Spécifications +| Spécification | Status | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName('HTML WHATWG', 'parsing.html#the-end:event-domcontentloaded', 'DOMContentLoaded')}} | {{Spec2('HTML WHATWG')}} | | +| {{SpecName('HTML5 W3C', 'syntax.html#the-end', 'DOMContentLoaded')}} | {{Spec2('HTML5 W3C')}} | | +## Compatibilité des navigateurs -<p>{{Compat("api.Document.DOMContentLoaded_event")}}</p> +{{Compat("api.Document.DOMContentLoaded_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>Évènements similaires: {{domxref("Window/load_event", "load")}}, {{domxref("Document/readystatechange_event", "readystatechange")}}, {{domxref("Window/beforeunload_event", "beforeunload")}} et {{domxref("Window/unload_event", "unload")}}</li> - <li>Cet évènement sur la cible {{domxref("Window")}}: {{domxref("Window/DOMContentLoaded_event", "DOMContentLoaded")}}</li> -</ul> +- Évènements similaires: {{domxref("Window/load_event", "load")}}, {{domxref("Document/readystatechange_event", "readystatechange")}}, {{domxref("Window/beforeunload_event", "beforeunload")}} et {{domxref("Window/unload_event", "unload")}} +- Cet évènement sur la cible {{domxref("Window")}}: {{domxref("Window/DOMContentLoaded_event", "DOMContentLoaded")}} diff --git a/files/fr/web/api/document/drag_event/index.md b/files/fr/web/api/document/drag_event/index.md index 18ffca7385..f285e0a7b1 100644 --- a/files/fr/web/api/document/drag_event/index.md +++ b/files/fr/web/api/document/drag_event/index.md @@ -3,151 +3,61 @@ title: drag slug: Web/API/Document/drag_event translation_of: Web/API/Document/drag_event --- -<div>{{APIRef}}</div> - -<p>L'événement drag est déclenché lorsqu'un élément ou une section de texte est glissé (toutes les quelques centaines de milisecondes)</p> - -<h2 id="Informations_générales">Informations générales</h2> - -<dl> - <dt style="float: left; text-align: right; width: 120px;">Interface</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("DragEvent")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Propagation</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Annulable</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Cible</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("Document")}}, {{domxref("Element")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Action par défaut</dt> - <dd style="margin: 0 0 0 120px;">Continuer l'opération drag & drop.</dd> -</dl> - -<h2 id="Propriétés">Propriétés</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/EventTarget"><code>EventTarget</code></a></td> - <td>The element that was underneath the element being dragged.</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/DOMString"><code>DOMString</code></a></td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event normally bubbles or not</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event is cancellable or not?</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/WindowProxy" rel="nofollow"><code>WindowProxy</code></a></td> - <td><a href="/en-US/docs/Web/API/Document/defaultView"><code>document.defaultView</code></a> (<code>window</code> of the document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td><code>long</code> (<code>float</code>)</td> - <td>0.</td> - </tr> - <tr> - <td><code>dataTransfer</code></td> - <td>DataTransfer</td> - <td>The data that underlies a drag-and-drop operation, known as the <a href="/en-US/docs/Web/API/DataTransfer">drag data store</a>. Protected mode.</td> - </tr> - <tr> - <td><code>currentTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>The node that had the event listener attached.</td> - </tr> - <tr> - <td><code>relatedTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>For <code>mouseover</code>, <code>mouseout</code>, <code>mouseenter</code> and <code>mouseleave</code> events: the target of the complementary event (the <code>mouseleave</code> target in the case of a <code>mouseenter</code> event). <code>null</code> otherwise.</td> - </tr> - <tr> - <td><code>screenX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>screenY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>clientX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>clientY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>button</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left.</td> - </tr> - <tr> - <td><code>buttons</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 | 2). <a href="/en-US/docs/Web/API/MouseEvent">More info</a>.</td> - </tr> - <tr> - <td><code>mozPressure</code> {{readonlyInline}}</td> - <td>float</td> - <td>The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure).</td> - </tr> - <tr> - <td><code>ctrlKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the control key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>shiftKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the shift key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>altKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the alt key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>metaKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the meta key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemple">Exemple</h2> - -<pre class="brush: html"><div class="dropzone"> - <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> +{{APIRef}} + +L'événement drag est déclenché lorsqu'un élément ou une section de texte est glissé (toutes les quelques centaines de milisecondes) + +## Informations générales + +- Interface + - : {{domxref("DragEvent")}} +- Propagation + - : Oui +- Annulable + - : Oui +- Cible + - : {{domxref("Document")}}, {{domxref("Element")}} +- Action par défaut + - : Continuer l'opération drag & drop. + +## Propriétés + +| Property | Type | Description | +| ---------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `target` {{readonlyInline}} | [`EventTarget`](/en-US/docs/Web/API/EventTarget) | The element that was underneath the element being dragged. | +| `type` {{readonlyInline}} | [`DOMString`](/en-US/docs/Web/API/DOMString) | The type of event. | +| `bubbles` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event normally bubbles or not | +| `cancelable` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event is cancellable or not? | +| `view` {{readonlyInline}} | [`WindowProxy`](/en-US/docs/Web/API/WindowProxy) | [`document.defaultView`](/en-US/docs/Web/API/Document/defaultView) (`window` of the document) | +| `detail` {{readonlyInline}} | `long` (`float`) | 0. | +| `dataTransfer` | DataTransfer | The data that underlies a drag-and-drop operation, known as the [drag data store](/en-US/docs/Web/API/DataTransfer). Protected mode. | +| `currentTarget` {{readonlyInline}} | EventTarget | The node that had the event listener attached. | +| `relatedTarget` {{readonlyInline}} | EventTarget | For `mouseover`, `mouseout`, `mouseenter` and `mouseleave` events: the target of the complementary event (the `mouseleave` target in the case of a `mouseenter` event). `null` otherwise. | +| `screenX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in global (screen) coordinates. | +| `screenY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in global (screen) coordinates. | +| `clientX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in local (DOM content) coordinates. | +| `clientY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in local (DOM content) coordinates. | +| `button` {{readonlyInline}} | unsigned short | The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left. | +| `buttons` {{readonlyInline}} | unsigned short | The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 \| 2). [More info](/en-US/docs/Web/API/MouseEvent). | +| `mozPressure` {{readonlyInline}} | float | The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure). | +| `ctrlKey` {{readonlyInline}} | boolean | `true` if the control key was down when the event was fired. `false` otherwise. | +| `shiftKey` {{readonlyInline}} | boolean | `true` if the shift key was down when the event was fired. `false` otherwise. | +| `altKey` {{readonlyInline}} | boolean | `true` if the alt key was down when the event was fired. `false` otherwise. | +| `metaKey` {{readonlyInline}} | boolean | `true` if the meta key was down when the event was fired. `false` otherwise. | + +## Exemple + +```html +<div class="dropzone"> + <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> This div is draggable - </div> -</div> -<div class="dropzone"></div> -<div class="dropzone"></div> -<div class="dropzone"></div> + </div> +</div> +<div class="dropzone"></div> +<div class="dropzone"></div> +<div class="dropzone"></div> -<style> +<style> #draggable { width: 200px; height: 20px; @@ -162,9 +72,9 @@ translation_of: Web/API/Document/drag_event margin-bottom: 10px; padding: 10px; } -</style> +</style> -<script> +<script> var dragged; /* Les événements sont déclenchés sur les objets glissables */ @@ -217,45 +127,28 @@ translation_of: Web/API/Document/drag_event } }, false); -</script> -</pre> +</script> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "interaction.html#dndevents", "drag event")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("HTML5.1", "editing.html#dndevents", "drag event")}}</td> - <td>{{Spec2("HTML5.1")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Specification | Status | Comment | +| ------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------- | +| {{SpecName("HTML WHATWG", "interaction.html#dndevents", "drag event")}} | {{Spec2("HTML WHATWG")}} | | +| {{SpecName("HTML5.1", "editing.html#dndevents", "drag event")}} | {{Spec2("HTML5.1")}} | Définition initiale | -<h2 id="Compatibilités_navigateur">Compatibilités navigateur</h2> +## Compatibilités navigateur -<p>{{Compat("api.Document.drag_event")}}</p> +{{Compat("api.Document.drag_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{event("drag")}}</li> - <li>{{event("dragstart")}}</li> - <li>{{event("dragend")}}</li> - <li>{{event("dragover")}}</li> - <li>{{event("dragenter")}}</li> - <li>{{event("dragleave")}}</li> - <li>{{event("dragexit")}}</li> - <li>{{event("drop")}}</li> - <li><a href="http://jsfiddle.net/zfnj5rv4/">Demo</a></li> -</ul> +- {{event("drag")}} +- {{event("dragstart")}} +- {{event("dragend")}} +- {{event("dragover")}} +- {{event("dragenter")}} +- {{event("dragleave")}} +- {{event("dragexit")}} +- {{event("drop")}} +- [Demo](http://jsfiddle.net/zfnj5rv4/) diff --git a/files/fr/web/api/document/dragend_event/index.md b/files/fr/web/api/document/dragend_event/index.md index 8435a6c7e4..9c76951378 100644 --- a/files/fr/web/api/document/dragend_event/index.md +++ b/files/fr/web/api/document/dragend_event/index.md @@ -3,149 +3,59 @@ title: dragend slug: Web/API/Document/dragend_event translation_of: Web/API/Document/dragend_event --- -<p>L'événement <strong>dragend</strong> est déclenché lorsque une opération de glissement est terminée (en relâchant le bouton de la souris ou en appuyant sur la touche Echap).</p> - -<h2>Informations générales</h2> - -<dl> - <dt>Interface</dt> - <dd>{{domxref("DragEvent")}}</dd> - <dt>Propagation</dt> - <dd>Oui</dd> - <dt>Annulable</dt> - <dd>Non</dd> - <dt>Cible</dt> - <dd>{{domxref("Document")}}, {{domxref("Element")}}</dd> - <dt>Action par défaut</dt> - <dd>Varie</dd> -</dl> - -<h2 id="Propriétés">Propriétés</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/EventTarget"><code>EventTarget</code></a></td> - <td>The element that was underneath the element being dragged.</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/DOMString"><code>DOMString</code></a></td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event normally bubbles or not</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event is cancellable or not?</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/WindowProxy" rel="nofollow"><code>WindowProxy</code></a></td> - <td><a href="/en-US/docs/Web/API/Document/defaultView"><code>document.defaultView</code></a> (<code>window</code> of the document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td><code>long</code> (<code>float</code>)</td> - <td>0.</td> - </tr> - <tr> - <td><code>dataTransfer</code></td> - <td>DataTransfer</td> - <td>The data that underlies a drag-and-drop operation, known as the <a href="/en-US/docs/Web/API/DataTransfer">drag data store</a>. Protected mode.</td> - </tr> - <tr> - <td><code>currentTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>The node that had the event listener attached.</td> - </tr> - <tr> - <td><code>relatedTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>For <code>mouseover</code>, <code>mouseout</code>, <code>mouseenter</code> and <code>mouseleave</code> events: the target of the complementary event (the <code>mouseleave</code> target in the case of a <code>mouseenter</code> event). <code>null</code> otherwise.</td> - </tr> - <tr> - <td><code>screenX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>screenY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>clientX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>clientY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>button</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left.</td> - </tr> - <tr> - <td><code>buttons</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 | 2). <a href="/en-US/docs/Web/API/MouseEvent">More info</a>.</td> - </tr> - <tr> - <td><code>mozPressure</code> {{readonlyInline}}</td> - <td>float</td> - <td>The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure).</td> - </tr> - <tr> - <td><code>ctrlKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the control key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>shiftKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the shift key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>altKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the alt key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>metaKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the meta key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemple">Exemple</h2> - -<pre class="brush: html"><div class="dropzone"> - <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> +L'événement **dragend** est déclenché lorsque une opération de glissement est terminée (en relâchant le bouton de la souris ou en appuyant sur la touche Echap). + +## Informations générales + +- Interface + - : {{domxref("DragEvent")}} +- Propagation + - : Oui +- Annulable + - : Non +- Cible + - : {{domxref("Document")}}, {{domxref("Element")}} +- Action par défaut + - : Varie + +## Propriétés + +| Property | Type | Description | +| ---------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `target` {{readonlyInline}} | [`EventTarget`](/en-US/docs/Web/API/EventTarget) | The element that was underneath the element being dragged. | +| `type` {{readonlyInline}} | [`DOMString`](/en-US/docs/Web/API/DOMString) | The type of event. | +| `bubbles` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event normally bubbles or not | +| `cancelable` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event is cancellable or not? | +| `view` {{readonlyInline}} | [`WindowProxy`](/en-US/docs/Web/API/WindowProxy) | [`document.defaultView`](/en-US/docs/Web/API/Document/defaultView) (`window` of the document) | +| `detail` {{readonlyInline}} | `long` (`float`) | 0. | +| `dataTransfer` | DataTransfer | The data that underlies a drag-and-drop operation, known as the [drag data store](/en-US/docs/Web/API/DataTransfer). Protected mode. | +| `currentTarget` {{readonlyInline}} | EventTarget | The node that had the event listener attached. | +| `relatedTarget` {{readonlyInline}} | EventTarget | For `mouseover`, `mouseout`, `mouseenter` and `mouseleave` events: the target of the complementary event (the `mouseleave` target in the case of a `mouseenter` event). `null` otherwise. | +| `screenX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in global (screen) coordinates. | +| `screenY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in global (screen) coordinates. | +| `clientX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in local (DOM content) coordinates. | +| `clientY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in local (DOM content) coordinates. | +| `button` {{readonlyInline}} | unsigned short | The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left. | +| `buttons` {{readonlyInline}} | unsigned short | The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 \| 2). [More info](/en-US/docs/Web/API/MouseEvent). | +| `mozPressure` {{readonlyInline}} | float | The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure). | +| `ctrlKey` {{readonlyInline}} | boolean | `true` if the control key was down when the event was fired. `false` otherwise. | +| `shiftKey` {{readonlyInline}} | boolean | `true` if the shift key was down when the event was fired. `false` otherwise. | +| `altKey` {{readonlyInline}} | boolean | `true` if the alt key was down when the event was fired. `false` otherwise. | +| `metaKey` {{readonlyInline}} | boolean | `true` if the meta key was down when the event was fired. `false` otherwise. | + +## Exemple + +```html +<div class="dropzone"> + <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> This div is draggable - </div> -</div> -<div class="dropzone"></div> -<div class="dropzone"></div> -<div class="dropzone"></div> + </div> +</div> +<div class="dropzone"></div> +<div class="dropzone"></div> +<div class="dropzone"></div> -<style> +<style> #draggable { width: 200px; height: 20px; @@ -160,9 +70,9 @@ translation_of: Web/API/Document/dragend_event margin-bottom: 10px; padding: 10px; } -</style> +</style> -<script> +<script> var dragged; /* Les événements sont déclenchés sur les objets glissables */ @@ -215,44 +125,27 @@ translation_of: Web/API/Document/dragend_event } }, false); -</script> -</pre> +</script> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragend")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("HTML5.1", "editing.html#dndevents", "dragend")}}</td> - <td>{{Spec2("HTML5.1")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragend")}} | {{Spec2("HTML WHATWG")}} | | +| {{SpecName("HTML5.1", "editing.html#dndevents", "dragend")}} | {{Spec2("HTML5.1")}} | Définition initiale | -<h2 id="Compatibilités_navigateurs">Compatibilités navigateurs</h2> +## Compatibilités navigateurs -<p>{{Compat("api.Document.dragend_event")}}</p> +{{Compat("api.Document.dragend_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{event("drag")}}</li> - <li>{{event("dragstart")}}</li> - <li>{{event("dragend")}}</li> - <li>{{event("dragover")}}</li> - <li>{{event("dragenter")}}</li> - <li>{{event("dragleave")}}</li> - <li>{{event("dragexit")}}</li> - <li>{{event("drop")}}</li> -</ul> +- {{event("drag")}} +- {{event("dragstart")}} +- {{event("dragend")}} +- {{event("dragover")}} +- {{event("dragenter")}} +- {{event("dragleave")}} +- {{event("dragexit")}} +- {{event("drop")}} diff --git a/files/fr/web/api/document/dragenter_event/index.md b/files/fr/web/api/document/dragenter_event/index.md index 370d84b4d3..4aff1b3c8d 100644 --- a/files/fr/web/api/document/dragenter_event/index.md +++ b/files/fr/web/api/document/dragenter_event/index.md @@ -3,151 +3,61 @@ title: dragenter slug: Web/API/Document/dragenter_event translation_of: Web/API/Document/dragenter_event --- -<div>{{APIRef}}</div> - -<p>L'événement <strong>dragenter</strong> est déclenché lorsqu'un élément glissé ou une sélection de texte entre dans une cible de drop valide.</p> - -<h2>Informations générales</h2> - -<dl> - <dt>Interface</dt> - <dd>{{domxref("DragEvent")}}</dd> - <dt>Propagation</dt> - <dd>Oui</dd> - <dt>Annulable</dt> - <dd>Oui</dd> - <dt>Cible</dt> - <dd>La sélection immédiate de l'utilisateur (l'élément présentement indiqué par l'utilisateur comme cible pour le drop), ou l'élément {{HTMLElement("body")}}.</dd> - <dt>Action par défaut</dt> - <dd>Rejette la sélection immédiate de l'utilisateur comme élément cible potentiel</dd> -</dl> - -<h2 id="Properties">Properties</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/EventTarget"><code>EventTarget</code></a></td> - <td>The element that was underneath the element being dragged.</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/DOMString"><code>DOMString</code></a></td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event normally bubbles or not</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event is cancellable or not?</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/WindowProxy" rel="nofollow"><code>WindowProxy</code></a></td> - <td><a href="/en-US/docs/Web/API/Document/defaultView"><code>document.defaultView</code></a> (<code>window</code> of the document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td><code>long</code> (<code>float</code>)</td> - <td>0.</td> - </tr> - <tr> - <td><code>dataTransfer</code></td> - <td>DataTransfer</td> - <td>The data that underlies a drag-and-drop operation, known as the <a href="/en-US/docs/Web/API/DataTransfer">drag data store</a>. Protected mode.</td> - </tr> - <tr> - <td><code>currentTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>The node that had the event listener attached.</td> - </tr> - <tr> - <td><code>relatedTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>For <code>mouseover</code>, <code>mouseout</code>, <code>mouseenter</code> and <code>mouseleave</code> events: the target of the complementary event (the <code>mouseleave</code> target in the case of a <code>mouseenter</code> event). <code>null</code> otherwise.</td> - </tr> - <tr> - <td><code>screenX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>screenY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>clientX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>clientY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>button</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left.</td> - </tr> - <tr> - <td><code>buttons</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 | 2). <a href="/en-US/docs/Web/API/MouseEvent">More info</a>.</td> - </tr> - <tr> - <td><code>mozPressure</code> {{readonlyInline}}</td> - <td>float</td> - <td>The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure).</td> - </tr> - <tr> - <td><code>ctrlKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the control key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>shiftKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the shift key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>altKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the alt key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>metaKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the meta key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemple">Exemple</h2> - -<pre class="brush: html"><div class="dropzone"> - <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> +{{APIRef}} + +L'événement **dragenter** est déclenché lorsqu'un élément glissé ou une sélection de texte entre dans une cible de drop valide. + +## Informations générales + +- Interface + - : {{domxref("DragEvent")}} +- Propagation + - : Oui +- Annulable + - : Oui +- Cible + - : La sélection immédiate de l'utilisateur (l'élément présentement indiqué par l'utilisateur comme cible pour le drop), ou l'élément {{HTMLElement("body")}}. +- Action par défaut + - : Rejette la sélection immédiate de l'utilisateur comme élément cible potentiel + +## Properties + +| Property | Type | Description | +| ---------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `target` {{readonlyInline}} | [`EventTarget`](/en-US/docs/Web/API/EventTarget) | The element that was underneath the element being dragged. | +| `type` {{readonlyInline}} | [`DOMString`](/en-US/docs/Web/API/DOMString) | The type of event. | +| `bubbles` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event normally bubbles or not | +| `cancelable` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event is cancellable or not? | +| `view` {{readonlyInline}} | [`WindowProxy`](/en-US/docs/Web/API/WindowProxy) | [`document.defaultView`](/en-US/docs/Web/API/Document/defaultView) (`window` of the document) | +| `detail` {{readonlyInline}} | `long` (`float`) | 0. | +| `dataTransfer` | DataTransfer | The data that underlies a drag-and-drop operation, known as the [drag data store](/en-US/docs/Web/API/DataTransfer). Protected mode. | +| `currentTarget` {{readonlyInline}} | EventTarget | The node that had the event listener attached. | +| `relatedTarget` {{readonlyInline}} | EventTarget | For `mouseover`, `mouseout`, `mouseenter` and `mouseleave` events: the target of the complementary event (the `mouseleave` target in the case of a `mouseenter` event). `null` otherwise. | +| `screenX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in global (screen) coordinates. | +| `screenY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in global (screen) coordinates. | +| `clientX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in local (DOM content) coordinates. | +| `clientY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in local (DOM content) coordinates. | +| `button` {{readonlyInline}} | unsigned short | The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left. | +| `buttons` {{readonlyInline}} | unsigned short | The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 \| 2). [More info](/en-US/docs/Web/API/MouseEvent). | +| `mozPressure` {{readonlyInline}} | float | The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure). | +| `ctrlKey` {{readonlyInline}} | boolean | `true` if the control key was down when the event was fired. `false` otherwise. | +| `shiftKey` {{readonlyInline}} | boolean | `true` if the shift key was down when the event was fired. `false` otherwise. | +| `altKey` {{readonlyInline}} | boolean | `true` if the alt key was down when the event was fired. `false` otherwise. | +| `metaKey` {{readonlyInline}} | boolean | `true` if the meta key was down when the event was fired. `false` otherwise. | + +## Exemple + +```html +<div class="dropzone"> + <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> This div is draggable - </div> -</div> -<div class="dropzone"></div> -<div class="dropzone"></div> -<div class="dropzone"></div> + </div> +</div> +<div class="dropzone"></div> +<div class="dropzone"></div> +<div class="dropzone"></div> -<style> +<style> #draggable { width: 200px; height: 20px; @@ -162,9 +72,9 @@ translation_of: Web/API/Document/dragenter_event margin-bottom: 10px; padding: 10px; } -</style> +</style> -<script> +<script> var dragged; /* Les événements sont déclenchés sur les objets glissables */ @@ -199,7 +109,7 @@ translation_of: Web/API/Document/dragenter_event }, false); document.addEventListener("dragleave", function( event ) { - // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent + // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent if ( event.target.className == "dropzone" ) { event.target.style.background = ""; } @@ -217,44 +127,27 @@ translation_of: Web/API/Document/dragenter_event } }, false); -</script> -</pre> +</script> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragenter")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("HTML5.1", "editing.html#dndevents", "dragenter")}}</td> - <td>{{Spec2("HTML5.1")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragenter")}} | {{Spec2("HTML WHATWG")}} | | +| {{SpecName("HTML5.1", "editing.html#dndevents", "dragenter")}} | {{Spec2("HTML5.1")}} | Définition initiale | -<h2 id="Compatiblités_navigateurs">Compatiblités navigateurs</h2> +## Compatiblités navigateurs -<p>{{Compat("api.Document.dragenter_event")}}</p> +{{Compat("api.Document.dragenter_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{event("drag")}}</li> - <li>{{event("dragstart")}}</li> - <li>{{event("dragend")}}</li> - <li>{{event("dragover")}}</li> - <li>{{event("dragenter")}}</li> - <li>{{event("dragleave")}}</li> - <li>{{event("dragexit")}}</li> - <li>{{event("drop")}}</li> -</ul> +- {{event("drag")}} +- {{event("dragstart")}} +- {{event("dragend")}} +- {{event("dragover")}} +- {{event("dragenter")}} +- {{event("dragleave")}} +- {{event("dragexit")}} +- {{event("drop")}} diff --git a/files/fr/web/api/document/dragleave_event/index.md b/files/fr/web/api/document/dragleave_event/index.md index b8624adb26..6c5b8849bd 100644 --- a/files/fr/web/api/document/dragleave_event/index.md +++ b/files/fr/web/api/document/dragleave_event/index.md @@ -3,149 +3,59 @@ title: dragleave slug: Web/API/Document/dragleave_event translation_of: Web/API/Document/dragleave_event --- -<p>L'événement <strong>dragleave </strong>est déclenché lorsqu'un élément glissé ou une sélection de texte quitte une cible de dépôt valide.</p> - -<h2 id="Informations_générales">Informations générales</h2> - -<dl> - <dt style="float: left; text-align: right; width: 120px;">Interface</dt> - <dd style="margin: 0 0 0 120px;"><a href="/fr/docs/Web/API/DragEvent"><code>DragEvent</code></a></dd> - <dt style="float: left; text-align: right; width: 120px;">Propagation</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Annulable</dt> - <dd style="margin: 0 0 0 120px;">Non</dd> - <dt style="float: left; text-align: right; width: 120px;">Cible</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("Document")}}, {{domxref("Element")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Action par défaut</dt> - <dd style="margin: 0 0 0 120px;">Aucune</dd> -</dl> - -<h2 id="Propriétés">Propriétés</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/EventTarget"><code>EventTarget</code></a></td> - <td>The element that was underneath the element being dragged.</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/DOMString"><code>DOMString</code></a></td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event normally bubbles or not</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event is cancellable or not?</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/WindowProxy" rel="nofollow"><code>WindowProxy</code></a></td> - <td><a href="/en-US/docs/Web/API/Document/defaultView"><code>document.defaultView</code></a> (<code>window</code> of the document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td><code>long</code> (<code>float</code>)</td> - <td>0.</td> - </tr> - <tr> - <td><code>dataTransfer</code></td> - <td>DataTransfer</td> - <td>The data that underlies a drag-and-drop operation, known as the <a href="/en-US/docs/Web/API/DataTransfer">drag data store</a>. Protected mode.</td> - </tr> - <tr> - <td><code>currentTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>The node that had the event listener attached.</td> - </tr> - <tr> - <td><code>relatedTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>For <code>mouseover</code>, <code>mouseout</code>, <code>mouseenter</code> and <code>mouseleave</code> events: the target of the complementary event (the <code>mouseleave</code> target in the case of a <code>mouseenter</code> event). <code>null</code> otherwise.</td> - </tr> - <tr> - <td><code>screenX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>screenY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>clientX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>clientY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>button</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left.</td> - </tr> - <tr> - <td><code>buttons</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 | 2). <a href="/en-US/docs/Web/API/MouseEvent">More info</a>.</td> - </tr> - <tr> - <td><code>mozPressure</code> {{readonlyInline}}</td> - <td>float</td> - <td>The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure).</td> - </tr> - <tr> - <td><code>ctrlKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the control key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>shiftKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the shift key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>altKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the alt key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>metaKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the meta key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemple">Exemple</h2> - -<pre class="brush: html"><div class="dropzone"> - <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> +L'événement **dragleave** est déclenché lorsqu'un élément glissé ou une sélection de texte quitte une cible de dépôt valide. + +## Informations générales + +- Interface + - : [`DragEvent`](/fr/docs/Web/API/DragEvent) +- Propagation + - : Oui +- Annulable + - : Non +- Cible + - : {{domxref("Document")}}, {{domxref("Element")}} +- Action par défaut + - : Aucune + +## Propriétés + +| Property | Type | Description | +| ---------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `target` {{readonlyInline}} | [`EventTarget`](/en-US/docs/Web/API/EventTarget) | The element that was underneath the element being dragged. | +| `type` {{readonlyInline}} | [`DOMString`](/en-US/docs/Web/API/DOMString) | The type of event. | +| `bubbles` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event normally bubbles or not | +| `cancelable` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event is cancellable or not? | +| `view` {{readonlyInline}} | [`WindowProxy`](/en-US/docs/Web/API/WindowProxy) | [`document.defaultView`](/en-US/docs/Web/API/Document/defaultView) (`window` of the document) | +| `detail` {{readonlyInline}} | `long` (`float`) | 0. | +| `dataTransfer` | DataTransfer | The data that underlies a drag-and-drop operation, known as the [drag data store](/en-US/docs/Web/API/DataTransfer). Protected mode. | +| `currentTarget` {{readonlyInline}} | EventTarget | The node that had the event listener attached. | +| `relatedTarget` {{readonlyInline}} | EventTarget | For `mouseover`, `mouseout`, `mouseenter` and `mouseleave` events: the target of the complementary event (the `mouseleave` target in the case of a `mouseenter` event). `null` otherwise. | +| `screenX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in global (screen) coordinates. | +| `screenY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in global (screen) coordinates. | +| `clientX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in local (DOM content) coordinates. | +| `clientY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in local (DOM content) coordinates. | +| `button` {{readonlyInline}} | unsigned short | The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left. | +| `buttons` {{readonlyInline}} | unsigned short | The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 \| 2). [More info](/en-US/docs/Web/API/MouseEvent). | +| `mozPressure` {{readonlyInline}} | float | The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure). | +| `ctrlKey` {{readonlyInline}} | boolean | `true` if the control key was down when the event was fired. `false` otherwise. | +| `shiftKey` {{readonlyInline}} | boolean | `true` if the shift key was down when the event was fired. `false` otherwise. | +| `altKey` {{readonlyInline}} | boolean | `true` if the alt key was down when the event was fired. `false` otherwise. | +| `metaKey` {{readonlyInline}} | boolean | `true` if the meta key was down when the event was fired. `false` otherwise. | + +## Exemple + +```html +<div class="dropzone"> + <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> This div is draggable - </div> -</div> -<div class="dropzone"></div> -<div class="dropzone"></div> -<div class="dropzone"></div> + </div> +</div> +<div class="dropzone"></div> +<div class="dropzone"></div> +<div class="dropzone"></div> -<style> +<style> #draggable { width: 200px; height: 20px; @@ -160,9 +70,9 @@ translation_of: Web/API/Document/dragleave_event margin-bottom: 10px; padding: 10px; } -</style> +</style> -<script> +<script> var dragged; /* Les événements sont déclenchés sur les objets glissables */ @@ -197,7 +107,7 @@ translation_of: Web/API/Document/dragleave_event }, false); document.addEventListener("dragleave", function( event ) { - // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent + // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent if ( event.target.className == "dropzone" ) { event.target.style.background = ""; } @@ -215,44 +125,27 @@ translation_of: Web/API/Document/dragleave_event } }, false); -</script> -</pre> +</script> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragleave")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("HTML5.1", "editing.html#dndevents", "dragleave")}}</td> - <td>{{Spec2("HTML5.1")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragleave")}} | {{Spec2("HTML WHATWG")}} | | +| {{SpecName("HTML5.1", "editing.html#dndevents", "dragleave")}} | {{Spec2("HTML5.1")}} | Définition initiale | -<h2 id="Compatibilités_navigateur">Compatibilités navigateur</h2> +## Compatibilités navigateur -<p>{{Compat("api.Document.dragleave_event")}}</p> +{{Compat("api.Document.dragleave_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{event("drag")}}</li> - <li>{{event("dragstart")}}</li> - <li>{{event("dragend")}}</li> - <li>{{event("dragover")}}</li> - <li>{{event("dragenter")}}</li> - <li>{{event("dragleave")}}</li> - <li>{{event("dragexit")}}</li> - <li>{{event("drop")}}</li> -</ul> +- {{event("drag")}} +- {{event("dragstart")}} +- {{event("dragend")}} +- {{event("dragover")}} +- {{event("dragenter")}} +- {{event("dragleave")}} +- {{event("dragexit")}} +- {{event("drop")}} diff --git a/files/fr/web/api/document/dragover_event/index.md b/files/fr/web/api/document/dragover_event/index.md index eb7ab548fd..c189df61a0 100644 --- a/files/fr/web/api/document/dragover_event/index.md +++ b/files/fr/web/api/document/dragover_event/index.md @@ -3,151 +3,61 @@ title: dragover slug: Web/API/Document/dragover_event translation_of: Web/API/Document/dragover_event --- -<div>{{APIRef}}</div> - -<p>L'événement <strong>dragover </strong>est déclenché lorsqu'un élément ou une sélection de texte est glissé jusqu'à une cible de dépôt valide (toutes les 100ms)</p> - -<h2 id="Informations_générales">Informations générales</h2> - -<dl> - <dt style="float: left; text-align: right; width: 120px;">Interface</dt> - <dd style="margin: 0 0 0 120px;"><a href="/fr/docs/Web/API/DragEvent"><code>DragEvent</code></a></dd> - <dt style="float: left; text-align: right; width: 120px;">Propagation</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Annulable</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Cible</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("Document")}}, {{domxref("Element")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Action par défaut</dt> - <dd style="margin: 0 0 0 120px;">Reset l'opération de glissement courante à "none"</dd> -</dl> - -<h2 id="Properties">Properties</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/EventTarget"><code>EventTarget</code></a></td> - <td>The element that was underneath the element being dragged.</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/DOMString"><code>DOMString</code></a></td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event normally bubbles or not</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event is cancellable or not?</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/WindowProxy" rel="nofollow"><code>WindowProxy</code></a></td> - <td><a href="/en-US/docs/Web/API/Document/defaultView"><code>document.defaultView</code></a> (<code>window</code> of the document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td><code>long</code> (<code>float</code>)</td> - <td>0.</td> - </tr> - <tr> - <td><code>dataTransfer</code></td> - <td>DataTransfer</td> - <td>The data that underlies a drag-and-drop operation, known as the <a href="/en-US/docs/Web/API/DataTransfer">drag data store</a>. Protected mode.</td> - </tr> - <tr> - <td><code>currentTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>The node that had the event listener attached.</td> - </tr> - <tr> - <td><code>relatedTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>For <code>mouseover</code>, <code>mouseout</code>, <code>mouseenter</code> and <code>mouseleave</code> events: the target of the complementary event (the <code>mouseleave</code> target in the case of a <code>mouseenter</code> event). <code>null</code> otherwise.</td> - </tr> - <tr> - <td><code>screenX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>screenY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>clientX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>clientY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>button</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left.</td> - </tr> - <tr> - <td><code>buttons</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 | 2). <a href="/en-US/docs/Web/API/MouseEvent">More info</a>.</td> - </tr> - <tr> - <td><code>mozPressure</code> {{readonlyInline}}</td> - <td>float</td> - <td>The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure).</td> - </tr> - <tr> - <td><code>ctrlKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the control key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>shiftKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the shift key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>altKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the alt key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>metaKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the meta key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemple">Exemple</h2> - -<pre class="brush: html"><div class="dropzone"> - <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> +{{APIRef}} + +L'événement **dragover** est déclenché lorsqu'un élément ou une sélection de texte est glissé jusqu'à une cible de dépôt valide (toutes les 100ms) + +## Informations générales + +- Interface + - : [`DragEvent`](/fr/docs/Web/API/DragEvent) +- Propagation + - : Oui +- Annulable + - : Oui +- Cible + - : {{domxref("Document")}}, {{domxref("Element")}} +- Action par défaut + - : Reset l'opération de glissement courante à "none" + +## Properties + +| Property | Type | Description | +| ---------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `target` {{readonlyInline}} | [`EventTarget`](/en-US/docs/Web/API/EventTarget) | The element that was underneath the element being dragged. | +| `type` {{readonlyInline}} | [`DOMString`](/en-US/docs/Web/API/DOMString) | The type of event. | +| `bubbles` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event normally bubbles or not | +| `cancelable` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event is cancellable or not? | +| `view` {{readonlyInline}} | [`WindowProxy`](/en-US/docs/Web/API/WindowProxy) | [`document.defaultView`](/en-US/docs/Web/API/Document/defaultView) (`window` of the document) | +| `detail` {{readonlyInline}} | `long` (`float`) | 0. | +| `dataTransfer` | DataTransfer | The data that underlies a drag-and-drop operation, known as the [drag data store](/en-US/docs/Web/API/DataTransfer). Protected mode. | +| `currentTarget` {{readonlyInline}} | EventTarget | The node that had the event listener attached. | +| `relatedTarget` {{readonlyInline}} | EventTarget | For `mouseover`, `mouseout`, `mouseenter` and `mouseleave` events: the target of the complementary event (the `mouseleave` target in the case of a `mouseenter` event). `null` otherwise. | +| `screenX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in global (screen) coordinates. | +| `screenY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in global (screen) coordinates. | +| `clientX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in local (DOM content) coordinates. | +| `clientY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in local (DOM content) coordinates. | +| `button` {{readonlyInline}} | unsigned short | The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left. | +| `buttons` {{readonlyInline}} | unsigned short | The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 \| 2). [More info](/en-US/docs/Web/API/MouseEvent). | +| `mozPressure` {{readonlyInline}} | float | The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure). | +| `ctrlKey` {{readonlyInline}} | boolean | `true` if the control key was down when the event was fired. `false` otherwise. | +| `shiftKey` {{readonlyInline}} | boolean | `true` if the shift key was down when the event was fired. `false` otherwise. | +| `altKey` {{readonlyInline}} | boolean | `true` if the alt key was down when the event was fired. `false` otherwise. | +| `metaKey` {{readonlyInline}} | boolean | `true` if the meta key was down when the event was fired. `false` otherwise. | + +## Exemple + +```html +<div class="dropzone"> + <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> This div is draggable - </div> -</div> -<div class="dropzone"></div> -<div class="dropzone"></div> -<div class="dropzone"></div> + </div> +</div> +<div class="dropzone"></div> +<div class="dropzone"></div> +<div class="dropzone"></div> -<style> +<style> #draggable { width: 200px; height: 20px; @@ -162,9 +72,9 @@ translation_of: Web/API/Document/dragover_event margin-bottom: 10px; padding: 10px; } -</style> +</style> -<script> +<script> var dragged; /* Les événements sont déclenchés sur les objets glissables */ @@ -199,7 +109,7 @@ translation_of: Web/API/Document/dragover_event }, false); document.addEventListener("dragleave", function( event ) { - // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent + // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent if ( event.target.className == "dropzone" ) { event.target.style.background = ""; } @@ -217,43 +127,27 @@ translation_of: Web/API/Document/dragover_event } }, false); -</script></pre> +</script> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragover")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("HTML5.1", "editing.html#dndevents", "dragover")}}</td> - <td>{{Spec2("HTML5.1")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragover")}} | {{Spec2("HTML WHATWG")}} | | +| {{SpecName("HTML5.1", "editing.html#dndevents", "dragover")}} | {{Spec2("HTML5.1")}} | Définition initiale | -<h2 id="Compatibilités_navigateur">Compatibilités navigateur</h2> +## Compatibilités navigateur -<p>{{Compat("api.Document.dragover_event")}}</p> +{{Compat("api.Document.dragover_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{event("drag")}}</li> - <li>{{event("dragstart")}}</li> - <li>{{event("dragend")}}</li> - <li>{{event("dragover")}}</li> - <li>{{event("dragenter")}}</li> - <li>{{event("dragleave")}}</li> - <li>{{event("dragexit")}}</li> - <li>{{event("drop")}}</li> -</ul> +- {{event("drag")}} +- {{event("dragstart")}} +- {{event("dragend")}} +- {{event("dragover")}} +- {{event("dragenter")}} +- {{event("dragleave")}} +- {{event("dragexit")}} +- {{event("drop")}} diff --git a/files/fr/web/api/document/dragstart_event/index.md b/files/fr/web/api/document/dragstart_event/index.md index f45827df5c..2e0cc56f99 100644 --- a/files/fr/web/api/document/dragstart_event/index.md +++ b/files/fr/web/api/document/dragstart_event/index.md @@ -3,154 +3,65 @@ title: dragstart slug: Web/API/Document/dragstart_event translation_of: Web/API/Document/dragstart_event --- -<p>L'événement <strong>dragstart </strong>est déclenché lorsque l'utilisateur glisse un élément ou une sélection de texte.</p> - -<h2 id="Informations_générales">Informations générales</h2> - -<dl> - <dt style="float: left; text-align: right; width: 120px;">Interface</dt> - <dd style="margin: 0 0 0 120px;"><a href="/fr/docs/Web/API/DragEvent"><code>DragEvent</code></a></dd> - <dt style="float: left; text-align: right; width: 120px;">Propagation</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Annulable</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Cible</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("Document")}}, {{domxref("Element")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Action par défaut</dt> - <dd style="margin: 0 0 0 120px;">Initie l'opération de glisser-déposer</dd> -</dl> - -<h2 id="Properties">Properties</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/EventTarget"><code>EventTarget</code></a></td> - <td>The element that was underneath the element being dragged.</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/DOMString"><code>DOMString</code></a></td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event normally bubbles or not</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event is cancellable or not?</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/WindowProxy" rel="nofollow"><code>WindowProxy</code></a></td> - <td><a href="/en-US/docs/Web/API/Document/defaultView"><code>document.defaultView</code></a> (<code>window</code> of the document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td><code>long</code> (<code>float</code>)</td> - <td>0.</td> - </tr> - <tr> - <td><code>dataTransfer</code></td> - <td>DataTransfer</td> - <td>The data that underlies a drag-and-drop operation, known as the <a href="/en-US/docs/Web/API/DataTransfer">drag data store</a>. Protected mode.</td> - </tr> - <tr> - <td><code>currentTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>The node that had the event listener attached.</td> - </tr> - <tr> - <td><code>relatedTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>For <code>mouseover</code>, <code>mouseout</code>, <code>mouseenter</code> and <code>mouseleave</code> events: the target of the complementary event (the <code>mouseleave</code> target in the case of a <code>mouseenter</code> event). <code>null</code> otherwise.</td> - </tr> - <tr> - <td><code>screenX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>screenY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>clientX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>clientY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>button</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left.</td> - </tr> - <tr> - <td><code>buttons</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 | 2). <a href="/en-US/docs/Web/API/MouseEvent">More info</a>.</td> - </tr> - <tr> - <td><code>mozPressure</code> {{readonlyInline}}</td> - <td>float</td> - <td>The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure).</td> - </tr> - <tr> - <td><code>ctrlKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the control key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>shiftKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the shift key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>altKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the alt key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>metaKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the meta key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemple：dropzone">Exemple：dropzone</h2> - -<h3 id="HTML_Content">HTML Content</h3> - -<pre class="brush: html"><div class="dropzone"> - <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> +L'événement **dragstart** est déclenché lorsque l'utilisateur glisse un élément ou une sélection de texte. + +## Informations générales + +- Interface + - : [`DragEvent`](/fr/docs/Web/API/DragEvent) +- Propagation + - : Oui +- Annulable + - : Oui +- Cible + - : {{domxref("Document")}}, {{domxref("Element")}} +- Action par défaut + - : Initie l'opération de glisser-déposer + +## Properties + +| Property | Type | Description | +| ---------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `target` {{readonlyInline}} | [`EventTarget`](/en-US/docs/Web/API/EventTarget) | The element that was underneath the element being dragged. | +| `type` {{readonlyInline}} | [`DOMString`](/en-US/docs/Web/API/DOMString) | The type of event. | +| `bubbles` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event normally bubbles or not | +| `cancelable` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event is cancellable or not? | +| `view` {{readonlyInline}} | [`WindowProxy`](/en-US/docs/Web/API/WindowProxy) | [`document.defaultView`](/en-US/docs/Web/API/Document/defaultView) (`window` of the document) | +| `detail` {{readonlyInline}} | `long` (`float`) | 0. | +| `dataTransfer` | DataTransfer | The data that underlies a drag-and-drop operation, known as the [drag data store](/en-US/docs/Web/API/DataTransfer). Protected mode. | +| `currentTarget` {{readonlyInline}} | EventTarget | The node that had the event listener attached. | +| `relatedTarget` {{readonlyInline}} | EventTarget | For `mouseover`, `mouseout`, `mouseenter` and `mouseleave` events: the target of the complementary event (the `mouseleave` target in the case of a `mouseenter` event). `null` otherwise. | +| `screenX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in global (screen) coordinates. | +| `screenY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in global (screen) coordinates. | +| `clientX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in local (DOM content) coordinates. | +| `clientY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in local (DOM content) coordinates. | +| `button` {{readonlyInline}} | unsigned short | The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left. | +| `buttons` {{readonlyInline}} | unsigned short | The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 \| 2). [More info](/en-US/docs/Web/API/MouseEvent). | +| `mozPressure` {{readonlyInline}} | float | The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure). | +| `ctrlKey` {{readonlyInline}} | boolean | `true` if the control key was down when the event was fired. `false` otherwise. | +| `shiftKey` {{readonlyInline}} | boolean | `true` if the shift key was down when the event was fired. `false` otherwise. | +| `altKey` {{readonlyInline}} | boolean | `true` if the alt key was down when the event was fired. `false` otherwise. | +| `metaKey` {{readonlyInline}} | boolean | `true` if the meta key was down when the event was fired. `false` otherwise. | + +## Exemple：dropzone + +### HTML Content + +```html +<div class="dropzone"> + <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> This div is draggable - </div> -</div> -<div class="dropzone"></div> -<div class="dropzone"></div> -<div class="dropzone"></div> -</pre> + </div> +</div> +<div class="dropzone"></div> +<div class="dropzone"></div> +<div class="dropzone"></div> +``` -<h3 id="CSS_Content">CSS Content</h3> +### CSS Content -<pre class="brush: css"> #draggable { +```css + #draggable { width: 200px; height: 20px; text-align: center; @@ -164,11 +75,12 @@ translation_of: Web/API/Document/dragstart_event margin-bottom: 10px; padding: 10px; } -</pre> +``` -<h3 id="JavaScript_Content">JavaScript Content</h3> +### JavaScript Content -<pre class="brush: js"> var dragged; +```js + var dragged; /* Les événements sont déclenchés sur les objets glissables */ document.addEventListener("drag", function( event ) { @@ -219,45 +131,29 @@ translation_of: Web/API/Document/dragstart_event event.target.appendChild( dragged ); } - }, false);</pre> + }, false); +``` -<p>{{ EmbedLiveSample('Example：dropzone') }}</p> +{{ EmbedLiveSample('Example：dropzone') }} -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragstart")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("HTML5.1", "editing.html#dndevents", "dragstart")}}</td> - <td>{{Spec2("HTML5.1")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragstart")}} | {{Spec2("HTML WHATWG")}} | | +| {{SpecName("HTML5.1", "editing.html#dndevents", "dragstart")}} | {{Spec2("HTML5.1")}} | Définition initiale | -<h2 id="Compatibilités_navigateur">Compatibilités navigateur</h2> +## Compatibilités navigateur -<p>{{Compat("api.Document.dragstart_event")}}</p> +{{Compat("api.Document.dragstart_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{event("drag")}}</li> - <li>{{event("dragstart")}}</li> - <li>{{event("dragend")}}</li> - <li>{{event("dragover")}}</li> - <li>{{event("dragenter")}}</li> - <li>{{event("dragleave")}}</li> - <li>{{event("dragexit")}}</li> - <li>{{event("drop")}}</li> -</ul> +- {{event("drag")}} +- {{event("dragstart")}} +- {{event("dragend")}} +- {{event("dragover")}} +- {{event("dragenter")}} +- {{event("dragleave")}} +- {{event("dragexit")}} +- {{event("drop")}} diff --git a/files/fr/web/api/document/drop_event/index.md b/files/fr/web/api/document/drop_event/index.md index 64453e9860..539c0d9ce2 100644 --- a/files/fr/web/api/document/drop_event/index.md +++ b/files/fr/web/api/document/drop_event/index.md @@ -3,151 +3,61 @@ title: drop slug: Web/API/Document/drop_event translation_of: Web/API/Document/drop_event --- -<div>{{APIRef}}</div> - -<p>L'événement <strong>drop </strong>est déclenché lorsqu'un élément ou une sélection de texte est déposé sur une cible de dépôt valide.</p> - -<h2 id="Informations_générales">Informations générales</h2> - -<dl> - <dt style="float: left; text-align: right; width: 120px;">Interface</dt> - <dd style="margin: 0 0 0 120px;"><a href="/fr/docs/Web/API/DragEvent"><code>DragEvent</code></a></dd> - <dt style="float: left; text-align: right; width: 120px;">Propagation</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Annulable</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Cible</dt> - <dd style="margin: 0 0 0 120px;"><a href="/fr/docs/Web/API/Document"><code>Document</code></a>, <a href="/fr/docs/Web/API/Element"><code>Element</code></a></dd> - <dt style="float: left; text-align: right; width: 120px;">Action par défaut</dt> - <dd style="margin: 0 0 0 120px;">Varie</dd> -</dl> - -<h2 id="Properties">Properties</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/EventTarget"><code>EventTarget</code></a></td> - <td>The element that was underneath the element being dragged.</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/DOMString"><code>DOMString</code></a></td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event normally bubbles or not</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event is cancellable or not?</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/WindowProxy" rel="nofollow"><code>WindowProxy</code></a></td> - <td><a href="/en-US/docs/Web/API/Document/defaultView"><code>document.defaultView</code></a> (<code>window</code> of the document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td><code>long</code> (<code>float</code>)</td> - <td>0.</td> - </tr> - <tr> - <td><code>dataTransfer</code></td> - <td>DataTransfer</td> - <td>The data that underlies a drag-and-drop operation, known as the <a href="/en-US/docs/Web/API/DataTransfer">drag data store</a>. Protected mode.</td> - </tr> - <tr> - <td><code>currentTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>The node that had the event listener attached.</td> - </tr> - <tr> - <td><code>relatedTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>For <code>mouseover</code>, <code>mouseout</code>, <code>mouseenter</code> and <code>mouseleave</code> events: the target of the complementary event (the <code>mouseleave</code> target in the case of a <code>mouseenter</code> event). <code>null</code> otherwise.</td> - </tr> - <tr> - <td><code>screenX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>screenY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>clientX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>clientY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>button</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left.</td> - </tr> - <tr> - <td><code>buttons</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 | 2). <a href="/en-US/docs/Web/API/MouseEvent">More info</a>.</td> - </tr> - <tr> - <td><code>mozPressure</code> {{readonlyInline}}</td> - <td>float</td> - <td>The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure).</td> - </tr> - <tr> - <td><code>ctrlKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the control key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>shiftKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the shift key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>altKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the alt key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>metaKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the meta key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemple">Exemple</h2> - -<pre class="brush: html"><div class="dropzone"> - <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> +{{APIRef}} + +L'événement **drop** est déclenché lorsqu'un élément ou une sélection de texte est déposé sur une cible de dépôt valide. + +## Informations générales + +- Interface + - : [`DragEvent`](/fr/docs/Web/API/DragEvent) +- Propagation + - : Oui +- Annulable + - : Oui +- Cible + - : [`Document`](/fr/docs/Web/API/Document), [`Element`](/fr/docs/Web/API/Element) +- Action par défaut + - : Varie + +## Properties + +| Property | Type | Description | +| ---------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `target` {{readonlyInline}} | [`EventTarget`](/en-US/docs/Web/API/EventTarget) | The element that was underneath the element being dragged. | +| `type` {{readonlyInline}} | [`DOMString`](/en-US/docs/Web/API/DOMString) | The type of event. | +| `bubbles` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event normally bubbles or not | +| `cancelable` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event is cancellable or not? | +| `view` {{readonlyInline}} | [`WindowProxy`](/en-US/docs/Web/API/WindowProxy) | [`document.defaultView`](/en-US/docs/Web/API/Document/defaultView) (`window` of the document) | +| `detail` {{readonlyInline}} | `long` (`float`) | 0. | +| `dataTransfer` | DataTransfer | The data that underlies a drag-and-drop operation, known as the [drag data store](/en-US/docs/Web/API/DataTransfer). Protected mode. | +| `currentTarget` {{readonlyInline}} | EventTarget | The node that had the event listener attached. | +| `relatedTarget` {{readonlyInline}} | EventTarget | For `mouseover`, `mouseout`, `mouseenter` and `mouseleave` events: the target of the complementary event (the `mouseleave` target in the case of a `mouseenter` event). `null` otherwise. | +| `screenX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in global (screen) coordinates. | +| `screenY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in global (screen) coordinates. | +| `clientX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in local (DOM content) coordinates. | +| `clientY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in local (DOM content) coordinates. | +| `button` {{readonlyInline}} | unsigned short | The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left. | +| `buttons` {{readonlyInline}} | unsigned short | The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 \| 2). [More info](/en-US/docs/Web/API/MouseEvent). | +| `mozPressure` {{readonlyInline}} | float | The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure). | +| `ctrlKey` {{readonlyInline}} | boolean | `true` if the control key was down when the event was fired. `false` otherwise. | +| `shiftKey` {{readonlyInline}} | boolean | `true` if the shift key was down when the event was fired. `false` otherwise. | +| `altKey` {{readonlyInline}} | boolean | `true` if the alt key was down when the event was fired. `false` otherwise. | +| `metaKey` {{readonlyInline}} | boolean | `true` if the meta key was down when the event was fired. `false` otherwise. | + +## Exemple + +```html +<div class="dropzone"> + <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> Cette div peut être glissée - </div> -</div> -<div class="dropzone"></div> -<div class="dropzone"></div> -<div class="dropzone"></div> + </div> +</div> +<div class="dropzone"></div> +<div class="dropzone"></div> +<div class="dropzone"></div> -<style> +<style> #draggable { width: 200px; height: 20px; @@ -162,9 +72,9 @@ translation_of: Web/API/Document/drop_event margin-bottom: 10px; padding: 10px; } -</style> +</style> -<script> +<script> var dragged; /* Les événements sont déclenchés sur les objets glissables */ @@ -199,7 +109,7 @@ translation_of: Web/API/Document/drop_event }, false); document.addEventListener("dragleave", function( event ) { - // réinitialisation de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent + // réinitialisation de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent if ( event.target.className == "dropzone" ) { event.target.style.background = ""; } @@ -217,43 +127,27 @@ translation_of: Web/API/Document/drop_event } }, false); -</script></pre> +</script> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "interaction.html#dndevents", "drop event")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("HTML5.1", "editing.html#dndevents", "drop event")}}</td> - <td>{{Spec2("HTML5.1")}}</td> - <td>Première définition</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------- | +| {{SpecName("HTML WHATWG", "interaction.html#dndevents", "drop event")}} | {{Spec2("HTML WHATWG")}} | | +| {{SpecName("HTML5.1", "editing.html#dndevents", "drop event")}} | {{Spec2("HTML5.1")}} | Première définition | -<h2 id="Compatibilités_navigateur">Compatibilités navigateur</h2> +## Compatibilités navigateur -<p>{{Compat("api.Document.drop_event")}}</p> +{{Compat("api.Document.drop_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{event("drag")}}</li> - <li>{{event("dragstart")}}</li> - <li>{{event("dragend")}}</li> - <li>{{event("dragover")}}</li> - <li>{{event("dragenter")}}</li> - <li>{{event("dragleave")}}</li> - <li>{{event("dragexit")}}</li> - <li>{{event("drop")}}</li> -</ul> +- {{event("drag")}} +- {{event("dragstart")}} +- {{event("dragend")}} +- {{event("dragover")}} +- {{event("dragenter")}} +- {{event("dragleave")}} +- {{event("dragexit")}} +- {{event("drop")}} diff --git a/files/fr/web/api/document/elementfrompoint/index.md b/files/fr/web/api/document/elementfrompoint/index.md index 8028725d21..cbd5891099 100644 --- a/files/fr/web/api/document/elementfrompoint/index.md +++ b/files/fr/web/api/document/elementfrompoint/index.md @@ -7,44 +7,54 @@ translation_of: Web/API/DocumentOrShadowRoot/elementFromPoint translation_of_original: Web/API/Document/elementFromPoint original_slug: Web/API/DocumentOrShadowRoot/elementFromPoint --- -<p>{{ ApiRef() }}</p> -<h3 id="R.C3.A9sum.C3.A9">Résumé</h3> -<p>Renvoie l'élément visible au point donné, spécifié relativement au point supérieur gauche visible dans le document.</p> -<h3 id="Syntaxe">Syntaxe</h3> -<pre class="eval"><i>element</i> = document.elementFromPoint(<i>x</i>,<i>y</i>); -</pre> -<p>where</p> -<ul> - <li><code>element</code> est un objet <a href="fr/DOM/element">element</a>.</li> - <li><code>x</code> et <code>y</code> spécifient les coordonnées à vérifier.</li> -</ul> -<h3 id="Exemple">Exemple</h3> -<pre class="brush: html"><html> -<head> -<title>Exemple d'utilisation d'elementFromPoint</title> - -<script type="text/javascript"> +{{ ApiRef() }} + +### Résumé + +Renvoie l'élément visible au point donné, spécifié relativement au point supérieur gauche visible dans le document. + +### Syntaxe + + element = document.elementFromPoint(x,y); + +where + +- `element` est un objet [element](fr/DOM/element). +- `x` et `y` spécifient les coordonnées à vérifier. + +### Exemple + +```html +<html> +<head> +<title>Exemple d'utilisation d'elementFromPoint</title> + +<script type="text/javascript"> function changeColor(newColor) { elem = document.elementFromPoint(2, 2); elem.style.color = newColor; } -</script> -</head> - -<body> -<p id="para1">Un peu de texte ici</p> -<button onclick="changeColor('blue');">bleu</button> -<button onclick="changeColor('red');">rouge</button> -</body> -</html> -</pre> -<h3 id="Notes">Notes</h3> -<p>Si l'élément au point spécifié appartient à un autre document (par exemple, les sous-document d'un iframe), l'élément dans le DOM du document appelant (l'iframe lui-même) est renvoyé. Si l'élément au point donné est anonyme ou du contenu généré par XBL, comme la barre de défilement d'une boîte de texte, le premier élément parent non anonyme (par exemple, la boîte de texte) est renvoyé.</p> -<p>Si le point spécifié est en dehors de la portion visible du document ou que l'une ou l'autre des coordonnées est négative, le résultat est <code>NULL</code>.</p> -<p>{{ Note("Les appelants qui sont des documents XUL devraient attendre que l\'évènement <code>onload</code> se soit déclenché avant d\'appeler cette méthode.") }}</p> -<h3 id="Sp.C3.A9cification">Spécification</h3> -<ul> - <li>Spécification préliminaire : <code><a href="http://dev.w3.org/csswg/cssom/#documentlayout-elementfrompoint">elementFromPoint</a></code></li> -</ul>
\ No newline at end of file +</script> +</head> + +<body> +<p id="para1">Un peu de texte ici</p> +<button onclick="changeColor('blue');">bleu</button> +<button onclick="changeColor('red');">rouge</button> +</body> +</html> +``` + +### Notes + +Si l'élément au point spécifié appartient à un autre document (par exemple, les sous-document d'un iframe), l'élément dans le DOM du document appelant (l'iframe lui-même) est renvoyé. Si l'élément au point donné est anonyme ou du contenu généré par XBL, comme la barre de défilement d'une boîte de texte, le premier élément parent non anonyme (par exemple, la boîte de texte) est renvoyé. + +Si le point spécifié est en dehors de la portion visible du document ou que l'une ou l'autre des coordonnées est négative, le résultat est `NULL`. + +{{ Note("Les appelants qui sont des documents XUL devraient attendre que l\'évènement <code>onload</code> se soit déclenché avant d\'appeler cette méthode.") }} + +### Spécification + +- Spécification préliminaire : [`elementFromPoint`](http://dev.w3.org/csswg/cssom/#documentlayout-elementfrompoint) diff --git a/files/fr/web/api/document/elementsfrompoint/index.md b/files/fr/web/api/document/elementsfrompoint/index.md index 259d9da6fc..e275e5780d 100644 --- a/files/fr/web/api/document/elementsfrompoint/index.md +++ b/files/fr/web/api/document/elementsfrompoint/index.md @@ -14,90 +14,72 @@ tags: translation_of: Web/API/DocumentOrShadowRoot/elementsFromPoint original_slug: Web/API/DocumentOrShadowRoot/elementsFromPoint --- -<div>{{APIRef("DOM")}}{{SeeCompatTable}}</div> +{{APIRef("DOM")}}{{SeeCompatTable}} -<p>La propriété <strong><code>elementsFromPoint()</code></strong> de l'interface {{domxref("DocumentOrShadowRoot")}} renvoie un tableau (<em>array</em>) de tous les éléments présents sous le point fourni en paramètre (relatif au <em>viewport</em>).</p> +La propriété **`elementsFromPoint()`** de l'interface {{domxref("DocumentOrShadowRoot")}} renvoie un tableau (_array_) de tous les éléments présents sous le point fourni en paramètre (relatif au _viewport_). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var elements = document.elementsFromPoint(x, y);</pre> + var elements = document.elementsFromPoint(x, y); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt>x</dt> - <dd>L'abscisse du point (coordonnée horizontale).</dd> - <dt>y</dt> - <dd>L'ordonnée du point (coordonnée verticale).</dd> -</dl> +- x + - : L'abscisse du point (coordonnée horizontale). +- y + - : L'ordonnée du point (coordonnée verticale). -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un tableau (<em>array</em>) d'objets {{domxref('element')}} représentants les éléments du DOM concernés.</p> +Un tableau (_array_) d'objets {{domxref('element')}} représentants les éléments du DOM concernés. -<h2 id="Example">Exemples</h2> +## Exemples -<h3 id="HTML">HTML</h3> +### HTML -<pre class="brush: html"><div> - <p>Du texte</p> -</div> -<p>Éléments au point 30, 20:</p> -<div id="output"></div> -</pre> +```html +<div> + <p>Du texte</p> +</div> +<p>Éléments au point 30, 20:</p> +<div id="output"></div> +``` -<h3 id="JavaScript">JavaScript</h3> +### JavaScript -<pre class="brush: js">var output = document.getElementById("output"); +```js +var output = document.getElementById("output"); if (document.elementsFromPoint) { var elements = document.elementsFromPoint(30, 20); - for(var i = 0; i < elements.length; i++) { + for(var i = 0; i < elements.length; i++) { output.textContent += elements[i].localName; - if (i < elements.length - 1) { - output.textContent += " < "; + if (i < elements.length - 1) { + output.textContent += " < "; } } } else { - output.innerHTML = "<span style=\"color: red;\">" + - "Votre navigateur ne prend pas en charge <code>document.elementsFromPoint()</code>" + - "</span>"; -}</pre> - -<h3 id="Résultat">Résultat</h3> - -<p>{{EmbedLiveSample('Example', '420', '120')}}</p> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Shadow DOM','#extensions-to-the-documentorshadowroot-mixin','DocumentOrShadowRoot')}}</td> - <td>{{Spec2('Shadow DOM')}}</td> - <td>Définition initiale</td> - </tr> - <tr> - <td>{{SpecName('CSSOM View', '#dom-document-elementsfrompoint', 'Document')}}</td> - <td>{{Spec2('CSSOM View')}}</td> - <td>Précise l'ordre selon lequel les éléments sont peints.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.DocumentOrShadowRoot.elementsFromPoint")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{DOMxRef("DocumentOrShadowRoot.elementFromPoint()")}}</li> - <li>{{DOMxRef("DocumentOrShadowRoot.msElementsFromRect()")}} {{Non-standard_Inline}}</li> -</ul> + output.innerHTML = "<span style=\"color: red;\">" + + "Votre navigateur ne prend pas en charge <code>document.elementsFromPoint()</code>" + + "</span>"; +} +``` + +### Résultat + +{{EmbedLiveSample('Example', '420', '120')}} + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------------ | +| {{SpecName('Shadow DOM','#extensions-to-the-documentorshadowroot-mixin','DocumentOrShadowRoot')}} | {{Spec2('Shadow DOM')}} | Définition initiale | +| {{SpecName('CSSOM View', '#dom-document-elementsfrompoint', 'Document')}} | {{Spec2('CSSOM View')}} | Précise l'ordre selon lequel les éléments sont peints. | + +## Compatibilité des navigateurs + +{{Compat("api.DocumentOrShadowRoot.elementsFromPoint")}} + +## Voir aussi + +- {{DOMxRef("DocumentOrShadowRoot.elementFromPoint()")}} +- {{DOMxRef("DocumentOrShadowRoot.msElementsFromRect()")}} {{Non-standard_Inline}} diff --git a/files/fr/web/api/document/enablestylesheetsforset/index.md b/files/fr/web/api/document/enablestylesheetsforset/index.md index f0aca39903..ac899fc8c4 100644 --- a/files/fr/web/api/document/enablestylesheetsforset/index.md +++ b/files/fr/web/api/document/enablestylesheetsforset/index.md @@ -10,50 +10,40 @@ tags: - Méthode translation_of: Web/API/Document/enableStyleSheetsForSet --- -<p>{{ APIRef("DOM") }}{{ gecko_minversion_header("1.9") }}</p> +{{ APIRef("DOM") }}{{ gecko_minversion_header("1.9") }} -<p>Active les feuilles de styles correspondant au nom spécifié dans l'ensemble de feuilles de styles en cours et désactive toutes les autres (à l'exception de celles sans titre qui sont toujours activées).</p> +Active les feuilles de styles correspondant au nom spécifié dans l'ensemble de feuilles de styles en cours et désactive toutes les autres (à l'exception de celles sans titre qui sont toujours activées). -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval">document.enableStyleSheetsForSet(<em>name</em>) -</pre> + document.enableStyleSheetsForSet(name) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>name</code></dt> - <dd>Le nom des feuilles de styles à activer. Toutes les feuilles de styles dont le titre correspond à ce nom seront activées, tandis que toutes celles possédant un autre titre seront désactivées. Spécifiez une chaîne vide dans le paramètre <code>name</code> pour supprimer toutes les feuilles de styles alternatives et préférées (mais pas les feuilles de styles persistantes, c'est-à-dire, celles sans attribut <code>title</code> (<em>titre</em>)).</dd> -</dl> +- `name` + - : Le nom des feuilles de styles à activer. Toutes les feuilles de styles dont le titre correspond à ce nom seront activées, tandis que toutes celles possédant un autre titre seront désactivées. Spécifiez une chaîne vide dans le paramètre `name` pour supprimer toutes les feuilles de styles alternatives et préférées (mais pas les feuilles de styles persistantes, c'est-à-dire, celles sans attribut `title` (_titre_)). -<h2 id="Notes">Notes</h2> +## Notes -<ul> - <li>Les correspondances de titre sont sensibles à la casse.</li> - <li>L'appel de cette méthode avec un <code>name</code> <code>null</code> n'a pas d'effet ; si vous voulez désactiver toutes les feuilles de styles alternatives et préférées, vous <strong>devez</strong> utiliser "", la chaîne vide.</li> - <li>Les feuilles de styles qui n'ont pas de titre ne sont jamais affectées par cette méthode.</li> - <li>Cette méthode n'affecte jamais les valeurs de {{ domxref("document.lastStyleSheetSet") }} ou {{ domxref("document.preferredStyleSheetSet") }}.</li> -</ul> +- Les correspondances de titre sont sensibles à la casse. +- L'appel de cette méthode avec un `name` `null` n'a pas d'effet ; si vous voulez désactiver toutes les feuilles de styles alternatives et préférées, vous **devez** utiliser "", la chaîne vide. +- Les feuilles de styles qui n'ont pas de titre ne sont jamais affectées par cette méthode. +- Cette méthode n'affecte jamais les valeurs de {{ domxref("document.lastStyleSheetSet") }} ou {{ domxref("document.preferredStyleSheetSet") }}. -<h2 id="Example">Exemple</h2> +## Exemple -<pre>document.enableStyleSheetsForSet("Some style sheet set name"); -</pre> + document.enableStyleSheetsForSet("Some style sheet set name"); -<h2 id="Specification">Spécifications</h2> +## Spécifications -<ul> - <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets">HTML5 : Alternate Style Sheets</a></li> -</ul> +- [HTML5 : Alternate Style Sheets](http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{ domxref("Stylesheet") }}</li> - <li>{{ domxref("document.styleSheets") }}</li> - <li>{{ domxref("document.lastStyleSheetSet") }}</li> - <li>{{ domxref("document.preferredStyleSheetSet") }}</li> - <li>{{ domxref("document.selectedStyleSheetSet") }}</li> - <li>{{ domxref("document.enableStyleSheetsForSet()") }}</li> - <li><a href="/fr/docs/Archive/Standards_du_Web/Utiliser_des_titres_corrects_avec_des_feuilles_de_styles_externes">Utiliser des titres corrects avec des feuilles de styles externes</a></li> -</ul> +- {{ domxref("Stylesheet") }} +- {{ domxref("document.styleSheets") }} +- {{ domxref("document.lastStyleSheetSet") }} +- {{ domxref("document.preferredStyleSheetSet") }} +- {{ domxref("document.selectedStyleSheetSet") }} +- {{ domxref("document.enableStyleSheetsForSet()") }} +- [Utiliser des titres corrects avec des feuilles de styles externes](/fr/docs/Archive/Standards_du_Web/Utiliser_des_titres_corrects_avec_des_feuilles_de_styles_externes) diff --git a/files/fr/web/api/document/evaluate/index.md b/files/fr/web/api/document/evaluate/index.md index 03cc732e3e..44ea0ed1da 100644 --- a/files/fr/web/api/document/evaluate/index.md +++ b/files/fr/web/api/document/evaluate/index.md @@ -9,31 +9,30 @@ tags: - XPath translation_of: Web/API/Document/evaluate --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>La méthode <code><strong>evaluate()</strong></code> renvoie un {{domxref("XPathResult")}} basé sur une expression <a href="/fr/docs/XPath">XPath</a> et d'autres paramètres donnés.</p> +La méthode **`evaluate()`** renvoie un {{domxref("XPathResult")}} basé sur une expression [XPath](/fr/docs/XPath) et d'autres paramètres donnés. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var xpathResult = document.evaluate( - xpathExpression, - contextNode, - namespaceResolver, - resultType, - result -);</pre> + var xpathResult = document.evaluate( + xpathExpression, + contextNode, + namespaceResolver, + resultType, + result + ); -<ul> - <li><code>xpathExpression</code> est une chaîne de caractères représentant le XPath à évaluer.</li> - <li><code>contextNode</code> spécifie le noeud de contexte pour la requête (voir <a href="http://www.w3.org/TR/xpath">XPath specification</a>) . Il est courant de transmettre un document en tant que nœud de contexte.</li> - <li><code>namespaceResolver</code> est une fonction qui recevra tous les préfixes d'espace de noms et devrait renvoyer une chaîne représentant l'URI de l'espace de noms associé à ce préfixe. Il sera utilisé pour résoudre les préfixes dans le XPath lui-même, afin qu'ils puissent être mis en correspondance avec le document. <code>null</code> est commun pour les documents HTML ou lorsque aucun préfixe d'espace de noms n'est utilisé.</li> - <li><code>resultType</code> est un nombre entier qui correspond au type de résultat <code>XPathResult</code> à retourner. Utilisez des <a href="#Types_de_resultats">propriétés de constantes nommées</a>, comme <code>XPathResult.ANY_TYPE</code> du constructeur de XPathResult , lequel correspond à un nombre entier compris entre 0 et 9.</li> - <li><code>result</code> est un <code>XPathResult</code> existant à utiliser pour les résultats. <code>null</code> est le plus commun et va créer un nouveau XPathResult</li> -</ul> +- `xpathExpression` est une chaîne de caractères représentant le XPath à évaluer. +- `contextNode` spécifie le noeud de contexte pour la requête (voir [XPath specification](http://www.w3.org/TR/xpath)) . Il est courant de transmettre un document en tant que nœud de contexte. +- `namespaceResolver` est une fonction qui recevra tous les préfixes d'espace de noms et devrait renvoyer une chaîne représentant l'URI de l'espace de noms associé à ce préfixe. Il sera utilisé pour résoudre les préfixes dans le XPath lui-même, afin qu'ils puissent être mis en correspondance avec le document. `null` est commun pour les documents HTML ou lorsque aucun préfixe d'espace de noms n'est utilisé. +- `resultType` est un nombre entier qui correspond au type de résultat `XPathResult` à retourner. Utilisez des [propriétés de constantes nommées](#Types_de_resultats), comme `XPathResult.ANY_TYPE` du constructeur de XPathResult , lequel correspond à un nombre entier compris entre 0 et 9. +- `result` est un `XPathResult` existant à utiliser pour les résultats. `null` est le plus commun et va créer un nouveau XPathResult -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js "> var headings = document . evaluate ( " / html / body //h2", document, null, XPathResult.ANY_TYPE, null); +```js + var headings = document . evaluate ( " / html / body //h2", document, null, XPathResult.ANY_TYPE, null); /* Cherche le document pour tout élément h2. * Le résultat sera probablement un itérateur de noeuds non ordonné. */ var thisHeading = headings . iterateNext ( ) ; @@ -42,120 +41,140 @@ translation_of: Web/API/Document/evaluate alertText + = thisHeading . textContent + "\n" ; thisHeading = headings . iterateNext ( ) ; } - alert ( alertText ) ; // Alerte le texte de tout élément h2 </pre> + alert ( alertText ) ; // Alerte le texte de tout élément h2 +``` -<p>Note : dans l'exemple ci-dessus, un XPath plus verbeux est préféré aux raccourcis communs tels que <code>//h2</code>. Généralement, des sélecteurs XPath plus spécifiques, comme dans l'exemple ci-dessus, améliorent de façon significative les performances, en particulier pour les documents très volumineux. C'est parce que l'évaluation de la requête ne perd pas de temps à visiter des noeuds inutiles. L'utilisation de // est généralement lente car elle visite tous les nœuds de la racine et tous les sous-nœuds à la recherche de correspondances possibles.</p> +Note : dans l'exemple ci-dessus, un XPath plus verbeux est préféré aux raccourcis communs tels que `//h2`. Généralement, des sélecteurs XPath plus spécifiques, comme dans l'exemple ci-dessus, améliorent de façon significative les performances, en particulier pour les documents très volumineux. C'est parce que l'évaluation de la requête ne perd pas de temps à visiter des noeuds inutiles. L'utilisation de // est généralement lente car elle visite tous les nœuds de la racine et tous les sous-nœuds à la recherche de correspondances possibles. -<p>Une optimisation supplémentaire peut être obtenue en utilisant soigneusement le paramètre de contexte. Par exemple, si vous savez que le contenu que vous recherchez se trouve quelque part dans la balise body, vous pouvez utiliser ceci :</p> +Une optimisation supplémentaire peut être obtenue en utilisant soigneusement le paramètre de contexte. Par exemple, si vous savez que le contenu que vous recherchez se trouve quelque part dans la balise body, vous pouvez utiliser ceci : -<pre class="brush: js">document . evaluate ( " . //h2", document.body, null, XPathResult.ANY_TYPE, null); </pre> +```js +document . evaluate ( " . //h2", document.body, null, XPathResult.ANY_TYPE, null); +``` -<p>Remarquez ci-dessus, <code>document.body</code> a été utilisé comme contexte plutôt que comme document, de sorte que le XPath commence à partir de l'élément body. (Dans cet exemple, le <code>"."</code> est important pour indiquer que l'interrogation doit commencer à partir du noeud contextuel, document.body . Si le "." est omis (en quittant <code>//h2</code>), la requête démarrera à partir du noeud racine ( <code>html</code>) ce qui serait plus inutile.)</p> +Remarquez ci-dessus, `document.body` a été utilisé comme contexte plutôt que comme document, de sorte que le XPath commence à partir de l'élément body. (Dans cet exemple, le `"."` est important pour indiquer que l'interrogation doit commencer à partir du noeud contextuel, document.body . Si le "." est omis (en quittant `//h2`), la requête démarrera à partir du noeud racine ( `html`) ce qui serait plus inutile.) -<p>Voir <a href="/fr/docs/Introduction_%C3%A0_l'utilisation_de_XPath_avec_JavaScript">Introduction à l'utilisation de XPath avec JavaScript</a> pour plus d'informations.</p> +Voir [Introduction à l'utilisation de XPath avec JavaScript](/fr/docs/Introduction_%C3%A0_l'utilisation_de_XPath_avec_JavaScript) pour plus d'informations. -<h2 id="Notes">Notes</h2> +## Notes -<ul> - <li>Les expressions XPath peuvent être évaluées sur les documents HTML et XML.</li> - <li>Lors de l'utilisation de document.evaluate() dans FF2 ; dans FF3, il faut utiliser someXMLDoc.evaluate() si l'on évalue quelque chose d'autre que le document actuel.</li> -</ul> +- Les expressions XPath peuvent être évaluées sur les documents HTML et XML. +- Lors de l'utilisation de document.evaluate() dans FF2 ; dans FF3, il faut utiliser someXMLDoc.evaluate() si l'on évalue quelque chose d'autre que le document actuel. -<h2 id="Types_de_résultats">Types de résultats</h2> +## Types de résultats -<p>Ce sont des valeurs prises en charge pour le paramètre <code>resultType</code> de la méthode <code>evaluate</code> :</p> +Ce sont des valeurs prises en charge pour le paramètre `resultType` de la méthode `evaluate` : <table class="standard-table"> - <tbody> - <tr> - <td class="header">Type de résultat</td> - <td class="header">Valeur</td> - <td class="header">Description</td> - </tr> - <tr> - <td><code>ANY_TYPE</code></td> - <td>0</td> - <td>Quel que soit le type, résulte naturellement de l'expression donnée.</td> - </tr> - <tr> - <td><code>NUMBER_TYPE</code></td> - <td>1</td> - <td>Un ensemble de résultats contenant un seul nombre. Utile, par exemple, dans une expression XPath utilisant la fonction count().</td> - </tr> - <tr> - <td><code>STRING_TYPE</code></td> - <td>2</td> - <td>Un ensemble de résultats contenant une seule chaîne de caractères.</td> - </tr> - <tr> - <td><code>BOOLEAN_TYPE</code></td> - <td>3</td> - <td>Un ensemble de résultats contenant une seule valeur booléenne. Utile pour, par exemple, une expression XPath utilisant la fonction not().</td> - </tr> - <tr> - <td><code>UNORDERED_NODE_ITERATOR_TYPE</code></td> - <td>4</td> - <td>Un ensemble de résultats contenant tous les nœuds correspondant à l'expression. Les nœuds de cet ensemble ne sont pas nécessairement dans le même ordre que celui de leur apparition dans le document.</td> - </tr> - <tr> - <td><code>ORDERED_NODE_ITERATOR_TYPE</code></td> - <td>5</td> - <td>Un ensemble de résultats contenant tous les noeuds correspondant à l'expression. Les nœuds de cet ensemble sont dans le même ordre que celui de leur apparition dans le document .</td> - </tr> - <tr> - <td><code>UNORDERED_NODE_SNAPSHOT_TYPE</code></td> - <td>6</td> - <td>Un ensemble de résultats contenant des instantanés de tous les nœuds correspondant à l'expression. Les nœuds de cet ensemble ne sont pas nécessairement dans le même ordre que celui de leur apparition dans le document .</td> - </tr> - <tr> - <td><code>ORDERED_NODE_SNAPSHOT_TYPE</code></td> - <td>7</td> - <td>Un ensemble de résultats contenant des instantanés de tous les nœuds correspondant à l'expression. Les nœuds de cet ensemble sont dans le même ordre que celui de leur apparition dans le document .</td> - </tr> - <tr> - <td><code>ANY_UNORDERED_NODE_TYPE</code></td> - <td>8</td> - <td>Un ensemble de résultats contenant un seul nœud correspondant à l'expression. Le noeud n'est pas nécessairement le premier noeud du document qui correspond à l'expression.</td> - </tr> - <tr> - <td><code>FIRST_ORDERED_NODE_TYPE</code></td> - <td>9</td> - <td>Un ensemble de résultats contenant le premier nœud du document qui correspond à l'expression.</td> - </tr> - </tbody> + <tbody> + <tr> + <td class="header">Type de résultat</td> + <td class="header">Valeur</td> + <td class="header">Description</td> + </tr> + <tr> + <td><code>ANY_TYPE</code></td> + <td>0</td> + <td> + Quel que soit le type, résulte naturellement de l'expression donnée. + </td> + </tr> + <tr> + <td><code>NUMBER_TYPE</code></td> + <td>1</td> + <td> + Un ensemble de résultats contenant un seul nombre. Utile, par exemple, + dans une expression XPath utilisant la fonction count(). + </td> + </tr> + <tr> + <td><code>STRING_TYPE</code></td> + <td>2</td> + <td> + Un ensemble de résultats contenant une seule chaîne de caractères. + </td> + </tr> + <tr> + <td><code>BOOLEAN_TYPE</code></td> + <td>3</td> + <td> + Un ensemble de résultats contenant une seule valeur booléenne. Utile + pour, par exemple, une expression XPath utilisant la fonction not(). + </td> + </tr> + <tr> + <td><code>UNORDERED_NODE_ITERATOR_TYPE</code></td> + <td>4</td> + <td> + Un ensemble de résultats contenant tous les nœuds correspondant à + l'expression. Les nœuds de cet ensemble ne sont pas nécessairement dans + le même ordre que celui de leur apparition dans le document. + </td> + </tr> + <tr> + <td><code>ORDERED_NODE_ITERATOR_TYPE</code></td> + <td>5</td> + <td> + Un ensemble de résultats contenant tous les noeuds correspondant à + l'expression. Les nœuds de cet ensemble sont dans le même ordre que + celui de leur apparition dans le document . + </td> + </tr> + <tr> + <td><code>UNORDERED_NODE_SNAPSHOT_TYPE</code></td> + <td>6</td> + <td> + Un ensemble de résultats contenant des instantanés de tous les nœuds + correspondant à l'expression. Les nœuds de cet ensemble ne sont pas + nécessairement dans le même ordre que celui de leur apparition dans le + document . + </td> + </tr> + <tr> + <td><code>ORDERED_NODE_SNAPSHOT_TYPE</code></td> + <td>7</td> + <td> + Un ensemble de résultats contenant des instantanés de tous les nœuds + correspondant à l'expression. Les nœuds de cet ensemble sont dans le + même ordre que celui de leur apparition dans le document . + </td> + </tr> + <tr> + <td><code>ANY_UNORDERED_NODE_TYPE</code></td> + <td>8</td> + <td> + Un ensemble de résultats contenant un seul nœud correspondant à + l'expression. Le noeud n'est pas nécessairement le premier noeud du + document qui correspond à l'expression. + </td> + </tr> + <tr> + <td><code>FIRST_ORDERED_NODE_TYPE</code></td> + <td>9</td> + <td> + Un ensemble de résultats contenant le premier nœud du document qui + correspond à l'expression. + </td> + </tr> + </tbody> </table> -<p>Les résultats des types <code>NODE_ITERATOR</code> contiennent des références aux noeuds du document. La modification d'un nœud invalidera l'itérateur. Après avoir modifié un nœud, tenter de parcourir les résultats entraînera une erreur.</p> +Les résultats des types `NODE_ITERATOR` contiennent des références aux noeuds du document. La modification d'un nœud invalidera l'itérateur. Après avoir modifié un nœud, tenter de parcourir les résultats entraînera une erreur. -<p>Les résultats des types <code>NODE_SNAPSHOT</code> sont des instantanés, qui sont essentiellement des listes de nœuds correspondants. Vous pouvez apporter des modifications au document en modifiant les nœuds de capture instantanée. La modification du document n'invalide pas l'instantané. Toutefois, si le document est modifié, l'instantané peut ne pas correspondre à l'état actuel du document, car les nœuds peuvent avoir été déplacés, modifiés, ajoutés ou supprimés.</p> +Les résultats des types `NODE_SNAPSHOT` sont des instantanés, qui sont essentiellement des listes de nœuds correspondants. Vous pouvez apporter des modifications au document en modifiant les nœuds de capture instantanée. La modification du document n'invalide pas l'instantané. Toutefois, si le document est modifié, l'instantané peut ne pas correspondre à l'état actuel du document, car les nœuds peuvent avoir été déplacés, modifiés, ajoutés ou supprimés. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("DOM3 XPath", "xpath.html#XPathEvaluator-evaluate", "Document.evaluate")}}</td> - <td>{{Spec2("DOM3 XPath")}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------- | +| {{SpecName("DOM3 XPath", "xpath.html#XPathEvaluator-evaluate", "Document.evaluate")}} | {{Spec2("DOM3 XPath")}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.evaluate")}}</p> +{{Compat("api.Document.evaluate")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/Document/createExpression">DOM : document.createExpression</a></li> - <li><a href="/fr/Add-ons/Code_snippets/XPath">XPath Code Snippets</a></li> - <li><a href="http://codepen.io/johan/full/ckFgn">Vérifier le support du navigateur</a></li> -</ul> +- [DOM : document.createExpression](/fr/docs/Web/API/Document/createExpression) +- [XPath Code Snippets](/fr/Add-ons/Code_snippets/XPath) +- [Vérifier le support du navigateur](http://codepen.io/johan/full/ckFgn) diff --git a/files/fr/web/api/document/execcommand/index.md b/files/fr/web/api/document/execcommand/index.md index c581db094d..dfd9812dcd 100644 --- a/files/fr/web/api/document/execcommand/index.md +++ b/files/fr/web/api/document/execcommand/index.md @@ -9,185 +9,163 @@ tags: - Reference translation_of: Web/API/Document/execCommand --- -<div>{{ApiRef("DOM")}}{{deprecated_header}}</div> - -<p>Lorsqu'un document HTML passe en <code><a href="/fr/docs/Web/API/Document/designMode">designMode</a></code>, l'objet <code>document</code> correspondant expose une méthode <strong><code>execCommand()</code></strong> permettant d'exécuter des commandes manipulant la région éditable courante tels que <a href="/fr/docs/Web/HTML/Element/input">les champs de formulaire</a> ou les éléments <code><a href="/fr/docs/Web/HTML/Global_attributes/contenteditable">contentEditable</a></code>.</p> - -<p>La plupart des commandes affectent la <a - href="/fr/docs/Web/API/Selection">sélection</a> du document (mise en gras, italique, etc.), tandis que - d'autres insèrent de nouveaux éléments (un lien) ou modifient toute une ligne (indentation). Lorsqu'on - utilise <code>contentEditable</code>, <code>execCommand()</code> affecte l'élément éditable - courant.</p> - -<h2 id="Syntax">Syntaxe</h2> - -<pre class="brush: js"><var>document</var>.execCommand(<var>aCommandName</var>, <var>aShowDefaultUI</var>, <var>aValueArgument</var>) -</pre> - -<h3 id="Return_value">Valeur de retour</h3> - -<p>Un booléen ({{jsxref('Boolean')}}) qui vaut <code>false</code> si la commande n'est pas - prise en charge ou si elle est désactivée.</p> - -<div class="note"> - <p><strong>Note :</strong> <code><var>document</var>.execCommand()</code> ne renvoie - <code>true</code> que s'il est appelé à partir d'une interaction utilisateur. On ne - peut pas l'invoquer dans un script afin de vérifier la prise en charge navigateur avant - d'appeler une commande. À partir de Firefox 82, les appels imbriqués à - <code>document.execCommand()</code> renverront toujours <code>false</code>.</p> -</div> - -<h3 id="Parameters">Paramètres</h3> - -<dl> - <dt><code><var>aCommandName</var></code></dt> - <dd>Une chaîne de caractères {{domxref("DOMString")}} indiquant le nom de la commande à - exécuter. Voir {{anch("Commands")}} pour une liste de commandes possibles.</dd> - <dt><code><var>aShowDefaultUI</var></code></dt> - <dd>Un booléen ({{jsxref("Boolean")}}) indiquant si l'interface utilisateur par défaut - devrait être affichée. Ce n'est pas implémenté par Mozilla.</dd> - <dt><code><var>aValueArgument</var></code></dt> - <dd>Pour les commandes utilisant un argument en entrée, il s'agit d'une chaîne {{domxref("DOMString")}} - qui fournit cette information. On pourra, par exemple, <code>insertImage</code> utilise - l'URL de l'image à insérer. On utilisera <code>null</code> si aucun argument n'est utilisé.</dd> -</dl> - -<h3 id="Commands">Commandes</h3> - -<dl> - <dt><code>backColor</code></dt> - <dd><p>Modifie la couleur d'arrière-plan du document. Avec le mode <code>styleWithCss</code> cela affecte la couleur d'arrière-plan du bloc englobant. Une chaîne de caractères décrivant une valeur {{cssxref("<color>")}} doit être passée en argument. On notera qu'Internet Explorer utilise ceci pour la couleur d'arrière-plan du texte.</p></dd> - <dt><code>bold</code></dt> - <dd><p>Active ou désactive la mise en gras pour la sélection ou à partir du point d'insertion Internet Explorer utilise la balise {{HTMLElement("strong")}} plutôt que {{HTMLElement("b")}}.</p></dd> - <dt><code>ClearAuthenticationCache</code></dt> - <dd><p>Supprime toutes les informations d'authentification <i>credentials</i>) du cache.</p></dd> - <dt><code>contentReadOnly</code></dt> - <dd><p>Rend le contenu du document en lecture seule ou éditable en fonction du booléen passé en argument (n'est pas pris en charge par Internet Explorer)</p></dd> - <dt><code>copy</code></dt> - <dd><p>Copie la sélection courante vers le presse-papier. Les conditions pour obtenir ce comportement peuvent varier d'un navigateur à l'autre. Veuillez voir le tableau de compatibilité ci-après.</p></dd> - <dt><code>createLink</code></dt> - <dd><p>Crée un hyperlien à partir de la sélection (sous réserve qu'il y en ait une). Une chaîne de caractères formant un URI est nécessaire comme argument afin de fournir la valeur de l'attribut <code>href</code>. L'URI doit contenir au moins un caractère (qui peut être un blanc). (Internet Explorer créera un lien avec une valeur <code>null</code>.)</p></dd> - <dt><code>cut</code></dt> - <dd><p>Coupe le contenu de la sélection courante et le copie dans le presse-papier. Les conditions pour obtenir ce comportement peuvent varier d'un navigateur à l'autre. Veuillez voir le tableau de compatibilité ci-après.</p></dd> - <dt><code>decreaseFontSize</code></dt> - <dd><p>Ajoute une balise {{HTMLElement("small")}} autour de la sélection ou au point d'insertion. (Non pris en charge par Internet Explorer.)</p></dd> - <dt><code>defaultParagraphSeparator</code></dt> - <dd><p>Modifie le séparateur de paragraphe utilisé lorsque de nouveaux paragraphes sont créés dans les zones de texte éditables. Voir <a href="/fr/docs/Web/Guide/HTML/Editable_content#differences_in_markup_generation"> Différences dans la génération du balisage</a> pour plus de détails.</p></dd> - <dt><code>delete</code></dt> - <dd><p>Supprimer la sélection courante.</p></dd> - <dt><code>enableAbsolutePositionEditor</code></dt> - <dd><p>Active ou désactive la poignée qui permet de déplacer les éléments positionnés de façon absolue. Celle-ci est désactivée par défaut depuis Firefox 64 ({{bug(1490641)}}).</p></dd> - <dt><code>enableInlineTableEditing</code></dt> - <dd><p>Active ou désactive les contrôles pour l'insertion ou la suppression des lignes ou colonnes de tableau. Les contrôles sont désactivés par défaut depuis Firefox 64 ({{bug(1490641)}}).</p></dd> - <dt><code>enableObjectResizing</code></dt> - <dd><p>Active ou désactive les contrôles permettant de redimensionner les images, tableaux ou les éléments positionnés de façon absolue. Les poignées sont désactivées par défaut depuis Firefox 64 ({{bug(1490641)}}).</p></dd> - <dt><code>fontName</code></dt> - <dd><p>Modifie le nom de la police pour la sélection ou à partir du point d'insertion. La valeur fournie en argument doit être un nom de police (ex. <code>"Arial"</code>).</p></dd> - <dt><code>fontSize</code></dt> - <dd><p>Modifie la taille de la police pour la sélection ou à partir du point d'insertion. La valeur fournie en argument doit être un entier compris entre 1 et 7.</p></dd> - <dt><code>foreColor</code></dt> - <dd><p>Modifie la couleur de la police pour la sélection ou à partir du point d'insertion. La valeur passée en argument doit être une chaîne de caractères décrivant une couleur exprimée en notation hexadécimale.</p></dd> - <dt><code>formatBlock</code></dt> - <dd><p>Ajoute un élément HTML de bloc autour de la ligne contenant la sélection courante et remplace l'éventuel élément de bloc englobant s'il en existe un (pour Firefox, {{HTMLElement("blockquote")}} fera exception et englobera n'importe quel bloc). L'argument passé doit être un nom de balise. Tous les éléments de bloc peuvent en théorie être utilisés. (Internet Explorer et Edge ne prennent en charge que les balises <code>H1</code><code>H6</code>, <code>ADDRESS</code>, et <code>PRE</code> qui doivent être passées entre chevrons : <code>"<H1>"</code>.)</p></dd> - <dt><code>forwardDelete</code></dt> - <dd><p>Supprime un caractère à la position du curseur. Le comportement obtenu est le même que lorsqu'on appuie sur la touche <kbd>Suppr</kbd> d'un clavier Windows.</p></dd> - <dt><code>heading</code></dt> - <dd><p>Ajoute un élément de titre autour de la sélection ou au niveau du point d'insertion. L'argument doit être le nom d'une balise de titre (<code>"H1"</code> à <code>"H6"</code>). (Non pris en charge par Internet Explorer et Safari.)</p></dd> - <dt><code>hiliteColor</code></dt> - <dd><p>Modifie la couleur d'arrière-plan pour la sélection ou à partir du point d'insertion. La valeur passée en argument doit être une chaîne de caractères définissant une couleur et <code>useCSS</code> doit valoir <code>true</code>. (Non pris en charge par Internet Explorer.)</p></dd> - <dt><code>increaseFontSize</code></dt> - <dd><p>Ajoute une balise {{HTMLElement("big")}} autour de la sélection ou à partir du point d'insertion. (Non pris en charge par Internet Explorer).</p></dd> - <dt><code>indent</code></dt> - <dd><p>Augmente l'indentation de la ligne contenant la sélection ou le point d'insertion. Pour Firefox, si la sélection s'étend sur plusieurs lignes ayant différents niveaux d'indentation, seules les lignes les moins indentées seront décalées.</p></dd> - <dt><code>insertBrOnReturn</code></dt> - <dd><p>Contrôle si la touche <kbd>Entrée</kbd> insère un élément {{HTMLElement("br")}} ou si le bloc courant est scindé en deux. (Non pris en charge par Internet Explorer.)</p></dd> - <dt><code>insertHorizontalRule</code></dt> - <dd><p>Insère un élément {{HTMLElement("hr")}} au point d'insertion ou remplace la sélection courante par cet élément.</p></dd> - <dt><code>insertHTML</code></dt> - <dd><p>Insère un élément au point d'insertion en supprimant la sélection. Une chaîne de caractères HTML valide doit être fournie en argument. (Non pris en charge par Internet Explorer.)</p></dd> - <dt><code>insertImage</code></dt> - <dd><p>Insère une image au point d'insertion en supprimant la sélection. L'argument doit être une chaîne de caractères indiquant l'URL à utiliser pour l'attribut <code>src</code> de l'image. Les prérequis de cette valeur sont les mêmes que pour <code>createLink</code>.</p></dd> - <dt><code>insertOrderedList</code></dt> - <dd><p>Crée une <a href="/fr/docs/Web/HTML/Element/ol">liste numérotée ordonnée</a> pour la sélection ou à partir du point d'insertion.</p></dd> - <dt><code>insertUnorderedList</code></dt> - <dd><p>Crée une <a href="/fr/docs/Web/HTML/Element/ul">liste non-ordonnée</a> pour la sélection ou à partir du point d'insertion.</p></dd> - <dt><code>insertParagraph</code></dt> - <dd><p>Insère un <a href="/fr/docs/Web/HTML/Element/p">paragraphe</a> autour de la sélection pour la ligne courante. (Internet Explorer insère un paragraphe au point d'insertion et supprime la sélection.)</p></dd> - <dt><code>insertText</code></dt> - <dd><p>Insère le texte indiqué au point d'insertion (quitte à supprimer l'éventuelle sélection courante).</p></dd> - <dt><code>italic</code></dt> - <dd><p>Active ou désactive la mise en italique pour la sélection ou à partir du point d'insertion. (Internet Explorer utilisera l'élément {{HTMLElement("em")}} plutôt que {{HTMLElement("i")}}.)</p></dd> - <dt><code>justifyCenter</code></dt> - <dd><p>Centre la sélection ou le point d'insertion.</p></dd> - <dt><code>justifyFull</code></dt> - <dd><p>Justifie la sélection ou le point d'insertion.</p></dd> - <dt><code>justifyLeft</code></dt> - <dd><p>Justifie à gauche la sélection ou le point d'insertion.</p></dd> - <dt><code>justifyRight</code></dt> - <dd><p>Justifie à droite la sélection ou le point d'insertion.</p></dd> - <dt><code>outdent</code></dt> - <dd><p>Effectue un retrait d'indentation pour la ligne courante.</p></dd> - <dt><code>paste</code></dt> - <dd><p>Colle le contenu du presse-papier au point d'insertion (et remplace éventuellement la sélection actuelle). Fonctionnalité désactivée pour le contenu web.</p></dd> - <dt><code>redo</code></dt> - <dd><p>Rejoue l'action annulée par la précédente commande <code>undo</code>.</p></dd> - <dt><code>removeFormat</code></dt> - <dd><p>Supprime toute mise en forme pour la sélection courante.</p></dd> - <dt><code>selectAll</code></dt> - <dd><p>Sélectionne l'ensemble du contenu de la région éditable.</p></dd> - <dt><code>strikeThrough</code></dt> - <dd><p>Active ou désactive la rayure de la sélection ou à partir d'un point d'insertion.</p></dd> - <dt><code>subscript</code></dt> - <dd><p>Active ou désactive <a href="/fr/docs/Web/HTML/Element/sub">la mise en indice</a> pour la sélection ou au point d'insertion</p></dd> - <dt><code>superscript</code></dt> - <dd><p>Active ou désactive <a href="/fr/docs/Web/HTML/Element/sup">la mise en exposant</a> pour la sélection ou au point d'insertion</p></dd> - <dt><code>underline</code></dt> - <dd><p>Active ou désactive <a href="/fr/docs/Web/HTML/Element/u">le soulignement</a> pour la sélection ou au point d'insertion.</p></dd> - <dt><code>undo</code></dt> - <dd><p>Annule la dernière commande exécutée.</p></dd> - <dt><code>unlink</code></dt> - <dd><p>Retire l'<a href="/fr/docs/Web/HTML/Element/a">ancre</a> de l'hyperlien sélectionné.</p></dd> - <dt><code>useCSS</code> {{Deprecated_inline}}</dt> - <dd><p>Active/désactive l'utilisation de balises HTML ou de CSS pour le balisage généré. La valeur de l'argument doit être un booléen. Note : cet argument possède une logique inversée (<code>false</code> permet d'utiliser CSS et <code>true</code> permet d'utiliser HTML). Cette valeur n'est pas prise en charge par Internet Explorer et a été dépréciée en faveur de <code>styleWithCSS</code>.</p></dd> <dt><code>styleWithCSS</code></dt> - <dd><p>Remplace la commande <code>useCSS</code>. <code>true</code> modifie/génère des attributs <code>style</code> dans le balisage tandis que <code>false</code> génère des éléments HTML de présentation.</p></dd> -</dl> - -<h2 id="Example">Exemple</h2> - -<p>Un exemple d'utilisation est disponible - <a href="https://codepen.io/chrisdavidmills/full/gzYjag/">sur CodePen</a>.</p> - -<h2 id="Specifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td><a href="https://w3c.github.io/editing/docs/execCommand/">execCommand</a></td> - <td>Brouillon non officiel</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.execCommand")}}</p> - -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li>{{domxref("HTMLElement.contentEditable")}}</li> - <li>{{domxref("document.designMode")}}</li> - <li><a href="/fr/docs/Web/Guide/HTML/Editable_content/Rich-Text_Editing_in_Mozilla">L'édition HTML dans Firefox</a> - </li> - <li><a - href="https://github.com/guardian/scribe/blob/master/BROWSERINCONSISTENCIES.md">Documentation des incohérences - navigateur dans Scribe</a> qui indique les bugs liés à <code>document.execCommand</code>.</li> -</ul> +{{ApiRef("DOM")}}{{deprecated_header}} + +Lorsqu'un document HTML passe en [`designMode`](/fr/docs/Web/API/Document/designMode), l'objet `document` correspondant expose une méthode **`execCommand()`** permettant d'exécuter des commandes manipulant la région éditable courante tels que [les champs de formulaire](/fr/docs/Web/HTML/Element/input) ou les éléments [`contentEditable`](/fr/docs/Web/HTML/Global_attributes/contenteditable). + +La plupart des commandes affectent la [sélection](/fr/docs/Web/API/Selection) du document (mise en gras, italique, etc.), tandis que +d'autres insèrent de nouveaux éléments (un lien) ou modifient toute une ligne (indentation). Lorsqu'on +utilise `contentEditable`, `execCommand()` affecte l'élément éditable +courant. + +## Syntaxe + +```js +document.execCommand(aCommandName, aShowDefaultUI, aValueArgument) +``` + +### Valeur de retour + +Un booléen ({{jsxref('Boolean')}}) qui vaut `false` si la commande n'est pas +prise en charge ou si elle est désactivée. + +> **Note :** `document.execCommand()` ne renvoie +> `true` que s'il est appelé à partir d'une interaction utilisateur. On ne +> peut pas l'invoquer dans un script afin de vérifier la prise en charge navigateur avant +> d'appeler une commande. À partir de Firefox 82, les appels imbriqués à +> `document.execCommand()` renverront toujours `false`. + +### Paramètres + +- `aCommandName` + - : Une chaîne de caractères {{domxref("DOMString")}} indiquant le nom de la commande à + exécuter. Voir {{anch("Commands")}} pour une liste de commandes possibles. +- `aShowDefaultUI` + - : Un booléen ({{jsxref("Boolean")}}) indiquant si l'interface utilisateur par défaut + devrait être affichée. Ce n'est pas implémenté par Mozilla. +- `aValueArgument` + - : Pour les commandes utilisant un argument en entrée, il s'agit d'une chaîne {{domxref("DOMString")}} + qui fournit cette information. On pourra, par exemple, `insertImage` utilise + l'URL de l'image à insérer. On utilisera `null` si aucun argument n'est utilisé. + +### Commandes + +- `backColor` + - : Modifie la couleur d'arrière-plan du document. Avec le mode `styleWithCss` cela affecte la couleur d'arrière-plan du bloc englobant. Une chaîne de caractères décrivant une valeur {{cssxref("<color>")}} doit être passée en argument. On notera qu'Internet Explorer utilise ceci pour la couleur d'arrière-plan du texte. +- `bold` + - : Active ou désactive la mise en gras pour la sélection ou à partir du point d'insertion Internet Explorer utilise la balise {{HTMLElement("strong")}} plutôt que {{HTMLElement("b")}}. +- `ClearAuthenticationCache` + - : Supprime toutes les informations d'authentification _credentials_) du cache. +- `contentReadOnly` + - : Rend le contenu du document en lecture seule ou éditable en fonction du booléen passé en argument (n'est pas pris en charge par Internet Explorer) +- `copy` + - : Copie la sélection courante vers le presse-papier. Les conditions pour obtenir ce comportement peuvent varier d'un navigateur à l'autre. Veuillez voir le tableau de compatibilité ci-après. +- `createLink` + - : Crée un hyperlien à partir de la sélection (sous réserve qu'il y en ait une). Une chaîne de caractères formant un URI est nécessaire comme argument afin de fournir la valeur de l'attribut `href`. L'URI doit contenir au moins un caractère (qui peut être un blanc). (Internet Explorer créera un lien avec une valeur `null`.) +- `cut` + - : Coupe le contenu de la sélection courante et le copie dans le presse-papier. Les conditions pour obtenir ce comportement peuvent varier d'un navigateur à l'autre. Veuillez voir le tableau de compatibilité ci-après. +- `decreaseFontSize` + - : Ajoute une balise {{HTMLElement("small")}} autour de la sélection ou au point d'insertion. (Non pris en charge par Internet Explorer.) +- `defaultParagraphSeparator` + - : Modifie le séparateur de paragraphe utilisé lorsque de nouveaux paragraphes sont créés dans les zones de texte éditables. Voir [Différences dans la génération du balisage](/fr/docs/Web/Guide/HTML/Editable_content#differences_in_markup_generation) pour plus de détails. +- `delete` + - : Supprimer la sélection courante. +- `enableAbsolutePositionEditor` + - : Active ou désactive la poignée qui permet de déplacer les éléments positionnés de façon absolue. Celle-ci est désactivée par défaut depuis Firefox 64 ({{bug(1490641)}}). +- `enableInlineTableEditing` + - : Active ou désactive les contrôles pour l'insertion ou la suppression des lignes ou colonnes de tableau. Les contrôles sont désactivés par défaut depuis Firefox 64 ({{bug(1490641)}}). +- `enableObjectResizing` + - : Active ou désactive les contrôles permettant de redimensionner les images, tableaux ou les éléments positionnés de façon absolue. Les poignées sont désactivées par défaut depuis Firefox 64 ({{bug(1490641)}}). +- `fontName` + - : Modifie le nom de la police pour la sélection ou à partir du point d'insertion. La valeur fournie en argument doit être un nom de police (ex. `"Arial"`). +- `fontSize` + - : Modifie la taille de la police pour la sélection ou à partir du point d'insertion. La valeur fournie en argument doit être un entier compris entre 1 et 7. +- `foreColor` + - : Modifie la couleur de la police pour la sélection ou à partir du point d'insertion. La valeur passée en argument doit être une chaîne de caractères décrivant une couleur exprimée en notation hexadécimale. +- `formatBlock` + - : Ajoute un élément HTML de bloc autour de la ligne contenant la sélection courante et remplace l'éventuel élément de bloc englobant s'il en existe un (pour Firefox, {{HTMLElement("blockquote")}} fera exception et englobera n'importe quel bloc). L'argument passé doit être un nom de balise. Tous les éléments de bloc peuvent en théorie être utilisés. (Internet Explorer et Edge ne prennent en charge que les balises ` H1``H6 `, `ADDRESS`, et `PRE` qui doivent être passées entre chevrons : `"<H1>"`.) +- `forwardDelete` + - : Supprime un caractère à la position du curseur. Le comportement obtenu est le même que lorsqu'on appuie sur la touche <kbd>Suppr</kbd> d'un clavier Windows. +- `heading` + - : Ajoute un élément de titre autour de la sélection ou au niveau du point d'insertion. L'argument doit être le nom d'une balise de titre (`"H1"` à `"H6"`). (Non pris en charge par Internet Explorer et Safari.) +- `hiliteColor` + - : Modifie la couleur d'arrière-plan pour la sélection ou à partir du point d'insertion. La valeur passée en argument doit être une chaîne de caractères définissant une couleur et `useCSS` doit valoir `true`. (Non pris en charge par Internet Explorer.) +- `increaseFontSize` + - : Ajoute une balise {{HTMLElement("big")}} autour de la sélection ou à partir du point d'insertion. (Non pris en charge par Internet Explorer). +- `indent` + - : Augmente l'indentation de la ligne contenant la sélection ou le point d'insertion. Pour Firefox, si la sélection s'étend sur plusieurs lignes ayant différents niveaux d'indentation, seules les lignes les moins indentées seront décalées. +- `insertBrOnReturn` + - : Contrôle si la touche <kbd>Entrée</kbd> insère un élément {{HTMLElement("br")}} ou si le bloc courant est scindé en deux. (Non pris en charge par Internet Explorer.) +- `insertHorizontalRule` + - : Insère un élément {{HTMLElement("hr")}} au point d'insertion ou remplace la sélection courante par cet élément. +- `insertHTML` + - : Insère un élément au point d'insertion en supprimant la sélection. Une chaîne de caractères HTML valide doit être fournie en argument. (Non pris en charge par Internet Explorer.) +- `insertImage` + - : Insère une image au point d'insertion en supprimant la sélection. L'argument doit être une chaîne de caractères indiquant l'URL à utiliser pour l'attribut `src` de l'image. Les prérequis de cette valeur sont les mêmes que pour `createLink`. +- `insertOrderedList` + - : Crée une [liste numérotée ordonnée](/fr/docs/Web/HTML/Element/ol) pour la sélection ou à partir du point d'insertion. +- `insertUnorderedList` + - : Crée une [liste non-ordonnée](/fr/docs/Web/HTML/Element/ul) pour la sélection ou à partir du point d'insertion. +- `insertParagraph` + - : Insère un [paragraphe](/fr/docs/Web/HTML/Element/p) autour de la sélection pour la ligne courante. (Internet Explorer insère un paragraphe au point d'insertion et supprime la sélection.) +- `insertText` + - : Insère le texte indiqué au point d'insertion (quitte à supprimer l'éventuelle sélection courante). +- `italic` + - : Active ou désactive la mise en italique pour la sélection ou à partir du point d'insertion. (Internet Explorer utilisera l'élément {{HTMLElement("em")}} plutôt que {{HTMLElement("i")}}.) +- `justifyCenter` + - : Centre la sélection ou le point d'insertion. +- `justifyFull` + - : Justifie la sélection ou le point d'insertion. +- `justifyLeft` + - : Justifie à gauche la sélection ou le point d'insertion. +- `justifyRight` + - : Justifie à droite la sélection ou le point d'insertion. +- `outdent` + - : Effectue un retrait d'indentation pour la ligne courante. +- `paste` + - : Colle le contenu du presse-papier au point d'insertion (et remplace éventuellement la sélection actuelle). Fonctionnalité désactivée pour le contenu web. +- `redo` + - : Rejoue l'action annulée par la précédente commande `undo`. +- `removeFormat` + - : Supprime toute mise en forme pour la sélection courante. +- `selectAll` + - : Sélectionne l'ensemble du contenu de la région éditable. +- `strikeThrough` + - : Active ou désactive la rayure de la sélection ou à partir d'un point d'insertion. +- `subscript` + - : Active ou désactive [la mise en indice](/fr/docs/Web/HTML/Element/sub) pour la sélection ou au point d'insertion +- `superscript` + - : Active ou désactive [la mise en exposant](/fr/docs/Web/HTML/Element/sup) pour la sélection ou au point d'insertion +- `underline` + - : Active ou désactive [le soulignement](/fr/docs/Web/HTML/Element/u) pour la sélection ou au point d'insertion. +- `undo` + - : Annule la dernière commande exécutée. +- `unlink` + - : Retire l'[ancre](/fr/docs/Web/HTML/Element/a) de l'hyperlien sélectionné. +- `useCSS` {{Deprecated_inline}} + - : Active/désactive l'utilisation de balises HTML ou de CSS pour le balisage généré. La valeur de l'argument doit être un booléen. Note : cet argument possède une logique inversée (`false` permet d'utiliser CSS et `true` permet d'utiliser HTML). Cette valeur n'est pas prise en charge par Internet Explorer et a été dépréciée en faveur de `styleWithCSS`. +- `styleWithCSS` + - : Remplace la commande `useCSS`. `true` modifie/génère des attributs `style` dans le balisage tandis que `false` génère des éléments HTML de présentation. + +## Exemple + +Un exemple d'utilisation est disponible +[sur CodePen](https://codepen.io/chrisdavidmills/full/gzYjag/). + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------- | ---------------------- | ------------ | +| [execCommand](https://w3c.github.io/editing/docs/execCommand/) | Brouillon non officiel | | + +## Compatibilité des navigateurs + +{{Compat("api.Document.execCommand")}} + +## Voir aussi + +- {{domxref("HTMLElement.contentEditable")}} +- {{domxref("document.designMode")}} +- [L'édition HTML dans Firefox](/fr/docs/Web/Guide/HTML/Editable_content/Rich-Text_Editing_in_Mozilla) +- [Documentation des incohérences + navigateur dans Scribe](https://github.com/guardian/scribe/blob/master/BROWSERINCONSISTENCIES.md) qui indique les bugs liés à `document.execCommand`. diff --git a/files/fr/web/api/document/exitfullscreen/index.md b/files/fr/web/api/document/exitfullscreen/index.md index 5bff1f4f8c..6ba66c8671 100644 --- a/files/fr/web/api/document/exitfullscreen/index.md +++ b/files/fr/web/api/document/exitfullscreen/index.md @@ -9,59 +9,45 @@ tags: - Plein écran translation_of: Web/API/Document/exitFullscreen --- -<div>{{ApiRef("Fullscreen API")}}</div> +{{ApiRef("Fullscreen API")}} -<p>La méthode <code><strong>Document.exitFullscreen()</strong></code> extrait le document du mode plein écran ; elle est utilisée pour inverser les effets d'un appel au mode plein écran réalisé avec la méthode {{domxref("Element.requestFullscreen()")}}.</p> +La méthode **`Document.exitFullscreen()`** extrait le document du mode plein écran ; elle est utilisée pour inverser les effets d'un appel au mode plein écran réalisé avec la méthode {{domxref("Element.requestFullscreen()")}}. -<div class="note"> - <p><strong>Note :</strong> Si un autre élément était précédemment en mode plein écran lorsque l'élément en cours a été placé en mode plein écran, cet élément précédent reprend le mode plein écran. Une "pile" d'éléments en plein écran est maintenue par le navigateur à cette fin.</p> -</div> +> **Note :** Si un autre élément était précédemment en mode plein écran lorsque l'élément en cours a été placé en mode plein écran, cet élément précédent reprend le mode plein écran. Une "pile" d'éléments en plein écran est maintenue par le navigateur à cette fin. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">document.exitFullscreen(); -</pre> + document.exitFullscreen(); -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">// Click bascule en mode plein écran +```js +// Click bascule en mode plein écran document.onclick = function (event) { if (document.fullscreenElement) { document.exitFullscreen() } else { document.documentElement.requestFullscreen() } -};</pre> +}; +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("Fullscreen", "#dom-document-exitfullscreen", "Document.exitFullscreen()")}}</td> - <td>{{Spec2("Fullscreen")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("Fullscreen", "#dom-document-exitfullscreen", "Document.exitFullscreen()")}} | {{Spec2("Fullscreen")}} | Définition initiale | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.exitFullscreen")}}</p> +{{Compat("api.Document.exitFullscreen")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/Guide/DOM/Using_full_screen_mode">Utiliser le mode plein écran</a></li> - <li>{{ domxref("Element.requestFullscreen()") }}</li> - <li>{{ domxref("Document.exitFullscreen()") }}</li> - <li>{{ domxref("Document.fullscreen") }}</li> - <li>{{ domxref("Document.fullscreenElement") }}</li> - <li>{{ cssxref(":fullscreen") }}</li> - <li>{{ HTMLAttrXRef("allowfullscreen", "iframe") }}</li> -</ul> +- [Utiliser le mode plein écran](/fr/docs/Web/Guide/DOM/Using_full_screen_mode) +- {{ domxref("Element.requestFullscreen()") }} +- {{ domxref("Document.exitFullscreen()") }} +- {{ domxref("Document.fullscreen") }} +- {{ domxref("Document.fullscreenElement") }} +- {{ cssxref(":fullscreen") }} +- {{ HTMLAttrXRef("allowfullscreen", "iframe") }} diff --git a/files/fr/web/api/document/exitpointerlock/index.md b/files/fr/web/api/document/exitpointerlock/index.md index 72a24c5f2f..d7290e0749 100644 --- a/files/fr/web/api/document/exitpointerlock/index.md +++ b/files/fr/web/api/document/exitpointerlock/index.md @@ -9,42 +9,28 @@ tags: - Reference translation_of: Web/API/Document/exitPointerLock --- -<div>{{APIRef("DOM")}}{{SeeCompatTable}}</div> +{{APIRef("DOM")}}{{SeeCompatTable}} -<p>La méthode <strong><code>exitPointerLock()</code></strong> permet de relâcher un pointeur de façon asynchrone lorsque le pointeur était auparavant mobilisé par la méthode {{domxref("Element.requestPointerLock()")}}.</p> +La méthode **`exitPointerLock()`** permet de relâcher un pointeur de façon asynchrone lorsque le pointeur était auparavant mobilisé par la méthode {{domxref("Element.requestPointerLock()")}}. -<p>Pour connaître le succès ou l'échec de cette requête, il faut surveiller les évènements {{event("pointerlockchange")}} et {{event("pointerlockerror")}}.</p> +Pour connaître le succès ou l'échec de cette requête, il faut surveiller les évènements {{event("pointerlockchange")}} et {{event("pointerlockerror")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">document.exitPointerLock(); -</pre> + document.exitPointerLock(); -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('Pointer Lock','l#extensions-to-the-document-interface','Document')}}</td> - <td>{{Spec2('Pointer Lock')}}</td> - <td>Extension de l'interface <code>Document</code></td> - </tr> - </tbody> -</table> +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------------------------------- | +| {{SpecName('Pointer Lock','l#extensions-to-the-document-interface','Document')}} | {{Spec2('Pointer Lock')}} | Extension de l'interface `Document` | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.exitPointerLock")}}</p> +{{Compat("api.Document.exitPointerLock")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Document.pointerLockElement")}}</li> - <li>{{domxref("Element.requestPointerLock()")}}</li> - <li><a href="/fr/docs/WebAPI/Pointer_Lock">L'API <em>Pointer Lock</em></a></li> -</ul> +- {{domxref("Document.pointerLockElement")}} +- {{domxref("Element.requestPointerLock()")}} +- [L'API _Pointer Lock_](/fr/docs/WebAPI/Pointer_Lock) diff --git a/files/fr/web/api/document/featurepolicy/index.md b/files/fr/web/api/document/featurepolicy/index.md index 4c2dbbe9ba..7c926f4c7e 100644 --- a/files/fr/web/api/document/featurepolicy/index.md +++ b/files/fr/web/api/document/featurepolicy/index.md @@ -9,39 +9,24 @@ tags: - Reference translation_of: Web/API/Document/featurePolicy --- -<p>{{APIRef("Feature Policy")}}</p> +{{APIRef("Feature Policy")}} -<p>La propriété en lecture seule <strong><code>featurePolicy</code></strong> de l'interface {{domxref("Document")}} retourne l'interface {{domxref("FeaturePolicy")}}, qui fournit une API permettant de consulter facilement les règles de fonctionnalités appliquées sur un document spécifique.</p> +La propriété en lecture seule **`featurePolicy`** de l'interface {{domxref("Document")}} retourne l'interface {{domxref("FeaturePolicy")}}, qui fournit une API permettant de consulter facilement les règles de fonctionnalités appliquées sur un document spécifique. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="notranslate">var <var>policy</var> = <var>iframeElement</var>.featurePolicy</pre> + var policy = iframeElement.featurePolicy -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>Un objet {{domxref("FeaturePolicy")}} pouvant être utilisé pour consulter les paramètres de Feature Policy appliqués au document.</p> +Un objet {{domxref("FeaturePolicy")}} pouvant être utilisé pour consulter les paramètres de Feature Policy appliqués au document. -<h2 id="Spécification">Spécification</h2> +## Spécification -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("Feature Policy")}}</td> - <td>{{Spec2("Feature Policy")}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------- | ------------------------------------ | -------------------- | +| {{SpecName("Feature Policy")}} | {{Spec2("Feature Policy")}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs - - -<p>{{Compat("api.Document.featurePolicy")}}</p> +{{Compat("api.Document.featurePolicy")}} diff --git a/files/fr/web/api/document/forms/index.md b/files/fr/web/api/document/forms/index.md index 69a310feb2..9331ece590 100644 --- a/files/fr/web/api/document/forms/index.md +++ b/files/fr/web/api/document/forms/index.md @@ -9,108 +9,91 @@ tags: - Propriétés translation_of: Web/API/Document/forms --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>La propriété <code>forms</code> de {{domxref("Document")}} retourne une collection ({{domxref("HTMLCollection")}}) des éléments {{HTMLElement("form")}} présents dans le document actuel.</p> +La propriété `forms` de {{domxref("Document")}} retourne une collection ({{domxref("HTMLCollection")}}) des éléments {{HTMLElement("form")}} présents dans le document actuel. -<div class="note"> -<p><strong>Note :</strong> De même, vous pouvez accéder à une liste des éléments d'entrée utilisateur d'un formulaire à l'aide de la propriété {{domxref ("HTMLFormElement.elements")}}.</p> -</div> +> **Note :** De même, vous pouvez accéder à une liste des éléments d'entrée utilisateur d'un formulaire à l'aide de la propriété {{domxref ("HTMLFormElement.elements")}}. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>collection</var> = document.forms;</pre> + collection = document.forms; -<h3 id="Example">Valeur</h3> +### Valeur -<p>Un objet {{domxref("HTMLCollection")}} listant tous les formulaires du document. Chaque élément de la collection est un {{domxref("HTMLFormElement")}} représentant un seul élément <code><form></code>.</p> +Un objet {{domxref("HTMLCollection")}} listant tous les formulaires du document. Chaque élément de la collection est un {{domxref("HTMLFormElement")}} représentant un seul élément `<form>`. -<h2 id="Example">Exemples</h2> +## Exemples -<h3 id="Example">Récupérer les informations d'un formulaire</h3> +### Récupérer les informations d'un formulaire -<pre class="brush:html"><!DOCTYPE html> -<html lang="en"> +```html +<!DOCTYPE html> +<html lang="en"> -<head> -<title>document.forms example</title> -</head> +<head> +<title>document.forms example</title> +</head> -<body> +<body> -<form id="robby"> - <input type="button" onclick="alert(document.forms[0].id);" value="robby's form" /> -</form> +<form id="robby"> + <input type="button" onclick="alert(document.forms[0].id);" value="robby's form" /> +</form> -<form id="dave"> - <input type="button" onclick="alert(document.forms[1].id);" value="dave's form" /> -</form> +<form id="dave"> + <input type="button" onclick="alert(document.forms[1].id);" value="dave's form" /> +</form> -<form id="paul"> - <input type="button" onclick="alert(document.forms[2].id);" value="paul's form" /> -</form> +<form id="paul"> + <input type="button" onclick="alert(document.forms[2].id);" value="paul's form" /> +</form> -</body> -</html> -</pre> +</body> +</html> +``` -<h3 id="Accéder_à_un_élément_contenu_dans_un_formulaire">Accéder à un élément contenu dans un formulaire</h3> +### Accéder à un élément contenu dans un formulaire -<pre class="brush: js">var selectForm = document.forms[index]; +```js +var selectForm = document.forms[index]; var selectFormElement = document.forms[index].elements[index]; -</pre> +``` -<h3 id="Specification">Accéder aux formulaires nommés</h3> +### Accéder aux formulaires nommés -<pre class="brush: html"><!DOCTYPE html> -<html lang="en"> -<head> - <title>document.forms example</title> -</head> +```html +<!DOCTYPE html> +<html lang="en"> +<head> + <title>document.forms example</title> +</head> -<body> +<body> -<form name="login"> - <input name="email" type="email"> - <input name="password" type="password"> - <button type="submit">Log in</button> -</form> +<form name="login"> + <input name="email" type="email"> + <input name="password" type="password"> + <button type="submit">Log in</button> +</form> -<script> +<script> var loginForm = document.forms.login; // Ou document.forms['login'] loginForm.elements.email.placeholder = 'test@example.com'; loginForm.elements.password.placeholder = 'password'; -</script> -</body> -</html></pre> - -<h2 id="Specification">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', '#dom-document-forms', 'Document.forms')}}</td> - <td>{{ Spec2('HTML WHATWG') }}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('DOM2 HTML', 'html.html#ID-1689064', 'Document.forms')}}</td> - <td>{{ Spec2('DOM2 Events') }}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="See_Also">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/Guide/HTML/Formulaires">Formulaires HTML</a></li> - <li>{{HTMLElement("form")}} et l'interface {{domxref("HTMLFormElement")}}</li> -</ul> +</script> +</body> +</html> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------- | +| {{SpecName('HTML WHATWG', '#dom-document-forms', 'Document.forms')}} | {{ Spec2('HTML WHATWG') }} | | +| {{SpecName('DOM2 HTML', 'html.html#ID-1689064', 'Document.forms')}} | {{ Spec2('DOM2 Events') }} | Définition initiale. | + +## Voir aussi + +- [Formulaires HTML](/fr/docs/Web/Guide/HTML/Formulaires) +- {{HTMLElement("form")}} et l'interface {{domxref("HTMLFormElement")}} diff --git a/files/fr/web/api/document/fullscreenchange_event/index.md b/files/fr/web/api/document/fullscreenchange_event/index.md index a2606c65b2..adcd354eb9 100644 --- a/files/fr/web/api/document/fullscreenchange_event/index.md +++ b/files/fr/web/api/document/fullscreenchange_event/index.md @@ -3,62 +3,36 @@ title: fullscreenchange slug: Web/API/Document/fullscreenchange_event translation_of: Web/API/Document/fullscreenchange_event --- -<p>L'événement <strong><code>onfullscreenchange</code></strong> est déclenché lorsque le navigateur alterne entre le mode fenêtré et plein écran.</p> - -<h2 id="Informations_générales">Informations générales</h2> - -<dl> - <dt style="float: left; text-align: right; width: 120px;">Spécification</dt> - <dd style="margin: 0 0 0 120px;"><a href="https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html#api">Fullscreen</a></dd> - <dt style="float: left; text-align: right; width: 120px;">Interface</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("Event")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Propagation</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Annulable</dt> - <dd style="margin: 0 0 0 120px;">Non</dd> - <dt style="float: left; text-align: right; width: 120px;">Cible</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("Document")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Action par défaut</dt> - <dd style="margin: 0 0 0 120px;">Aucune</dd> -</dl> - -<h2 id="Propriétés">Propriétés</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td>{{domxref("EventTarget")}}</td> - <td>L'élément recevant l'événement.</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td>{{domxref("DOMString")}}</td> - <td>Le type de l'événement.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td>{{jsxref("Boolean")}}</td> - <td>Indique si l'événement bubble habituellement ou non.</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td>{{jsxref("Boolean")}}</td> - <td>Indique si l'événement est annulable ou non.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemple">Exemple</h2> - -<pre class="brush:js;">// Noter que l'API est toujours vendor-prefixed dans les navigateurs l'implémentant +L'événement **`onfullscreenchange`** est déclenché lorsque le navigateur alterne entre le mode fenêtré et plein écran. + +## Informations générales + +- Spécification + - : [Fullscreen](https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html#api) +- Interface + - : {{domxref("Event")}} +- Propagation + - : Oui +- Annulable + - : Non +- Cible + - : {{domxref("Document")}} +- Action par défaut + - : Aucune + +## Propriétés + +| Property | Type | Description | +| ------------------------------------- | ------------------------------------ | ---------------------------------------------------- | +| `target` {{readonlyInline}} | {{domxref("EventTarget")}} | L'élément recevant l'événement. | +| `type` {{readonlyInline}} | {{domxref("DOMString")}} | Le type de l'événement. | +| `bubbles` {{readonlyInline}} | {{jsxref("Boolean")}} | Indique si l'événement bubble habituellement ou non. | +| `cancelable` {{readonlyInline}} | {{jsxref("Boolean")}} | Indique si l'événement est annulable ou non. | + +## Exemple + +```js +// Noter que l'API est toujours vendor-prefixed dans les navigateurs l'implémentant document.addEventListener("fullscreenchange", function( event ) { // L'objet event ne porte pas l'information à propos du mode plein écran @@ -70,16 +44,13 @@ document.addEventListener("fullscreenchange", function( event ) { document.fullscreenElement; } -});</pre> +}); +``` -<h2 id="Evénements_liés">Evénements liés</h2> +## Evénements liés -<ul> - <li><a href="/fr/docs/Mozilla_event_reference/fullscreenerror"><code>fullscreenerror</code></a></li> -</ul> +- [`fullscreenerror`](/fr/docs/Mozilla_event_reference/fullscreenerror) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/DOM/Using_full-screen_mode">Utilisation du mode plein écran</a></li> -</ul> +- [Utilisation du mode plein écran](/fr/docs/DOM/Using_full-screen_mode) diff --git a/files/fr/web/api/document/fullscreenerror_event/index.md b/files/fr/web/api/document/fullscreenerror_event/index.md index dafb34cf85..93500c4c70 100644 --- a/files/fr/web/api/document/fullscreenerror_event/index.md +++ b/files/fr/web/api/document/fullscreenerror_event/index.md @@ -3,67 +3,36 @@ title: fullscreenerror slug: Web/API/Document/fullscreenerror_event translation_of: Web/API/Document/fullscreenerror_event --- -<p>L'événement <strong><code>fullscreenerror</code></strong><code> est déclenché lorsque le navigateur ne peut pas entrer en mode plein écran.</code></p> +L'événement **`fullscreenerror`**` est déclenché lorsque le navigateur ne peut pas entrer en mode plein écran.` -<h2 id="Informations_générales">Informations générales</h2> +## Informations générales -<dl> - <dt style="float: left; text-align: right; width: 120px;">Spécification</dt> - <dd style="margin: 0 0 0 120px;"><a href="https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html#api">Fullscreen</a></dd> - <dt style="float: left; text-align: right; width: 120px;">Interface</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("Event")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Propagation</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Annulable</dt> - <dd style="margin: 0 0 0 120px;">Non</dd> - <dt style="float: left; text-align: right; width: 120px;">Cible</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("Document")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Action par défaut</dt> - <dd style="margin: 0 0 0 120px;">Aucune</dd> -</dl> +- Spécification + - : [Fullscreen](https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html#api) +- Interface + - : {{domxref("Event")}} +- Propagation + - : Oui +- Annulable + - : Non +- Cible + - : {{domxref("Document")}} +- Action par défaut + - : Aucune -<h2 id="Propriétés">Propriétés</h2> +## Propriétés -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td>{{domxref("EventTarget")}}</td> - <td>The event target (the topmost target in the DOM tree).</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td>{{domxref("DOMString")}}</td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td>{{jsxref("Boolean")}}</td> - <td>Whether the event normally bubbles or not.</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td>{{jsxref("Boolean")}}</td> - <td>Whether the event is cancellable or not.</td> - </tr> - </tbody> -</table> +| Property | Type | Description | +| ------------------------------------- | ------------------------------------ | ------------------------------------------------------ | +| `target` {{readonlyInline}} | {{domxref("EventTarget")}} | The event target (the topmost target in the DOM tree). | +| `type` {{readonlyInline}} | {{domxref("DOMString")}} | The type of event. | +| `bubbles` {{readonlyInline}} | {{jsxref("Boolean")}} | Whether the event normally bubbles or not. | +| `cancelable` {{readonlyInline}} | {{jsxref("Boolean")}} | Whether the event is cancellable or not. | -<h2 id="Evénements_liés">Evénements liés</h2> +## Evénements liés -<ul> - <li><a href="/fr/docs/Mozilla_event_reference/fullscreenchange"><code>fullscreenchange</code></a></li> -</ul> +- [`fullscreenchange`](/fr/docs/Mozilla_event_reference/fullscreenchange) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/DOM/Using_full-screen_mode">Utilisation du mode plein écran</a></li> -</ul> +- [Utilisation du mode plein écran](/fr/docs/DOM/Using_full-screen_mode) diff --git a/files/fr/web/api/document/getboxobjectfor/index.md b/files/fr/web/api/document/getboxobjectfor/index.md index 5160c98e2a..716afb6997 100644 --- a/files/fr/web/api/document/getboxobjectfor/index.md +++ b/files/fr/web/api/document/getboxobjectfor/index.md @@ -9,27 +9,23 @@ tags: - Objets translation_of: Web/API/Document/getBoxObjectFor --- -<p>{{ ApiRef("DOM") }} {{obsolete_header}}</p> +{{ ApiRef("DOM") }} {{obsolete_header}} -<p>Renvoie un <code>boxObject</code> (x, y, largeur, hauteur) pour un élément spécifié.</p> +Renvoie un `boxObject` (x, y, largeur, hauteur) pour un élément spécifié. -<div class="note"> - <p><strong>Note :</strong> Cette méthode est obsolète. Vous devez utiliser la méthode {{domxref("element.getBoundingClientRect()")}} à la place.</p> -</div> +> **Note :** Cette méthode est obsolète. Vous devez utiliser la méthode {{domxref("element.getBoundingClientRect()")}} à la place. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>boxObject</var> = <var>document</var>.getBoxObjectFor(<var>element</var>); -</pre> + boxObject = document.getBoxObjectFor(element); -<ul> - <li><code>boxObject</code> est un {{interface("nsIBoxObject")}}.</li> - <li><code>element</code> est un {{domxref("element","DOMElement")}}</li> -</ul> +- `boxObject` est un {{interface("nsIBoxObject")}}. +- `element` est un {{domxref("element","DOMElement")}} -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:js">var myDiv = document.getElementById("myDiv"), +```js +var myDiv = document.getElementById("myDiv"), boxObj = document.getBoxObjectFor (myDiv); alert ( @@ -37,8 +33,9 @@ alert ( ", y:" + boxObj.y + ", Width:" + boxObj.width + ", Height:" + boxObj.height -);</pre> +); +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>Spécifié dans <a href="http://mxr.mozilla.org/mozilla-central/source/dom/interfaces/xul/nsIDOMXULDocument.idl">nsIXULDocument.idl</a></p> +Spécifié dans [nsIXULDocument.idl](http://mxr.mozilla.org/mozilla-central/source/dom/interfaces/xul/nsIDOMXULDocument.idl) diff --git a/files/fr/web/api/document/getelementbyid/index.md b/files/fr/web/api/document/getelementbyid/index.md index eacf9ef0a2..cc1a21f505 100644 --- a/files/fr/web/api/document/getelementbyid/index.md +++ b/files/fr/web/api/document/getelementbyid/index.md @@ -10,136 +10,118 @@ tags: - Méthodes translation_of: Web/API/Document/getElementById --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>La méthode <code><strong>getElementById()</strong></code> de {{domxref("Document")}} renvoie un objet {{domxref("Element")}} représentant l'élément dont la propriété {{domxref("Element.id", "id")}} correspond à la chaîne de caractères spécifiée. Étant donné que les ID d'élément doivent être uniques, s'ils sont spécifiés, ils constituent un moyen utile d'accéder rapidement à un élément spécifique.</p> +La méthode **`getElementById()`** de {{domxref("Document")}} renvoie un objet {{domxref("Element")}} représentant l'élément dont la propriété {{domxref("Element.id", "id")}} correspond à la chaîne de caractères spécifiée. Étant donné que les ID d'élément doivent être uniques, s'ils sont spécifiés, ils constituent un moyen utile d'accéder rapidement à un élément spécifique. -<p>Si vous avez besoin d'accéder à un élément qui n'a pas d'ID, vous pouvez utiliser {{domxref("Document.querySelector","querySelector()")}} pour trouver l'élément en utilisant un {{Glossary("CSS selector","sélecteur")}}.</p> +Si vous avez besoin d'accéder à un élément qui n'a pas d'ID, vous pouvez utiliser {{domxref("Document.querySelector","querySelector()")}} pour trouver l'élément en utilisant un {{Glossary("CSS selector","sélecteur")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"><em>var element</em> = document.getElementById(<em>id</em>); -</pre> +```js +var element = document.getElementById(id); +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>id</code></dt> - <dd><p>L'ID (<em>identifiant)</em> de l'élément à localiser. Il est une chaîne de caractères sensible à la casse qui est unique ; un seul élément peut avoir un ID donné.</p></dd> -</dl> +- `id` + - : L'ID (_identifiant)_ de l'élément à localiser. Il est une chaîne de caractères sensible à la casse qui est unique ; un seul élément peut avoir un ID donné. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un objet {{domxref("Element")}} décrivant l'objet élément du DOM correspondant à l'ID spécifié ou <code>null</code> si aucun n'a été trouvé dans le document.</p> +Un objet {{domxref("Element")}} décrivant l'objet élément du DOM correspondant à l'ID spécifié ou `null` si aucun n'a été trouvé dans le document. -<h2 id="Exemple">Exemple</h2> +## Exemple -<h3 id="Contenu_HTML">Contenu HTML</h3> +### Contenu HTML -<pre class="brush: html"><html> -<head> - <title>getElementById example</title> -</head> -<body> - <p id="para">Some text here</p> - <button onclick="changeColor('blue');">blue</button> - <button onclick="changeColor('red');">red</button> -</body> -</html></pre> +```html +<html> +<head> + <title>getElementById example</title> +</head> +<body> + <p id="para">Some text here</p> + <button onclick="changeColor('blue');">blue</button> + <button onclick="changeColor('red');">red</button> +</body> +</html> +``` -<h3 id="Contenu_JavaScript">Contenu JavaScript</h3> +### Contenu JavaScript -<pre class="brush: js">function changeColor(newColor) { +```js +function changeColor(newColor) { var elem = document.getElementById('para'); elem.style.color = newColor; -}</pre> +} +``` -<h3 id="Notes">Résultat</h3> +### Résultat -<p>{{ EmbedLiveSample('Example1', 250, 100) }}</p> +{{ EmbedLiveSample('Example1', 250, 100) }} -<h2 id="Notes">Notes d'utilisation</h2> +## Notes d'utilisation -<p>L'écriture de la lettre capitale de « Id » dans le nom de cette méthode <em>doit</em> être respectée pour que le code fonctionne ; <code>getElementByID()</code> n'est pas valide et ne fonctionnera <em>pas</em>, même si elle semble naturelle.</p> +L'écriture de la lettre capitale de « Id » dans le nom de cette méthode _doit_ être respectée pour que le code fonctionne ; `getElementByID()` n'est pas valide et ne fonctionnera _pas_, même si elle semble naturelle. -<p>Contrairement à d'autres méthodes de recherche d'éléments, comme {{domxref("Document.querySelector()")}} et {{domxref("Document.querySelectorAll()")}}, <code>getElementById</code> est uniquement disponible comme méthode de l'objet global <code>document</code> et <em>n'est pas</em> disponible sur tous les objets du DOM. Parce que les valeurs d'ID doivent être uniques dans l'ensemble du document, il n'y pas besoin d'avoir une version "locale" de la fonction.</p> +Contrairement à d'autres méthodes de recherche d'éléments, comme {{domxref("Document.querySelector()")}} et {{domxref("Document.querySelectorAll()")}}, `getElementById` est uniquement disponible comme méthode de l'objet global `document` et _n'est pas_ disponible sur tous les objets du DOM. Parce que les valeurs d'ID doivent être uniques dans l'ensemble du document, il n'y pas besoin d'avoir une version "locale" de la fonction. -<h2 id="Exemple_2">Exemple</h2> +## Exemple -<pre class="brush: html"><!doctype html> -<html> -<head> - <meta charset="UTF-8"> - <title>Document</title> -</head> -<body> - <div id="parent-id"> - <p>hello word1</p> - <p id="test1">hello word2</p> - <p>hello word3</p> - <p>hello word4</p> - </div> - <script> +```html +<!doctype html> +<html> +<head> + <meta charset="UTF-8"> + <title>Document</title> +</head> +<body> + <div id="parent-id"> + <p>hello word1</p> + <p id="test1">hello word2</p> + <p>hello word3</p> + <p>hello word4</p> + </div> + <script> var parentDOM = document.getElementById('parent-id'); var test1=parentDOM.getElementById('test1'); - //erreur de lancement - //TypeError inattendu : parentDOM.getElementById n'est pas une fonction - </script> -</body> -</html></pre> + //erreur de lancement + //TypeError inattendu : parentDOM.getElementById n'est pas une fonction + </script> +</body> +</html> +``` -<p>S'il n'y a pas d'élément avec l'<code>id</code> fourni, cette fonction retourne <code>null</code>. A noter que le paramètre <code>id</code> est sensible à la casse, ainsi<code> document.getElementById("Main")</code> retournera <code>null</code> au lieu de l'élément <code><div id="main"></code> étant donné que "M" et "m" sont différents pour cette méthode.</p> +S'il n'y a pas d'élément avec l'`id` fourni, cette fonction retourne `null`. A noter que le paramètre `id` est sensible à la casse, ainsi` document.getElementById("Main")` retournera `null` au lieu de l'élément `<div id="main">` étant donné que "M" et "m" sont différents pour cette méthode. -<p><strong>Les éléments absents du document</strong> ne sont pas cherchés par <code>getElementById()</code>. Quand vous créez un élément et y assignez un ID, vous devez insérer l'élément dans l'arbre du document avec {{domxref("Node.insertBefore()")}} ou une méthode similaire avant de pouvoir y accéder avec <code>getElementById()</code> :</p> +**Les éléments absents du document** ne sont pas cherchés par `getElementById()`. Quand vous créez un élément et y assignez un ID, vous devez insérer l'élément dans l'arbre du document avec {{domxref("Node.insertBefore()")}} ou une méthode similaire avant de pouvoir y accéder avec `getElementById()` : -<pre class="brush: js">var element = document.createElement('div'); +```js +var element = document.createElement('div'); element.id = 'testqq'; -var el = document.getElementById('testqq'); // el vaudra null !</pre> - -<p><strong>Les documents non-HTML.</strong> Les implémentations du DOM doivent avoir une information qui précise quels attributs sont de type ID. Un attribut portant le nom « id » n'est pas de type ID tant qu'il n'a pas été explicitement défini ainsi (dans la DTD du document). L'attribut <code>id</code> est défini comme étant de type ID dans les langages courants comme <a href="/fr/XHTML">XHTML</a> ou <a href="/fr/XUL">XUL</a>. Les implémentations ne sachant pas déterminer si les attributs sont de type ID ou non sont supposées renvoyer <code>null</code>.</p> - -<h2 id="Sp.C3.A9cification">Spécification</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('DOM1','level-one-html.html#method-getElementById','getElementById')}}</td> - <td>{{Spec2('DOM1')}}</td> - <td>Définition initiale de l'interface</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Core','core.html#ID-getElBId','getElementById')}}</td> - <td>{{Spec2('DOM2 Core')}}</td> - <td>Remplace DOM 1</td> - </tr> - <tr> - <td>{{SpecName('DOM3 Core','core.html#ID-getElBId','getElementById')}}</td> - <td>{{Spec2('DOM3 Core')}}</td> - <td>Remplace DOM 2</td> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG','#interface-nonelementparentnode','getElementById')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Remplacera DOM 3</td> - </tr> - </tbody> -</table> - -<p>Traduction en français (non normative) : <a href="http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-getElBId">getElementById</a></p> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.getElementById")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("Document")}} référence pour d'autres méthodes et propriétés que vous pouvez utiliser pour obtenir la référence vers des éléments du document.</li> - <li>{{domxref("Document.querySelector()")}} pour utiliser des sélecteurs avec des requêtes comme <code>'div.myclass'</code></li> - <li><a href="/fr/xml/xml:id">xml:id</a> dispose d'une méthode utilitaire permettant à getElementById d'obtenir les valeur 'xml:id' dans les documents XML (comme ceux qui pourraient être renvoyés par des appels Ajax).</li> -</ul> +var el = document.getElementById('testqq'); // el vaudra null ! +``` + +**Les documents non-HTML.** Les implémentations du DOM doivent avoir une information qui précise quels attributs sont de type ID. Un attribut portant le nom « id » n'est pas de type ID tant qu'il n'a pas été explicitement défini ainsi (dans la DTD du document). L'attribut `id` est défini comme étant de type ID dans les langages courants comme [XHTML](/fr/XHTML) ou [XUL](/fr/XUL). Les implémentations ne sachant pas déterminer si les attributs sont de type ID ou non sont supposées renvoyer `null`. + +## Spécification + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------ | -------------------------------- | ---------------------------------- | +| {{SpecName('DOM1','level-one-html.html#method-getElementById','getElementById')}} | {{Spec2('DOM1')}} | Définition initiale de l'interface | +| {{SpecName('DOM2 Core','core.html#ID-getElBId','getElementById')}} | {{Spec2('DOM2 Core')}} | Remplace DOM 1 | +| {{SpecName('DOM3 Core','core.html#ID-getElBId','getElementById')}} | {{Spec2('DOM3 Core')}} | Remplace DOM 2 | +| {{SpecName('DOM WHATWG','#interface-nonelementparentnode','getElementById')}} | {{Spec2('DOM WHATWG')}} | Remplacera DOM 3 | + +Traduction en français (non normative) : [getElementById](http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-getElBId) + +## Compatibilité des navigateurs + +{{Compat("api.Document.getElementById")}} + +## Voir aussi + +- {{domxref("Document")}} référence pour d'autres méthodes et propriétés que vous pouvez utiliser pour obtenir la référence vers des éléments du document. +- {{domxref("Document.querySelector()")}} pour utiliser des sélecteurs avec des requêtes comme `'div.myclass'` +- [xml:id](/fr/xml/xml:id) dispose d'une méthode utilitaire permettant à getElementById d'obtenir les valeur 'xml:id' dans les documents XML (comme ceux qui pourraient être renvoyés par des appels Ajax). diff --git a/files/fr/web/api/document/getelementsbyclassname/index.md b/files/fr/web/api/document/getelementsbyclassname/index.md index 43ff0fb18a..02659c2a50 100644 --- a/files/fr/web/api/document/getelementsbyclassname/index.md +++ b/files/fr/web/api/document/getelementsbyclassname/index.md @@ -8,85 +8,79 @@ tags: - Reference translation_of: Web/API/Document/getElementsByClassName --- -<p>{{APIRef("DOM")}}</p> +{{APIRef("DOM")}} -<p>Renvoie un objet de type tableau de tous les éléments enfants qui ont tous les noms de classe donnés. Lorsqu'il est appelé sur l'objet document, le document complet est recherché, y compris le nœud racine. Vous pouvez également appeler {{domxref ("Element.getElementsByClassName", "getElementsByClassName ()")}} sur n'importe quel élément; il retournera uniquement les éléments qui sont les descendants de l'élément racine spécifié avec les noms de classes donnés.</p> +Renvoie un objet de type tableau de tous les éléments enfants qui ont tous les noms de classe donnés. Lorsqu'il est appelé sur l'objet document, le document complet est recherché, y compris le nœud racine. Vous pouvez également appeler {{domxref ("Element.getElementsByClassName", "getElementsByClassName ()")}} sur n'importe quel élément; il retournera uniquement les éléments qui sont les descendants de l'élément racine spécifié avec les noms de classes donnés. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>var elements</var> = document.getElementsByClassName(<em>names</em>); // or: -<var>var elements</var> = rootElement.getElementsByClassName(<em>names</em>);</pre> + var elements = document.getElementsByClassName(names); // or: + var elements = rootElement.getElementsByClassName(names); -<ul> - <li><var>elements</var> est une {{domxref ("HTMLCollection")}} des éléments trouvés.</li> - <li><var>names</var> est une chaîne représentant le nom de la classe des éléments à trouver.</li> - <li>getElementsByClassName peut être appelé sur n'importe quel élément, pas seulement sur le document. L'élément sur lequel il est appelé sera utilisé comme racine de la recherche.</li> -</ul> +- _elements_ est une {{domxref ("HTMLCollection")}} des éléments trouvés. +- _names_ est une chaîne représentant le nom de la classe des éléments à trouver. +- getElementsByClassName peut être appelé sur n'importe quel élément, pas seulement sur le document. L'élément sur lequel il est appelé sera utilisé comme racine de la recherche. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Trouve tous les éléments ayant la classe « test » :</p> +Trouve tous les éléments ayant la classe « test » : -<pre class="eval"> document.getElementsByClassName('test') -</pre> + document.getElementsByClassName('test') -<p>Trouve tous les éléments ayant les classes « rouge » et « test » :</p> +Trouve tous les éléments ayant les classes « rouge » et « test » : -<pre class="eval"> document.getElementsByClassName('rouge test') -</pre> + document.getElementsByClassName('rouge test') -<p>Trouve tous les éléments qui ont la classe « test » à l'intérieur d'un élément ayant l'ID « main » :</p> +Trouve tous les éléments qui ont la classe « test » à l'intérieur d'un élément ayant l'ID « main » : -<pre class="eval"> document.getElementById('main').getElementsByClassName('test') -</pre> + document.getElementById('main').getElementsByClassName('test') -<p>Nous pouvons également utiliser les méthodes de Array.prototype sur toute {{domxref ("HTMLCollection")}} en passant HTMLCollection comme valeur de la méthode. Ici, nous allons trouver tous les éléments div qui ont une classe de 'test':</p> +Nous pouvons également utiliser les méthodes de Array.prototype sur toute {{domxref ("HTMLCollection")}} en passant HTMLCollection comme valeur de la méthode. Ici, nous allons trouver tous les éléments div qui ont une classe de 'test': -<pre class="brush: js">var testElements = document.getElementsByClassName('test'); +```js +var testElements = document.getElementsByClassName('test'); var testDivs = Array.prototype.filter.call(testElements, function(testElement){ return testElement.nodeName === 'DIV'; -});</pre> - -<p>XXX writeme == Notes == Une méthode semblable existe pour <code>Element</code></p> - -<h2 id="Sp.C3.A9cification">Obtenir la classe des éléments test</h2> - -<p>C'est la méthode d'opération la plus couramment utilisée.</p> - -<pre class="brush: html"><!doctype html> -<html> -<head> - <meta charset="UTF-8"> - <title>Document</title> -</head> -<body> - <div id="parent-id"> - <p>hello word1</p> - <p class="test">hello word2</p> - <p >hello word3</p> - <p>hello word4</p> - </div> - <script> +}); +``` + +XXX writeme == Notes == Une méthode semblable existe pour \<code>Element\</code> + +## Obtenir la classe des éléments test + +C'est la méthode d'opération la plus couramment utilisée. + +```html +<!doctype html> +<html> +<head> + <meta charset="UTF-8"> + <title>Document</title> +</head> +<body> + <div id="parent-id"> + <p>hello word1</p> + <p class="test">hello word2</p> + <p >hello word3</p> + <p>hello word4</p> + </div> + <script> var parentDOM = document.getElementById("parent-id"); var test=parentDOM.getElementsByClassName("test");//test is not target element console.log(test);//HTMLCollection[1] var testTarget=parentDOM.getElementsByClassName("test")[0];//here , this element is target - console.log(testTarget);//<p class="test">hello word2</p> - </script> -</body> -</html></pre> + console.log(testTarget);//<p class="test">hello word2</p> + </script> +</body> +</html> +``` -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.Document.getElementsByClassName")}} -<p>{{Compat("api.Document.getElementsByClassName")}}</p> +## Spécification - - -<h2 id="Specification">Spécification</h2> - -<ul> - <li><a href="https://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-getelementsbyclassname">W3C: getElementsByClassName</a></li> -</ul> +- [W3C: getElementsByClassName](https://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-getelementsbyclassname) diff --git a/files/fr/web/api/document/getelementsbyname/index.md b/files/fr/web/api/document/getelementsbyname/index.md index d2087a0d22..dd734d067d 100644 --- a/files/fr/web/api/document/getelementsbyname/index.md +++ b/files/fr/web/api/document/getelementsbyname/index.md @@ -9,78 +9,56 @@ tags: - Méthodes translation_of: Web/API/Document/getElementsByName --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>Renvoie une liste des éléments portant un {{domxref("element.name","name")}} donné dans le document (X)HTML.</p> +Renvoie une liste des éléments portant un {{domxref("element.name","name")}} donné dans le document (X)HTML. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>elements</em> = document.getElementsByName(<em>name</em>) -</pre> + elements = document.getElementsByName(name) -<ul> - <li><code>elements</code> est une collection de {{domxref("NodeList")}}</li> - <li><code>name</code> est la valeur de l'attribut <code>name</code> des éléments.</li> -</ul> +- `elements` est une collection de {{domxref("NodeList")}} +- `name` est la valeur de l'attribut `name` des éléments. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush:html"><!DOCTYPE html> -<html lang="en"> -<head> +```html +<!DOCTYPE html> +<html lang="en"> +<head> ... -</head> +</head> -<body> -<form name="up"><input type="text"></form> -<div name="down"><input type="text"></div> +<body> +<form name="up"><input type="text"></form> +<div name="down"><input type="text"></div> -<script> +<script> var up_forms = document.getElementsByName("up"); console.log(up_forms[0].tagName); // retourne "FORM" -</script> -</body> -</html></pre> - -<h2 id="Notes">Notes</h2> - -<p>L'attribut <code><a href="/fr/docs/Web/API/Element/name">name</a></code> est uniquement applicable aux documents (X) HTML. La méthode renvoie une collection {{domxref("NodeList")}} en cours qui contient tous les éléments avec une valeur donnée pour l'attribut name, tels que {{htmlelement("meta")}} ou {{htmlelement("object")}} ou même si le nom est placé sur des éléments qui ne supportent pas du tout un attribut <code>name</code>.</p> - -<p>La méthode <strong>getElementsByName</strong> fonctionne différemment dans différents navigateurs. Dans IE <10, la méthode getElementsByName () renvoie également les éléments qui ont un attribut id avec la valeur spécifiée. Vous devriez donc faire attention à ne pas utiliser la même chaîne pour le nom et l'identifiant.</p> - -<h2 id="Sp.C3.A9cification">Spécifications</h2> - -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-71555259">DOM Level 2 HTML : getElementsByName</a> — <a href="http://www.yoyodesign.org/doc/w3c/dom2-html/html.html#ID-71555259">traduction en français</a> (non normative)</li> - <li><a href="http://www.whatwg.org/html/#dom-document-getelementsbyname">HTML5 : getElementsByName</a></li> -</ul> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', '#dom-document-getelementsbyname', "Document.getElementsByName()")}}</td> - <td>{{ Spec2('HTML WHATWG') }}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("DOM2 HTML", "html.html#ID-71555259", "Document.getElementsByName()")}}</td> - <td>{{Spec2("DOM2 HTML")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> - -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li>{{domxref("document.getElementById()")}} pour retourner une référence à un élément par son ID</li> - <li>{{domxref("document.getElementsByTagName()")}} pour renvoyer les références sur les éléments avec la balise de nom donnée</li> - <li>{{domxref("document.querySelector()")}} pour des sélecteurs par des requêtes comme <code>'div.myclass'</code></li> -</ul> - -<p> </p> +</script> +</body> +</html> +``` + +## Notes + +L'attribut [`name`](/fr/docs/Web/API/Element/name) est uniquement applicable aux documents (X) HTML. La méthode renvoie une collection {{domxref("NodeList")}} en cours qui contient tous les éléments avec une valeur donnée pour l'attribut name, tels que {{htmlelement("meta")}} ou {{htmlelement("object")}} ou même si le nom est placé sur des éléments qui ne supportent pas du tout un attribut `name`. + +La méthode **getElementsByName** fonctionne différemment dans différents navigateurs. Dans IE <10, la méthode getElementsByName () renvoie également les éléments qui ont un attribut id avec la valeur spécifiée. Vous devriez donc faire attention à ne pas utiliser la même chaîne pour le nom et l'identifiant. + +## Spécifications + +- [DOM Level 2 HTML : getElementsByName](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-71555259) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-html/html.html#ID-71555259) (non normative) +- [HTML5 : getElementsByName](http://www.whatwg.org/html/#dom-document-getelementsbyname) + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------- | +| {{SpecName('HTML WHATWG', '#dom-document-getelementsbyname', "Document.getElementsByName()")}} | {{ Spec2('HTML WHATWG') }} | | +| {{SpecName("DOM2 HTML", "html.html#ID-71555259", "Document.getElementsByName()")}} | {{Spec2("DOM2 HTML")}} | Définition initiale | + +## Voir aussi + +- {{domxref("document.getElementById()")}} pour retourner une référence à un élément par son ID +- {{domxref("document.getElementsByTagName()")}} pour renvoyer les références sur les éléments avec la balise de nom donnée +- {{domxref("document.querySelector()")}} pour des sélecteurs par des requêtes comme `'div.myclass'` diff --git a/files/fr/web/api/document/getelementsbytagname/index.md b/files/fr/web/api/document/getelementsbytagname/index.md index b90d19fbe0..5ba9a313ba 100644 --- a/files/fr/web/api/document/getelementsbytagname/index.md +++ b/files/fr/web/api/document/getelementsbytagname/index.md @@ -8,37 +8,32 @@ tags: - Méthodes translation_of: Web/API/Document/getElementsByTagName --- -<div>{{ ApiRef("DOM") }}</div> +{{ ApiRef("DOM") }} -<div> </div> +Renvoie une {{domxref ("HTMLCollection")}} des éléments avec le nom de balise donné. Le document complet est recherché, y compris le nœud racine. Le `HTMLCollection` renvoyée est en direct, ce qui signifie qu'elle se met à jour automatiquement pour rester synchronisée avec l'arborescence DOM sans avoir à rappeler document.getElementsByTagName (). -<p>Renvoie une {{domxref ("HTMLCollection")}} des éléments avec le nom de balise donné. Le document complet est recherché, y compris le nœud racine. Le <code>HTMLCollection</code> renvoyée est en direct, ce qui signifie qu'elle se met à jour automatiquement pour rester synchronisée avec l'arborescence DOM sans avoir à rappeler document.getElementsByTagName ().</p> +## Syntaxe -<h2 id="Syntaxe">Syntaxe</h2> + var elements = document.getElementsByTagName(name); -<pre class="syntaxbox">var <var>elements</var> = document.getElementsByTagName(<em>name</em>);</pre> +- `elements` est une liste de nœuds (`NodeList`) des éléments trouvés dans l'ordre dans lequel ils apparaissent dans l'arbre. +- `nom` est une chaîne représentant le nom des éléments. La chaîne spéciale `"*"` représente « tous les éléments ». -<ul> - <li><code>elements</code> est une liste de nœuds (<code>NodeList</code>) des éléments trouvés dans l'ordre dans lequel ils apparaissent dans l'arbre.</li> - <li><code>nom</code> est une chaîne représentant le nom des éléments. La chaîne spéciale <code>"*"</code> représente « tous les éléments ».</li> -</ul> +> **Note :** [La dernière spécification W3C](https://dom.spec.whatwg.org/) dit que `elements` est une `HTMLCollection` ; cependant cette méthode renvoie une {{domxref("NodeList")}} dans les navigateurs WebKit. Voir {{bug(14869)}} pour plus de détails. -<div class="note"> -<p><strong>Note :</strong> <a href="https://dom.spec.whatwg.org/">La dernière spécification W3C</a> dit que <code>elements</code> est une <code>HTMLCollection</code> ; cependant cette méthode renvoie une {{domxref("NodeList")}} dans les navigateurs WebKit. Voir {{bug(14869)}} pour plus de détails.</p> -</div> +## Exemple -<h2 id="Exemple">Exemple</h2> +Dans l'exemple suivant, `getElementsByTagName()` commence à partir d'un élément parent particulier et effectue une recherche descendante récursive dans le DOM à partir de cet élément parent, en créant une collection de tous les éléments descendants qui correspondent au paramètre de `name`. Cela démontre à la fois `document.getElementsByTagName()` et son homologue {{domxref ("Element.getElementsByTagName ()")}}, qui lance la recherche sur un élément spécifique dans l'arbre DOM. -<p>Dans l'exemple suivant, <code>getElementsByTagName()</code> commence à partir d'un élément parent particulier et effectue une recherche descendante récursive dans le DOM à partir de cet élément parent, en créant une collection de tous les éléments descendants qui correspondent au paramètre de <code>name</code>. Cela démontre à la fois <code>document.getElementsByTagName()</code> et son homologue {{domxref ("Element.getElementsByTagName ()")}}, qui lance la recherche sur un élément spécifique dans l'arbre DOM.</p> +Cliquer sur les boutons utilise `getElementsByTagName()` pour compter les éléments de paragraphe descendant d'un parent particulier (le document lui-même ou l'un des éléments {{HTMLElement ("div")}} imbriqués). -<p>Cliquer sur les boutons utilise <code>getElementsByTagName()</code> pour compter les éléments de paragraphe descendant d'un parent particulier (le document lui-même ou l'un des éléments {{HTMLElement ("div")}} imbriqués).</p> - -<pre class="brush:html"><!DOCTYPE html> -<html lang="en"> -<head> - <meta charset="UTF-8" /> - <title>getElementsByTagName example</title> - <script> +```html +<!DOCTYPE html> +<html lang="en"> +<head> + <meta charset="UTF-8" /> + <title>getElementsByTagName example</title> + <script> function getAllParaElems() { var allParas = document.getElementsByTagName('p'); var num = allParas.length; @@ -58,56 +53,53 @@ translation_of: Web/API/Document/getElementsByTagName var num = div2Paras.length; alert('There are ' + num + ' paragraph in #div2'); } - </script> -</head> -<body style="border: solid green 3px"> - <p>Some outer text</p> - <p>Some outer text</p> + </script> +</head> +<body style="border: solid green 3px"> + <p>Some outer text</p> + <p>Some outer text</p> + + <div id="div1" style="border: solid blue 3px"> + <p>Some div1 text</p> + <p>Some div1 text</p> + <p>Some div1 text</p> - <div id="div1" style="border: solid blue 3px"> - <p>Some div1 text</p> - <p>Some div1 text</p> - <p>Some div1 text</p> + <div id="div2" style="border: solid red 3px"> + <p>Some div2 text</p> + <p>Some div2 text</p> + </div> + </div> - <div id="div2" style="border: solid red 3px"> - <p>Some div2 text</p> - <p>Some div2 text</p> - </div> - </div> + <p>Some outer text</p> + <p>Some outer text</p> - <p>Some outer text</p> - <p>Some outer text</p> + <button onclick="getAllParaElems();"> + show all p elements in document</button><br /> - <button onclick="getAllParaElems();"> - show all p elements in document</button><br /> + <button onclick="div1ParaElems();"> + show all p elements in div1 element</button><br /> - <button onclick="div1ParaElems();"> - show all p elements in div1 element</button><br /> + <button onclick="div2ParaElems();"> + show all p elements in div2 element</button> - <button onclick="div2ParaElems();"> - show all p elements in div2 element</button> +</body> +</html> +``` -</body> -</html></pre> +## Notes -<h2 id="Sp.C3.A9cification">Notes</h2> +Lorsqu'elle est appelée sur un document HTML, `getElementsByTagName()` classe son argument avant de continuer. Cela n'est pas souhaitable lorsque vous essayez de faire correspondre des éléments camelCase SVG dans un sous-arbre dans un document HTML. {{Domxref ("document.getElementsByTagNameNS ()")}} est utile dans ce cas. Voir aussi {{Bug (499656)}}. -<p>Lorsqu'elle est appelée sur un document HTML, <code>getElementsByTagName()</code> classe son argument avant de continuer. Cela n'est pas souhaitable lorsque vous essayez de faire correspondre des éléments camelCase SVG dans un sous-arbre dans un document HTML. {{Domxref ("document.getElementsByTagNameNS ()")}} est utile dans ce cas. Voir aussi {{Bug (499656)}}.<br> - <br> - <code>document.getElementsByTagName()</code> est similaire à {{domxref ("element.getElementsByTagName ()")}}, sauf que sa recherche englobe tout le document.</p> +`document.getElementsByTagName()` est similaire à {{domxref ("element.getElementsByTagName ()")}}, sauf que sa recherche englobe tout le document. -<h2 id="Sp.C3.A9cification">Spécifications</h2> +## Spécifications -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-A6C9094">DOM Level 2 Core : getElementsByTagName</a> <small>— <a href="http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-A6C9094">traduction</a> (non normative)</small></li> - <li><a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#apis-in-html-documents">HTML 5: APIs in HTML documents</a></li> -</ul> +- [DOM Level 2 Core : getElementsByTagName](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-A6C9094) — [traduction](http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-A6C9094) (non normative) +- [HTML 5: APIs in HTML documents](http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#apis-in-html-documents) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Element.getElementsByTagName()")}}</li> - <li>{{domxref("document.getElementById()")}} pour renvoyer une référence à un élément par son <code>id</code> (<em>identifiant</em>)</li> - <li>{{domxref("document.getElementsByName()")}} pour renvoyer une référence à un élément par son <code>name</code> (<em>nom</em>)</li> - <li>{{domxref("document.querySelector()")}} pour les sélecteurs puissants via des requêtes comme <code>'div.myclass'</code></li> -</ul> +- {{domxref("Element.getElementsByTagName()")}} +- {{domxref("document.getElementById()")}} pour renvoyer une référence à un élément par son `id` (_identifiant_) +- {{domxref("document.getElementsByName()")}} pour renvoyer une référence à un élément par son `name` (_nom_) +- {{domxref("document.querySelector()")}} pour les sélecteurs puissants via des requêtes comme `'div.myclass'` diff --git a/files/fr/web/api/document/getelementsbytagnamens/index.md b/files/fr/web/api/document/getelementsbytagnamens/index.md index a91fcc93bb..c508a93d8f 100644 --- a/files/fr/web/api/document/getelementsbytagnamens/index.md +++ b/files/fr/web/api/document/getelementsbytagnamens/index.md @@ -10,41 +10,37 @@ tags: - XPath translation_of: Web/API/Document/getElementsByTagNameNS --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>{{ fx_minversion_note("3.6","Voir la <a href='\"/en/DOM/element.getElementsByTagNameNS#Notes\"'>section Notes de element.getElementsByTagNameNS</a> pour les changements qui s'appliquent aussi à cet API dans Firefox 3.6.") }}</p> +{{ fx_minversion_note("3.6","Voir la <a href='\"/en/DOM/element.getElementsByTagNameNS#Notes\"'>section Notes de element.getElementsByTagNameNS</a> pour les changements qui s'appliquent aussi à cet API dans Firefox 3.6.") }} -<p>Renvoie une liste d'éléments avec la balise de nom donnée appartenant à l'espace de noms donné. Le document complet est recherché, y compris le noeud racine.</p> +Renvoie une liste d'éléments avec la balise de nom donnée appartenant à l'espace de noms donné. Le document complet est recherché, y compris le noeud racine. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>elements</em> = document.getElementsByTagNameNS(<em>namespace</em>,<em>name</em>) -</pre> + elements = document.getElementsByTagNameNS(namespace,name) -<ul> - <li><code>elements</code> est une {{domxref("NodeList")}} (<em>liste de noeud</em>) directe (mais voir le note ci-dessous) d'éléments trouvés dans l'ordre de leur apparition dans l'arbre.</li> - <li><code>namespace</code> l'URI d'espace de noms des éléments à rechercher (voir <code><a href="/en/DOM/Node.namespaceURI">element.namespaceURI</a></code>).</li> - <li><code>name</code> est, soit le nom local des éléments à rechercher, soit la valeur spéciale <code>"*"</code> pour tous les éléments (voir <code><a href="/en/DOM/Node.localName">element.localName</a></code>).</li> -</ul> +- `elements` est une {{domxref("NodeList")}} (_liste de noeud_) directe (mais voir le note ci-dessous) d'éléments trouvés dans l'ordre de leur apparition dans l'arbre. +- `namespace` l'URI d'espace de noms des éléments à rechercher (voir [`element.namespaceURI`](/en/DOM/Node.namespaceURI)). +- `name` est, soit le nom local des éléments à rechercher, soit la valeur spéciale `"*"` pour tous les éléments (voir [`element.localName`](/en/DOM/Node.localName)). -<div class="note"> - <p><strong>Note :</strong> Tandis que la spécification W3C indique que les <code>elements</code> sont des <code>NodeList</code>, cette méthode renvoie une {{domxref("HTMLCollection")}} dans Gecko et Internet Explorer. Opera retourne une <code>NodeList</code>, mais avec une méthode implémentée <code>namedItem</code>, ce qui la rend similaire à une <code>HTMLCollection</code>. À partir de Janvier 2012, dans les navigateurs WebKit seulement, la valeur retournée est une pure <code>NodeList</code>. Voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=14869">bug 14869</a> pour plus de détails.</p> -</div> +> **Note :** Tandis que la spécification W3C indique que les `elements` sont des `NodeList`, cette méthode renvoie une {{domxref("HTMLCollection")}} dans Gecko et Internet Explorer. Opera retourne une `NodeList`, mais avec une méthode implémentée `namedItem`, ce qui la rend similaire à une `HTMLCollection`. À partir de Janvier 2012, dans les navigateurs WebKit seulement, la valeur retournée est une pure `NodeList`. Voir [bug 14869](https://bugzilla.mozilla.org/show_bug.cgi?id=14869) pour plus de détails. -<h2 id="Example">Exemple</h2> +## Exemple -<p>Dans l'exemple suivant, <code>getElementsByTagNameNS</code> commence à partir d'un élément parent particulier et cherche dans le DOM récursivement de haut en bas à partir de cet élément parent, les éléments enfants correspondant au paramètre <code>name</code> de la balise.</p> +Dans l'exemple suivant, `getElementsByTagNameNS` commence à partir d'un élément parent particulier et cherche dans le DOM récursivement de haut en bas à partir de cet élément parent, les éléments enfants correspondant au paramètre `name` de la balise. -<p>Notez que lorsque le noeud sur lequel <code>getElementsByTagName</code> est invoqué n'est pas un noeud <code>document</code>, la méthode <a href="/fr/docs/Web/API/Element/getElementsByTagNameNS">element.getElementsByTagNameNS</a> est en fait utilisée.</p> +Notez que lorsque le noeud sur lequel `getElementsByTagName` est invoqué n'est pas un noeud `document`, la méthode [element.getElementsByTagNameNS](/fr/docs/Web/API/Element/getElementsByTagNameNS) est en fait utilisée. -<p>Pour utiliser l'exemple suivant, il suffit de le copier/coller dans un nouveau fichier enregistré avec l'extension .xhtml.</p> +Pour utiliser l'exemple suivant, il suffit de le copier/coller dans un nouveau fichier enregistré avec l'extension .xhtml. -<pre class="brush: html">http://www.w3.org/1999/xhtml"> +```html +http://www.w3.org/1999/xhtml"> -<head> -<title>getElementsByTagNameNS example</title> +<head> +<title>getElementsByTagNameNS example</title> -<script type="text/javascript"> +<script type="text/javascript"> function getAllParaElems() { @@ -52,7 +48,7 @@ function getAllParaElems() var num = allParas.length; - alert("There are " + num + " &lt;p&gt; elements in this document"); + alert("There are " + num + " <p> elements in this document"); } @@ -63,7 +59,7 @@ function div1ParaElems() var num = div1Paras.length; - alert("There are " + num + " &lt;p&gt; elements in div1 element"); + alert("There are " + num + " <p> elements in div1 element"); } @@ -74,48 +70,49 @@ function div2ParaElems() var num = div2Paras.length; - alert("There are " + num + " &lt;p&gt; elements in div2 element"); + alert("There are " + num + " <p> elements in div2 element"); } -</script> -</head> +</script> +</head> -<body style="border: solid green 3px"> -<p>Some outer text</p> -<p>Some outer text</p> +<body style="border: solid green 3px"> +<p>Some outer text</p> +<p>Some outer text</p> - <div id="div1" style="border: solid blue 3px"> - <p>Some div1 text</p> - <p>Some div1 text</p> - <p>Some div1 text</p> + <div id="div1" style="border: solid blue 3px"> + <p>Some div1 text</p> + <p>Some div1 text</p> + <p>Some div1 text</p> - <div id="div2" style="border: solid red 3px"> - <p>Some div2 text</p> - <p>Some div2 text</p> - </div> - </div> + <div id="div2" style="border: solid red 3px"> + <p>Some div2 text</p> + <p>Some div2 text</p> + </div> + </div> -<p>Some outer text</p> -<p>Some outer text</p> +<p>Some outer text</p> +<p>Some outer text</p> -<button onclick="getAllParaElems();"> - show all p elements in document</button><br /> +<button onclick="getAllParaElems();"> + show all p elements in document</button><br /> -<button onclick="div1ParaElems();"> - show all p elements in div1 element</button><br /> +<button onclick="div1ParaElems();"> + show all p elements in div1 element</button><br /> -<button onclick="div2ParaElems();"> - show all p elements in div2 element</button> +<button onclick="div2ParaElems();"> + show all p elements in div2 element</button> -</body> -</html> -</pre> +</body> +</html> +``` -<h2 id="Potential_Workaround_for_other_browsers_which_do_not_support">Solution de contournement potentielle pour les navigateurs qui ne prennent pas en charge XPath</h2> +## Solution de contournement potentielle pour les navigateurs qui ne prennent pas en charge XPath -<p>Si le navigateur souhaité ne supporte pas XPath, une autre approche (comme traverser le DOM à travers tous ses enfants, identifier toutes les instances de @xmlns, etc.) serait nécessaire pour trouver toutes les balises avec le nom local et l'espace de noms, mais XPath est beaucoup plus rapide. (Pour adapter à Explorer, on pourrait appeler un wrapper XPath au lieu du XPath dans la fonction ci-dessous (comme Explorer supporte XPath avec une API différente), comme <a href="http://www.davidflanagan.com/javascript5/display.php?n=21-10&f=21/10.js">cette classe wrapper</a>.)</p> +Si le navigateur souhaité ne supporte pas XPath, une autre approche (comme traverser le DOM à travers tous ses enfants, identifier toutes les instances de @xmlns, etc.) serait nécessaire pour trouver toutes les balises avec le nom local et l'espace de noms, mais XPath est beaucoup plus rapide. (Pour adapter à Explorer, on pourrait appeler un wrapper XPath au lieu du XPath dans la fonction ci-dessous (comme Explorer supporte XPath avec une API différente), comme [cette classe wrapper](http://www.davidflanagan.com/javascript5/display.php?n=21-10&f=21/10.js).) -<pre class="brush: js">function getElementsByTagNameNSWrapper (ns, elName, doc, context) { +```js +function getElementsByTagNameNSWrapper (ns, elName, doc, context) { if (!doc) { doc = document; } @@ -126,13 +123,13 @@ function div2ParaElems() var result = doc.evaluate('//*[local-name()="'+elName+'" and namespace-uri() = "'+ns+'"]', context, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null); var a = []; - for(var i = 0; i < result.snapshotLength; i++) { + for(var i = 0; i < result.snapshotLength; i++) { a[i] = result.snapshotItem(i); } return a; } -</pre> +``` -<h2 id="Specification">Spécifications</h2> +## Spécifications -<p><a href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-getElBTNNS">DOM Level 2 Core: Document.getElementsByTagNameNS</a></p> +[DOM Level 2 Core: Document.getElementsByTagNameNS](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-getElBTNNS) diff --git a/files/fr/web/api/document/getselection/index.md b/files/fr/web/api/document/getselection/index.md index e485df22ae..270449529f 100644 --- a/files/fr/web/api/document/getselection/index.md +++ b/files/fr/web/api/document/getselection/index.md @@ -11,6 +11,6 @@ translation_of: Web/API/DocumentOrShadowRoot/getSelection translation_of_original: Web/API/Document/getSelection original_slug: Web/API/DocumentOrShadowRoot/getSelection --- -<p>{{APIRef("DOM")}}</p> +{{APIRef("DOM")}} -<p>Cette méthode fonctionne de manière identique à la méthode {{domxref ("Window.getSelection()")}} ; elle renvoie un objet {{domxref ("Selection")}} représentant le texte actuellement sélectionné dans le document.</p> +Cette méthode fonctionne de manière identique à la méthode {{domxref ("Window.getSelection()")}} ; elle renvoie un objet {{domxref ("Selection")}} représentant le texte actuellement sélectionné dans le document. diff --git a/files/fr/web/api/document/hasfocus/index.md b/files/fr/web/api/document/hasfocus/index.md index fb6088c0a9..e57571e2f3 100644 --- a/files/fr/web/api/document/hasfocus/index.md +++ b/files/fr/web/api/document/hasfocus/index.md @@ -9,34 +9,32 @@ tags: - Reference translation_of: Web/API/Document/hasFocus --- -<p>{{ ApiRef() }}</p> +{{ ApiRef() }} -<p>La méthode <code><strong>Document.hasFocus()</strong></code> retourne une valeur {{jsxref("Boolean")}} <code>true</code> <em>(vrai)</em> indiquant si le document ou tout élément à l'intérieur du document a le focus. Cette méthode peut être utilisée pour déterminer si l'élément actif d'un document a le focus.</p> +La méthode **`Document.hasFocus()`** retourne une valeur {{jsxref("Boolean")}} `true` _(vrai)_ indiquant si le document ou tout élément à l'intérieur du document a le focus. Cette méthode peut être utilisée pour déterminer si l'élément actif d'un document a le focus. -<div class="note"> -<p><strong>Note :</strong> Lors de la visualisation d'un document, un élément avec focus est toujours l'élément actif dans le document, mais un élément actif n'a pas nécessairement le focus. Par exemple, un élément actif dans une fenêtre contextuelle qui n'est pas le premier plan n'a pas de focus.</p> -</div> +> **Note :** Lors de la visualisation d'un document, un élément avec focus est toujours l'élément actif dans le document, mais un élément actif n'a pas nécessairement le focus. Par exemple, un élément actif dans une fenêtre contextuelle qui n'est pas le premier plan n'a pas de focus. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="eval">focused = document.hasFocus(); -</pre> + focused = document.hasFocus(); -<h3 id="Exemple">Valeur retournée</h3> +### Valeur retournée -<p><code>false</code> <em>(faux)</em> si l'élément actif dans le document n'a pas de focus ; <code>true</code><em> (vrai)</em> si l'élément actif dans le document a le focus.</p> +`false` _(faux)_ si l'élément actif dans le document n'a pas de focus ; `true` _(vrai)_ si l'élément actif dans le document a le focus. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush:html"><!DOCTYPE html> -<html lang="en"> -<head> -<meta charset="UTF-8" /> -<title>TEST</title> -<style> +```html +<!DOCTYPE html> +<html lang="en"> +<head> +<meta charset="UTF-8" /> +<title>TEST</title> +<style> #message { font-weight: bold; } -</style> -<script> +</style> +<script> setInterval( checkPageFocus, 200 ); function checkPageFocus() { @@ -56,40 +54,26 @@ function openWindow() { "width=640,height=300,left=150,top=260" ); } -</script> -</head> -<body> - <h1>JavaScript hasFocus example</h1> - <div id="message">Waiting for user action</div> - <div><button onclick="openWindow()">Open a new window</button></div> -</body> -</html></pre> - -<h2 id="Specifications">Spécification</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', 'interaction.html#dom-document-hasfocus', 'Document.hasFocus()')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.hasFocus")}}</p> - -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/API/Page_Visibility_API">Utilisation de l'API de visibilité des pages</a></li> -</ul> +</script> +</head> +<body> + <h1>JavaScript hasFocus example</h1> + <div id="message">Waiting for user action</div> + <div><button onclick="openWindow()">Open a new window</button></div> +</body> +</html> +``` + +## Spécification + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName('HTML WHATWG', 'interaction.html#dom-document-hasfocus', 'Document.hasFocus()')}} | {{Spec2('HTML WHATWG')}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Document.hasFocus")}} + +## Voir aussi + +- [Utilisation de l'API de visibilité des pages](/fr/docs/Web/API/Page_Visibility_API) diff --git a/files/fr/web/api/document/head/index.md b/files/fr/web/api/document/head/index.md index ef80950d76..b0ecd73b49 100644 --- a/files/fr/web/api/document/head/index.md +++ b/files/fr/web/api/document/head/index.md @@ -7,63 +7,39 @@ tags: - HTML5 translation_of: Web/API/Document/head --- +Retourne l'élément {{HTMLElement("head")}} du document courant. S'il y a plus d'un élément \<head>, le premier est retourné. -<p>Retourne l'élément {{HTMLElement("head")}} du document courant. S'il y a plus d'un élément <head>, le premier est retourné.</p> +## Syntaxe -<h2 id="Syntax">Syntaxe</h2> + var objRef = document.head; -<pre class="syntaxbox"><em>var objRef</em> = document.head; -</pre> +## Exemple -<h2 id="Example">Exemple</h2> - -<pre class="brush: js">// en HTML: <head id="my-document-head"> +```js +// en HTML: <head id="my-document-head"> var aHead = document.head; alert(aHead.id); // "my-document-head"; alert( document.head === document.querySelector("head") ); // true -</pre> +``` -<h2 id="Example">Notes</h2> +## Notes -<p><code>document.head</code> est en lecture seule. Essayer d'assigner une valeur à cettre propriété échouera en silence ou lancera une <code>TypeError</code> si le mode strict d'ECMAScript est activé dans un navigateur Gecko.</p> +`document.head` est en lecture seule. Essayer d'assigner une valeur à cettre propriété échouera en silence ou lancera une `TypeError` si le mode strict d'ECMAScript est activé dans un navigateur Gecko. -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML5.1','dom.html#dom-document-head','Document.head')}}</td> - <td>{{Spec2('HTML5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('HTML5 W3C','dom.html#dom-document-head','Document.head')}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG','dom.html#dom-document-head','Document.head')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------- | +| {{SpecName('HTML5.1','dom.html#dom-document-head','Document.head')}} | {{Spec2('HTML5.1')}} | | +| {{SpecName('HTML5 W3C','dom.html#dom-document-head','Document.head')}} | {{Spec2('HTML5 W3C')}} | | +| {{SpecName('HTML WHATWG','dom.html#dom-document-head','Document.head')}} | {{Spec2('HTML WHATWG')}} | Initial definition. | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.head")}}</p> +{{Compat("api.Document.head")}} -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("document.body")}}</li> -</ul> +- {{domxref("document.body")}} diff --git a/files/fr/web/api/document/height/index.md b/files/fr/web/api/document/height/index.md index 6dbe1f47e8..f05e75b127 100644 --- a/files/fr/web/api/document/height/index.md +++ b/files/fr/web/api/document/height/index.md @@ -3,42 +3,37 @@ title: Document.height slug: Web/API/Document/height translation_of: Web/API/Document/height --- -<div>{{APIRef("DOM")}} {{Obsolete_header}}</div> +{{APIRef("DOM")}} {{Obsolete_header}} -<div class="note"> -<p><strong>Note:</strong> Apparu avec {{Gecko("6.0")}},<code> document.height n'est plus supporté</code>. Utilisez à la place <code>document.body.clientHeight</code>. Voir {{domxref("element.clientHeight")}}.</p> -</div> +> **Note :** Apparu avec {{Gecko("6.0")}},` document.height n'est plus supporté`. Utilisez à la place `document.body.clientHeight`. Voir {{domxref("element.clientHeight")}}. -<h2 id="Résumé">Résumé</h2> +## Résumé -<p>Retourne la hauteur de l'objet {{domxref("document")}}. Dans la plupart des cas, ceci est égal à l'élément {{HTMLElement("body")}} du document courant.</p> +Retourne la hauteur de l'objet {{domxref("document")}}. Dans la plupart des cas, ceci est égal à l'élément {{HTMLElement("body")}} du document courant. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>height_value</em> = document.height -</pre> + height_value = document.height -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">// alert document height +```js +// alert document height alert(document.height); -</pre> +``` -<h2 id="Alternatives">Alternatives</h2> +## Alternatives -<pre class="syntaxbox">document.body.clientHeight -document.documentElement.clientHeight -document.documentElement.scrollHeight -</pre> + document.body.clientHeight + document.documentElement.clientHeight + document.documentElement.scrollHeight -<h2 id="Spécification">Spécification</h2> +## Spécification -<p>HTML5</p> +HTML5 -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("document.width")}}</li> - <li>{{domxref("Element.clientHeight")}}</li> - <li>{{domxref("Element.scrollHeight")}}</li> -</ul> +- {{domxref("document.width")}} +- {{domxref("Element.clientHeight")}} +- {{domxref("Element.scrollHeight")}} diff --git a/files/fr/web/api/document/hidden/index.md b/files/fr/web/api/document/hidden/index.md index 66da5b2e9d..23432385c6 100644 --- a/files/fr/web/api/document/hidden/index.md +++ b/files/fr/web/api/document/hidden/index.md @@ -3,39 +3,29 @@ title: Document.hidden slug: Web/API/Document/hidden translation_of: Web/API/Document/hidden --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>La propriété <code><strong>Document.hidden</strong></code> retourne un Booléen qui indique si la page est considérée cachée ou pas.</p> +La propriété **`Document.hidden`** retourne un Booléen qui indique si la page est considérée cachée ou pas. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <em>boolean</em> = document.hidden</pre> + var boolean = document.hidden -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush:js;">document.addEventListener("visibilitychange", function() { +```js +document.addEventListener("visibilitychange", function() { console.log( document.hidden ); // Modifier le comportement... }); -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th>Specification</th> - <th>Status</th> - <th>Comment</th> - </tr> - <tr> - <td>{{SpecName('Page Visibility API','#dom-document-hidden', 'Document.hidden')}}</td> - <td>{{Spec2('Page Visibility API')}}</td> - <td>Initial definition</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{Compat("api.Document.hidden")}}</p> +``` + +## Spécifications + +| Specification | Status | Comment | +| -------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------ | +| {{SpecName('Page Visibility API','#dom-document-hidden', 'Document.hidden')}} | {{Spec2('Page Visibility API')}} | Initial definition | + +## Browser compatibility + +{{Compat("api.Document.hidden")}} diff --git a/files/fr/web/api/document/images/index.md b/files/fr/web/api/document/images/index.md index 1b127eb980..2aaeb008e4 100644 --- a/files/fr/web/api/document/images/index.md +++ b/files/fr/web/api/document/images/index.md @@ -5,29 +5,32 @@ tags: - Référence_du_DOM_Gecko translation_of: Web/API/Document/images --- -<p>{{ ApiRef() }}</p> +{{ ApiRef() }} -<p><code>document.images</code> renvoie une collection des images du document HTML courant.</p> +`document.images` renvoie une collection des images du document HTML courant. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">HTMLCollection =document.images</pre> +```js +HTMLCollection =document.images +``` -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush:js">var listeimg = document.images; -for(var i = 0; i < listeimg.length; i++) { +```js +var listeimg = document.images; +for(var i = 0; i < listeimg.length; i++) { if(listeimg[i] == "banner.gif") { // l'image banner a été trouvée } } -</pre> +``` -<h2 id="Notes">Notes</h2> +## Notes -<p><a href="/fr/DOM/document.images"><code>document.images</code></a> fait partie du DOM HTML, et fonctionne uniquement pour les document HTML.</p> -<h2 id="Sp.C3.A9cification">Spécification</h2> -<ul> - <li>Spécification DOM Level 2 HTML : <a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-90379117">HTMLDocument.images</a></li> - <li>Traduction en français (non normative) : <a href="http://www.yoyodesign.org/doc/w3c/dom2/html/html.html#ID-90379117">HTMLDocument.images</a></li> -</ul> +[`document.images`](/fr/DOM/document.images) fait partie du DOM HTML, et fonctionne uniquement pour les document HTML. + +## Spécification + +- Spécification DOM Level 2 HTML : [HTMLDocument.images](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-90379117) +- Traduction en français (non normative) : [HTMLDocument.images](http://www.yoyodesign.org/doc/w3c/dom2/html/html.html#ID-90379117) diff --git a/files/fr/web/api/document/implementation/index.md b/files/fr/web/api/document/implementation/index.md index f7684fa56f..ec2cccdd51 100644 --- a/files/fr/web/api/document/implementation/index.md +++ b/files/fr/web/api/document/implementation/index.md @@ -8,40 +8,37 @@ tags: - Reference translation_of: Web/API/Document/implementation --- -<h2 id="Résumé">Résumé</h2> +## Résumé -<p>Retourne un objet {{domxref("DOMImplementation")}} associé avec le document courant.</p> +Retourne un objet {{domxref("DOMImplementation")}} associé avec le document courant. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>DOMImpObj</var> = document.implementation; -</pre> + DOMImpObj = document.implementation; -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">var modName = "HTML"; +```js +var modName = "HTML"; var modVer = "2.0"; var conformTest = document.implementation.hasFeature( modName, modVer ); alert( "DOM " + modName + " " + modVer + " supported?: " + conformTest ); -// alerte avec : "DOM HTML 2.0 pris en charge ?: true" si le module DOM niveau 2 HTML est pris en charge.</pre> +// alerte avec : "DOM HTML 2.0 pris en charge ?: true" si le module DOM niveau 2 HTML est pris en charge. +``` -<p>Une liste de noms de modules (par exemple, Core, HTML, XML, etc.) est disponible dans la <a href="http://www.w3.org/TR/DOM-Level-2-Core/introduction.html#ID-Conformance-h2">Conformance Section</a> DOM niveau 2.</p> +Une liste de noms de modules (par exemple, Core, HTML, XML, etc.) est disponible dans la [Conformance Section](http://www.w3.org/TR/DOM-Level-2-Core/introduction.html#ID-Conformance-h2) DOM niveau 2. -<h2 id="Notes">Notes</h2> +## Notes -<p>La recommandation DOM niveau 1 du W3C ne spécifiait que la méthode <code>hasFeature</code>, qui est un moyen de déterminer si un module DOM est supporté par un navigateur (voir l'exemple ci-dessus et ce que votre agent utilisateur prétend prendre en charge ?). Si disponibles, d'autres méthodes <code>DOMImplementation</code> fournissent des services pour contrôler des choses en dehors d'un document unique. Par exemple, l'interface <code>DOMImplementation</code> inclut une méthode <code>createDocumentType</code> avec laquelle des DTD peuvent être créées pour un ou plusieurs documents gérés par l'implémentation.</p> +La recommandation DOM niveau 1 du W3C ne spécifiait que la méthode `hasFeature`, qui est un moyen de déterminer si un module DOM est supporté par un navigateur (voir l'exemple ci-dessus et ce que votre agent utilisateur prétend prendre en charge ?). Si disponibles, d'autres méthodes `DOMImplementation` fournissent des services pour contrôler des choses en dehors d'un document unique. Par exemple, l'interface `DOMImplementation` inclut une méthode `createDocumentType` avec laquelle des DTD peuvent être créées pour un ou plusieurs documents gérés par l'implémentation. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-102161490">DOM Level 2 Core: implementation</a></li> - <li><a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-102161490">DOM Level 3 Core: implementation</a></li> -</ul> +- [DOM Level 2 Core: implementation](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-102161490) +- [DOM Level 3 Core: implementation](http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-102161490) -<h2 id="Notes_propres_à_Gecko">Notes propres à Gecko</h2> +## Notes propres à Gecko -<ul> - <li>À partir de Gecko 19.0 {{geckoRelease ("19.0")}} la méthode {{domxref ("DOMImplementation.hasFeature", "hasFeature")}} retournera toujours true.</li> -</ul> +- À partir de Gecko 19.0 {{geckoRelease ("19.0")}} la méthode {{domxref ("DOMImplementation.hasFeature", "hasFeature")}} retournera toujours true. diff --git a/files/fr/web/api/document/importnode/index.md b/files/fr/web/api/document/importnode/index.md index afda055041..65c30cb570 100644 --- a/files/fr/web/api/document/importnode/index.md +++ b/files/fr/web/api/document/importnode/index.md @@ -10,83 +10,57 @@ tags: - Reference translation_of: Web/API/Document/importNode --- -<p>{{APIRef("DOM")}}</p> +{{APIRef("DOM")}} -<p>La méthode {{domxref ("Document")}} <code>importNode()</code> crée une nouvelle copie du {{domxref ("Node")}} ou {{domxref ("DocumentFragment")}} spécifié à partir d'un autre document, afin qu'il puisse être inséré dans le document actuel. Il n'est pas encore inclus dans l'arbre des documents; Pour ce faire, vous devez appeler une méthode telle que {{domxref ("Node.appendChild", "appendChild ()")}} ou {{domxref ("Node.insertBefore", "insertBefore ()")}}.</p> +La méthode {{domxref ("Document")}} `importNode()` crée une nouvelle copie du {{domxref ("Node")}} ou {{domxref ("DocumentFragment")}} spécifié à partir d'un autre document, afin qu'il puisse être inséré dans le document actuel. Il n'est pas encore inclus dans l'arbre des documents; Pour ce faire, vous devez appeler une méthode telle que {{domxref ("Node.appendChild", "appendChild ()")}} ou {{domxref ("Node.insertBefore", "insertBefore ()")}}. -<h3 id="Syntaxe">Syntaxe</h3> +### Syntaxe -<pre class="syntaxbox">var <em>node</em> = <em>document</em>.importNode(<em>externalNode</em>, <em>deep</em>); -</pre> + var node = document.importNode(externalNode, deep); -<dl> - <dt><code>externalNode</code></dt> - <dd>Le nouveau <code>Node</code> ou <code>DocumentFragment</code> à importer dans le document courant. Après l'importation, le nouveau <code><a href="/fr/docs/Web/API/Node/parentNode">parentNode</a></code> du noeud est <code>null</code>, car il n'a pas encore été inséré dans l'arborescence du document.</dd> - <dt><code>deep</code></dt> - <dd>Une valeur booléenne qui indique s'il faut ou non importer la totalité de la sous-arborescence DOM provenant de <code>externalNode</code>. Si ce paramètre est <code>true</code> (<em>vrai</em>), alors <code>externalNode</code> et tous ses descendants sont copiés; si <code>false</code> <em>(faux)</em>, seul le nœud unique, <code>externalNode</code>, est importé.</dd> -</dl> +- `externalNode` + - : Le nouveau `Node` ou `DocumentFragment` à importer dans le document courant. Après l'importation, le nouveau [`parentNode`](/fr/docs/Web/API/Node/parentNode) du noeud est `null`, car il n'a pas encore été inséré dans l'arborescence du document. +- `deep` + - : Une valeur booléenne qui indique s'il faut ou non importer la totalité de la sous-arborescence DOM provenant de `externalNode`. Si ce paramètre est `true` (_vrai_), alors `externalNode` et tous ses descendants sont copiés; si `false` _(faux)_, seul le nœud unique, `externalNode`, est importé. -<div class="note"> -<p><strong>Note :</strong> Dans la spécification DOM4, <code>deep</code> est répertorié en tant qu'argument facultatif. S'il est omis, la méthode agit comme si la valeur de <code>deep</code> était <code>true</code>, par défaut, elle utilisait le clonage profond comme comportement par défaut. Pour créer un clone superficiel, la profondeur doit être définie sur <code>false</code>.<br> - <br> - Ce comportement a été modifié dans la dernière spécification, et s'il est omis, la méthode agira comme si la valeur de <code>deep</code> était <code>false</code>. Bien que ce soit toujours facultatif, vous devriez toujours fournir l'argument <code>deep</code> à la fois pour la compatibilité en amont et en aval. Avec Gecko 28.0 {{geckoRelease (28)}}, la console a averti les développeurs de ne pas omettre l'argument. À partir de Gecko 29.0 {{geckoRelease (29)}}), un clone superficiel est défini par défaut au lieu d'un clone profond.</p> -</div> +> **Note :** Dans la spécification DOM4, `deep` est répertorié en tant qu'argument facultatif. S'il est omis, la méthode agit comme si la valeur de `deep` était `true`, par défaut, elle utilisait le clonage profond comme comportement par défaut. Pour créer un clone superficiel, la profondeur doit être définie sur `false`. +> +> Ce comportement a été modifié dans la dernière spécification, et s'il est omis, la méthode agira comme si la valeur de `deep` était `false`. Bien que ce soit toujours facultatif, vous devriez toujours fournir l'argument `deep` à la fois pour la compatibilité en amont et en aval. Avec Gecko 28.0 {{geckoRelease (28)}}, la console a averti les développeurs de ne pas omettre l'argument. À partir de Gecko 29.0 {{geckoRelease (29)}}), un clone superficiel est défini par défaut au lieu d'un clone profond. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">var iframe = document.getElementsByTagName("iframe")[0]; +```js +var iframe = document.getElementsByTagName("iframe")[0]; var oldNode = iframe.contentWindow.document.getElementById("myNode"); var newNode = document.importNode(oldNode, true); -document.getElementById("container").appendChild(newNode);</pre> +document.getElementById("container").appendChild(newNode); +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>Le noeud d'origine n'est pas supprimé du document d'origine. Le noeud importé est un clone de l'original.</p> +Le noeud d'origine n'est pas supprimé du document d'origine. Le noeud importé est un clone de l'original. -<p> </p> -<p>Les nœuds provenant de documents externes doivent être clonés à l'aide de <a href="/fr/docs/Web/API/Document/importNode"><code>document.importNode()</code></a> (ou adoptés avec <a href="/fr/docs/Web/API/Document/adoptNode"><code>document.adoptNode()</code></a>) avant de pouvoir être insérés dans le document courant. Pour en savoir plus sur les problèmes de <a href="/fr/docs/Web/API/Node/ownerDocument"><code>Node.ownerDocument</code></a>, consultez la <a href="http://www.w3.org/DOM/faq.html#ownerdoc" rel="noopener">FAQ DOM du W3C</a> (en anglais).</p> -<p>Gecko n'obligeait pas à utiliser <a href="/fr/docs/Web/API/Document/importNode"><code>document.importNode()</code></a> et <a href="/fr/docs/Web/API/Document/adoptNode"><code>document.adoptNode()</code></a> avant sa version 1.9. Depuis les versions 1.9 alphas, si un nœud n'est pas adopté ou importé avant d'être utilisé dans un autre document, l'exception <code>WRONG_DOCUMENT_ERR</code> est déclenchée (<code>NS_ERROR_DOM_WRONG_DOCUMENT_ERR</code>). implémentation dans le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=47903" rel="noopener">bug 47903</a>.</p> +Les nœuds provenant de documents externes doivent être clonés à l'aide de [`document.importNode()`](/fr/docs/Web/API/Document/importNode) (ou adoptés avec [`document.adoptNode()`](/fr/docs/Web/API/Document/adoptNode)) avant de pouvoir être insérés dans le document courant. Pour en savoir plus sur les problèmes de [`Node.ownerDocument`](/fr/docs/Web/API/Node/ownerDocument), consultez la [FAQ DOM du W3C](http://www.w3.org/DOM/faq.html#ownerdoc) (en anglais). -<p> </p> +Gecko n'obligeait pas à utiliser [`document.importNode()`](/fr/docs/Web/API/Document/importNode) et [`document.adoptNode()`](/fr/docs/Web/API/Document/adoptNode) avant sa version 1.9. Depuis les versions 1.9 alphas, si un nœud n'est pas adopté ou importé avant d'être utilisé dans un autre document, l'exception `WRONG_DOCUMENT_ERR` est déclenchée (`NS_ERROR_DOM_WRONG_DOCUMENT_ERR`). implémentation dans le [bug 47903](https://bugzilla.mozilla.org/show_bug.cgi?id=47903). -<h2 id="Sp.C3.A9cification">Spécifications</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("DOM WHATWG", "#dom-document-importnode", "document.importNode()")}}</td> - <td>{{Spec2("DOM WHATWG")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("DOM2 Core", "core.html#Core-Document-importNode", "document.importNode()")}}</td> - <td>{{Spec2("DOM2 Core")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Spécifications -<div> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("DOM WHATWG", "#dom-document-importnode", "document.importNode()")}} | {{Spec2("DOM WHATWG")}} | | +| {{SpecName("DOM2 Core", "core.html#Core-Document-importNode", "document.importNode()")}} | {{Spec2("DOM2 Core")}} | Définition initiale | +## Compatibilité des navigateurs -<p>{{Compat("api.Document.importNode")}} </p> -</div> +{{Compat("api.Document.importNode")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("document.adoptNode()")}}</li> - <li>{{domxref("Node.appendChild()")}}</li> - <li>{{domxref("Node.insertBefore()")}}</li> -</ul> - -<p> </p> +- {{domxref("document.adoptNode()")}} +- {{domxref("Node.appendChild()")}} +- {{domxref("Node.insertBefore()")}} diff --git a/files/fr/web/api/document/index.md b/files/fr/web/api/document/index.md index 186904db9e..b510b17ae1 100644 --- a/files/fr/web/api/document/index.md +++ b/files/fr/web/api/document/index.md @@ -9,482 +9,402 @@ tags: - Reference translation_of: Web/API/Document --- -<p>{{ApiRef}}</p> - -<p>L'interface <strong><code>Document</code></strong> représente n'importe quelle page Web chargée dans le navigateur et sert de point d'entrée dans le contenu de la page Web, qui est l'arborescence DOM. L'arborescence DOM inclut des éléments tels que {{HTMLElement ("body")}} <em>(corps)</em> et {{HTMLElement ("table")}} <em>(tableau)</em>, parmi beaucoup d'autres. Il fournit des fonctionnalités globales au document, comme le moyen d'obtenir l'URL de la page et de créer de nouveaux éléments dans le document.</p> - -<p>{{inheritanceDiagram}}</p> - -<p>L'interface Document décrit les propriétés et méthodes communes à tout type de document. En fonction du type de document (HTML, XML, SVG, ...), une API plus grande est disponible : les documents HTML, servis avec le type <code>text/html</code>, implémentent également l'interface {{domxref ("HTMLDocument")}}, alors que les documents XML et SVG implémentent l'interface {{domxref ("XMLDocument")}}.</p> - -<h2 id="Constructeur">Constructeur</h2> - -<dl> - <dt>{{domxref("Document.Document","Document()")}}{{non-standard_inline}}</dt> - <dd>crée un nouvel objet <code>Document</code> .</dd> -</dl> - -<h2 id="Propri.C3.A9t.C3.A9s">Propriétés</h2> - -<p><em>Cette interface hérite aussi des interfaces {{domxref("Node")}} et {{domxref("EventTarget")}} .</em></p> - -<dl> - <dt>{{domxref("Document.all")}} {{Deprecated_inline}} {{non-standard_inline}}</dt> - <dd>fournit un accès à tous les éléments du document. C'est une interface héritée non standard qui ne doit pas être utilisée.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.async")}} {{Deprecated_inline}}</dt> - <dd>utilisé avec {{domxref("document.load")}} pour indiquer une requête asynchrone.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.characterSet")}} {{readonlyinline}} {{Deprecated_inline}}</dt> - <dd>renvoie le jeu de caractères utilisé par le document.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.compatMode")}} {{readonlyinline}} {{experimental_inline}}</dt> - <dd>indique si le document est rendu en mode <em>Quirks</em> ou <em>Strict</em>.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.contentType")}} {{readonlyinline}} {{experimental_inline}}</dt> - <dd>Renvoie le type de contenu de l'en-tête MIME du document courant.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.doctype")}} {{readonlyinline}}</dt> - <dd>Renvoie le DTD (Document Type Definition) du document courant.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.documentElement")}} {{readonlyinline}}</dt> - <dd>Renvoie l'{{domxref("Element")}} qui est l'enfant direct du document. Pour les documents HTML, il s'agit normalement de l'élément {{HTMLElement("HTML")}}.</dd> - <dt>{{domxref("Document.documentURI")}} {{readonlyinline}}</dt> - <dd>retroune l'emplacement du document sous la forme d'une chaîne de caractères.</dd> - <dt>{{domxref("Document.domConfig")}} {{Deprecated_inline}}</dt> - <dd>devrait retourner un objet {{domxref("DOMConfiguration")}} .</dd> - <dt>{{domxref("Document.fullscreen")}} {{obsolete_inline}}</dt> - <dd><code>true</code> <em>(vrai)</em> quand le document est en {{domxref("Using_full-screen_mode","mode plein écran")}}.</dd> - <dt>{{domxref("Document.hidden")}} {{readonlyinline}}</dt> - <dd>...</dd> - <dt>{{domxref("Document.implementation")}} {{readonlyinline}}</dt> - <dd>Renvoie l'implémentation DOM associée au document courant.</dd> - <dt>{{domxref("Document.inputEncoding")}} {{readonlyinline}} {{Deprecated_inline}}</dt> - <dd>alias de {{domxref("Document.characterSet")}}. Utilisez cette propriété à la place.</dd> - <dt>{{domxref("Document.lastStyleSheetSet")}} {{readonlyinline}}</dt> - <dd>retourne le nom de l'ensemble de feuilles de style qui a été activé en dernier. A la valeur <code>null</code> jusqu'à ce que la feuille de style soit modifiée en définissant la valeur de {{domxref("document.selectedStyleSheetSet","selectedStyleSheetSet")}}.</dd> - <dt>{{domxref("Document.mozSyntheticDocument")}} {{non-standard_inline}} {{gecko_minversion_inline("8.0")}}</dt> - <dd>retourne un {{jsxref("Boolean")}} qui est <code>true</code> <em>(vrai)</em> seulement si le document est synthétique, tel qu'une image autonome, une vidéo, un fichier audio ou similaire.</dd> - <dt>{{domxref("Document.mozFullScreenElement")}} {{readonlyinline}} {{non-standard_inline}} {{gecko_minversion_inline("9.0")}}</dt> - <dd>L'élément qui est actuellement affiché en mode plein écran pour ce document.</dd> - <dt>{{domxref("Document.mozFullScreenEnabled")}} {{readonlyinline}} {{non-standard_inline}} {{gecko_minversion_inline("9.0")}}</dt> - <dd><code>true</code> <em>(vrai)</em> si l'appel {{domxref("Element.mozRequestFullscreen()")}} est réussi dans le document courant.</dd> - <dt>{{domxref("Document.pointerLockElement")}} {{readonlyinline}} {{experimental_inline}}</dt> - <dd>renvoie l'ensemble d'éléments en tant que cible pour les événements de la souris lorsque le pointeur est verrouillé. <code>null</code> si le verrouillage est en attente, le pointeur est déverrouillé ou la cible se trouve dans un autre document.</dd> - <dt>{{domxref("Document.preferredStyleSheetSet")}} {{readonlyinline}}</dt> - <dd>renvoie la page de style préférée spécifiée par l'auteur de la page.</dd> - <dt>{{domxref("Document.scrollingElement")}} {{experimental_inline}} {{readonlyinline}}</dt> - <dd>retourne une référence à l'{{domxref("Element")}} qui fait défiler le document.</dd> - <dt>{{domxref("Document.selectedStyleSheetSet")}}</dt> - <dd>renvoie la feuille de style actuellement utilisée.</dd> - <dt>{{domxref("Document.styleSheets")}} {{readonlyinline}}</dt> - <dd>Renvoie une liste de tous les objets {{domxref("stylesheet")}}<em> (feuilles de styles)</em> du document courant.</dd> - <dt>{{domxref("Document.timeline")}} {{readonlyinline}}</dt> - <dd>...</dd> - <dt>{{domxref("Document.undoManager")}} {{readonlyinline}} {{experimental_inline}}</dt> - <dd>...</dd> - <dt>{{domxref("Document.visibilityState")}} {{readonlyinline}}</dt> - <dd>renvoie une <code>string</code> <em>(chaîne de caractères)</em> indiquant l'état de visibilité du document. Les valeurs possibles sont <code>visible</code> , <code>hidden <em>(masqué)</em></code> , prerender <em>(pré-rendu)</em> et <code>unloaded</code> <em>(</em><em>déchargées</em>).</dd> - <dt>{{domxref("Document.xmlEncoding")}} {{Deprecated_inline}}</dt> - <dd>retourne le codage déterminé par une déclaration XML.</dd> - <dt>{{domxref("Document.xmlStandalone")}} {{obsolete_inline("10.0")}}</dt> - <dd>renvoie <code>true</code> si la déclaration XML précise que le document doit être autonome (par exemple, une partie externe de la DTD du contenu du document), sinon <code>false</code> <em>(faux)</em>.</dd> - <dt>{{domxref("Document.xmlVersion")}} {{obsolete_inline("10.0")}}</dt> - <dd>retourne le numéro de la version spécifié dans la déclaration XML ou <code>"1.0"</code> si la déclaration est absente.</dd> -</dl> - -<p>L'interface Document est étendue avec l'interface {{domxref("ParentNode")}} :</p> - -<p>{{page("/fr/docs/Web/API/ParentNode","Propriétés")}}</p> - -<h3 id="Extensions_du_document_HTML">Extensions du document HTML</h3> - -<p>L'interface Document, pour les documents HTML, hérite de l'interface <em>{{domxref("HTMLDocument")}}</em> ou depuis HTML5, est étendue pour eux.</p> - -<dl> - <dt>{{domxref("Document.activeElement")}} {{readonlyinline}}</dt> - <dd>Renvoie l'élément courant qui a la focus.</dd> - <dt>{{domxref("Document.alinkColor")}} {{Deprecated_inline}}</dt> - <dd>Renvoie ou définit la couleur des liens actifs du corps du document.</dd> - <dt>{{domxref("Document.anchors")}}</dt> - <dd>Renvoie une liste de toutes les ancres du document.</dd> - <dt>{{domxref("Document.applets")}} {{Deprecated_inline}}</dt> - <dd>Renvoie une liste ordonnée des "applets" du document.</dd> - <dt>{{domxref("Document.bgColor")}} {{Deprecated_inline}}</dt> - <dd><strong>bgColor</strong> renvoie ou définit la couleur d'arrière-plan du document courant.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.body")}}</dt> - <dd><strong>body</strong> renvoie l'élément {{HTMLElement("body")}} du document en cours.</dd> - <dt>{{domxref("Document.cookie")}}</dt> - <dd>Renvoie une liste des cookies du document, séparés par des points virgules, ou définit un cookie.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.defaultView")}} {{readonlyinline}}</dt> - <dd>Renvoie une référence à l'objet window.</dd> - <dt>{{domxref("Document.designMode")}}</dt> - <dd>renvoie ou définit les capacités d'édition du document entier.</dd> - <dt>{{domxref("Document.dir")}} {{readonlyinline}}</dt> - <dd>Assigne / renvoie le sens du texte (rtl/ltr) <em>(de gauche à droite / de droite à gauche)</em> du document.</dd> - <dt>{{domxref("Document.domain")}}</dt> - <dd>renvoie ou affecte le domaine de l'élément courant.</dd> - <dt>{{domxref("Document.embeds")}} {{readonlyinline}}</dt> - <dd>renvoie une liste des objets {{HTMLElement('embed')}} inclus dans le document courant.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.fgColor")}} {{Deprecated_inline}}</dt> - <dd>renvoie ou définit la couleur du texte du document courant.</dd> - <dt>{{domxref("Document.forms")}} {{readonlyinline}}</dt> - <dd><strong>forms</strong> renvoie une liste des éléments {{HTMLElement("form")}} du document courant</dd> - <dt>{{domxref("Document.head")}} {{readonlyinline}}</dt> - <dd>Renvoie l'élément {{HTMLElement("head")}} du document.</dd> - <dt>{{domxref("Document.height")}} {{non-standard_inline}} {{obsolete_inline}}</dt> - <dd>renvoie ou définit la hauteur du document courant.</dd> - <dt>{{domxref("Document.images")}} {{readonlyinline}}</dt> - <dd>renvoie une liste des images du document courant.</dd> - <dt>{{domxref("Document.lastModified")}} {{readonlyinline}}</dt> - <dd>Renvoie la date de dernière modification du document.</dd> - <dt>{{domxref("Document.linkColor")}} {{Deprecated_inline}}</dt> - <dd>Renvoie ou définit la couleur des liens du document.</dd> - <dt>{{domxref("Document.links")}} {{readonlyinline}}</dt> - <dd>Renvoie un tableau de tous les liens du document.</dd> - <dt>{{domxref("Document.location")}} {{readonlyinline}}</dt> - <dd>Renvoie l'URI (Uniform Ressource Identifier : <em>identifiant uniforme de ressource</em>) du document courant.</dd> - <dt>{{domxref("Document.plugins")}} {{readonlyinline}}</dt> - <dd>Renvoie une liste des plugins disponibles.</dd> - <dt>{{domxref("Document.readyState")}} {{readonlyinline}} {{gecko_minversion_inline("1.9.2")}}</dt> - <dd>retourne l'état du chargement du document.</dd> - <dt>{{domxref("Document.referrer")}} {{readonlyinline}}</dt> - <dd>Renvoie l'URI de la page qui a amené à cette page.</dd> - <dt>{{domxref("Document.scripts")}} {{readonlyinline}}</dt> - <dd>renvoie tous les éléments {{HTMLElement("script")}} sur le document.</dd> - <dt>{{domxref("Document.title")}}</dt> - <dd>Renvoie le titre du document courant.</dd> - <dt>{{domxref("Document.URL")}} {{readonlyInline}}</dt> - <dd>Renvoie une chaîne de caractères contenant l'URL ("Uniform Resource Locator", <em>repère uniforme de ressource</em>) du document courant.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.vlinkColor")}} {{Deprecated_inline}}</dt> - <dd>Renvoie ou définit la couleur des liens visités du document.</dd> - <dt>{{domxref("Document.width")}} {{non-standard_inline}} {{obsolete_inline}}</dt> - <dd>Renvoie la largeur du document courant.</dd> -</dl> - -<h3 id="Gestionnaire_d'évènements">Gestionnaire d'évènements</h3> - -<dl> - <dt>{{domxref("Document.onafterscriptexecute")}} {{non-standard_inline}}</dt> - <dd>représente le code de gestion d'évènements pour l'évènement {{event("afterscriptexecute")}}</dd> - <dt>{{domxref("Document.onbeforescriptexecute")}} {{non-standard_inline}}</dt> - <dd>retourne le code de gestion d'évènements pour l'évènement {{event("beforescriptexecute")}} .</dd> - <dt>{{domxref("Document.oncopy")}} {{non-standard_inline}}</dt> - <dd>représente le code de gestion d'évènements pour l'évènement {{event("copy")}} .</dd> - <dt>{{domxref("Document.oncut")}} {{non-standard_inline}}</dt> - <dd>représente le code de gestion d'évènements pour l'évènement {{event("cut")}} .</dd> - <dt>{{domxref("Document.onfullscreenchange")}}</dt> - <dd>est un {{event("Event_handlers", "event handler")}} <em>( gestionnaire d'évènements)</em> représentant le code à appeler quand l'élément {{event("fullscreenchange")}} est relevé.</dd> - <dt>{{domxref("Document.onfullscreenerror")}}</dt> - <dt>{{domxref("Document.onfullscreenchange")}}</dt> - <dd>est un {{event("Event_handlers", "event handler")}} <em>( gestionnaire d'évènements)</em> représentant le code à appeler quand l'élément {{event("fullscreenerror")}} est relevé.</dd> - <dt>{{domxref("Document.onpaste")}} {{non-standard_inline}}</dt> - <dd>représente le code de gestion d'évènements pour l'évènement {{event("paste")}} .</dd> - <dt>{{domxref("Document.onpointerlockchange")}} {{experimental_inline}}</dt> - <dd>représente le code de gestion d'évènements pour l'évènement {{event("pointerlockchange")}} .</dd> - <dt>{{domxref("Document.onpointerlockerror")}} {{experimental_inline}}</dt> - <dd>représente le code de gestion d'évènements pour l'évènement {{event("pointerlockerror")}} .</dd> - <dt>{{domxref("Document.onreadystatechange")}} {{gecko_minversion_inline("1.9.2")}}</dt> - <dd>représente le code de gestion d'évènements pour l'évènement {{event("readystatechange")}} .</dd> - <dt>{{domxref("Document.onselectionchange")}} {{experimental_inline}}</dt> - <dd>est un {{event("Event_handlers", "event handler")}} <em>( gestionnaire d'évènements)</em> représentant le code à appeler quand l'élément {{event("selectionchange")}} est relevé.</dd> - <dt>{{domxref("Document.onvisibilitychange")}}</dt> - <dd>est un {{event("Event_handlers", "event handler")}} <em>( gestionnaire d'évènements)</em> représentant le code à appeler quand l'élément {{event("visibilitychange")}} est relevé.</dd> - <dt>{{domxref("Document.onwheel")}} {{non-standard_inline}}</dt> - <dd>représente le code de gestion d'évènements pour l'évènement {{event("wheel")}} .</dd> -</dl> - -<p>L'interface <code>Document</code> est étendue avec l'interface {{domxref("GlobalEventHandlers")}} :</p> - -<p>{{Page("/fr/docs/Web/API/GlobalEventHandlers", "Propriétés")}}</p> - -<h2 id="Méthodes">Méthodes</h2> - -<p><em>Cette interface hérite également des interfaces {{domxref ("Node")}} et {{domxref ("EventTarget")}}.</em></p> - -<dl> - <dt>{{domxref("Document.adoptNode()")}}</dt> - <dd>adopte le noeud d'un document externe.</dd> - <dt>{{domxref("Document.captureEvents()")}} {{Deprecated_inline}}</dt> - <dd>voir {{domxref("Window.captureEvents")}}.</dd> - <dt>{{domxref("Document.caretPositionFromPoint()")}}{{experimental_inline}}</dt> - <dd>obtient le {{domxref ("CaretPosition")}} aux ou près des coordonnées spécifiées.</dd> - <dt>{{domxref("Document.caretRangeFromPoint()")}}{{non-standard_inline}}</dt> - <dd>Obtient un objet {{Domxref ("Range")}} pour le fragment de document sous les coordonnées spécifiées.</dd> - <dt>{{domxref("Document.createAttribute()")}}</dt> - <dd>Crée un nouvel objet {{domxref("Attr")}} et le renvoie.</dd> - <dt>{{domxref("Document.createAttributeNS()")}}</dt> - <dd>Crée un nouveau noeud dans l'espace nom donné et le renvoie.</dd> - <dt>{{domxref("Document.createCDATASection()")}}</dt> - <dd>Crée un nouveau nœud CDATA et le renvoie.</dd> - <dt>{{domxref("Document.createComment()")}}</dt> - <dd>Crée un nouveau nœud de commentaire et le renvoie.</dd> - <dt>{{domxref("Document.createDocumentFragment()")}}</dt> - <dd>Crée un nouveau fragment de document.</dd> - <dt>{{domxref("Document.createElement()")}}</dt> - <dd>Crée un nouvel élément avec l'étiquette spécifiée.</dd> - <dt>{{domxref("Document.createElementNS()")}}</dt> - <dd>Crée un nouvel élément du type et avec l'URI d'espace de nom spécifiés.</dd> - <dt>{{domxref("Document.createEntityReference()")}} {{obsolete_inline}}</dt> - <dd>Crée un nouvel objet de référence à une entité et le renvoie.</dd> - <dt>{{domxref("Document.createEvent()")}}</dt> - <dd>Crée un nouvel évènement.</dd> - <dt>{{domxref("Document.createNodeIterator()")}}</dt> - <dd>crée un objet {{domxref("NodeIterator")}} .</dd> - <dt>{{domxref("Document.createProcessingInstruction()")}}</dt> - <dd>crée un nouvel objet {{domxref("ProcessingInstruction")}} .</dd> - <dt>{{domxref("Document.createRange()")}}</dt> - <dd>Crée un objet {{domxref("Range")}} .</dd> - <dt>{{domxref("Document.createTextNode()")}}</dt> - <dd>Crée un nœud de texte.</dd> - <dt>{{domxref("Document.createTouch()")}} {{Deprecated_inline}}</dt> - <dd>crée un objet {{domxref("Touch")}}</dd> - <dt>{{domxref("Document.createTouchList()")}}</dt> - <dd>crée un objet {{domxref("TouchList")}}</dd> - <dt>{{domxref("Document.createTreeWalker()")}}</dt> - <dd>Crée un objet {{domxref("TreeWalker")}} .</dd> - <dt>{{domxref("Document.elementFromPoint()")}}{{experimental_inline}}</dt> - <dd>Renvoie l'élément visible aux coordonnées spécifiées.</dd> - <dt>{{domxref("Document.elementsFromPoint()")}}{{experimental_inline}}</dt> - <dd>Renvoie un tableau de tous les éléments aux coordonnées spécifiées.</dd> - <dt>{{domxref("Document.enableStyleSheetsForSet()")}}</dt> - <dd>active les feuilles de style pour l'ensemble de feuilles de style spécifié.</dd> - <dt>{{domxref("Document.exitPointerLock()")}} {{experimental_inline}}</dt> - <dd>Supprime le verrou du pointeur.</dd> - <dt>{{domxref("Document.getAnimations()")}} {{experimental_inline}}</dt> - <dd>retourne un tableau de tous les objets {{domxref("Animation")}} actuels, dont les éléments cibles sont les descendants de ce <code>document</code>.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.getElementsByClassName()")}}</dt> - <dd>Renvoie une liste des éléments ayant le nom de classe donné.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.getElementsByTagName()")}}</dt> - <dd>Renvoie une liste des éléments ayant le nom de balise donné.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.getElementsByTagNameNS()")}}</dt> - <dd>Renvoie une liste des éléments du nom de balise et de l'espace de noms spécifiés.</dd> -</dl> - -<dl> - <dt>{{domxref("Document.importNode()")}}</dt> - <dd>Renvoie une copie (un clone) d'un élément provenant d'un document externe.</dd> - <dt>{{domxref("Document.normalizeDocument()")}} {{obsolete_inline}}</dt> - <dd>remplace les entités, normalise les noeuds de texte, etc.</dd> - <dt>{{domxref("Document.registerElement()")}} {{experimental_inline}}</dt> - <dd>Enregistre un composant Web.</dd> - <dt>{{domxref("Document.releaseCapture()")}} {{non-standard_inline}} {{gecko_minversion_inline("2.0")}}</dt> - <dd>Libère la capture de la souris en cours s'il s'agit d'un élément de ce document.</dd> - <dt>{{domxref("Document.releaseEvents()")}} {{non-standard_inline}} {{Deprecated_inline}}</dt> - <dd>voir {{domxref("Window.releaseEvents()")}}.</dd> - <dt>{{domxref("Document.routeEvent()")}} {{non-standard_inline}} {{obsolete_inline(24)}}</dt> - <dd>Voir {{domxref("Window.routeEvent()")}}.</dd> - <dt>{{domxref("Document.mozSetImageElement()")}} {{non-standard_inline}} {{gecko_minversion_inline("2.0")}}</dt> - <dd>Vous permet de modifier l'élément utilisé comme image d'arrière-plan pour un ID d'élément spécifié.</dd> -</dl> - -<p>L'interface <code>Document</code> est étendue avec l'interface {{domxref("ParentNode")}} :</p> - -<dl> - <dt>{{domxref("document.getElementById","document.getElementById(String id)")}}</dt> - <dd>retourne une référence d'objet à l'élément identifié.</dd> - <dt>{{domxref("document.querySelector","document.querySelector(String selector)")}} {{gecko_minversion_inline("1.9.1")}}</dt> - <dd>Renvoie le premier noeud <code>Element</code> dans le document, dans l'ordre du document, qui correspond aux sélecteurs spécifiés.</dd> - <dt>{{domxref("document.querySelectorAll","document.querySelectorAll(String selector)")}} {{gecko_minversion_inline("1.9.1")}}</dt> - <dd>retourne une liste de tous les noeuds éléments inclus dans le document qui correspondent aux sélecteurs spécifiés.</dd> -</dl> - -<p>L'interface Document est étendue avec l'interface {{domxref("XPathEvaluator")}} :</p> - -<dl> - <dt>{{domxref("document.createExpression","document.createExpression(String expression, XPathNSResolver resolver)")}}</dt> - <dd>compile une <code><a href="/fr/docs/Web/API/XPathExpression">XPathExpression</a></code> qui peut ensuite être utilisée pour des évaluations (répétées).</dd> - <dt>{{domxref("document.createNSResolver","document.createNSResolver(Node resolver)")}}</dt> - <dd>crée un objet {{domxref("XPathNSResolver")}} .</dd> - <dt>{{domxref("document.evaluate","document.evaluate(String expression, Node contextNode, XPathNSResolver resolver, Number type, Object result)")}}</dt> - <dd>évalue l'expression XPath .</dd> -</dl> - -<h3 id="Extensions_pour_les_documents_HTML">Extensions pour les documents HTML</h3> - -<dl> - <dt>{{domxref("document.clear()")}} {{non-standard_inline}} {{Deprecated_inline}}</dt> - <dd>dans la majorité des navigateurs modernes, y compris les versions récentes de Firefox et Internet Explorer, cette méthode ne fait rien.</dd> - <dt>{{domxref("document.close()")}}</dt> - <dd>ferme un flux de document pour l'écriture.</dd> - <dt>{{domxref("document.execCommand","document.execCommand(String command[, Boolean showUI[, String value]])")}}</dt> - <dd>Sur un document modifiable, exécute une commande de formatage.</dd> - <dt>{{domxref("document.getElementsByName","document.getElementsByName(String name)")}}</dt> - <dd>retourne une liste d'éléments ayant le nom donné.</dd> - <dt>{{domxref("document.getSelection()")}}</dt> - <dd>retourne un objet {{domxref("Selection")}} relatif au texte sélectionné dans le document.</dd> - <dt>{{domxref("document.hasFocus()")}}</dt> - <dd>retourne <code>true</code> (vrai) si le focus est actuellement localisé n'importe où sur le document spécifié.</dd> - <dt>{{domxref("document.open()")}}</dt> - <dd>Ouvre un flux pour l'écriture dans le document.</dd> - <dt>{{domxref("document.queryCommandEnabled","document.queryCommandEnabled(String command)")}}</dt> - <dd>Renvoie <code>true</code> si la commande de formatage peut être exécutée sur la plage courante.</dd> - <dt>{{domxref("document.queryCommandIndeterm","document.queryCommandIndeterm(String command)")}}</dt> - <dd>Renvoie <code>true</code> si la commande de formatage est dans un état indéterminé sur la plage courante.</dd> - <dt>{{domxref("document.queryCommandState","document.queryCommandState(String command)")}}</dt> - <dd>Renvoie <code>true</code> si la commande de formatage a été exécutée sur la plage courante.</dd> - <dt>{{domxref("document.queryCommandSupported","document.queryCommandSupported(String command)")}}</dt> - <dd>retourne <code>true</code> <em>(vrai)</em> si la commande de formatage est supportée sur la plage courante.</dd> - <dt>{{domxref("document.queryCommandValue","document.queryCommandValue(String command)")}}</dt> - <dd>renvoie la valeur courante de la plage en cours pour une commande de formatage.</dd> - <dt>{{domxref("document.write","document.write(String text)")}}</dt> - <dd>Écrit du texte dans le document.</dd> - <dt>{{domxref("document.writeln","document.writeln(String text)")}}</dt> - <dd>Écrit une ligne de texte dans le document.</dd> -</dl> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('Page Visibility API', '#onvisiblitychange-event-handler', 'onvisibilitychange')}}</td> - <td>{{Spec2('Page Visibility API')}}</td> - <td>Ajoute <code>onvisibilitychange.</code></td> - </tr> - <tr> - <td>{{SpecName('Selection API', '', 'Extend Document and GlobalEventHandlers')}}</td> - <td>{{Spec2('Selection API')}}</td> - <td>Ajoute <code>onselectstart</code>et <code>onselectionchange</code>.</td> - </tr> - <tr> - <td>{{SpecName('DOM1','#i-Document','Document')}}</td> - <td>{{Spec2('DOM1')}}</td> - <td>Définition initiale pour l'interface</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Core','#i-Document','Document')}}</td> - <td>{{Spec2('DOM2 Core')}}</td> - <td>Remplace DOM 1</td> - </tr> - <tr> - <td>{{SpecName('DOM3 Core','#i-Document','Document')}}</td> - <td>{{Spec2('DOM3 Core')}}</td> - <td>remplace DOM 2</td> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG','#interface-document','Document')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>en vue de remplacer DOM 3</td> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG','dom.html#the-document-object','Document')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Transforme l'interface {{domxref("HTMLDocument")}} en une extension de <code>Document</code></td> - </tr> - <tr> - <td>{{SpecName('DOM3 XPath','xpath.html#XPathEvaluator','XPathEvaluator')}}</td> - <td>{{Spec2('DOM3 XPath')}}</td> - <td>Definit l'interface {{domxref("XPathEvaluator")}} qui étend le document.</td> - </tr> - <tr> - <td>{{SpecName('Page Visibility API', '#sec-document-interface', 'Document')}}</td> - <td>{{Spec2('Page Visibility API')}}</td> - <td>Étend l'interface <code>Document</code> avec les attributs <code>visibilityState</code> et <code>hidden</code>.</td> - </tr> - <tr> - <td>{{SpecName('HTML Editing','#dom-document-getselection','Document')}}</td> - <td>{{Spec2('HTML Editing')}}</td> - <td>Étend l'interface <code>Document</code></td> - </tr> - <tr> - <td>{{SpecName('CSSOM View','#extensions-to-the-document-interface','Document')}}</td> - <td>{{Spec2('CSSOM View')}}</td> - <td>Étend l'interface <code>Document</code></td> - </tr> - <tr> - <td>{{SpecName('CSSOM','#extensions-to-the-document-interface','Document')}}</td> - <td>{{Spec2('CSSOM')}}</td> - <td>Étend l'interface <code>Document</code></td> - </tr> - <tr> - <td>{{SpecName('Pointer Lock','#extensions-to-the-document-interface','Document')}}</td> - <td>{{Spec2('Pointer Lock')}}</td> - <td>Étend l'interface <code>Document</code></td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs_notes">Compatibilité des navigateurs notes</h2> - -<h3 id="Notes_concernant_Firefox">Notes concernant Firefox :</h3> - -<p>Mozilla définit un ensemble de propriétés non-standard créées seulement pour le contenu XUL :</p> - -<dl> - <dt>{{domxref("document.currentScript")}} {{non-standard_inline}} {{gecko_minversion_inline("2.0")}}</dt> - <dd>retourne l'élément {{HTMLElement("script")}} qui est en cours d'exécution.</dd> - <dt>{{domxref("document.documentURIObject")}} {{gecko_minversion_inline("1.9")}}</dt> - <dd>(extensions Mozilla seulement) retourne l'objet {{Interface("nsIURI")}} représentant l'URI du document. Cette propriété a seulement une signification spéciale dans le code JavaScript privilégié (avec les privilèges UniversalXPConnect).</dd> - <dt>{{domxref("document.popupNode")}}</dt> - <dd>retourne le noeud ouvert lors de l'appel d'une fenêtre contextuelle.</dd> - <dt>{{domxref("document.tooltipNode")}}</dt> - <dd>retourne le noeud qui est la cible de l'info-bulle actuelle.</dd> -</dl> - -<p>Mozilla a également défini quelques méthodes non standard :</p> - -<dl> - <dt>{{domxref("document.execCommandShowHelp")}} {{obsolete_inline("14.0")}}</dt> - <dd>Cette méthode n'a jamais rien fait et a toujours lancé une exception, elle a donc été supprimée dans Gecko 14.0 {{geckoRelease ("14.0")}}.</dd> - <dt>{{domxref("document.getBoxObjectFor")}} {{obsolete_inline}}</dt> - <dd>Utiliser la méthode {{domxref("Element.getBoundingClientRect()")}} à la place.</dd> - <dt>{{domxref("document.loadOverlay")}}</dt> - <dd>charge dynamiquement un <a href="/fr/docs/Overlays_XUL">XUL overlay</a> . Celui-ci fonctionne seulement dans les documents XUL.</dd> - <dt>{{domxref("document.queryCommandText")}} {{obsolete_inline("14.0")}}</dt> - <dd>Cette méthode n'a jamais rien fait d'autre que de lancer une exception, elle a donc été supprimée dans Gecko 14.0 {{geckoRelease ("14.0")}}.</dd> -</dl> - -<h3 id="Notes_concernant_Internet_Explorer">Notes concernant Internet Explorer</h3> - -<p>Microsoft a défini quelques propriétés non standard :</p> - -<dl> - <dt>{{domxref("document.fileSize")}}* {{non-standard_inline}} {{obsolete_inline}}</dt> - <dd>Retourne la taille en octets du document. À partir d'Internet Explorer 11, cette propriété n'est plus prise en charge. Voir <a href="http://msdn.microsoft.com/en-us/library/ms533752%28v=VS.85%29.aspx">MSDN</a>.</dd> -</dl> - -<p>Internet Explorer ne prend pas en charge toutes les méthodes de l'interface Node dans l'interface Document :</p> - -<dl> - <dt>{{domxref("document.contains")}}</dt> - <dd>Pour contourner le problème, <code>document.body.contains ()</code> peut être utilisé.</dd> -</dl> +{{ApiRef}} + +L'interface **`Document`** représente n'importe quelle page Web chargée dans le navigateur et sert de point d'entrée dans le contenu de la page Web, qui est l'arborescence DOM. L'arborescence DOM inclut des éléments tels que {{HTMLElement ("body")}} _(corps)_ et {{HTMLElement ("table")}} _(tableau)_, parmi beaucoup d'autres. Il fournit des fonctionnalités globales au document, comme le moyen d'obtenir l'URL de la page et de créer de nouveaux éléments dans le document. + +{{inheritanceDiagram}} + +L'interface Document décrit les propriétés et méthodes communes à tout type de document. En fonction du type de document (HTML, XML, SVG, ...), une API plus grande est disponible : les documents HTML, servis avec le type `text/html`, implémentent également l'interface {{domxref ("HTMLDocument")}}, alors que les documents XML et SVG implémentent l'interface {{domxref ("XMLDocument")}}. + +## Constructeur + +- {{domxref("Document.Document","Document()")}}{{non-standard_inline}} + - : crée un nouvel objet `Document` . + +## Propriétés + +_Cette interface hérite aussi des interfaces {{domxref("Node")}} et {{domxref("EventTarget")}} ._ + +- {{domxref("Document.all")}} {{Deprecated_inline}} {{non-standard_inline}} + - : fournit un accès à tous les éléments du document. C'est une interface héritée non standard qui ne doit pas être utilisée. + +<!----> + +- {{domxref("Document.async")}} {{Deprecated_inline}} + - : utilisé avec {{domxref("document.load")}} pour indiquer une requête asynchrone. + +<!----> + +- {{domxref("Document.characterSet")}} {{readonlyinline}} {{Deprecated_inline}} + - : renvoie le jeu de caractères utilisé par le document. + +<!----> + +- {{domxref("Document.compatMode")}} {{readonlyinline}} {{experimental_inline}} + - : indique si le document est rendu en mode _Quirks_ ou _Strict_. + +<!----> + +- {{domxref("Document.contentType")}} {{readonlyinline}} {{experimental_inline}} + - : Renvoie le type de contenu de l'en-tête MIME du document courant. + +<!----> + +- {{domxref("Document.doctype")}} {{readonlyinline}} + - : Renvoie le DTD (Document Type Definition) du document courant. + +<!----> + +- {{domxref("Document.documentElement")}} {{readonlyinline}} + - : Renvoie l'{{domxref("Element")}} qui est l'enfant direct du document. Pour les documents HTML, il s'agit normalement de l'élément {{HTMLElement("HTML")}}. +- {{domxref("Document.documentURI")}} {{readonlyinline}} + - : retroune l'emplacement du document sous la forme d'une chaîne de caractères. +- {{domxref("Document.domConfig")}} {{Deprecated_inline}} + - : devrait retourner un objet {{domxref("DOMConfiguration")}} . +- {{domxref("Document.fullscreen")}} {{obsolete_inline}} + - : `true` _(vrai)_ quand le document est en {{domxref("Using_full-screen_mode","mode plein écran")}}. +- {{domxref("Document.hidden")}} {{readonlyinline}} + - : ... +- {{domxref("Document.implementation")}} {{readonlyinline}} + - : Renvoie l'implémentation DOM associée au document courant. +- {{domxref("Document.inputEncoding")}} {{readonlyinline}} {{Deprecated_inline}} + - : alias de {{domxref("Document.characterSet")}}. Utilisez cette propriété à la place. +- {{domxref("Document.lastStyleSheetSet")}} {{readonlyinline}} + - : retourne le nom de l'ensemble de feuilles de style qui a été activé en dernier. A la valeur `null` jusqu'à ce que la feuille de style soit modifiée en définissant la valeur de {{domxref("document.selectedStyleSheetSet","selectedStyleSheetSet")}}. +- {{domxref("Document.mozSyntheticDocument")}} {{non-standard_inline}} {{gecko_minversion_inline("8.0")}} + - : retourne un {{jsxref("Boolean")}} qui est `true` _(vrai)_ seulement si le document est synthétique, tel qu'une image autonome, une vidéo, un fichier audio ou similaire. +- {{domxref("Document.mozFullScreenElement")}} {{readonlyinline}} {{non-standard_inline}} {{gecko_minversion_inline("9.0")}} + - : L'élément qui est actuellement affiché en mode plein écran pour ce document. +- {{domxref("Document.mozFullScreenEnabled")}} {{readonlyinline}} {{non-standard_inline}} {{gecko_minversion_inline("9.0")}} + - : `true` _(vrai)_ si l'appel {{domxref("Element.mozRequestFullscreen()")}} est réussi dans le document courant. +- {{domxref("Document.pointerLockElement")}} {{readonlyinline}} {{experimental_inline}} + - : renvoie l'ensemble d'éléments en tant que cible pour les événements de la souris lorsque le pointeur est verrouillé. `null` si le verrouillage est en attente, le pointeur est déverrouillé ou la cible se trouve dans un autre document. +- {{domxref("Document.preferredStyleSheetSet")}} {{readonlyinline}} + - : renvoie la page de style préférée spécifiée par l'auteur de la page. +- {{domxref("Document.scrollingElement")}} {{experimental_inline}} {{readonlyinline}} + - : retourne une référence à l'{{domxref("Element")}} qui fait défiler le document. +- {{domxref("Document.selectedStyleSheetSet")}} + - : renvoie la feuille de style actuellement utilisée. +- {{domxref("Document.styleSheets")}} {{readonlyinline}} + - : Renvoie une liste de tous les objets {{domxref("stylesheet")}} _(feuilles de styles)_ du document courant. +- {{domxref("Document.timeline")}} {{readonlyinline}} + - : ... +- {{domxref("Document.undoManager")}} {{readonlyinline}} {{experimental_inline}} + - : ... +- {{domxref("Document.visibilityState")}} {{readonlyinline}} + - : renvoie une `string` _(chaîne de caractères)_ indiquant l'état de visibilité du document. Les valeurs possibles sont `visible` , `hidden (masqué)` , prerender _(pré-rendu)_ et `unloaded` _(\*\*déchargées_). +- {{domxref("Document.xmlEncoding")}} {{Deprecated_inline}} + - : retourne le codage déterminé par une déclaration XML. +- {{domxref("Document.xmlStandalone")}} {{obsolete_inline("10.0")}} + - : renvoie `true` si la déclaration XML précise que le document doit être autonome (par exemple, une partie externe de la DTD du contenu du document), sinon `false` _(faux)_. +- {{domxref("Document.xmlVersion")}} {{obsolete_inline("10.0")}} + - : retourne le numéro de la version spécifié dans la déclaration XML ou `"1.0"` si la déclaration est absente. + +L'interface Document est étendue avec l'interface {{domxref("ParentNode")}} : + +{{page("/fr/docs/Web/API/ParentNode","Propriétés")}} + +### Extensions du document HTML + +L'interface Document, pour les documents HTML, hérite de l'interface *{{domxref("HTMLDocument")}}* ou depuis HTML5, est étendue pour eux. + +- {{domxref("Document.activeElement")}} {{readonlyinline}} + - : Renvoie l'élément courant qui a la focus. +- {{domxref("Document.alinkColor")}} {{Deprecated_inline}} + - : Renvoie ou définit la couleur des liens actifs du corps du document. +- {{domxref("Document.anchors")}} + - : Renvoie une liste de toutes les ancres du document. +- {{domxref("Document.applets")}} {{Deprecated_inline}} + - : Renvoie une liste ordonnée des "applets" du document. +- {{domxref("Document.bgColor")}} {{Deprecated_inline}} + - : **bgColor** renvoie ou définit la couleur d'arrière-plan du document courant. + +<!----> + +- {{domxref("Document.body")}} + - : **body** renvoie l'élément {{HTMLElement("body")}} du document en cours. +- {{domxref("Document.cookie")}} + - : Renvoie une liste des cookies du document, séparés par des points virgules, ou définit un cookie. + +<!----> + +- {{domxref("Document.defaultView")}} {{readonlyinline}} + - : Renvoie une référence à l'objet window. +- {{domxref("Document.designMode")}} + - : renvoie ou définit les capacités d'édition du document entier. +- {{domxref("Document.dir")}} {{readonlyinline}} + - : Assigne / renvoie le sens du texte (rtl/ltr) _(de gauche à droite / de droite à gauche)_ du document. +- {{domxref("Document.domain")}} + - : renvoie ou affecte le domaine de l'élément courant. +- {{domxref("Document.embeds")}} {{readonlyinline}} + - : renvoie une liste des objets {{HTMLElement('embed')}} inclus dans le document courant. + +<!----> + +- {{domxref("Document.fgColor")}} {{Deprecated_inline}} + - : renvoie ou définit la couleur du texte du document courant. +- {{domxref("Document.forms")}} {{readonlyinline}} + - : **forms** renvoie une liste des éléments {{HTMLElement("form")}} du document courant +- {{domxref("Document.head")}} {{readonlyinline}} + - : Renvoie l'élément {{HTMLElement("head")}} du document. +- {{domxref("Document.height")}} {{non-standard_inline}} {{obsolete_inline}} + - : renvoie ou définit la hauteur du document courant. +- {{domxref("Document.images")}} {{readonlyinline}} + - : renvoie une liste des images du document courant. +- {{domxref("Document.lastModified")}} {{readonlyinline}} + - : Renvoie la date de dernière modification du document. +- {{domxref("Document.linkColor")}} {{Deprecated_inline}} + - : Renvoie ou définit la couleur des liens du document. +- {{domxref("Document.links")}} {{readonlyinline}} + - : Renvoie un tableau de tous les liens du document. +- {{domxref("Document.location")}} {{readonlyinline}} + - : Renvoie l'URI (Uniform Ressource Identifier : _identifiant uniforme de ressource_) du document courant. +- {{domxref("Document.plugins")}} {{readonlyinline}} + - : Renvoie une liste des plugins disponibles. +- {{domxref("Document.readyState")}} {{readonlyinline}} {{gecko_minversion_inline("1.9.2")}} + - : retourne l'état du chargement du document. +- {{domxref("Document.referrer")}} {{readonlyinline}} + - : Renvoie l'URI de la page qui a amené à cette page. +- {{domxref("Document.scripts")}} {{readonlyinline}} + - : renvoie tous les éléments {{HTMLElement("script")}} sur le document. +- {{domxref("Document.title")}} + - : Renvoie le titre du document courant. +- {{domxref("Document.URL")}} {{readonlyInline}} + - : Renvoie une chaîne de caractères contenant l'URL ("Uniform Resource Locator", _repère uniforme de ressource_) du document courant. + +<!----> + +- {{domxref("Document.vlinkColor")}} {{Deprecated_inline}} + - : Renvoie ou définit la couleur des liens visités du document. +- {{domxref("Document.width")}} {{non-standard_inline}} {{obsolete_inline}} + - : Renvoie la largeur du document courant. + +### Gestionnaire d'évènements + +- {{domxref("Document.onafterscriptexecute")}} {{non-standard_inline}} + - : représente le code de gestion d'évènements pour l'évènement {{event("afterscriptexecute")}} +- {{domxref("Document.onbeforescriptexecute")}} {{non-standard_inline}} + - : retourne le code de gestion d'évènements pour l'évènement {{event("beforescriptexecute")}} . +- {{domxref("Document.oncopy")}} {{non-standard_inline}} + - : représente le code de gestion d'évènements pour l'évènement {{event("copy")}} . +- {{domxref("Document.oncut")}} {{non-standard_inline}} + - : représente le code de gestion d'évènements pour l'évènement {{event("cut")}} . +- {{domxref("Document.onfullscreenchange")}} + - : est un {{event("Event_handlers", "event handler")}} _( gestionnaire d'évènements)_ représentant le code à appeler quand l'élément {{event("fullscreenchange")}} est relevé. +- {{domxref("Document.onfullscreenerror")}} + + {{domxref("Document.onfullscreenchange")}} + + - : est un {{event("Event_handlers", "event handler")}} _( gestionnaire d'évènements)_ représentant le code à appeler quand l'élément {{event("fullscreenerror")}} est relevé. + +- {{domxref("Document.onpaste")}} {{non-standard_inline}} + - : représente le code de gestion d'évènements pour l'évènement {{event("paste")}} . +- {{domxref("Document.onpointerlockchange")}} {{experimental_inline}} + - : représente le code de gestion d'évènements pour l'évènement {{event("pointerlockchange")}} . +- {{domxref("Document.onpointerlockerror")}} {{experimental_inline}} + - : représente le code de gestion d'évènements pour l'évènement {{event("pointerlockerror")}} . +- {{domxref("Document.onreadystatechange")}} {{gecko_minversion_inline("1.9.2")}} + - : représente le code de gestion d'évènements pour l'évènement {{event("readystatechange")}} . +- {{domxref("Document.onselectionchange")}} {{experimental_inline}} + - : est un {{event("Event_handlers", "event handler")}} _( gestionnaire d'évènements)_ représentant le code à appeler quand l'élément {{event("selectionchange")}} est relevé. +- {{domxref("Document.onvisibilitychange")}} + - : est un {{event("Event_handlers", "event handler")}} _( gestionnaire d'évènements)_ représentant le code à appeler quand l'élément {{event("visibilitychange")}} est relevé. +- {{domxref("Document.onwheel")}} {{non-standard_inline}} + - : représente le code de gestion d'évènements pour l'évènement {{event("wheel")}} . + +L'interface `Document` est étendue avec l'interface {{domxref("GlobalEventHandlers")}} : + +{{Page("/fr/docs/Web/API/GlobalEventHandlers", "Propriétés")}} + +## Méthodes + +_Cette interface hérite également des interfaces {{domxref ("Node")}} et {{domxref ("EventTarget")}}._ + +- {{domxref("Document.adoptNode()")}} + - : adopte le noeud d'un document externe. +- {{domxref("Document.captureEvents()")}} {{Deprecated_inline}} + - : voir {{domxref("Window.captureEvents")}}. +- {{domxref("Document.caretPositionFromPoint()")}}{{experimental_inline}} + - : obtient le {{domxref ("CaretPosition")}} aux ou près des coordonnées spécifiées. +- {{domxref("Document.caretRangeFromPoint()")}}{{non-standard_inline}} + - : Obtient un objet {{Domxref ("Range")}} pour le fragment de document sous les coordonnées spécifiées. +- {{domxref("Document.createAttribute()")}} + - : Crée un nouvel objet {{domxref("Attr")}} et le renvoie. +- {{domxref("Document.createAttributeNS()")}} + - : Crée un nouveau noeud dans l'espace nom donné et le renvoie. +- {{domxref("Document.createCDATASection()")}} + - : Crée un nouveau nœud CDATA et le renvoie. +- {{domxref("Document.createComment()")}} + - : Crée un nouveau nœud de commentaire et le renvoie. +- {{domxref("Document.createDocumentFragment()")}} + - : Crée un nouveau fragment de document. +- {{domxref("Document.createElement()")}} + - : Crée un nouvel élément avec l'étiquette spécifiée. +- {{domxref("Document.createElementNS()")}} + - : Crée un nouvel élément du type et avec l'URI d'espace de nom spécifiés. +- {{domxref("Document.createEntityReference()")}} {{obsolete_inline}} + - : Crée un nouvel objet de référence à une entité et le renvoie. +- {{domxref("Document.createEvent()")}} + - : Crée un nouvel évènement. +- {{domxref("Document.createNodeIterator()")}} + - : crée un objet {{domxref("NodeIterator")}} . +- {{domxref("Document.createProcessingInstruction()")}} + - : crée un nouvel objet {{domxref("ProcessingInstruction")}} . +- {{domxref("Document.createRange()")}} + - : Crée un objet {{domxref("Range")}} . +- {{domxref("Document.createTextNode()")}} + - : Crée un nœud de texte. +- {{domxref("Document.createTouch()")}} {{Deprecated_inline}} + - : crée un objet {{domxref("Touch")}} +- {{domxref("Document.createTouchList()")}} + - : crée un objet {{domxref("TouchList")}} +- {{domxref("Document.createTreeWalker()")}} + - : Crée un objet {{domxref("TreeWalker")}} . +- {{domxref("Document.elementFromPoint()")}}{{experimental_inline}} + - : Renvoie l'élément visible aux coordonnées spécifiées. +- {{domxref("Document.elementsFromPoint()")}}{{experimental_inline}} + - : Renvoie un tableau de tous les éléments aux coordonnées spécifiées. +- {{domxref("Document.enableStyleSheetsForSet()")}} + - : active les feuilles de style pour l'ensemble de feuilles de style spécifié. +- {{domxref("Document.exitPointerLock()")}} {{experimental_inline}} + - : Supprime le verrou du pointeur. +- {{domxref("Document.getAnimations()")}} {{experimental_inline}} + - : retourne un tableau de tous les objets {{domxref("Animation")}} actuels, dont les éléments cibles sont les descendants de ce `document`. + +<!----> + +- {{domxref("Document.getElementsByClassName()")}} + - : Renvoie une liste des éléments ayant le nom de classe donné. + +<!----> + +- {{domxref("Document.getElementsByTagName()")}} + - : Renvoie une liste des éléments ayant le nom de balise donné. + +<!----> + +- {{domxref("Document.getElementsByTagNameNS()")}} + - : Renvoie une liste des éléments du nom de balise et de l'espace de noms spécifiés. + +<!----> + +- {{domxref("Document.importNode()")}} + - : Renvoie une copie (un clone) d'un élément provenant d'un document externe. +- {{domxref("Document.normalizeDocument()")}} {{obsolete_inline}} + - : remplace les entités, normalise les noeuds de texte, etc. +- {{domxref("Document.registerElement()")}} {{experimental_inline}} + - : Enregistre un composant Web. +- {{domxref("Document.releaseCapture()")}} {{non-standard_inline}} {{gecko_minversion_inline("2.0")}} + - : Libère la capture de la souris en cours s'il s'agit d'un élément de ce document. +- {{domxref("Document.releaseEvents()")}} {{non-standard_inline}} {{Deprecated_inline}} + - : voir {{domxref("Window.releaseEvents()")}}. +- {{domxref("Document.routeEvent()")}} {{non-standard_inline}} {{obsolete_inline(24)}} + - : Voir {{domxref("Window.routeEvent()")}}. +- {{domxref("Document.mozSetImageElement()")}} {{non-standard_inline}} {{gecko_minversion_inline("2.0")}} + - : Vous permet de modifier l'élément utilisé comme image d'arrière-plan pour un ID d'élément spécifié. + +L'interface `Document` est étendue avec l'interface {{domxref("ParentNode")}} : + +- {{domxref("document.getElementById","document.getElementById(String id)")}} + - : retourne une référence d'objet à l'élément identifié. +- {{domxref("document.querySelector","document.querySelector(String selector)")}} {{gecko_minversion_inline("1.9.1")}} + - : Renvoie le premier noeud `Element` dans le document, dans l'ordre du document, qui correspond aux sélecteurs spécifiés. +- {{domxref("document.querySelectorAll","document.querySelectorAll(String selector)")}} {{gecko_minversion_inline("1.9.1")}} + - : retourne une liste de tous les noeuds éléments inclus dans le document qui correspondent aux sélecteurs spécifiés. + +L'interface Document est étendue avec l'interface {{domxref("XPathEvaluator")}} : + +- {{domxref("document.createExpression","document.createExpression(String expression, XPathNSResolver resolver)")}} + - : compile une [`XPathExpression`](/fr/docs/Web/API/XPathExpression) qui peut ensuite être utilisée pour des évaluations (répétées). +- {{domxref("document.createNSResolver","document.createNSResolver(Node resolver)")}} + - : crée un objet {{domxref("XPathNSResolver")}} . +- {{domxref("document.evaluate","document.evaluate(String expression, Node contextNode, XPathNSResolver resolver, Number type, Object result)")}} + - : évalue l'expression XPath . + +### Extensions pour les documents HTML + +- {{domxref("document.clear()")}} {{non-standard_inline}} {{Deprecated_inline}} + - : dans la majorité des navigateurs modernes, y compris les versions récentes de Firefox et Internet Explorer, cette méthode ne fait rien. +- {{domxref("document.close()")}} + - : ferme un flux de document pour l'écriture. +- {{domxref("document.execCommand","document.execCommand(String command[, Boolean showUI[, String value]])")}} + - : Sur un document modifiable, exécute une commande de formatage. +- {{domxref("document.getElementsByName","document.getElementsByName(String name)")}} + - : retourne une liste d'éléments ayant le nom donné. +- {{domxref("document.getSelection()")}} + - : retourne un objet {{domxref("Selection")}} relatif au texte sélectionné dans le document. +- {{domxref("document.hasFocus()")}} + - : retourne `true` (vrai) si le focus est actuellement localisé n'importe où sur le document spécifié. +- {{domxref("document.open()")}} + - : Ouvre un flux pour l'écriture dans le document. +- {{domxref("document.queryCommandEnabled","document.queryCommandEnabled(String command)")}} + - : Renvoie `true` si la commande de formatage peut être exécutée sur la plage courante. +- {{domxref("document.queryCommandIndeterm","document.queryCommandIndeterm(String command)")}} + - : Renvoie `true` si la commande de formatage est dans un état indéterminé sur la plage courante. +- {{domxref("document.queryCommandState","document.queryCommandState(String command)")}} + - : Renvoie `true` si la commande de formatage a été exécutée sur la plage courante. +- {{domxref("document.queryCommandSupported","document.queryCommandSupported(String command)")}} + - : retourne `true` _(vrai)_ si la commande de formatage est supportée sur la plage courante. +- {{domxref("document.queryCommandValue","document.queryCommandValue(String command)")}} + - : renvoie la valeur courante de la plage en cours pour une commande de formatage. +- {{domxref("document.write","document.write(String text)")}} + - : Écrit du texte dans le document. +- {{domxref("document.writeln","document.writeln(String text)")}} + - : Écrit une ligne de texte dans le document. + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------ | +| {{SpecName('Page Visibility API', '#onvisiblitychange-event-handler', 'onvisibilitychange')}} | {{Spec2('Page Visibility API')}} | Ajoute `onvisibilitychange.` | +| {{SpecName('Selection API', '', 'Extend Document and GlobalEventHandlers')}} | {{Spec2('Selection API')}} | Ajoute `onselectstart`et `onselectionchange`. | +| {{SpecName('DOM1','#i-Document','Document')}} | {{Spec2('DOM1')}} | Définition initiale pour l'interface | +| {{SpecName('DOM2 Core','#i-Document','Document')}} | {{Spec2('DOM2 Core')}} | Remplace DOM 1 | +| {{SpecName('DOM3 Core','#i-Document','Document')}} | {{Spec2('DOM3 Core')}} | remplace DOM 2 | +| {{SpecName('DOM WHATWG','#interface-document','Document')}} | {{Spec2('DOM WHATWG')}} | en vue de remplacer DOM 3 | +| {{SpecName('HTML WHATWG','dom.html#the-document-object','Document')}} | {{Spec2('HTML WHATWG')}} | Transforme l'interface {{domxref("HTMLDocument")}} en une extension de `Document` | +| {{SpecName('DOM3 XPath','xpath.html#XPathEvaluator','XPathEvaluator')}} | {{Spec2('DOM3 XPath')}} | Definit l'interface {{domxref("XPathEvaluator")}} qui étend le document. | +| {{SpecName('Page Visibility API', '#sec-document-interface', 'Document')}} | {{Spec2('Page Visibility API')}} | Étend l'interface `Document` avec les attributs `visibilityState` et `hidden`. | +| {{SpecName('HTML Editing','#dom-document-getselection','Document')}} | {{Spec2('HTML Editing')}} | Étend l'interface `Document` | +| {{SpecName('CSSOM View','#extensions-to-the-document-interface','Document')}} | {{Spec2('CSSOM View')}} | Étend l'interface `Document` | +| {{SpecName('CSSOM','#extensions-to-the-document-interface','Document')}} | {{Spec2('CSSOM')}} | Étend l'interface `Document` | +| {{SpecName('Pointer Lock','#extensions-to-the-document-interface','Document')}} | {{Spec2('Pointer Lock')}} | Étend l'interface `Document` | + +## Compatibilité des navigateurs notes + +### Notes concernant Firefox : + +Mozilla définit un ensemble de propriétés non-standard créées seulement pour le contenu XUL : + +- {{domxref("document.currentScript")}} {{non-standard_inline}} {{gecko_minversion_inline("2.0")}} + - : retourne l'élément {{HTMLElement("script")}} qui est en cours d'exécution. +- {{domxref("document.documentURIObject")}} {{gecko_minversion_inline("1.9")}} + - : (extensions Mozilla seulement) retourne l'objet {{Interface("nsIURI")}} représentant l'URI du document. Cette propriété a seulement une signification spéciale dans le code JavaScript privilégié (avec les privilèges UniversalXPConnect). +- {{domxref("document.popupNode")}} + - : retourne le noeud ouvert lors de l'appel d'une fenêtre contextuelle. +- {{domxref("document.tooltipNode")}} + - : retourne le noeud qui est la cible de l'info-bulle actuelle. + +Mozilla a également défini quelques méthodes non standard : + +- {{domxref("document.execCommandShowHelp")}} {{obsolete_inline("14.0")}} + - : Cette méthode n'a jamais rien fait et a toujours lancé une exception, elle a donc été supprimée dans Gecko 14.0 {{geckoRelease ("14.0")}}. +- {{domxref("document.getBoxObjectFor")}} {{obsolete_inline}} + - : Utiliser la méthode {{domxref("Element.getBoundingClientRect()")}} à la place. +- {{domxref("document.loadOverlay")}} + - : charge dynamiquement un [XUL overlay](/fr/docs/Overlays_XUL) . Celui-ci fonctionne seulement dans les documents XUL. +- {{domxref("document.queryCommandText")}} {{obsolete_inline("14.0")}} + - : Cette méthode n'a jamais rien fait d'autre que de lancer une exception, elle a donc été supprimée dans Gecko 14.0 {{geckoRelease ("14.0")}}. + +### Notes concernant Internet Explorer + +Microsoft a défini quelques propriétés non standard : + +- {{domxref("document.fileSize")}}\* {{non-standard_inline}} {{obsolete_inline}} + - : Retourne la taille en octets du document. À partir d'Internet Explorer 11, cette propriété n'est plus prise en charge. Voir [MSDN](http://msdn.microsoft.com/en-us/library/ms533752%28v=VS.85%29.aspx). + +Internet Explorer ne prend pas en charge toutes les méthodes de l'interface Node dans l'interface Document : + +- {{domxref("document.contains")}} + - : Pour contourner le problème, `document.body.contains ()` peut être utilisé. diff --git a/files/fr/web/api/document/keypress_event/index.md b/files/fr/web/api/document/keypress_event/index.md index 76807b1f92..f079811072 100644 --- a/files/fr/web/api/document/keypress_event/index.md +++ b/files/fr/web/api/document/keypress_event/index.md @@ -9,94 +9,91 @@ tags: - Reference translation_of: Web/API/Document/keypress_event --- -<div>{{APIRef}} {{deprecated_header}}</div> +{{APIRef}} {{deprecated_header}} -<p>L'évènement <strong><code>keypress</code></strong> est déclenché lorsqu'une touche produisant un caractère est pressée. Cela concerne les touches qui produisent des caractères alphabétiques, des caractères numériques et des signes de ponctuations. Les touches <kbd>Alt</kbd>, <kbd>Shift</kbd>, <kbd>Ctrl</kbd> ou <kbd>Meta</kbd> ne sont pas concernées.</p> +L'évènement **`keypress`** est déclenché lorsqu'une touche produisant un caractère est pressée. Cela concerne les touches qui produisent des caractères alphabétiques, des caractères numériques et des signes de ponctuations. Les touches <kbd>Alt</kbd>, <kbd>Shift</kbd>, <kbd>Ctrl</kbd> ou <kbd>Meta</kbd> ne sont pas concernées. -<div class="warning"> -<p><strong>Attention :</strong> Cet évènement est déprécié et il faudrait plutôt utiliser <code><a href="/fr/docs/Web/API/HTMLElement/beforeinput_event">beforeinput</a></code> ou <code><a href="/fr/docs/Web/API/Document/keydown_event">keydown</a></code>.</p> -</div> +> **Attention :** Cet évènement est déprécié et il faudrait plutôt utiliser [`beforeinput`](/fr/docs/Web/API/HTMLElement/beforeinput_event) ou [`keydown`](/fr/docs/Web/API/Document/keydown_event). <table class="properties"> - <thead> - </thead> - <tbody> - <tr> - <th>Interface</th> - <td>{{domxref("KeyboardEvent")}}</td> - </tr> - <tr> - <th>Remonte sur les parents (<em>bubbles</em>)</th> - <td>Oui</td> - </tr> - <tr> - <th>Annulable</th> - <td>Oui</td> - </tr> - <tr> - <th>Action par défaut</th> - <td>Cela peut varier : évènement <code>keypress</code> ; ouverture du système de composition du texte ; évènements <code><a href="/fr/docs/Web/API/Element/blur_event">blur</a></code> et <code><a href="/fr/docs/Web/API/Element/focus_event">focus</a></code> ; évènement <a href="/fr/docs/Web/API/Element/DOMActivate_event"><code>DOMActivate</code> </a>{{deprecated_inline}}; autre évènement.</td> - </tr> - </tbody> + <thead></thead> + <tbody> + <tr> + <th>Interface</th> + <td>{{domxref("KeyboardEvent")}}</td> + </tr> + <tr> + <th>Remonte sur les parents (<em>bubbles</em>)</th> + <td>Oui</td> + </tr> + <tr> + <th>Annulable</th> + <td>Oui</td> + </tr> + <tr> + <th>Action par défaut</th> + <td> + Cela peut varier : évènement <code>keypress</code> ; ouverture du + système de composition du texte ; évènements + <code><a href="/fr/docs/Web/API/Element/blur_event">blur</a></code> et + <code><a href="/fr/docs/Web/API/Element/focus_event">focus</a></code> ; + évènement + <a href="/fr/docs/Web/API/Element/DOMActivate_event" + ><code>DOMActivate</code> </a + >{{deprecated_inline}}; autre évènement. + </td> + </tr> + </tbody> </table> -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Ajout_d'un_addEventListener">Ajout d'un <code>addEventListener</code></h3> +### Ajout d'un `addEventListener` -<p>Dans cet exemple, on affiche la valeur de {{domxref("KeyboardEvent.code")}} lorsqu'on appuie sur une touche :</p> +Dans cet exemple, on affiche la valeur de {{domxref("KeyboardEvent.code")}} lorsqu'on appuie sur une touche : -<pre class="brush: html"><p> +```html +<p> Cliquez dans l'iframe pour lui passer le focus puis appuyez sur des touches du clavier. -</p> -<p id="log"></p></pre> +</p> +<p id="log"></p> +``` -<pre class="brush: js">const log = document.getElementById('log'); +```js +const log = document.getElementById('log'); document.addEventListener('keypress', logKey); function logKey(e) { log.textContent += ` ${e.code}`; -}</pre> +} +``` -<p>{{EmbedLiveSample("addEventListener_keypress_example")}}</p> +{{EmbedLiveSample("addEventListener_keypress_example")}} -<h3 id="Équivalent_onkeypress">Équivalent <code>onkeypress</code></h3> +### Équivalent `onkeypress` -<pre class="brush: js">document.onkeypress = logKey;</pre> +```js +document.onkeypress = logKey; +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('UI Events', '#event-type-keypress')}}</td> - <td>{{Spec2('UI Events')}}</td> - </tr> - </tbody> -</table> +| Spécification | État | +| ---------------------------------------------------------------- | ---------------------------- | +| {{SpecName('UI Events', '#event-type-keypress')}} | {{Spec2('UI Events')}} | + +## Compatibilité des navigateurs -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +{{Compat("api.Document.keypress_event")}} -<p>{{Compat("api.Document.keypress_event")}}</p> +## Voir aussi -<h2 id="Voir_aussi">Voir aussi</h2> +- {{domxref("GlobalEventHandlers.onkeypress")}} +- L'interface {{domxref("Element")}} que cet évènement cible +- Les évènements associés : -<ul> - <li>{{domxref("GlobalEventHandlers.onkeypress")}}</li> - <li>L'interface {{domxref("Element")}} que cet évènement cible</li> - <li>Les évènements associés : - <ul> - <li><code><a href="/fr/docs/Web/API/Document/keydown_event">keydown</a></code></li> - <li><code><a href="/fr/docs/Web/API/Document/keyup_event">keyup</a></code></li> - <li><code><a href="/fr/docs/Web/API/HTMLElement/beforeinput_event">beforeinput</a></code></li> - </ul> - </li> -</ul> + - [`keydown`](/fr/docs/Web/API/Document/keydown_event) + - [`keyup`](/fr/docs/Web/API/Document/keyup_event) + - [`beforeinput`](/fr/docs/Web/API/HTMLElement/beforeinput_event) diff --git a/files/fr/web/api/document/lastmodified/index.md b/files/fr/web/api/document/lastmodified/index.md index 90a7738bb3..bde5ee06e8 100644 --- a/files/fr/web/api/document/lastmodified/index.md +++ b/files/fr/web/api/document/lastmodified/index.md @@ -3,66 +3,70 @@ title: Document.lastModified slug: Web/API/Document/lastModified translation_of: Web/API/Document/lastModified --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>Retourne une chaîne de caractère contenant la date et l'heure à laquelle le présent document a été modifié pour la dernière fois.</p> +Retourne une chaîne de caractère contenant la date et l'heure à laquelle le présent document a été modifié pour la dernière fois. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>string</var> = document.lastModified; -</pre> + string = document.lastModified; -<h2 id="Example">Exemples</h2> +## Exemples -<h3 id="Exemple_1_Utilisation_simple">Exemple #1: Utilisation simple</h3> +### Exemple #1: Utilisation simple -<pre class="brush:js">alert(document.lastModified); +```js +alert(document.lastModified); // renvoie: 11/28/2015 16:11:15 -</pre> +``` -<h3 id="Exemple_2_Transformer_lastModified_en_un_objet_de_type_Date">Exemple #2: Transformer <code>lastModified</code> en un objet de type <a href="/en-US/docs/JavaScript/Reference/Global_Objects/Date"><code>Date</code></a></h3> +### Exemple #2: Transformer `lastModified` en un objet de type [`Date`](/en-US/docs/JavaScript/Reference/Global_Objects/Date) -<pre class="brush:js">var oLastModif = new Date(document.lastModified); -</pre> +```js +var oLastModif = new Date(document.lastModified); +``` -<h3 id="Exemple_3_Transformer_lastModified_en_un_nombre_de_millisecondes_passées_depuis_le_1_Janvier_1970_à_000000_heure_locale.">Exemple #3: Transformer <code>lastModified</code> en un nombre de millisecondes passées depuis le 1 Janvier 1970 à 00:00:00, heure locale.</h3> +### Exemple #3: Transformer `lastModified` en un nombre de millisecondes passées depuis le 1 Janvier 1970 à 00:00:00, heure locale. -<pre class="brush:js">var nLastModif = Date.parse(document.lastModified); -</pre> +```js +var nLastModif = Date.parse(document.lastModified); +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>Veuillez noter qu'en tant que chaîne de caractères, <code>lastModified </code>ne peut être <em>facilement </em>utilisé pour des comparaisons entre les dates modifées des documents. Voici un exemple possible qui montre comment afficher une alerte quand la page change (voir aussi: <a href="/en-US/docs/DOM/document.cookie">API des cookies en JavaScript</a>):</p> +Veuillez noter qu'en tant que chaîne de caractères, `lastModified `ne peut être *facilement* utilisé pour des comparaisons entre les dates modifées des documents. Voici un exemple possible qui montre comment afficher une alerte quand la page change (voir aussi: [API des cookies en JavaScript](/en-US/docs/DOM/document.cookie)): -<pre class="brush: js">if (Date.parse(document.lastModified) > parseFloat(document.cookie.replace(/(?:(?:^|.*;)\s*last_modif\s*\=\s*([^;]*).*$)|^.*$/, "$1") || "0")) { +```js +if (Date.parse(document.lastModified) > parseFloat(document.cookie.replace(/(?:(?:^|.*;)\s*last_modif\s*\=\s*([^;]*).*$)|^.*$/, "$1") || "0")) { document.cookie = "last_modif=" + Date.now() + "; expires=Fri, 31 Dec 9999 23:59:59 GMT; path=" + location.pathname; alert("Cette page a changé !"); -}</pre> +} +``` -<p>… le même exemple, mais en ignorant la première visite:</p> +… le même exemple, mais en ignorant la première visite: -<pre class="brush: js">var +```js +var nLastVisit = parseFloat(document.cookie.replace(/(?:(?:^|.*;)\s*last_modif\s*\=\s*([^;]*).*$)|^.*$/, "$1")), nLastModif = Date.parse(document.lastModified); -if (isNaN(nLastVisit) || nLastModif > nLastVisit) { +if (isNaN(nLastVisit) || nLastModif > nLastVisit) { document.cookie = "last_modif=" + Date.now() + "; expires=Fri, 31 Dec 9999 23:59:59 GMT; path=" + location.pathname; if (isFinite(nLastVisit)) { alert("Cette page a changé !"); } -}</pre> +} +``` -<div class="note"> - <p><strong>Note:</strong> WebKit renvoie le temps sous forme de chaîne de caractère en UTC; Gecko et Internet Explorer renvoient le temps selon le fuseau horaire local. (Voir: <a href="https://bugs.webkit.org/show_bug.cgi?id=4363">Bogue 4363 – document.lastModified renoive la date en UTC, mais devrait la renvoyer selon le fuseau horaire local</a>)</p> -</div> +> **Note :** WebKit renvoie le temps sous forme de chaîne de caractère en UTC; Gecko et Internet Explorer renvoient le temps selon le fuseau horaire local. (Voir: [Bogue 4363 – document.lastModified renoive la date en UTC, mais devrait la renvoyer selon le fuseau horaire local](https://bugs.webkit.org/show_bug.cgi?id=4363)) -<p>Si vous voulez savoir <strong>si <em>une page externe</em> a changé, </strong>veuillez lire <a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest#Get_last_modified_date">ce paragraphe à propos de l'API <code>XMLHttpRequest()</code></a>.</p> +Si vous voulez savoir **si *une page externe* a changé,** veuillez lire [ce paragraphe à propos de l'API `XMLHttpRequest()`](/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest#Get_last_modified_date). -<h2 id="Specification">Spécification</h2> +## Spécification -<p>HTML5</p> +HTML5 -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.lastModified")}}</p> +{{Compat("api.Document.lastModified")}} diff --git a/files/fr/web/api/document/laststylesheetset/index.md b/files/fr/web/api/document/laststylesheetset/index.md index dce73ac17e..c0fb8e8080 100644 --- a/files/fr/web/api/document/laststylesheetset/index.md +++ b/files/fr/web/api/document/laststylesheetset/index.md @@ -8,41 +8,35 @@ tags: - Propriétés translation_of: Web/API/Document/lastStyleSheetSet --- -<p>{{ APIRef("DOM") }}{{ gecko_minversion_header("1.9") }}</p> +{{ APIRef("DOM") }}{{ gecko_minversion_header("1.9") }} -<p>Renvoie le dernier jeu de feuilles de styles activé ; cette valeur de la propriété change chaque fois que la propriété {{ domxref("document.selectedStyleSheetSet") }} est modifiée.</p> +Renvoie le dernier jeu de feuilles de styles activé ; cette valeur de la propriété change chaque fois que la propriété {{ domxref("document.selectedStyleSheetSet") }} est modifiée. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>lastStyleSheetSet</em> = document.lastStyleSheetSet -</pre> + lastStyleSheetSet = document.lastStyleSheetSet -<p>En retour, <code>lastStyleSheetSet</code> indique le jeu de feuilles de styles qui a été défini le plus récemment. Si le jeu de feuilles de style en cours n'a pas été modifié en définissant {{ domxref("document.selectedStyleSheetSet") }}, la valeur retournée est <code>null</code>.</p> +En retour, `lastStyleSheetSet` indique le jeu de feuilles de styles qui a été défini le plus récemment. Si le jeu de feuilles de style en cours n'a pas été modifié en définissant {{ domxref("document.selectedStyleSheetSet") }}, la valeur retournée est `null`. -<div class="note"> - <p><strong>Note :</strong> Cette valeur ne doit pas changer lorsque {{ domxref("document.enableStyleSheetsForSet()") }} est appelé.</p> -</div> +> **Note :** Cette valeur ne doit pas changer lorsque {{ domxref("document.enableStyleSheetsForSet()") }} est appelé. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">var lastSheetSet = document.lastStyleSheetSet; +```js +var lastSheetSet = document.lastStyleSheetSet; if (!lastSheetSet) { lastSheetSet = "Sheet not yet changed"; } console.log("The last sheet set is: " + lastSheetSet); -</pre> +``` -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{ domxref("document.preferredStyleSheetSet") }}</li> - <li>{{ domxref("document.selectedStyleSheetSet") }}</li> - <li>{{ domxref("document.styleSheetSets") }}</li> - <li>{{ domxref("document.enableStyleSheetsForSet()") }}</li> -</ul> +- {{ domxref("document.preferredStyleSheetSet") }} +- {{ domxref("document.selectedStyleSheetSet") }} +- {{ domxref("document.styleSheetSets") }} +- {{ domxref("document.enableStyleSheetsForSet()") }} -<h2 id="Specification">Spécifications</h2> +## Spécifications -<ul> - <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets">HTML5: Alternate Style Sheets</a></li> -</ul> +- [HTML5: Alternate Style Sheets](http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets) diff --git a/files/fr/web/api/document/location/index.md b/files/fr/web/api/document/location/index.md index 2a6f3e51c3..a3fb30e1ae 100644 --- a/files/fr/web/api/document/location/index.md +++ b/files/fr/web/api/document/location/index.md @@ -10,56 +10,39 @@ tags: - lecture seule translation_of: Web/API/Document/location --- -<p>La propriété en lecture seule <strong><code>Document.location</code></strong><code> renvoie un objet</code> {{domxref("Location")}}, contenant les informations sur l'URL du document et fournit des moyens pour modifier cette URL ou charger une autre URL.</p> +La propriété en lecture seule **`Document.location`**` renvoie un objet` {{domxref("Location")}}, contenant les informations sur l'URL du document et fournit des moyens pour modifier cette URL ou charger une autre URL. -<p>Bien que <code>Document.location</code> soit un objet <code>Location</code> en <em>lecture seule</em>, vous pouvez lui assigner un {{domxref("DOMString")}}. Cela signifie que vous pouvez dans la plupart des cas utiliser document.location comme s'il s'agissait d'une chaîne de caractères: <code>document.location = 'http://www.example.com'</code> est un synonyme de <code>document.location.href = 'http://www.example.com'</code>.</p> +Bien que `Document.location` soit un objet `Location` en _lecture seule_, vous pouvez lui assigner un {{domxref("DOMString")}}. Cela signifie que vous pouvez dans la plupart des cas utiliser document.location comme s'il s'agissait d'une chaîne de caractères: `document.location = 'http://www.example.com'` est un synonyme de `document.location.href = 'http://www.example.com'`. -<p>Pour récupérer uniquement l'URL en tant que chaîne de caractères, la propriété {{domxref("document.URL")}} peut également être utilisée.</p> +Pour récupérer uniquement l'URL en tant que chaîne de caractères, la propriété {{domxref("document.URL")}} peut également être utilisée. -<p>Si le document courant n'est pas un contexte de navigation, la valeur renvoyée est <em>null</em>.</p> +Si le document courant n'est pas un contexte de navigation, la valeur renvoyée est _null_. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>locationObj</em> = document.location -document.location = 'http://www.mozilla.org' // équivalent à document.location.href = 'http://www.mozilla.org' -</pre> + locationObj = document.location + document.location = 'http://www.mozilla.org' // équivalent à document.location.href = 'http://www.mozilla.org' -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">console.log(document.location); +```js +console.log(document.location); // Affiche un string-like // "http://www.example.com/juicybits.html" dans la console -</pre> +``` -<h2 id="Spécification">Spécification</h2> +## Spécification -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', "history.html#the-location-interface", "Document.location")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Pas de changement avec {{SpecName("HTML5 W3C")}}.</td> - </tr> - <tr> - <td>{{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Document.location")}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Specification | Status | Comment | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- | +| {{SpecName('HTML WHATWG', "history.html#the-location-interface", "Document.location")}} | {{Spec2('HTML WHATWG')}} | Pas de changement avec {{SpecName("HTML5 W3C")}}. | +| {{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Document.location")}} | {{Spec2('HTML5 W3C')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.location")}}</p> +{{Compat("api.Document.location")}} -<h2 id="Voir_également">Voir également</h2> +## Voir également -<ul> - <li>L'interface de la valeur renvoyée, {{domxref("Location")}}.</li> - <li>Une information similaire mais attachée au contexte de navigation, {{domxref("Window.location")}}</li> -</ul> +- L'interface de la valeur renvoyée, {{domxref("Location")}}. +- Une information similaire mais attachée au contexte de navigation, {{domxref("Window.location")}} diff --git a/files/fr/web/api/document/mozsetimageelement/index.md b/files/fr/web/api/document/mozsetimageelement/index.md index aa70b99736..c91cbf97fd 100644 --- a/files/fr/web/api/document/mozsetimageelement/index.md +++ b/files/fr/web/api/document/mozsetimageelement/index.md @@ -10,31 +10,29 @@ tags: - Méthodes translation_of: Web/API/Document/mozSetImageElement --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>{{ gecko_minversion_header("2.0") }}{{ non-standard_header() }}</p> +{{ gecko_minversion_header("2.0") }}{{ non-standard_header() }} -<p>Change l'élément utilisé comme arrière-plan CSS par un arrière-plan avec un ID d'élément d'arrière-plan donné.</p> +Change l'élément utilisé comme arrière-plan CSS par un arrière-plan avec un ID d'élément d'arrière-plan donné. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval">document.mozSetImageElement(<em>imageElementId</em>, imageElement); -</pre> + document.mozSetImageElement(imageElementId, imageElement); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<ul> - <li><code>imageElementId</code> est une chaîne de caractères indiquant le nom d'un élément qui a été spécifié comme une image d'arrière-plan en utilisant la fonction CSS {{ cssxref("-moz-element") }}.</li> - <li><code>imageElement</code> est le nouvel élément à utiliser comme arrière-plan correspondant à cette chaîne d'élément image. Spécifiez <code>null</code> pour supprimer l'élément d'arrière-plan.</li> -</ul> +- `imageElementId` est une chaîne de caractères indiquant le nom d'un élément qui a été spécifié comme une image d'arrière-plan en utilisant la fonction CSS {{ cssxref("-moz-element") }}. +- `imageElement` est le nouvel élément à utiliser comme arrière-plan correspondant à cette chaîne d'élément image. Spécifiez `null` pour supprimer l'élément d'arrière-plan. -<h2 id="Example">Exemple</h2> +## Exemple -<p>Cet exemple change l'arrière-plan d'un bloc {{ HTMLElement("div") }} chaque fois que l'utilisateur clique sur le bloc.</p> +Cet exemple change l'arrière-plan d'un bloc {{ HTMLElement("div") }} chaque fois que l'utilisateur clique sur le bloc. -<p><a href="/samples/domref/mozSetImageElement.html">Vue de cet exemple en direct</a>.</p> +[Vue de cet exemple en direct](/samples/domref/mozSetImageElement.html). -<pre class="brush: html"><style type="text/css"> +```html +<style type="text/css"> #mybox { background-image: -moz-element(#canvasbg); text-align: center; @@ -42,12 +40,13 @@ translation_of: Web/API/Document/mozSetImageElement height: 400px; cursor: pointer; } -</style> -</pre> +</style> +``` -<p>Le CSS défini par le bloc {{ HTMLElement("style") }} ci-dessus est utilisé par notre {{ HTMLElement("div") }} pour afficher un élément, ayant l'id "canvasbg", en arrière-plan.</p> +Le CSS défini par le bloc {{ HTMLElement("style") }} ci-dessus est utilisé par notre {{ HTMLElement("div") }} pour afficher un élément, ayant l'id "canvasbg", en arrière-plan. -<pre class="brush: js">var c = 0x00; +```js +var c = 0x00; function clicked() { var canvas = document.createElement("canvas"); canvas.setAttribute("width", 100); @@ -58,24 +57,22 @@ function clicked() { ctx.fillRect(25, 25, 75, 75); c += 0x11; - if (c > 0xff) { + if (c > 0xff) { c = 0x00; } document.mozSetImageElement("canvasbg", canvas); } -</pre> +``` -<p>Le code ici est appelé chaque fois que l'utilisateur clique sur l'élément {{ HTMLElement("div") }}. Il crée un nouveau {{ HTMLElement("canvas") }} avec la largeur et la hauteur définies à 100 pixels et le dessine dans un carré de 50 par 50 pixels. Chaque fois que la fonction est appelée, le carré est d'une couleur différente (sa composante rouge est augmentée à chaque fois), donc chaque fois que l'utilisateur clique sur l'élément, le fond est plus lumineux et rempli d'un motif plus lumineux de carreaux rouges.</p> +Le code ici est appelé chaque fois que l'utilisateur clique sur l'élément {{ HTMLElement("div") }}. Il crée un nouveau {{ HTMLElement("canvas") }} avec la largeur et la hauteur définies à 100 pixels et le dessine dans un carré de 50 par 50 pixels. Chaque fois que la fonction est appelée, le carré est d'une couleur différente (sa composante rouge est augmentée à chaque fois), donc chaque fois que l'utilisateur clique sur l'élément, le fond est plus lumineux et rempli d'un motif plus lumineux de carreaux rouges. -<p>Une fois le canvas dessiné, <code>document.mozSetImageElement()</code> est appelée pour définir l'arrière-plan de tout CSS en utilisant l'ID "canvasbg" comme ID d'élément d'arrière-plan pour être notre nouveau canvas.</p> +Une fois le canvas dessiné, `document.mozSetImageElement()` est appelée pour définir l'arrière-plan de tout CSS en utilisant l'ID "canvasbg" comme ID d'élément d'arrière-plan pour être notre nouveau canvas. -<h2 id="Specification">Spécifications</h2> +## Spécifications -<p>Ne fait partie d'aucune spécification.</p> +Ne fait partie d'aucune spécification. -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{ cssxref("-moz-element") }}</li> -</ul> +- {{ cssxref("-moz-element") }} diff --git a/files/fr/web/api/document/mozsyntheticdocument/index.md b/files/fr/web/api/document/mozsyntheticdocument/index.md index c8847269ca..8a9529ff35 100644 --- a/files/fr/web/api/document/mozsyntheticdocument/index.md +++ b/files/fr/web/api/document/mozsyntheticdocument/index.md @@ -8,28 +8,26 @@ tags: - Propriétés translation_of: Web/API/Document/mozSyntheticDocument --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>Indique si le document est synthétique ou non ; c'est-à-dire un document représentant une image autonome, une vidéo, un son ou analogue.</p> +Indique si le document est synthétique ou non ; c'est-à-dire un document représentant une image autonome, une vidéo, un son ou analogue. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>var isSynthetic</em> = <em>document</em>.mozSyntheticDocument; -</pre> + var isSynthetic = document.mozSyntheticDocument; -<p>En retour, <code>isSynthetic</code> est <code>true</code> (<em>vrai</em>) si le document est synthétique ; sinon, <code>false</code> (<em>faux</em>).</p> +En retour, `isSynthetic` est `true` (_vrai_) si le document est synthétique ; sinon, `false` (_faux_). -<h2 id="Example">Exemple</h2> +## Exemple -<p>Il peut être utile, si vous avez un élément de menu contextuel que vous souhaitez uniquement afficher pour les documents synthétiques (ou, inversement, pour les documents qui ne sont pas synthétiques).</p> +Il peut être utile, si vous avez un élément de menu contextuel que vous souhaitez uniquement afficher pour les documents synthétiques (ou, inversement, pour les documents qui ne sont pas synthétiques). -<pre class="eval">var isSynthetic = document.mozSyntheticDocument; + var isSynthetic = document.mozSyntheticDocument; -if (isSynthetic) { - /* insert your menu item here */ -} -</pre> + if (isSynthetic) { + /* insert your menu item here */ + } -<h2 id="Specification">Spécifications</h2> +## Spécifications -<p>Ne fait partie d'aucune spécification.</p> +Ne fait partie d'aucune spécification. diff --git a/files/fr/web/api/document/onafterscriptexecute/index.md b/files/fr/web/api/document/onafterscriptexecute/index.md index 9c3d8d138a..a53d74a24d 100644 --- a/files/fr/web/api/document/onafterscriptexecute/index.md +++ b/files/fr/web/api/document/onafterscriptexecute/index.md @@ -8,41 +8,35 @@ tags: - scripts translation_of: Web/API/Document/onafterscriptexecute --- -<div>{{ ApiRef("DOM") }} {{non-standard_header}}</div> +{{ ApiRef("DOM") }} {{non-standard_header}} -<div> </div> +## Résumé -<h2 id="Résumé">Résumé</h2> +Lancé lorsqu'un élément {{HTMLElement("script")}} statique achève l'exécution de son script. N'est pas lancé si l'élément est ajouté dynamiquement, par exemple avec appendChild(). -<p>Lancé lorsqu'un élément {{HTMLElement("script")}} statique achève l'exécution de son script. N'est pas lancé si l'élément est ajouté dynamiquement, par exemple avec appendChild().</p> +## Syntaxe -<h2 id="Syntaxe">Syntaxe</h2> + document.onafterscriptexecute = funcRef; -<pre class="syntaxbox"><em>document.onafterscriptexecute = funcRef;</em> -</pre> +_funcRef_ est une référence de fonction appelée lorsqu'un évènement est lancé. L'attribut de la `target` (cible) d'évènement est défini sur l'{{domxref("Element")}} script dont l'exécution vient de s'achever. -<p><em>funcRef</em> est une référence de fonction appelée lorsqu'un évènement est lancé. L'attribut de la <code>target</code> (cible) d'évènement est défini sur l'{{domxref("Element")}} script dont l'exécution vient de s'achever.</p> +## Exemple -<h2 id="Exemple">Exemple</h2> - -<pre class="brush:js">function finished(e) { +```js +function finished(e) { logMessage("Finished script with ID: " + e.target.id); } document.addEventListener("afterscriptexecute", finished, true); -</pre> +``` -<p><a href="/samples/html/currentScript.html">Voir l'exemple sur une page</a></p> +[Voir l'exemple sur une page](/samples/html/currentScript.html) -<h2 id="Spécification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#the-script-element">HTML5</a></li> -</ul> +- [HTML5](http://www.whatwg.org/specs/web-apps/current-work/#the-script-element) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Document.onbeforescriptexecute")}}</li> - <li>{{domxref("Document.currentScript")}}</li> -</ul> +- {{domxref("Document.onbeforescriptexecute")}} +- {{domxref("Document.currentScript")}} diff --git a/files/fr/web/api/document/onbeforescriptexecute/index.md b/files/fr/web/api/document/onbeforescriptexecute/index.md index 8527a38555..638590127d 100644 --- a/files/fr/web/api/document/onbeforescriptexecute/index.md +++ b/files/fr/web/api/document/onbeforescriptexecute/index.md @@ -8,39 +8,35 @@ tags: - scripts translation_of: Web/API/Document/onbeforescriptexecute --- -<div>{{ApiRef("DOM")}} {{non-standard_header }}</div> +{{ApiRef("DOM")}} {{non-standard_header }} -<h2 id="Résumé">Résumé</h2> +## Résumé -<p>Lancé lorsque le code dans un élément {{HTMLElement("script")}} déclaré dans un document HTML est sur le point de s'exécuter. N'est pas déclenché si l'élément est ajouté dynamiquement, par exemple avec appendChild().</p> +Lancé lorsque le code dans un élément {{HTMLElement("script")}} déclaré dans un document HTML est sur le point de s'exécuter. N'est pas déclenché si l'élément est ajouté dynamiquement, par exemple avec appendChild(). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>document.onbeforescriptexecute = funcRef;</em> -</pre> + document.onbeforescriptexecute = funcRef; -<p><em>funcRef</em> est une référence de fonction appelée lorsque l'évènement est lancé. L'attribut de la <code>target</code> (<em>cible</em>) d'évènement est défini dans l'{{domxref("Element")}} script qui est sur le point d'être exécuté.</p> +_funcRef_ est une référence de fonction appelée lorsque l'évènement est lancé. L'attribut de la `target` (_cible_) d'évènement est défini dans l'{{domxref("Element")}} script qui est sur le point d'être exécuté. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">function starting(e) { +```js +function starting(e) { logMessage("Starting script with ID: " + e.target.id); } document.addEventListener("beforescriptexecute", starting, true); -</pre> +``` -<p><a href="/samples/html/currentScript.html">Voir l'exemple sur une page</a></p> +[Voir l'exemple sur une page](/samples/html/currentScript.html) -<h2 id="Spécification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#the-script-element">HTML5</a></li> -</ul> +- [HTML5](http://www.whatwg.org/specs/web-apps/current-work/#the-script-element) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Document.onafterscriptexecute")}}</li> - <li>{{domxref("Document.currentScript")}}</li> -</ul> +- {{domxref("Document.onafterscriptexecute")}} +- {{domxref("Document.currentScript")}} diff --git a/files/fr/web/api/document/onfullscreenchange/index.md b/files/fr/web/api/document/onfullscreenchange/index.md index a3251b0188..c5d6336ada 100644 --- a/files/fr/web/api/document/onfullscreenchange/index.md +++ b/files/fr/web/api/document/onfullscreenchange/index.md @@ -3,50 +3,37 @@ title: Document.onfullscreenchange slug: Web/API/Document/onfullscreenchange translation_of: Web/API/Document/onfullscreenchange --- -<div>{{ApiRef("Fullscreen API")}}</div> +{{ApiRef("Fullscreen API")}} -<p>La propriété <code><strong>Document</strong></code><strong><code>.onfullscreenchange</code> </strong>est un gestionnaire d'événement pour l'événement {{event("fullscreenchange")}} qui est lancé lorsque le document entre ou sort du mode plein écran.</p> +La propriété **`Document`\*\***`.onfullscreenchange` \*\*est un gestionnaire d'événement pour l'événement {{event("fullscreenchange")}} qui est lancé lorsque le document entre ou sort du mode plein écran. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>targetDocument</var>.onfullscreenchange = <var>fullscreenChangeHandler</var>; -</pre> + targetDocument.onfullscreenchange = fullscreenChangeHandler; -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">document.onfullscreenchange = function ( event ) { +```js +document.onfullscreenchange = function ( event ) { console.log("FULL SCREEN CHANGE") }; document.documentElement.onclick = function () { // requestFullscreen() doit être un gestionnaire d'événement, sinon ça échouera document.documentElement.requestFullscreen(); } -</pre> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName("Fullscreen", "#handler-document-onfullscreenchange", "onfullscreenchange")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.onfullscreenchange")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{event("fullscreenchange")}}</li> - <li>{{domxref("Document.onfullscreenerror")}}</li> -</ul> +``` + +## Specifications + +| Specification | Status | Comment | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("Fullscreen", "#handler-document-onfullscreenchange", "onfullscreenchange")}} | {{Spec2("HTML WHATWG")}} | Initial definition. | + +## Compatibilité des navigateurs + +{{Compat("api.Document.onfullscreenchange")}} + +## Voir aussi + +- {{event("fullscreenchange")}} +- {{domxref("Document.onfullscreenerror")}} diff --git a/files/fr/web/api/document/onoffline/index.md b/files/fr/web/api/document/onoffline/index.md index 4e9ac673aa..b373eaaa77 100644 --- a/files/fr/web/api/document/onoffline/index.md +++ b/files/fr/web/api/document/onoffline/index.md @@ -8,6 +8,6 @@ tags: - Propriétés translation_of: Web/API/Document/onoffline --- -<p>{{APIRef("DOM")}}</p> +{{APIRef("DOM")}} -<p>Le gestionnaire d'évènements est appelé lorsqu'un évènement {{event("offline")}} est lancé sur le corps (<em>body</em>) et propagé, quand la propriété <a href="/fr/docs/Web/API/NavigatorOnLine/onLine">navigator.onLine</a> change et devient <code>false</code> (<em>fausse</em>).</p> +Le gestionnaire d'évènements est appelé lorsqu'un évènement {{event("offline")}} est lancé sur le corps (_body_) et propagé, quand la propriété [navigator.onLine](/fr/docs/Web/API/NavigatorOnLine/onLine) change et devient `false` (_fausse_). diff --git a/files/fr/web/api/document/ononline/index.md b/files/fr/web/api/document/ononline/index.md index 0665ed87be..c2bdbdf88f 100644 --- a/files/fr/web/api/document/ononline/index.md +++ b/files/fr/web/api/document/ononline/index.md @@ -9,31 +9,25 @@ tags: - Propriétés translation_of: Web/API/Document/ononline --- -<p>{{APIRef("DOM")}}</p> +{{APIRef("DOM")}} -<p>Un évènement "<code>online</code>" est lancé sur le <code><body></code> (<em>corps</em>) de chaque page quand le navigateur bascule entre les modes online (<em>en ligne</em>) et offline (<em>hors ligne</em>). De plus les évènements se propagent de <code>document.body</code> vers <code>document</code> et finalement sur <code>window</code>. Les deux évènements ne sont pas annulables (vous ne pouvez pas empêcher l'utilisateur de se connecter ou de vous déconnecter).</p> +Un évènement "`online`" est lancé sur le `<body>` (_corps_) de chaque page quand le navigateur bascule entre les modes online (_en ligne_) et offline (_hors ligne_). De plus les évènements se propagent de `document.body` vers `document` et finalement sur `window`. Les deux évènements ne sont pas annulables (vous ne pouvez pas empêcher l'utilisateur de se connecter ou de vous déconnecter). -<p><code>window.navigator.onLine</code> renvoie un booléen <em>true</em> (<em>vrai</em>) si le navigateur est online et false s'il est définitivement offline (déconnecté du réseau). Les évènements online et offline sont lancés si la valeur de cet attribut change.</p> +`window.navigator.onLine` renvoie un booléen _true_ (_vrai_) si le navigateur est online et false s'il est définitivement offline (déconnecté du réseau). Les évènements online et offline sont lancés si la valeur de cet attribut change. -<div class="note"> -<p><strong>Note :</strong> Il est important de noter que cet événement et cet attribut sont intrinsèquement peu fiables. Un ordinateur peut être connecté à un réseau sans avoir accès à Internet.</p> -</div> +> **Note :** Il est important de noter que cet événement et cet attribut sont intrinsèquement peu fiables. Un ordinateur peut être connecté à un réseau sans avoir accès à Internet. -<p>Vous pouvez enregistrer les écouteurs de ces événements de plusieurs manières habituelles :</p> +Vous pouvez enregistrer les écouteurs de ces événements de plusieurs manières habituelles : -<ul> - <li>en utilisant <code><a href="/en/DOM/element.addEventListener">addEventListener</a></code> sur <code>window</code>, <code>document</code> ou <code>document.body</code></li> - <li>en définissant les propriétés <code>.ononline</code> ou <code>.onoffline</code> sur <code>document</code> ou <code>document.body</code> sur un objet <code>Function</code> JavaScript. (<strong>Note :</strong> l'utilisation de <code>window.ononline</code> ou <code>window.onoffline</code> ne fonctionnera pas pour des raisons de compatibilité).</li> - <li>en spécifiant les attributs <code>ononline="..."</code> ou <code>onoffline="..."</code> sur la balise <code><body></code> dans le balisage HTML.</li> -</ul> +- en utilisant [`addEventListener`](/en/DOM/element.addEventListener) sur `window`, `document` ou `document.body` +- en définissant les propriétés `.ononline` ou `.onoffline` sur `document` ou `document.body` sur un objet `Function` JavaScript. (**Note :** l'utilisation de `window.ononline` ou `window.onoffline` ne fonctionnera pas pour des raisons de compatibilité). +- en spécifiant les attributs `ononline="..."` ou `onoffline="..."` sur la balise `<body>` dans le balisage HTML. -<h2 id="Example">Exemple</h2> +## Exemple -<p>Il existe <a href="https://bugzilla.mozilla.org/attachment.cgi?id=220609">un cas de test simple</a> que vous pouvez exécuter pour vérifier le fonctionnement des évènements.</p> +Il existe [un cas de test simple](https://bugzilla.mozilla.org/attachment.cgi?id=220609) que vous pouvez exécuter pour vérifier le fonctionnement des évènements. -<h2 id="Example">Références</h2> +## Références -<ul> - <li><a href="/fr/docs/Web/API/NavigatorOnLine/%C3%89v%C3%A8nements_online_et_offline">Évènements online et offline</a></li> - <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#event-online">Spécification</a> <a href="http://www.whatwg.org/specs/web-apps/current-work/#event-online">WHATWG Web App</a> (en)</li> -</ul> +- [Évènements online et offline](/fr/docs/Web/API/NavigatorOnLine/%C3%89v%C3%A8nements_online_et_offline) +- [Spécification](http://www.whatwg.org/specs/web-apps/current-work/#event-online) [WHATWG Web App](http://www.whatwg.org/specs/web-apps/current-work/#event-online) (en) diff --git a/files/fr/web/api/document/open/index.md b/files/fr/web/api/document/open/index.md index c8da92836a..c427d5df05 100644 --- a/files/fr/web/api/document/open/index.md +++ b/files/fr/web/api/document/open/index.md @@ -8,69 +8,46 @@ tags: - Reference translation_of: Web/API/Document/open --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<div> </div> +La méthode **`document.open()`** ouvre un document pour [l'écriture](/fr/docs/Web/API/Document/write). -<p>La méthode <strong><code>document.open()</code></strong> ouvre un document pour <a href="/fr/docs/Web/API/Document/write">l'écriture</a>.</p> +## Syntaxe -<h2 id="Syntaxe">Syntaxe</h2> + document.open(); -<pre class="eval">document.open(); -</pre> +## Exemple -<h2 id="Exemple">Exemple</h2> + // Dans cet exemple, le contenu du document est + // écrasé au cours de la réinitialisation avec open() + document.write("<html><p>supprimez-moi</p></html>"); + document.open(); + // Le document est vide. -<pre>// Dans cet exemple, le contenu du document est -// écrasé au cours de la réinitialisation avec open() -document.write("<html><p>supprimez-moi</p></html>"); -document.open(); -// Le document est vide. -</pre> +## Notes -<h2 id="Notes">Notes</h2> +Si un document existe dans la cible, cette méthode le supprime (voir l'exemple ci-dessus). -<p>Si un document existe dans la cible, cette méthode le supprime (voir l'exemple ci-dessus).</p> +Par ailleurs, un appel automatique à `document.open()` est réalisé lorsque [document.write()](/fr/docs/Web/API/Document/write) est appelé après que la page ait été chargée, bien que ce ne soit pas défini dans la spécification du W3C. documenter les paramètres à document.open ne figurant pas dans la spécification -<p>Par ailleurs, un appel automatique à <code>document.open()</code> est réalisé lorsque <a href="/fr/docs/Web/API/Document/write">document.write()</a> est appelé après que la page ait été chargée, bien que ce ne soit pas défini dans la spécification du W3C. documenter les paramètres à document.open ne figurant pas dans la spécification</p> +Cette méthode ne doit pas être confondue avec [window.open()](/fr/docs/Web/API/Window/open). `document.open` permet d'écrire par dessus le document courant ou d'y ajouter du contenu, alors que `window.open` fournit une manière d'ouvrir une nouvelle fenêtre laissant le document courant intact. Comme `window` est l'objet, si on appelle juste `open(...)`, il sera traité comme un appel à `window.open(...)`. Le document ouvert peut être fermé à l'aide de [document.close()](/fr/docs/Web/API/Document/close). -<p>Cette méthode ne doit pas être confondue avec <a href="/fr/docs/Web/API/Window/open">window.open()</a>. <code>document.open</code> permet d'écrire par dessus le document courant ou d'y ajouter du contenu, alors que <code>window.open</code> fournit une manière d'ouvrir une nouvelle fenêtre laissant le document courant intact. Comme <code>window</code> est l'objet, si on appelle juste <code>open(...)</code>, il sera traité comme un appel à <code>window.open(...)</code>. Le document ouvert peut être fermé à l'aide de <a href="/fr/docs/Web/API/Document/close">document.close()</a>.</p> +Voir [Security check basics](/fr/docs/Mozilla/Gecko/Script_security#Security_checks) pour plus d'informations sur les principaux. -<p>Voir <a href="/fr/docs/Mozilla/Gecko/Script_security#Security_checks">Security check basics</a> pour plus d'informations sur les principaux.</p> +Si vous ne voulez pas créer une entrée d'historique, remplacez `open()` par `open("text/html", "replace")`. -<p>Si vous ne voulez pas créer une entrée d'historique, remplacez <code>open()</code> par <code>open("text/html", "replace")</code>.</p> +## Spécifications -<h2 id="Specifications">Spécifications</h2> +| Spécification | Status | Comment | +| -------------------------------------------------------------------------------------------- | -------------------------------- | -------------------- | +| {{SpecName("HTML WHATWG", "#dom-document-open", "document.open()")}} | {{Spec2("HTML WHATWG")}} | | +| {{SpecName("DOM2 HTML", "html.html#ID-72161170", "document.open()")}} | {{Spec2("DOM2 HTML")}} | Définition initiale. | -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("HTML WHATWG", "#dom-document-open", "document.open()")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName("DOM2 HTML", "html.html#ID-72161170", "document.open()")}}</td> - <td>{{Spec2("DOM2 HTML")}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +## Compatibilité des navigateurs -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +{{Compat("api.Document.open")}} -<p>{{Compat("api.Document.open")}}</p> +## Voir aussi -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li>{{domxref("Document")}}</li> - <li>{{domxref("Window.open()")}}</li> -</ul> +- {{domxref("Document")}} +- {{domxref("Window.open()")}} diff --git a/files/fr/web/api/document/origin/index.md b/files/fr/web/api/document/origin/index.md index 646f4e1242..326c3eef82 100644 --- a/files/fr/web/api/document/origin/index.md +++ b/files/fr/web/api/document/origin/index.md @@ -9,50 +9,34 @@ tags: - origine translation_of: Web/API/Document/origin --- -<div>{{APIRef("DOM")}}{{SeeCompatTable}}</div> +{{APIRef("DOM")}}{{SeeCompatTable}} -<p>La propriété en lecture seule <strong><code>Document.origin</code></strong> renvoie l'origine du document. Dans la plupart des cas, cette propriété est équivalente à <code>document.defaultView.location.origin</code>.</p> +La propriété en lecture seule **`Document.origin`** renvoie l'origine du document. Dans la plupart des cas, cette propriété est équivalente à `document.defaultView.location.origin`. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">var origin = document.origin; +```js +var origin = document.origin; // Sur cette page, renvoie:'https://developer.mozilla.org' var origin = document.origin; // Sur "about:blank", renvoie :'null' var origin = document.origin; -// Sur "data:text/html,<b>foo</b>", renvoie :'null' -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-document-origin', 'Document.origin')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Définition initiale.</td> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', '#origin:document', 'origin for Document objects')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<div>{{Compat("api.Document.origin")}}</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>La propriété {{domxref("URLUtils.origin")}}.</li> -</ul> +// Sur "data:text/html,<b>foo</b>", renvoie :'null' +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------- | +| {{SpecName('DOM WHATWG', '#dom-document-origin', 'Document.origin')}} | {{Spec2('DOM WHATWG')}} | Définition initiale. | +| {{SpecName('HTML WHATWG', '#origin:document', 'origin for Document objects')}} | {{Spec2('HTML WHATWG')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Document.origin")}} + +## Voir aussi + +- La propriété {{domxref("URLUtils.origin")}}. diff --git a/files/fr/web/api/document/popupnode/index.md b/files/fr/web/api/document/popupnode/index.md index be0b64250e..0874d7dca0 100644 --- a/files/fr/web/api/document/popupnode/index.md +++ b/files/fr/web/api/document/popupnode/index.md @@ -10,36 +10,32 @@ tags: - XUL translation_of: Web/API/Document/popupNode --- -<div>{{ApiRef("DOM")}}{{deprecated_header}}</div> +{{ApiRef("DOM")}}{{deprecated_header}} -<div class="note"> - <p><strong>Note :</strong> À partir de {{Gecko("2.0")}}, les auteurs sont encouragés à utiliser la propriété <a href="/fr/docs/Mozilla/Tech/XUL/menupopup">menupopup </a>triggerNode à la place.</p> -</div> +> **Note :** À partir de {{Gecko("2.0")}}, les auteurs sont encouragés à utiliser la propriété [menupopup ](/fr/docs/Mozilla/Tech/XUL/menupopup)triggerNode à la place. -<p>Quand une fenêtre contextuelle attachée via les attributs <code>popup</code> ou <code>context</code> est ouverte, la propriété <code>popupNode</code> du document XUL est définie sur le noeud sur lequel vous avez cliqué. Il sera la cible de l'événement de souris qui a activé la fenêtre contextuelle. Si elle a été ouverte avec le clavier, le nœud contextuel peut être défini sur null. En règle générale, cette propriété sera vérifiée au cours de la gestion des événements par popupshowing, un menu contextuel pour initialiser le menu basé sur le contexte.</p> +Quand une fenêtre contextuelle attachée via les attributs `popup` ou `context` est ouverte, la propriété `popupNode` du document XUL est définie sur le noeud sur lequel vous avez cliqué. Il sera la cible de l'événement de souris qui a activé la fenêtre contextuelle. Si elle a été ouverte avec le clavier, le nœud contextuel peut être défini sur null. En règle générale, cette propriété sera vérifiée au cours de la gestion des événements par popupshowing, un menu contextuel pour initialiser le menu basé sur le contexte. -<p>Cette propriété est uniquement définie pour les fenêtres contextuelles attachées via les attributs <code>popup</code> ou <code>context</code>. Pour les autres types, la valeur n'est pas modifiée. Dans ces autres cas, par exemple lors de l'appel de la méthode <a href="/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/showPopup">showPopup</a> de la fenêtre contextuelle, vous pouvez définir la propriété <code>popupNode</code> directement au préalable.</p> +Cette propriété est uniquement définie pour les fenêtres contextuelles attachées via les attributs `popup` ou `context`. Pour les autres types, la valeur n'est pas modifiée. Dans ces autres cas, par exemple lors de l'appel de la méthode [showPopup](/fr/docs/Mozilla/Tech/XUL/M%C3%A9thodes/showPopup) de la fenêtre contextuelle, vous pouvez définir la propriété `popupNode` directement au préalable. -<p>Cette propriété s'applique seulement aux documents XUL.</p> +Cette propriété s'applique seulement aux documents XUL. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <var>node</var> = <var>document</var>.popupNode; -</pre> + var node = document.popupNode; -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: xml"><menupopup id="toolbarContextMenu"> +```xml +<menupopup id="toolbarContextMenu"> ... - <menuitem oncommand="mailNewsCore.deleteButton(document.popupNode)"> + <menuitem oncommand="mailNewsCore.deleteButton(document.popupNode)"> ... -</menupopup> -</pre> +</menupopup> +``` -<p>Voir <a href="http://www.mozilla.org/xpfe/xptoolkit/popups.html">http://www.mozilla.org/xpfe/xptoolkit/popups.html</a></p> +Voir <http://www.mozilla.org/xpfe/xptoolkit/popups.html> -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>Défini dans {{Source("dom/public/idl/xul/nsIDOMXULDocument.idl#48", "nsIDOMXULDocument.idl")}}. méthode spécifique XUL. Ne fait partie d'aucune spécification.</li> -</ul> +- Défini dans {{Source("dom/public/idl/xul/nsIDOMXULDocument.idl#48", "nsIDOMXULDocument.idl")}}. méthode spécifique XUL. Ne fait partie d'aucune spécification. diff --git a/files/fr/web/api/document/preferredstylesheetset/index.md b/files/fr/web/api/document/preferredstylesheetset/index.md index ab47840dd3..9dabb35946 100644 --- a/files/fr/web/api/document/preferredstylesheetset/index.md +++ b/files/fr/web/api/document/preferredstylesheetset/index.md @@ -10,39 +10,35 @@ tags: - Reference translation_of: Web/API/Document/preferredStyleSheetSet --- -<div>{{APIRef("DOM")}}{{gecko_minversion_header("1.9")}}</div> +{{APIRef("DOM")}}{{gecko_minversion_header("1.9")}} -<p>Retourne la feuille de style préférée, telle que définie par l'auteur de la page.</p> +Retourne la feuille de style préférée, telle que définie par l'auteur de la page. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>preferredStyleSheetSet</var> = document.preferredStyleSheetSet -</pre> + preferredStyleSheetSet = document.preferredStyleSheetSet -<p>Au retour, <code>preferredStyleSheetSet</code> indique la feuille de style préférée par l'auteur. Ceci est déterminé par l'ordre des déclarations des feuilles de style et par l'entête HTTP intitulé <code>Default-Style</code>.</p> +Au retour, `preferredStyleSheetSet` indique la feuille de style préférée par l'auteur. Ceci est déterminé par l'ordre des déclarations des feuilles de style et par l'entête HTTP intitulé `Default-Style`. -<p>En l'absence de feuille de style préférée, une chaine vide ("") est retournée.</p> +En l'absence de feuille de style préférée, une chaine vide ("") est retournée. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">if (document.preferredStyleSheetSet) { +```js +if (document.preferredStyleSheetSet) { console.log("La feuille de style préférée est : " + document.preferredStyleSheetSet); } else { console.log("Il n'y a pas de feuille de style préférée."); } -</pre> +``` -<h2 id="Specification">Spécifications</h2> +## Spécifications -<ul> - <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets">HTML5: Alternate Style Sheets</a></li> -</ul> +- [HTML5: Alternate Style Sheets](http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets) -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("document.lastStyleSheetSet")}}</li> - <li>{{domxref("document.selectedStyleSheetSet")}}</li> - <li>{{domxref("document.styleSheetSets")}}</li> - <li>{{domxref("document.enableStyleSheetsForSet()")}}</li> -</ul> +- {{domxref("document.lastStyleSheetSet")}} +- {{domxref("document.selectedStyleSheetSet")}} +- {{domxref("document.styleSheetSets")}} +- {{domxref("document.enableStyleSheetsForSet()")}} diff --git a/files/fr/web/api/document/querycommandstate/index.md b/files/fr/web/api/document/querycommandstate/index.md index ca874815cb..aae32ace2b 100644 --- a/files/fr/web/api/document/querycommandstate/index.md +++ b/files/fr/web/api/document/querycommandstate/index.md @@ -7,43 +7,31 @@ tags: - Document translation_of: Web/API/Document/queryCommandState --- -<div>{{ApiRef("DOM")}}</div> +{{ApiRef("DOM")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">queryCommandState(String command) -</pre> +```js +queryCommandState(String command) +``` -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>TBD</p> +TBD -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('HTML Editing','#execcommand()','execCommand')}}</td> - <td>{{Spec2('HTML Editing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------- | -------------------------------- | -------------------- | +| {{SpecName('HTML Editing','#execcommand()','execCommand')}} | {{Spec2('HTML Editing')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.queryCommandState")}}</p> +{{Compat("api.Document.queryCommandState")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("HTMLElement.contentEditable")}}</li> - <li>{{domxref("document.designMode")}}</li> - <li><a href="/fr/docs/Web/Guide/HTML/Editable_content/Rich-Text_Editing_in_Mozilla">Rich-Text Editing in Mozilla</a></li> - <li>Les bogues du navigateur liés à <code>queryCommandState()</code>: <a href="https://github.com/guardian/scribe/blob/master/BROWSERINCONSISTENCIES.md#documentquerycommandstate">Scribe's "Browser Inconsistencies" documentation</a></li> -</ul> +- {{domxref("HTMLElement.contentEditable")}} +- {{domxref("document.designMode")}} +- [Rich-Text Editing in Mozilla](/fr/docs/Web/Guide/HTML/Editable_content/Rich-Text_Editing_in_Mozilla) +- Les bogues du navigateur liés à `queryCommandState()`: [Scribe's "Browser Inconsistencies" documentation](https://github.com/guardian/scribe/blob/master/BROWSERINCONSISTENCIES.md#documentquerycommandstate) diff --git a/files/fr/web/api/document/querycommandsupported/index.md b/files/fr/web/api/document/querycommandsupported/index.md index ddd356a31b..9e31a74d0f 100644 --- a/files/fr/web/api/document/querycommandsupported/index.md +++ b/files/fr/web/api/document/querycommandsupported/index.md @@ -10,63 +10,48 @@ tags: - editeur translation_of: Web/API/Document/queryCommandSupported --- -<div>{{ApiRef("DOM")}}</div> +{{ApiRef("DOM")}} -<p>La méthode <code><strong>Document.queryCommandSupported()</strong></code> indique si la commande d'éditeur spécifiée est prise en charge par le navigateur.</p> +La méthode **`Document.queryCommandSupported()`** indique si la commande d'éditeur spécifiée est prise en charge par le navigateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>isSupported</var> = document.queryCommandSupported(<var>command</var>); -</pre> + isSupported = document.queryCommandSupported(command); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>command</code></dt> - <dd>La commande pour laquelle on veut déterminer si elle est prise en charge.</dd> -</dl> +- `command` + - : La commande pour laquelle on veut déterminer si elle est prise en charge. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Renvoie un {{jsxref("Boolean")}} qui est <code>true</code> (<em>vrai</em>) si la commande est prise en charge et <code>false</code> (<em>faux</em>) sinon.</p> +Renvoie un {{jsxref("Boolean")}} qui est `true` (_vrai_) si la commande est prise en charge et `false` (_faux_) sinon. -<h2 id="Notes">Notes</h2> +## Notes -<p>La commande <code>'paste'</code> (<em>coller</em>) renvoie <code>false</code> (<em>faux</em>), pas seulement si la fonctionnalité n'est pas disponible, mais également si le script l'appelant a des privilèges insuffisants pour réaliser l'action <a href="#note1">[1]</a>.</p> +La commande `'paste'` (_coller_) renvoie `false` (_faux_), pas seulement si la fonctionnalité n'est pas disponible, mais également si le script l'appelant a des privilèges insuffisants pour réaliser l'action [\[1\]](#note1). -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush:js">var flg = document.queryCommandSupported("SelectAll"); +```js +var flg = document.queryCommandSupported("SelectAll"); if(flg) { // ...Faire quelque chose } -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('HTML Editing','#querycommandsupported()','querycommandsupported')}}</td> - <td>{{Spec2('HTML Editing')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.queryCommandSupported")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("Document.execCommand()")}}</li> - <li>{{domxref("Document.queryCommandEnabled()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------- | +| {{SpecName('HTML Editing','#querycommandsupported()','querycommandsupported')}} | {{Spec2('HTML Editing')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Document.queryCommandSupported")}} + +## Voir aussi + +- {{domxref("Document.execCommand()")}} +- {{domxref("Document.queryCommandEnabled()")}} diff --git a/files/fr/web/api/document/queryselector/index.md b/files/fr/web/api/document/queryselector/index.md index bb81eb32c0..5b3e19ea84 100644 --- a/files/fr/web/api/document/queryselector/index.md +++ b/files/fr/web/api/document/queryselector/index.md @@ -12,58 +12,52 @@ tags: - Échappement translation_of: Web/API/Document/querySelector --- -<div>{{ ApiRef("DOM") }}</div> +{{ ApiRef("DOM") }} -<p>La méthode <code><strong>querySelector()</strong></code> de l'interface {{domxref("Document")}} retourne le premier {{domxref("Element")}} dans le document correspondant au sélecteur - ou groupe de sélecteurs - spécifié(s), ou <code>null</code> si aucune correspondance n'est trouvée.</p> +La méthode **`querySelector()`** de l'interface {{domxref("Document")}} retourne le premier {{domxref("Element")}} dans le document correspondant au sélecteur - ou groupe de sélecteurs - spécifié(s), ou `null` si aucune correspondance n'est trouvée. -<div class="note"> -<p><strong>Note :</strong> La correspondance est effectuée en utilisant le parcours pré-ordonné profondeur-d'abord des nœuds du document, en partant du premier élément dans le balisage du document et en itérant à travers les nœuds en séquence, par ordre du compte de nœuds enfants.</p> -</div> +> **Note :** La correspondance est effectuée en utilisant le parcours pré-ordonné profondeur-d'abord des nœuds du document, en partant du premier élément dans le balisage du document et en itérant à travers les nœuds en séquence, par ordre du compte de nœuds enfants. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">element = document.querySelector(sélecteurs); -</pre> +```js +element = document.querySelector(sélecteurs); +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>selectors</code> (sélecteurs)</dt> - <dd>une {{domxref("DOMString")}} (<em>chaîne de caractères</em>) qui contient un ou plusieurs sélecteurs à comparer. La chaîne doit être composée de sélecteurs CSS valides ; sinon une exception <code>SYNTAX_ERR</code> est lancée. Voir <a href="/fr/docs/Web/API/Document_Object_Model/Localisation_des_%C3%A9l%C3%A9ments_DOM_avec_les_s%C3%A9lecteurs">Localisation des éléments DOM avec les sélecteurs</a> pour plus d'informations sur les sélecteurs et leur gestion.</dd> -</dl> +- `selectors` (sélecteurs) + - : une {{domxref("DOMString")}} (_chaîne de caractères_) qui contient un ou plusieurs sélecteurs à comparer. La chaîne doit être composée de sélecteurs CSS valides ; sinon une exception `SYNTAX_ERR` est lancée. Voir [Localisation des éléments DOM avec les sélecteurs](/fr/docs/Web/API/Document_Object_Model/Localisation_des_%C3%A9l%C3%A9ments_DOM_avec_les_s%C3%A9lecteurs) pour plus d'informations sur les sélecteurs et leur gestion. -<div class="note"> -<p><strong>Note :</strong> les caractères qui n'appartiennent pas à la syntaxe standard CSS doivent être échappés par un antislash ("\"). Puisque JavaScript utilise aussi cette barre pour l'échappement, une attention particulière est nécessaire quand des chaînes comprennent ces caractères. Voir {{anch("Caractère spécial d'échappement")}} pour plus d'informations.</p> -</div> +> **Note :** les caractères qui n'appartiennent pas à la syntaxe standard CSS doivent être échappés par un antislash ("\\"). Puisque JavaScript utilise aussi cette barre pour l'échappement, une attention particulière est nécessaire quand des chaînes comprennent ces caractères. Voir {{anch("Caractère spécial d'échappement")}} pour plus d'informations. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Un objet {{domxref("Element")}} représentant le premier élément dans le document qui corresponde au jeu de <a href="/fr/docs/Web/CSS/S%C3%A9lecteurs_CSS">sélecteurs CSS</a> spécifié, ou <code>null</code> s'il n'y a pas de correspondances.</p> +Un objet {{domxref("Element")}} représentant le premier élément dans le document qui corresponde au jeu de [sélecteurs CSS](/fr/docs/Web/CSS/S%C3%A9lecteurs_CSS) spécifié, ou `null` s'il n'y a pas de correspondances. -<p>Si vous avez besoin d'une liste de tous les éléments correspondant aux sélecteurs spécifiés, vous devez utiliser {{domxref("Document.querySelectorAll", "querySelectorAll()")}} à la place.</p> +Si vous avez besoin d'une liste de tous les éléments correspondant aux sélecteurs spécifiés, vous devez utiliser {{domxref("Document.querySelectorAll", "querySelectorAll()")}} à la place. -<h3 id="Exception">Exception</h3> +### Exception -<dl> - <dt><code>SYNTAX_ERR</code></dt> - <dd>La syntaxe des sélecteurs spécifiés est invalide.</dd> -</dl> +- `SYNTAX_ERR` + - : La syntaxe des sélecteurs spécifiés est invalide. -<h2 id="Notes">Notes d'utilisation</h2> +## Notes d'utilisation -<p>Si le sélecteur correspond à un ID et que cet ID est utilisé de façon erronée plusieurs fois dans le document, le premier élément en correspondance est retourné.</p> +Si le sélecteur correspond à un ID et que cet ID est utilisé de façon erronée plusieurs fois dans le document, le premier élément en correspondance est retourné. -<p>Les <a href="/fr/docs/Web/CSS/Pseudo-elements">pseudo-éléments</a> CSS ne retourneront jamais aucun élément, comme spécifié dans l'<a href="http://www.w3.org/TR/selectors-api/#grammar">API des sélecteurs</a> (en).</p> +Les [pseudo-éléments](/fr/docs/Web/CSS/Pseudo-elements) CSS ne retourneront jamais aucun élément, comme spécifié dans l'[API des sélecteurs](http://www.w3.org/TR/selectors-api/#grammar) (en). -<h3 id="Caractère_spécial_d'échappement">Caractère spécial d'échappement</h3> +### Caractère spécial d'échappement -<p>Pour faire correspondre un ID (<em>identifiant</em>) ou un sélecteur qui ne respecte pas la syntaxe CSS (en utilisant un point virgule ou un espace par exemple), vous devez échapper le caractère avec un antislash (\). Comme l'antislash est un caractère d'échappement en JavaScript, si vous entrez une chaîne de caractères littérale, vous devez donc l'échapper <em>deux fois</em> (une pour la chaîne de caractères JavaScript et une autre fois pour <code>querySelector</code>) :</p> +Pour faire correspondre un ID (_identifiant_) ou un sélecteur qui ne respecte pas la syntaxe CSS (en utilisant un point virgule ou un espace par exemple), vous devez échapper le caractère avec un antislash (\\). Comme l'antislash est un caractère d'échappement en JavaScript, si vous entrez une chaîne de caractères littérale, vous devez donc l'échapper _deux fois_ (une pour la chaîne de caractères JavaScript et une autre fois pour `querySelector`) : -<pre class="brush: html"><div id="machin\bidule"></div> -<div id="machin:bidule"></div> +```html +<div id="machin\bidule"></div> +<div id="machin:bidule"></div> -<script> - console.log('#machin\bidule') // "#machinidule" <code>(\b est le caractère de contrôle retour arrière)</code> +<script> + console.log('#machin\bidule') // "#machinidule" (\b est le caractère de contrôle retour arrière) document.querySelector('#machin\bidule') // ne correspond à rien console.log('#machin\\bidule') // "#machin\bidule" @@ -72,55 +66,42 @@ translation_of: Web/API/Document/querySelector document.querySelector('#machin:bidule') // ne correspond à rien document.querySelector('#machin\\:bidule') // correspond au second div -</script> -</pre> +</script> +``` -<h2 id="Exemple">Exemples</h2> +## Exemples -<h3 id="Trouver_le_premier_élément_correspondant_à_une_classe">Trouver le premier élément correspondant à une classe</h3> +### Trouver le premier élément correspondant à une classe -<p>Dans cet exemple, le premier élément dans le document qui contient la classe "<code>maclasse</code>" est retourné :</p> +Dans cet exemple, le premier élément dans le document qui contient la classe "`maclasse`" est retourné : -<pre class="brush: js">var el = document.querySelector(".maclasse");</pre> +```js +var el = document.querySelector(".maclasse"); +``` -<h3 id="Notes">Un sélecteur plus complexe</h3> +### Un sélecteur plus complexe -<p>Les <em>sélecteurs</em> peuvent également être réellement puissants comme le montre l'exemple suivant. Ici, le premier élément <code><input name="identifiant"/></code> dans un <code><div class="panneau-utilisateur principal"></code> dans le document est retourné :</p> +Les _sélecteurs_ peuvent également être réellement puissants comme le montre l'exemple suivant. Ici, le premier élément `<input name="identifiant"/>` dans un `<div class="panneau-utilisateur principal">` dans le document est retourné : -<pre class="brush: js">var el = document.querySelector("div.panneau-utilisateur.principal input[name='<code>identifiant</code>']");</pre> +```js +var el = document.querySelector("div.panneau-utilisateur.principal input[name='identifiant']"); +``` -<h2 id="Browser_Compatibility">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("Selectors API Level 2", "#interface-definitions", "document.querySelector()")}}</td> - <td>{{Spec2("Selectors API Level 2")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("Selectors API Level 1", "#interface-definitions", "document.querySelector()")}}</td> - <td>{{Spec2("Selectors API Level 1")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | ------------------- | +| {{SpecName("Selectors API Level 2", "#interface-definitions", "document.querySelector()")}} | {{Spec2("Selectors API Level 2")}} | | +| {{SpecName("Selectors API Level 1", "#interface-definitions", "document.querySelector()")}} | {{Spec2("Selectors API Level 1")}} | Définition initiale | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<div>{{Compat("api.Document.querySelector")}}</div> +{{Compat("api.Document.querySelector")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/Document_Object_Model/Localisation_des_%C3%A9l%C3%A9ments_DOM_avec_les_s%C3%A9lecteurs">Localisation des éléments DOM avec les sélecteurs</a></li> - <li>{{domxref("document.querySelectorAll()")}} ;</li> - <li>{{domxref("element.querySelector()")}} ;</li> - <li>{{domxref("element.querySelectorAll()")}} ;</li> - <li><a href="/fr/docs/Archive/Add-ons/Code_snippets/QuerySelector">Extraits de code pour <code>querySelector</code></a></li> -</ul> +- [Localisation des éléments DOM avec les sélecteurs](/fr/docs/Web/API/Document_Object_Model/Localisation_des_%C3%A9l%C3%A9ments_DOM_avec_les_s%C3%A9lecteurs) +- {{domxref("document.querySelectorAll()")}} ; +- {{domxref("element.querySelector()")}} ; +- {{domxref("element.querySelectorAll()")}} ; +- [Extraits de code pour `querySelector`](/fr/docs/Archive/Add-ons/Code_snippets/QuerySelector) diff --git a/files/fr/web/api/document/queryselectorall/index.md b/files/fr/web/api/document/queryselectorall/index.md index 7b73477245..07088e2c73 100644 --- a/files/fr/web/api/document/queryselectorall/index.md +++ b/files/fr/web/api/document/queryselectorall/index.md @@ -9,156 +9,139 @@ tags: - Sélecteurs translation_of: Web/API/Document/querySelectorAll --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>La méthode <code><strong>querySelectorAll()</strong></code> de {{domxref("Element")}} renvoie une {{domxref("NodeList")}} statique représentant une liste des éléments du document qui correspondent au groupe de sélecteurs spécifiés.</p> +La méthode **`querySelectorAll()`** de {{domxref("Element")}} renvoie une {{domxref("NodeList")}} statique représentant une liste des éléments du document qui correspondent au groupe de sélecteurs spécifiés. -<div class="note"> -<p><strong>Note :</strong> Cette méthode est implémentée à partir de {{domxref("ParentNode")}}, méthode du mixin {{domxref("ParentNode.querySelectorAll", "querySelectorAll()")}} .</p> -</div> +> **Note :** Cette méthode est implémentée à partir de {{domxref("ParentNode")}}, méthode du mixin {{domxref("ParentNode.querySelectorAll", "querySelectorAll()")}} . -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"><var>elementList</var> = <em>parentNode</em>.querySelectorAll(<var>selectors</var>); -</pre> +```js +elementList = parentNode.querySelectorAll(selectors); +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>selecteurs</code></dt> - <dd>une {{domxref("DOMString")}} (<em>chaîne de caractères</em>) qui contient un ou plusieurs <a href="/fr/docs/Web/CSS/CSS_Selectors">sélecteurs CSS</a> ; s'il n'y en a pas, une exception <code>SyntaxError</code> est lancée. Voir <a href="/fr/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors">localisation des éléments DOM avec les sélecteurs</a> pour plus d'informations sur l'utilisation des sélecteurs en vue d'identifier les éléments. Plusieurs sélecteurs peuvent être spécifiés, séparés par une virgule.</dd> -</dl> +- `selecteurs` + - : une {{domxref("DOMString")}} (_chaîne de caractères_) qui contient un ou plusieurs [sélecteurs CSS](/fr/docs/Web/CSS/CSS_Selectors) ; s'il n'y en a pas, une exception `SyntaxError` est lancée. Voir [localisation des éléments DOM avec les sélecteurs](/fr/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors) pour plus d'informations sur l'utilisation des sélecteurs en vue d'identifier les éléments. Plusieurs sélecteurs peuvent être spécifiés, séparés par une virgule. -<div class="note"> -<p><strong>Note :</strong> Les caractères qui ne font pas partie de la syntaxe CSS standard doivent être échappés à l'aide d'une barre oblique inverse. Puisque JavaScript utilise également l'échappement en retour arrière, un soin particulier doit être pris lors de l'écriture de littéraux de chaîne utilisant ces caractères. Voir {{anch ("Echapper des caractères spéciaux")}} pour plus d'informations.</p> -</div> +> **Note :** Les caractères qui ne font pas partie de la syntaxe CSS standard doivent être échappés à l'aide d'une barre oblique inverse. Puisque JavaScript utilise également l'échappement en retour arrière, un soin particulier doit être pris lors de l'écriture de littéraux de chaîne utilisant ces caractères. Voir {{anch ("Echapper des caractères spéciaux")}} pour plus d'informations. -<h3 id="Valeur_renvoyée">Valeur renvoyée</h3> +### Valeur renvoyée -<p>Une {{domxref("NodeList")}} statique contenant un objet {{domxref("Element")}} pour chaque élément qui correspond à au-moins un des sélecteurs spécifiés ou une {{domxref("NodeList")}} vide si aucune correspondance n'est trouvée .</p> +Une {{domxref("NodeList")}} statique contenant un objet {{domxref("Element")}} pour chaque élément qui correspond à au-moins un des sélecteurs spécifiés ou une {{domxref("NodeList")}} vide si aucune correspondance n'est trouvée . -<div class="note"> -<p><strong>Note :</strong> Si les <code><em>selectors</em></code> spécifiés contiennent un <a href="/fr/docs/Web/CSS/Pseudo-elements">pseudo-element CSS</a>, la liste retournée sera toujours vide.</p> -</div> +> **Note :** Si les `selectors` spécifiés contiennent un [pseudo-element CSS](/fr/docs/Web/CSS/Pseudo-elements), la liste retournée sera toujours vide. -<h3 id="Exceptions">Exceptions</h3> +### Exceptions -<dl> - <dt><code>SyntaxError</code></dt> - <dd>la syntaxe des chaînes <code>selectors</code> spécifiés n'est pas valide.</dd> -</dl> +- `SyntaxError` + - : la syntaxe des chaînes `selectors` spécifiés n'est pas valide. -<h2 id="Example">Exemples</h2> +## Exemples -<p>Pour obtenir une {{domxref("NodeList")}} (<em>liste de noeuds</em>) de tous les éléments {{HTMLElement("p")}} dans le document :</p> +Pour obtenir une {{domxref("NodeList")}} (_liste de noeuds_) de tous les éléments {{HTMLElement("p")}} dans le document : -<pre class="brush: js">const matches = document.querySelectorAll("p");</pre> +```js +const matches = document.querySelectorAll("p"); +``` -<p>Cet exemple renvoie la liste de tous les éléments <code>div</code> du <code>document</code> dont l'attribut de classe a pour valeur "<code>note</code>" ou "<code>alert</code>" :</p> +Cet exemple renvoie la liste de tous les éléments `div` du `document` dont l'attribut de classe a pour valeur "`note`" ou "`alert`" : -<pre class="brush: js">const matches = document.querySelectorAll("div.note, div.alert"); -</pre> +```js +const matches = document.querySelectorAll("div.note, div.alert"); +``` -<p>Ici, nous obtenons une liste des éléments <code><p></code> dont l'élément parent immédiat est un {{domxref("div")}} avec la classe <code>"highlighted"</code> et qui sont situés dans un conteneur dont l'identifiant est <code>"test"</code>.</p> +Ici, nous obtenons une liste des éléments `<p>` dont l'élément parent immédiat est un {{domxref("div")}} avec la classe `"highlighted"` et qui sont situés dans un conteneur dont l'identifiant est `"test"`. -<pre class="brush: js">const container = document.querySelector("#test"); -const matches = container.querySelectorAll("div.highlighted > p");</pre> +```js +const container = document.querySelector("#test"); +const matches = container.querySelectorAll("div.highlighted > p"); +``` -<p>Cet exemple utilise un <a href="/fr/docs/Web/CSS/S%C3%A9lecteurs_d_attribut">sélecteur d'attribut</a> pour renvoyer une liste d'éléments {{domxref("iframe")}} dans le document qui contient un attribut nommé <code>"data-src"</code> :</p> +Cet exemple utilise un [sélecteur d'attribut](/fr/docs/Web/CSS/S%C3%A9lecteurs_d_attribut) pour renvoyer une liste d'éléments {{domxref("iframe")}} dans le document qui contient un attribut nommé `"data-src"` : -<pre class="brush: js">const matches = document.querySelectorAll("iframe[data-src]");</pre> +```js +const matches = document.querySelectorAll("iframe[data-src]"); +``` -<p>Ici, un sélecteur d'attribut est utilisé pour renvoyer une liste d'éléments de liste contenus dans une liste dont l'identifiant est <code>"userlist"</code> lequel a un attribut <code>"data-active"</code> dont la valeur est <code>"1"</code>:</p> +Ici, un sélecteur d'attribut est utilisé pour renvoyer une liste d'éléments de liste contenus dans une liste dont l'identifiant est `"userlist"` lequel a un attribut `"data-active"` dont la valeur est `"1"`: -<pre class="brush: js">const container = document.querySelector("#userlist"); -const matches = container.querySelectorAll("li[data-active='1']");</pre> +```js +const container = document.querySelector("#userlist"); +const matches = container.querySelectorAll("li[data-active='1']"); +``` -<h3 id="Accès_aux_correspondances">Accès aux correspondances</h3> +### Accès aux correspondances -<p>Une fois que la {{domxref("NodeList")}} des éléments correspondants est renvoyée, vous pouvez l'examiner comme un tableau (<em>array</em>). Si le tableau est vide (c'est quand sa propriété <code>length</code> est 0), alors aucune correspondance n'a été trouvée.</p> +Une fois que la {{domxref("NodeList")}} des éléments correspondants est renvoyée, vous pouvez l'examiner comme un tableau (_array_). Si le tableau est vide (c'est quand sa propriété `length` est 0), alors aucune correspondance n'a été trouvée. -<p>Sinon, vous pouvez simplement utiliser la notation de tableau standard pour accéder au contenu de la liste. Vous pouvez utiliser n'importe quelle instruction de boucle commune, telle que :</p> +Sinon, vous pouvez simplement utiliser la notation de tableau standard pour accéder au contenu de la liste. Vous pouvez utiliser n'importe quelle instruction de boucle commune, telle que : -<pre class="brush: js">const highlightedItems = userList.querySelectorAll(".highlighted"); +```js +const highlightedItems = userList.querySelectorAll(".highlighted"); highlightedItems.forEach(function(userItem) { deleteUser(userItem); -});</pre> +}); +``` -<h2 id="Notes">Notes d'utilisation</h2> +## Notes d'utilisation -<p><code>querySelectorAll()</code> se comporte différemment des bibliothèques DOM JavaScript les plus courantes, ce qui peut entraîner des résultats inattendus.</p> +`querySelectorAll()` se comporte différemment des bibliothèques DOM JavaScript les plus courantes, ce qui peut entraîner des résultats inattendus. -<h3 id="HTML">HTML</h3> +### HTML -<p>Considérez ce HTML, avec ses trois blocs {{HTMLElement("div")}} imbriqués.</p> +Considérez ce HTML, avec ses trois blocs {{HTMLElement("div")}} imbriqués. -<pre class="brush: html"><div class="outer"> - <div class="select"> - <div class="inner"> - </div> - </div> -</div></pre> +```html +<div class="outer"> + <div class="select"> + <div class="inner"> + </div> + </div> +</div> +``` -<h3 id="JavaScript">JavaScript</h3> +### JavaScript -<pre class="brush: js">const select = document.querySelector('.select'); +```js +const select = document.querySelector('.select'); const inner = select.querySelectorAll('.outer .inner'); -inner.length; // 1, not 0!</pre> +inner.length; // 1, not 0! +``` -<p>Dans cet exemple, lors de la sélection de <code>".outer .inner"</code> dans le contexte, le <code><div></code> avec la classe <code>"select"</code>, l'élément avec la classe <code>".inner"</code> est toujours trouvé, même si <code>.outer</code> n'est pas un descendant de l'élément de base sur lequel la recherche <code>(".select")</code> est effectuée. Par défaut, <code>querySelectorAll()</code> vérifie uniquement que le dernier élément du sélecteur se trouve dans la portée de la recherche.</p> +Dans cet exemple, lors de la sélection de `".outer .inner"` dans le contexte, le `<div>` avec la classe `"select"`, l'élément avec la classe `".inner"` est toujours trouvé, même si `.outer` n'est pas un descendant de l'élément de base sur lequel la recherche `(".select")` est effectuée. Par défaut, `querySelectorAll()` vérifie uniquement que le dernier élément du sélecteur se trouve dans la portée de la recherche. -<p>La pseudo-classe {{cssxref (":scope")}} restaure le comportement attendu, ne faisant correspondre les sélecteurs que sur les descendants de l'élément de base :</p> +La pseudo-classe {{cssxref (":scope")}} restaure le comportement attendu, ne faisant correspondre les sélecteurs que sur les descendants de l'élément de base : -<pre class="brush: js">const select = document.querySelector('.select'); +```js +const select = document.querySelector('.select'); const inner = select.querySelectorAll(':scope .outer .inner'); -inner.length; // 0</pre> - -<h2 id="Spécification">Spécification</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("DOM WHATWG", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}}</td> - <td>{{Spec2("DOM WHATWG")}}</td> - <td>Norme actuelle</td> - </tr> - <tr> - <td>{{SpecName("Selectors API Level 2", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}}</td> - <td>{{Spec2("Selectors API Level 2")}}</td> - <td>Pas de changement</td> - </tr> - <tr> - <td>{{SpecName("DOM4", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}}</td> - <td>{{Spec2("DOM4")}}</td> - <td>Définition initiale</td> - </tr> - <tr> - <td>{{SpecName("Selectors API Level 1", "#interface-definitions", "document.querySelector()")}}</td> - <td>{{Spec2("Selectors API Level 1")}}</td> - <td>Définition originale</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.querySelectorAll")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors">Localisation des éléments DOM avec les sélecteurs</a></li> - <li><a href="/fr/docs/Web/CSS/Attribute_selectors">Sélecteurs d'attribut</a> dans le guide CSS</li> - <li><a href="/fr/docs/Learn/CSS/Introduction_to_CSS/Attribute_selectors">Sélecteurs d'attribut</a> dans la zone d'apprentissage de MDN</li> - <li>{{domxref("Element.querySelectorAll")}} et {{domxref("Element.querySelectorAll()")}}</li> - <li>{{domxref("document.querySelector")}}</li> - <li>{{domxref("DocumentFragment.querySelector()")}} et {{domxref("DocumentFragment.querySelectorAll()")}}</li> - <li>{{domxref("ParentNode.querySelector()")}} et {{domxref("ParentNode.querySelectorAll()")}}</li> - <li><a href="/fr/docs/Code_snippets/QuerySelector">Extraits de code pour <code>querySelector</code></a></li> -</ul> +inner.length; // 0 +``` + +## Spécification + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | -------------------- | +| {{SpecName("DOM WHATWG", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}} | {{Spec2("DOM WHATWG")}} | Norme actuelle | +| {{SpecName("Selectors API Level 2", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}} | {{Spec2("Selectors API Level 2")}} | Pas de changement | +| {{SpecName("DOM4", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}} | {{Spec2("DOM4")}} | Définition initiale | +| {{SpecName("Selectors API Level 1", "#interface-definitions", "document.querySelector()")}} | {{Spec2("Selectors API Level 1")}} | Définition originale | + +## Compatibilité des navigateurs + +{{Compat("api.Document.querySelectorAll")}} + +## Voir aussi + +- [Localisation des éléments DOM avec les sélecteurs](/fr/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors) +- [Sélecteurs d'attribut](/fr/docs/Web/CSS/Attribute_selectors) dans le guide CSS +- [Sélecteurs d'attribut](/fr/docs/Learn/CSS/Introduction_to_CSS/Attribute_selectors) dans la zone d'apprentissage de MDN +- {{domxref("Element.querySelectorAll")}} et {{domxref("Element.querySelectorAll()")}} +- {{domxref("document.querySelector")}} +- {{domxref("DocumentFragment.querySelector()")}} et {{domxref("DocumentFragment.querySelectorAll()")}} +- {{domxref("ParentNode.querySelector()")}} et {{domxref("ParentNode.querySelectorAll()")}} +- [Extraits de code pour `querySelector`](/fr/docs/Code_snippets/QuerySelector) diff --git a/files/fr/web/api/document/readystate/index.md b/files/fr/web/api/document/readystate/index.md index 36d01f7c11..e90f271bc5 100644 --- a/files/fr/web/api/document/readystate/index.md +++ b/files/fr/web/api/document/readystate/index.md @@ -8,42 +8,40 @@ tags: - Référence(2) translation_of: Web/API/Document/readyState --- -<div>{{APIRef("DOM")}} {{ gecko_minversion_header("1.9.2") }}</div> +{{APIRef("DOM")}} {{ gecko_minversion_header("1.9.2") }} -<p>La valeur <strong>Document.readyState</strong> est une propriété de {{ domxref("document") }} qui décrit l'état de chargement du document.</p> +La valeur **Document.readyState** est une propriété de {{ domxref("document") }} qui décrit l'état de chargement du document. -<p>À chaque évolution de la valeur, un évenement {{event("readystatechange")}} est émis dans l'objet {{ domxref("document") }}.</p> +À chaque évolution de la valeur, un évenement {{event("readystatechange")}} est émis dans l'objet {{ domxref("document") }}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <var>string</var> = <var>document</var>.readyState; -</pre> + var string = document.readyState; -<h3 id="Valeurs">Valeurs</h3> +### Valeurs -<p>La variable <code>readyState</code><strong> </strong>peut valoir :</p> +La variable `readyState`\*\* \*\*peut valoir : -<dl> - <dt><code><strong>loading</strong></code></dt> - <dd>Le {{ domxref("document") }} est encore en chargement.</dd> - <dt><code><strong>interactive</strong></code></dt> - <dd>Le document a été chargé, mais les ressources (images, scripts, css..) sont encore en cours d'acquisition. En revanche la structure DOM est générée, et {{event("DOMContentLoaded")}} a été émis.</dd> - <dt><code><strong>complete</strong></code></dt> - <dd>Le document et toutes les sous-ressources ont été chargés, et {{event("load")}} a été émis.</dd> -</dl> +- **`loading`** + - : Le {{ domxref("document") }} est encore en chargement. +- **`interactive`** + - : Le document a été chargé, mais les ressources (images, scripts, css..) sont encore en cours d'acquisition. En revanche la structure DOM est générée, et {{event("DOMContentLoaded")}} a été émis. +- **`complete`** + - : Le document et toutes les sous-ressources ont été chargés, et {{event("load")}} a été émis. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Différents_états_de_chargement">Différents états de chargement</h3> +### Différents états de chargement -<pre class="brush: js">switch (document.readyState) { +```js +switch (document.readyState) { case "loading": // Encore en chargement. break; case "interactive": // Le DOM est construit, on peut y accéder. var span = document.createElement("span"); - span.textContent = "A <span> element."; + span.textContent = "A <span> element."; document.body.appendChild(span); break; case "complete": @@ -51,77 +49,61 @@ translation_of: Web/API/Document/readyState console.log("The first CSS rule is: " + document.styleSheets[0].cssRules[0].cssText); break; } -</pre> +``` -<h3 id="readystatechange_comme_alternative_à_DOMContentLoaded">readystatechange comme alternative à DOMContentLoaded</h3> +### readystatechange comme alternative à DOMContentLoaded -<pre class="brush:js">// alternative à DOMContentLoaded +```js +// alternative à DOMContentLoaded document.onreadystatechange = function () { if (document.readyState == "interactive") { initApplication(); } -}</pre> +} +``` -<h3 id="readystatechange_comme_alternative_à_load">readystatechange comme alternative à load</h3> +### readystatechange comme alternative à load -<pre class="brush: js">// alternative à load +```js +// alternative à load document.onreadystatechange = function () { if (document.readyState == "complete") { initApplication(); } -}</pre> +} +``` -<h3 id="readystatechange_comme_event_listener_pour_insérer_ou_modifier_le_DOM_avant_DOMContentLoaded">readystatechange comme event listener pour insérer ou modifier le DOM avant DOMContentLoaded</h3> +### readystatechange comme event listener pour insérer ou modifier le DOM avant DOMContentLoaded -<pre class="brush: js">// Modification du document <body> dès que possible en utilisant un script externe +```js +// Modification du document <body> dès que possible en utilisant un script externe var bootstrap = function(evt){ if (evt.target.readyState === "interactive") { initLoader(); } else if (evt.target.readyState === "complete") { initApp(); } } document.addEventListener('readystatechange', bootstrap, false); -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécifications</th> - <th scope="col">Status</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "#current-document-readiness", "Document readiness")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName("HTML5.1", "#current-document-readiness", "Document readiness")}}</td> - <td>{{Spec2('HTML5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName("HTML5 W3C", "#current-document-readiness", "Document readiness")}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td>Spécification initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<div>{{Compat("api.Document.readyState")}}</div> - -<p>[1] Ne supporte que 'complete'. Opera Presto notifie 'complete' seulement après l'événement 'load' (dans un ordre incorrect par rapport à la spécification du standard HTML5).</p> - -<p>[2] Internet Explorer 9 et 10 ont des bogues quand l'état 'interactive' <a href="https://bugs.jquery.com/ticket/12282">peut être notifié trop tôt</a> avant que le document soit entièrement analysé.</p> - -<p>[3] À l'introduction dans IE 4, la propriété était seulement disponible pour les objets document, embed, img, link, object, script, et style. IE 5 a étendu le support à tous les objets élément HTML.</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'événement {{event("readystatechange")}}</li> - <li>L'événement {{event("DOMContentLoaded")}}</li> - <li>L'événement {{event("load")}}</li> -</ul> +``` + +## Spécifications + +| Spécifications | Status | Commentaires | +| ------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------------------- | +| {{SpecName("HTML WHATWG", "#current-document-readiness", "Document readiness")}} | {{Spec2('HTML WHATWG')}} | | +| {{SpecName("HTML5.1", "#current-document-readiness", "Document readiness")}} | {{Spec2('HTML5.1')}} | | +| {{SpecName("HTML5 W3C", "#current-document-readiness", "Document readiness")}} | {{Spec2('HTML5 W3C')}} | Spécification initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Document.readyState")}} + +\[1] Ne supporte que 'complete'. Opera Presto notifie 'complete' seulement après l'événement 'load' (dans un ordre incorrect par rapport à la spécification du standard HTML5). + +\[2] Internet Explorer 9 et 10 ont des bogues quand l'état 'interactive' [peut être notifié trop tôt](https://bugs.jquery.com/ticket/12282) avant que le document soit entièrement analysé. + +\[3] À l'introduction dans IE 4, la propriété était seulement disponible pour les objets document, embed, img, link, object, script, et style. IE 5 a étendu le support à tous les objets élément HTML. + +## Voir aussi + +- L'événement {{event("readystatechange")}} +- L'événement {{event("DOMContentLoaded")}} +- L'événement {{event("load")}} diff --git a/files/fr/web/api/document/readystatechange_event/index.md b/files/fr/web/api/document/readystatechange_event/index.md index 95c60dae30..c6f5652efe 100644 --- a/files/fr/web/api/document/readystatechange_event/index.md +++ b/files/fr/web/api/document/readystatechange_event/index.md @@ -4,64 +4,38 @@ slug: Web/API/Document/readystatechange_event translation_of: Web/API/Document/readystatechange_event original_slug: Web/Events/readystatechange --- -<p>{{ApiRef}}</p> - -<p>L'événement <code>readystatechange</code> est déclenché lorsque l'attribut <a href="/fr/docs/DOM/document.readyState"> <code>readyState</code> </a> d'un document a changé.</p> - -<h2 id="Information_générale">Information générale</h2> - -<dl> - <dt style="float: left; text-align: right; width: 120px;">Specification</dt> - <dd style="margin: 0 0 0 120px;"><a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#current-document-readiness">HTML5</a></dd> - <dt style="float: left; text-align: right; width: 120px;">Interface</dt> - <dd style="margin: 0 0 0 120px;">Event</dd> - <dt style="float: left; text-align: right; width: 120px;">Bubbles</dt> - <dd style="margin: 0 0 0 120px;">No</dd> - <dt style="float: left; text-align: right; width: 120px;">Cancelable</dt> - <dd style="margin: 0 0 0 120px;">No</dd> - <dt style="float: left; text-align: right; width: 120px;">Target</dt> - <dd style="margin: 0 0 0 120px;">Document</dd> - <dt style="float: left; text-align: right; width: 120px;">Default Action</dt> - <dd style="margin: 0 0 0 120px;">None.</dd> -</dl> - -<h2 id="propriétés">propriétés</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td>{{domxref("EventTarget")}}</td> - <td>The event target (the topmost target in the DOM tree).</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td>{{domxref("DOMString")}}</td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td>{{jsxref("Boolean")}}</td> - <td>Whether the event normally bubbles or not.</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td>{{jsxref("Boolean")}}</td> - <td>Whether the event is cancellable or not.</td> - </tr> - </tbody> -</table> - -<h2 id="exemple">exemple</h2> - -<pre class="brush: js">document.readyState === "complete"; +{{ApiRef}} + +L'événement `readystatechange` est déclenché lorsque l'attribut [`readyState` ](/fr/docs/DOM/document.readyState)d'un document a changé. + +## Information générale + +- Specification + - : [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#current-document-readiness) +- Interface + - : Event +- Bubbles + - : No +- Cancelable + - : No +- Target + - : Document +- Default Action + - : None. + +## propriétés + +| Property | Type | Description | +| ------------------------------------- | ------------------------------------ | ------------------------------------------------------ | +| `target` {{readonlyInline}} | {{domxref("EventTarget")}} | The event target (the topmost target in the DOM tree). | +| `type` {{readonlyInline}} | {{domxref("DOMString")}} | The type of event. | +| `bubbles` {{readonlyInline}} | {{jsxref("Boolean")}} | Whether the event normally bubbles or not. | +| `cancelable` {{readonlyInline}} | {{jsxref("Boolean")}} | Whether the event is cancellable or not. | + +## exemple + +```js +document.readyState === "complete"; // true @@ -71,18 +45,16 @@ document.onreadystatechange = function () { initApplication(); } } -</pre> +``` -<h2 id="Navigateur_compatible">Navigateur compatible</h2> +## Navigateur compatible -<p>Cet événement a longtemps été soutenue par Internet Explorer et peut être utilisé comme une alternative à l'evenement <code><a href="/fr/docs/">DOMContentLoaded</a></code> (voir la note [2] de la section <a href="/fr/docs/Web/Events/DOMContentLoaded#Navigateurs_compatibles">Navigateurs compatibles</a>).</p> +Cet événement a longtemps été soutenue par Internet Explorer et peut être utilisé comme une alternative à l'evenement [`DOMContentLoaded`](/fr/docs/) (voir la note \[2] de la section [Navigateurs compatibles](/fr/docs/Web/Events/DOMContentLoaded#Navigateurs_compatibles)). -<h2 id="Les_événements_liés">Les événements liés</h2> +## Les événements liés -<ul> - <li>{{event("DOMContentLoaded")}}</li> - <li>{{event("readystatechange")}}</li> - <li>{{event("load")}}</li> - <li>{{event("beforeunload")}}</li> - <li>{{event("unload")}}</li> -</ul> +- {{event("DOMContentLoaded")}} +- {{event("readystatechange")}} +- {{event("load")}} +- {{event("beforeunload")}} +- {{event("unload")}} diff --git a/files/fr/web/api/document/referrer/index.md b/files/fr/web/api/document/referrer/index.md index 075f837b2a..4c87c8e53d 100644 --- a/files/fr/web/api/document/referrer/index.md +++ b/files/fr/web/api/document/referrer/index.md @@ -8,16 +8,20 @@ tags: - Reference translation_of: Web/API/Document/referrer --- -<div> - {{APIRef}}</div> -<h2 id="Syntax">Résumé</h2> -<p>Renvoie l'<a href="http://www.w3.org/Addressing/#background">URI</a> de la page de provenance.</p> -<h2 id="Syntax">Syntaxe</h2> -<pre class="syntaxbox"><var>string</var> = document.referrer; -</pre> -<h2 id="Notes">Notes</h2> -<p>La valeur est une chaîne de caractères vide si l'utilisateur est arrivé directement sur la page (pas grâce à un lien, mais, par exemple, via un marque-page). Étant donné que cette propriété ne retourne qu'une chaîne, elle ne vous donne pas un accès DOM à la page de provenance.</p> -<h2 id="Specification">Spécification</h2> -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-95229140">DOM Level 2: referrer</a></li> -</ul> +{{APIRef}} + +## Résumé + +Renvoie l'[URI](http://www.w3.org/Addressing/#background) de la page de provenance. + +## Syntaxe + + string = document.referrer; + +## Notes + +La valeur est une chaîne de caractères vide si l'utilisateur est arrivé directement sur la page (pas grâce à un lien, mais, par exemple, via un marque-page). Étant donné que cette propriété ne retourne qu'une chaîne, elle ne vous donne pas un accès DOM à la page de provenance. + +## Spécification + +- [DOM Level 2: referrer](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-95229140) diff --git a/files/fr/web/api/document/registerelement/index.md b/files/fr/web/api/document/registerelement/index.md index 8512a48f5f..37a87f3cfe 100644 --- a/files/fr/web/api/document/registerelement/index.md +++ b/files/fr/web/api/document/registerelement/index.md @@ -10,56 +10,52 @@ tags: - Référence(2) translation_of: Web/API/Document/registerElement --- -<p>{{APIRef("DOM")}} {{Deprecated_header}}</p> +{{APIRef("DOM")}} {{Deprecated_header}} -<div class="warning"> -<p><strong>Attention :</strong> document.registerElement() est déprécié en faveur de <a href="/fr/docs/Web/API/CustomElementRegistry/define">customElements.define()</a>.</p> -</div> +> **Attention :** document.registerElement() est déprécié en faveur de [customElements.define()](/fr/docs/Web/API/CustomElementRegistry/define). -<p>{{draft}}</p> +{{draft}} -<p>La méthode <code><strong>Document.registerElement()</strong></code> permet d'enregistrer un nouvel <a href="/fr/docs/Web/Web_Components/Custom_Elements">élément personnalisé</a> dans le navigateur, et retourne un constructeur pour ce nouvel élément.</p> +La méthode **`Document.registerElement()`** permet d'enregistrer un nouvel [élément personnalisé](/fr/docs/Web/Web_Components/Custom_Elements) dans le navigateur, et retourne un constructeur pour ce nouvel élément. -<div class="note"> -<p><strong>Note :</strong> Il s'agit d'une technologie expérimentale. Le navigateur dans lequel vous l'utilisez doit être compatible avec les Composants Web. Voir <a href="/fr/docs/Web/Web_Components#Activer_les_Web_Components_dans_Firefox">Activer les Composants Web dans Firefox</a>.</p> -</div> +> **Note :** Il s'agit d'une technologie expérimentale. Le navigateur dans lequel vous l'utilisez doit être compatible avec les Composants Web. Voir [Activer les Composants Web dans Firefox](/fr/docs/Web/Web_Components#Activer_les_Web_Components_dans_Firefox). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <em>constructeur</em> = document.registerElement(<em>nom-tag</em>, <em>options</em>);</pre> + var constructeur = document.registerElement(nom-tag, options); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><em>nom-tag</em></dt> - <dd>Le nom de l'élément personnalisé. Le nom doit contenir un tiret (-), par exemple <code>mon-tag</code>.</dd> - <dt><em>options {{optional_inline}}</em></dt> - <dd>Un objet définissant le prototype sur lequel se base l'élément personnalisé, ainsi qu'un tag existant à étendre.</dd> -</dl> +- _nom-tag_ + - : Le nom de l'élément personnalisé. Le nom doit contenir un tiret (-), par exemple `mon-tag`. +- _options {{optional_inline}}_ + - : Un objet définissant le prototype sur lequel se base l'élément personnalisé, ainsi qu'un tag existant à étendre. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Voici un exemple très simple :</p> +Voici un exemple très simple : -<pre class="brush: js">var Montag = document.registerElement('mon-tag'); -</pre> +```js +var Montag = document.registerElement('mon-tag'); +``` -<p>Le nouveau tag est désormais enregistré dans le navigateur. La variable <code>Montag</code> contient un constructeur que vous pouvez utiliser pour créer des éléments <code>mon-tag</code> dans le document de la façon suivante :</p> +Le nouveau tag est désormais enregistré dans le navigateur. La variable `Montag` contient un constructeur que vous pouvez utiliser pour créer des éléments `mon-tag` dans le document de la façon suivante : -<pre class="brush: js">document.body.appendChild(new Montag());</pre> +```js +document.body.appendChild(new Montag()); +``` -<p>Ceci insert un élément <code>mon-tag</code> vide qui sera visible si vous utilisez les outils de développement du navigateur. Il ne sera pas visible si vous utilisez la fonction de visualisation de la source du navigateur. Et il ne sera pas visible dans le navigateur tant que vous n'aurez pas ajouter du contenu au tag. Ce qui suit est un exemple d'ajout de contenu au nouveau tag :</p> +Ceci insert un élément `mon-tag` vide qui sera visible si vous utilisez les outils de développement du navigateur. Il ne sera pas visible si vous utilisez la fonction de visualisation de la source du navigateur. Et il ne sera pas visible dans le navigateur tant que vous n'aurez pas ajouter du contenu au tag. Ce qui suit est un exemple d'ajout de contenu au nouveau tag : -<pre class="brush: js">var montag = document.getElementsByTagName("mon-tag")[0]; +```js +var montag = document.getElementsByTagName("mon-tag")[0]; montag.textContent = "Je suis un élément mon-tag."; -</pre> +``` -<h2 id="Compatibilité_avec_les_navigateurs">Compatibilité avec les navigateurs</h2> +## Compatibilité avec les navigateurs -<p>{{Compat("api.Document.registerElement")}}</p> +{{Compat("api.Document.registerElement")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/Web_Components/Custom_Elements">Éléments personnalisés</a></li> -</ul> +- [Éléments personnalisés](/fr/docs/Web/Web_Components/Custom_Elements) diff --git a/files/fr/web/api/document/releasecapture/index.md b/files/fr/web/api/document/releasecapture/index.md index bb7cafb599..4e07757b26 100644 --- a/files/fr/web/api/document/releasecapture/index.md +++ b/files/fr/web/api/document/releasecapture/index.md @@ -10,29 +10,24 @@ tags: - Souris translation_of: Web/API/Document/releaseCapture --- -<div>{{ ApiRef("DOM") }} {{gecko_minversion_header("2.0")}}</div> +{{ ApiRef("DOM") }} {{gecko_minversion_header("2.0")}} -<div> </div> +Libère la capture de la souris si elle est actuellement activée (_bouton gauche enfoncé_) sur un élément de ce document. L'activation de la capture de la souris sur un élément se fait en appelant {{domxref("element.setCapture()")}}. -<p>Libère la capture de la souris si elle est actuellement activée (<em>bouton gauche enfoncé</em>) sur un élément de ce document. L'activation de la capture de la souris sur un élément se fait en appelant {{domxref("element.setCapture()")}}.</p> +## Syntaxe -<h2 id="Syntax">Syntaxe</h2> + document.releaseCapture() -<pre class="syntaxbox">document.releaseCapture() -</pre> +Une fois la capture de la souris relâchée, les événements de souris ne seront plus dirigés vers l'élément sur lequel la capture est activée. -<p>Une fois la capture de la souris relâchée, les événements de souris ne seront plus dirigés vers l'élément sur lequel la capture est activée.</p> +## Exemple -<h2 id="Example">Exemple</h2> +Voir l'[exemple](/en-US/docs/Web/API/element.setCapture#Example) pour {{domxref("element.setCapture()")}}. -<p>Voir l'<a href="/en-US/docs/Web/API/element.setCapture#Example">exemple</a> pour {{domxref("element.setCapture()")}}.</p> +## Spécifications -<h2 id="Specification">Spécifications</h2> +Basé sur l'implémentation Internet Explorer. -<p>Basé sur l'implémentation Internet Explorer.</p> +## Voir aussi -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li>{{domxref("element.setCapture()")}}</li> -</ul> +- {{domxref("element.setCapture()")}} diff --git a/files/fr/web/api/document/scripts/index.md b/files/fr/web/api/document/scripts/index.md index cf019c81d2..3f974461c6 100644 --- a/files/fr/web/api/document/scripts/index.md +++ b/files/fr/web/api/document/scripts/index.md @@ -9,47 +9,36 @@ tags: - Reference translation_of: Web/API/Document/scripts --- -<div>{{ApiRef}}</div> +{{ApiRef}} -<p>Retourne une liste des scripts (éléments {{HTMLElement("script")}}) présents dans le document. L'objet retourné est une liste du type {{domxref("HTMLCollection")}}.</p> +Retourne une liste des scripts (éléments {{HTMLElement("script")}}) présents dans le document. L'objet retourné est une liste du type {{domxref("HTMLCollection")}}. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var <var>scriptList</var> = document.scripts; -</pre> +```js +var scriptList = document.scripts; +``` -<p>La liste <code>scriptList</code> est un objet {{domxref("HTMLCollection")}} qu'on peut utiliser comme un tableau pour accéder aux éléments qu'elle contient.</p> +La liste `scriptList` est un objet {{domxref("HTMLCollection")}} qu'on peut utiliser comme un tableau pour accéder aux éléments qu'elle contient. -<h2 id="Example">Exemple</h2> +## Exemple -<p>Cet exemple détecte la présence d'éléments {{HTMLElement("script")}} dans le document.</p> +Cet exemple détecte la présence d'éléments {{HTMLElement("script")}} dans le document. -<pre class="brush:js">var scripts = document.scripts; +```js +var scripts = document.scripts; if (scripts.length) { alert("This page has scripts!"); } -</pre> - -<h2 id="Specifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', '#dom-document-scripts', 'Document.scripts')}}</td> - <td>{{ Spec2('HTML WHATWG') }}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<div>{{Compat("api.Document.scripts")}}</div> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | ------------------------------------ | ----------- | +| {{SpecName('HTML WHATWG', '#dom-document-scripts', 'Document.scripts')}} | {{ Spec2('HTML WHATWG') }} | | + +## Compatibilité des navigateurs + +{{Compat("api.Document.scripts")}} diff --git a/files/fr/web/api/document/scroll_event/index.md b/files/fr/web/api/document/scroll_event/index.md index 21c5ba592e..47a92ef23c 100644 --- a/files/fr/web/api/document/scroll_event/index.md +++ b/files/fr/web/api/document/scroll_event/index.md @@ -9,94 +9,66 @@ tags: - requestAnimationFrame translation_of: Web/API/Document/scroll_event --- -<div>{{APIRef}}</div> +{{APIRef}} -<p>L’évènement <strong><code>scroll</code></strong> (défilement) est émis lorsque l’on fait défiler le document ou un élément.</p> +L’évènement **`scroll`** (défilement) est émis lorsque l’on fait défiler le document ou un élément. -<h2 id="Informations_générales">Informations générales</h2> +## Informations générales <table class="properties"> - <tbody> - <tr> - <th>Bouillonne</th> - <td>Pas sur les éléments, mais bouillonne vers la defaultView si émis sur le document</td> - </tr> - <tr> - <th>Annulable</th> - <td>Non</td> - </tr> - <tr> - <th>Interface</th> - <td>{{domxref("UIEvent")}}</td> - </tr> - <tr> - <th>Cible</th> - <td>DefaultView, {{domxref("Document")}}, {{domxref("Element")}}</td> - </tr> - <tr> - <th>Action par défaut</th> - <td>Aucune</td> - </tr> - </tbody> + <tbody> + <tr> + <th>Bouillonne</th> + <td> + Pas sur les éléments, mais bouillonne vers la defaultView si émis sur le + document + </td> + </tr> + <tr> + <th>Annulable</th> + <td>Non</td> + </tr> + <tr> + <th>Interface</th> + <td>{{domxref("UIEvent")}}</td> + </tr> + <tr> + <th>Cible</th> + <td> + DefaultView, {{domxref("Document")}}, + {{domxref("Element")}} + </td> + </tr> + <tr> + <th>Action par défaut</th> + <td>Aucune</td> + </tr> + </tbody> </table> -<div class="note"> -<p><strong>Note :</strong> Sur iOS UIWebViews, les évènements <code>scroll</code> ne sont pas émis pendant le défilement, mais une fois que celui-ci est terminé. Voir <a href="https://github.com/twbs/bootstrap/issues/16202">Bootstrap issue #16202</a>. Safari et WKWebViews ne sont pas affectés par ce bogue.</p> -</div> +> **Note :** Sur iOS UIWebViews, les évènements `scroll` ne sont pas émis pendant le défilement, mais une fois que celui-ci est terminé. Voir [Bootstrap issue #16202](https://github.com/twbs/bootstrap/issues/16202). Safari et WKWebViews ne sont pas affectés par ce bogue. -<h2 id="Propriétés">Propriétés</h2> +## Propriétés -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Propriété</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td>{{domxref("EventTarget")}}</td> - <td>La cible de l’évènement (la plus haute dans l’arbre DOM).</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td>{{domxref("DOMString")}}</td> - <td>Le type d’évènement.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td>{{domxref("Boolean")}}</td> - <td>Si l’évènement bouillonne ou non.</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td>{{domxref("Boolean")}}</td> - <td>Si l’évènement est annulable ou non.</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td>{{domxref("WindowProxy")}}</td> - <td>{{domxref("Document.defaultView")}} (objet <code>window</code> du document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td><code>long</code> (<code>float</code>)</td> - <td>0.</td> - </tr> - </tbody> -</table> +| Propriété | Type | Description | +| ------------------------------------- | ------------------------------------ | ----------------------------------------------------------------------------- | +| `target` {{readonlyInline}} | {{domxref("EventTarget")}} | La cible de l’évènement (la plus haute dans l’arbre DOM). | +| `type` {{readonlyInline}} | {{domxref("DOMString")}} | Le type d’évènement. | +| `bubbles` {{readonlyInline}} | {{domxref("Boolean")}} | Si l’évènement bouillonne ou non. | +| `cancelable` {{readonlyInline}} | {{domxref("Boolean")}} | Si l’évènement est annulable ou non. | +| `view` {{readonlyInline}} | {{domxref("WindowProxy")}} | {{domxref("Document.defaultView")}} (objet `window` du document) | +| `detail` {{readonlyInline}} | `long` (`float`) | 0. | -<h2 id="Exemple">Exemple</h2> +## Exemple -<h3 id="Temporisation_des_évènements_scroll">Temporisation des évènements scroll</h3> +### Temporisation des évènements scroll -<p>Comme les évènements <code>scroll</code> peuvent être émis à une fréquence élevée, le gestionnaire d’évènements ne devrait pas effectuer des opérations coûteuses en termes de puissance de calcul, telles que des modification du DOM. À la place, il est recommandé de temporiser l’évènement en utilisant {{domxref("window.requestAnimationFrame()", "requestAnimationFrame()")}}, {{domxref("window.setTimeout()", "setTimeout()")}} ou un {{domxref("CustomEvent")}}, comme suit.</p> +Comme les évènements `scroll` peuvent être émis à une fréquence élevée, le gestionnaire d’évènements ne devrait pas effectuer des opérations coûteuses en termes de puissance de calcul, telles que des modification du DOM. À la place, il est recommandé de temporiser l’évènement en utilisant {{domxref("window.requestAnimationFrame()", "requestAnimationFrame()")}}, {{domxref("window.setTimeout()", "setTimeout()")}} ou un {{domxref("CustomEvent")}}, comme suit. -<p>Notez, cependant, que les évènements d’interface utilisateur et les frames d’animation sont émises à peu près à la même fréquence, et ainsi l’optimisation qui suit est souvent superflue. Cet exemple optimise l’évènement <code>scroll</code> avec <code>requestAnimationFrame</code>.</p> +Notez, cependant, que les évènements d’interface utilisateur et les frames d’animation sont émises à peu près à la même fréquence, et ainsi l’optimisation qui suit est souvent superflue. Cet exemple optimise l’évènement `scroll` avec `requestAnimationFrame`. -<pre class="brush: js">// Référence: http://www.html5rocks.com/en/tutorials/speed/animations/ +```js +// Référence: http://www.html5rocks.com/en/tutorials/speed/animations/ var derniere_position_de_scroll_connue = 0; var ticking = false; @@ -116,33 +88,32 @@ window.addEventListener('scroll', function(e) { } ticking = true; -});</pre> +}); +``` -<h3 id="Autres_exemples">Autres exemples</h3> +### Autres exemples -<p>Pour plus d’exemples similaires, voir l’évènement <a href="/en-US/docs/Web/Events/resize#Example">resize</a>.</p> +Pour plus d’exemples similaires, voir l’évènement [resize](/en-US/docs/Web/Events/resize#Example). -<h2 id="Spécifications">Spécifications</h2> +## Spécifications <table class="standard-table"> - <tbody> - <tr> - <td>Spécification</td> - <td>État</td> - </tr> - <tr> - <td>{{SpecName('CSSOM View', '#scrolling-events')}}</td> - <td>{{Spec2('CSSOM View')}}</td> - </tr> - </tbody> + <tbody> + <tr> + <td>Spécification</td> + <td>État</td> + </tr> + <tr> + <td>{{SpecName('CSSOM View', '#scrolling-events')}}</td> + <td>{{Spec2('CSSOM View')}}</td> + </tr> + </tbody> </table> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.scroll_event")}}</p> +{{Compat("api.Document.scroll_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("GlobalEventHandlers.onscroll")}}</li> -</ul> +- {{domxref("GlobalEventHandlers.onscroll")}} diff --git a/files/fr/web/api/document/selectedstylesheetset/index.md b/files/fr/web/api/document/selectedstylesheetset/index.md index 270c7d8821..8ec18bf3a4 100644 --- a/files/fr/web/api/document/selectedstylesheetset/index.md +++ b/files/fr/web/api/document/selectedstylesheetset/index.md @@ -9,47 +9,39 @@ tags: - Propriétés translation_of: Web/API/Document/selectedStyleSheetSet --- -<p>{{ APIRef("DOM") }}{{ gecko_minversion_header("1.9") }}</p> +{{ APIRef("DOM") }}{{ gecko_minversion_header("1.9") }} -<p>Indique le nom du jeu de feuilles de styles actuellement utilisé.</p> +Indique le nom du jeu de feuilles de styles actuellement utilisé. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>currentStyleSheetSet</em> = document.selectedStyleSheetSet + currentStyleSheetSet = document.selectedStyleSheetSet -document.selectedStyleSheet = <em>newStyleSheetSet</em> -</pre> + document.selectedStyleSheet = newStyleSheetSet -<p>En retour, <code>currentStyleSheetSet</code> indique le nom du jeu de feuilles de styles en cours d'utilisation. Vous pouvez aussi définir celui-ci en utilisant cette propriété.</p> +En retour, `currentStyleSheetSet` indique le nom du jeu de feuilles de styles en cours d'utilisation. Vous pouvez aussi définir celui-ci en utilisant cette propriété. -<p>La définition de la valeur de cette propriété équivaut à appeler {{ domxref("document.enableStyleSheetsForSet()") }} avec la valeur de <code>currentStyleSheetSet</code>, puis de définir la valeur de <code>lastStyleSheetSet</code> sur cette valeur.</p> +La définition de la valeur de cette propriété équivaut à appeler {{ domxref("document.enableStyleSheetsForSet()") }} avec la valeur de `currentStyleSheetSet`, puis de définir la valeur de `lastStyleSheetSet` sur cette valeur. -<div class="note"> - <p><strong>Note :</strong> Cette valeur d'attribut est directe : sa modification affectera la valeur de l'attribut.</p> -</div> +> **Note :** Cette valeur d'attribut est directe : sa modification affectera la valeur de l'attribut. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">console.log("Current style sheet set: " + document.selectedStyleSheetSet); +```js +console.log("Current style sheet set: " + document.selectedStyleSheetSet); document.selectedStyleSheetSet = "Some other style sheet"; -</pre> +``` -<div class="note"> - <p><strong>Note :</strong> Cet exemple vous aidera à comprendre la différence de comportement entre la définition de la valeur de <code>selectedStyleSheetSet</code> et l'appel de {{ domxref("document.enableStyleSheetsForSet()") }}.</p> -</div> +> **Note :** Cet exemple vous aidera à comprendre la différence de comportement entre la définition de la valeur de `selectedStyleSheetSet` et l'appel de {{ domxref("document.enableStyleSheetsForSet()") }}. -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{ domxref("document.lastStyleSheetSet") }}</li> - <li>{{ domxref("document.preferredStyleSheetSet") }}</li> - <li>{{ domxref("document.styleSheetSets") }}</li> - <li>{{ domxref("document.enableStyleSheetsForSet()") }}</li> -</ul> +- {{ domxref("document.lastStyleSheetSet") }} +- {{ domxref("document.preferredStyleSheetSet") }} +- {{ domxref("document.styleSheetSets") }} +- {{ domxref("document.enableStyleSheetsForSet()") }} -<h2 id="Specification">Spécifications</h2> +## Spécifications -<ul> - <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets">HTML5: Alternate Style Sheets</a></li> -</ul> +- [HTML5: Alternate Style Sheets](http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets) diff --git a/files/fr/web/api/document/stylesheets/index.md b/files/fr/web/api/document/stylesheets/index.md index 44b8d92e15..ab07cc650e 100644 --- a/files/fr/web/api/document/stylesheets/index.md +++ b/files/fr/web/api/document/stylesheets/index.md @@ -5,53 +5,27 @@ translation_of: Web/API/DocumentOrShadowRoot/styleSheets translation_of_original: Web/API/Document/styleSheets original_slug: Web/API/DocumentOrShadowRoot/styleSheets --- -<div>{{APIRef}}</div> - -<div>La propriété <strong><code>Document.styleSheets </code></strong>est en lecture seule et retourne une liste {{domxref("StyleSheetList")}} d'objets {{domxref("StyleSheet")}}, qui font référence à l'ensemble des feuilles de style contenues ou embarquées dans le document.</div> - -<div> </div> - -<h2 id="Syntax">Syntaxe</h2> - -<pre class="syntaxbox">var <var>styleSheetList</var> = <em>document</em>.styleSheets; -</pre> - -<p>L'objet retourné est une liste {{domxref("StyleSheetList")}}.</p> - -<p>Il s'agit d'une collection ordonnée d'objets {{domxref("StyleSheet")}}. <code><em>styleSheetList</em>.item(<em>index</em>)</code> ou <code><em>styleSheetList</em>{{ mediawiki.External('<em>index</em>') }}</code> retourne un seul objet stylesheet par son <code>index </code>(<code>index</code> débute par 0).</p> - -<h2 id="Specification">Spécification</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - </tbody> - <tbody> - <tr> - <td>{{SpecName('CSSOM', '#dom-document-stylesheets', 'styleSheets')}}</td> - <td>{{Spec2('CSSOM')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('DOM2 Style', 'stylesheets.html#StyleSheets-DocumentStyle-styleSheets', 'styleSheets')}}</td> - <td>{{Spec2('DOM2 Style')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li>{{Link("/en-US/docs/Web/API/CSS_Object_Model/Using_dynamic_styling_information")}}</li> -</ul> - -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-Style/stylesheets.html#StyleSheets-DocumentStyle-styleSheets">DOM Level 2 Style: styleSheets</a></li> -</ul> +{{APIRef}}La propriété **`Document.styleSheets `**est en lecture seule et retourne une liste {{domxref("StyleSheetList")}} d'objets {{domxref("StyleSheet")}}, qui font référence à l'ensemble des feuilles de style contenues ou embarquées dans le document. + +## Syntaxe + + var styleSheetList = document.styleSheets; + +L'objet retourné est une liste {{domxref("StyleSheetList")}}. + +Il s'agit d'une collection ordonnée d'objets {{domxref("StyleSheet")}}. `styleSheetList.item(index)` ou `styleSheetList{{ mediawiki.External('<em>index</em>') }}` retourne un seul objet stylesheet par son `index `(`index` débute par 0). + +## Spécification + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------- | +| {{SpecName('CSSOM', '#dom-document-stylesheets', 'styleSheets')}} | {{Spec2('CSSOM')}} | | +| {{SpecName('DOM2 Style', 'stylesheets.html#StyleSheets-DocumentStyle-styleSheets', 'styleSheets')}} | {{Spec2('DOM2 Style')}} | | + +## Voir aussi + +- {{Link("/en-US/docs/Web/API/CSS_Object_Model/Using_dynamic_styling_information")}} + +<!----> + +- [DOM Level 2 Style: styleSheets](http://www.w3.org/TR/DOM-Level-2-Style/stylesheets.html#StyleSheets-DocumentStyle-styleSheets) diff --git a/files/fr/web/api/document/stylesheetsets/index.md b/files/fr/web/api/document/stylesheetsets/index.md index f584192df8..5f8f8eb146 100644 --- a/files/fr/web/api/document/stylesheetsets/index.md +++ b/files/fr/web/api/document/stylesheetsets/index.md @@ -9,50 +9,47 @@ tags: - Propriétés translation_of: Web/API/Document/styleSheetSets --- -<div>{{APIRef("DOM")}}{{gecko_minversion_header("1.9")}}</div> +{{APIRef("DOM")}}{{gecko_minversion_header("1.9")}} -<p>Renvoie une liste active de tous les jeux de feuilles de styles actuellement disponibles.</p> +Renvoie une liste active de tous les jeux de feuilles de styles actuellement disponibles. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>sets</em> = document.styleSheetSets -</pre> + sets = document.styleSheetSets -<p>En retour, <code>sets</code> est une liste de jeux de feuilles de styles disponibles.</p> +En retour, `sets` est une liste de jeux de feuilles de styles disponibles. -<h2 id="Example">Exemple</h2> +## Exemple -<p>Étant donné un élément {{HTMLElement("ul")}} (liste) avec l'ID "sheetList", vous pouvez le remplir avec tous les noms de tous les jeux de feuilles de styles disponibles avec un code comme celui-ci :</p> +Étant donné un élément {{HTMLElement("ul")}} (liste) avec l'ID "sheetList", vous pouvez le remplir avec tous les noms de tous les jeux de feuilles de styles disponibles avec un code comme celui-ci : -<pre class="brush:js">var list = document.getElementById("sheetList"); +```js +var list = document.getElementById("sheetList"); var sheets = document.styleSheetSets; list.innerHTML = ""; -for (var i = 0; i < sheets.length; i++) { +for (var i = 0; i < sheets.length; i++) { var item = document.createElement("li"); item.innerHTML = sheets[i]; list.appendChild(item); -}</pre> +} +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>La liste des jeux de feuilles de styles disponibles est construite par énumération de toutes les feuilles de styles disponibles pour le document, dans l'ordre dans lequel elles sont répertoriées dans l'attribut {{domxref("document.styleSheets")}}, en ajoutant le <code>title</code> (<em>titre</em>) de chacune de celles en ayant un. Les doublons sont supprimés de la liste (en utilisant une comparaison sensible à la casse).</p> +La liste des jeux de feuilles de styles disponibles est construite par énumération de toutes les feuilles de styles disponibles pour le document, dans l'ordre dans lequel elles sont répertoriées dans l'attribut {{domxref("document.styleSheets")}}, en ajoutant le `title` (_titre_) de chacune de celles en ayant un. Les doublons sont supprimés de la liste (en utilisant une comparaison sensible à la casse). -<h2 id="Specification">Spécifications</h2> +## Spécifications -<ul> - <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets">HTML5 : Alternate Style Sheets</a></li> -</ul> +- [HTML5 : Alternate Style Sheets](http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets) -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Stylesheet")}}</li> - <li>{{domxref("document.styleSheets")}}</li> - <li>{{domxref("document.lastStyleSheetSet")}}</li> - <li>{{domxref("document.preferredStyleSheetSet")}}</li> - <li>{{domxref("document.selectedStyleSheetSet")}}</li> - <li>{{domxref("document.enableStyleSheetsForSet()")}}</li> -</ul> +- {{domxref("Stylesheet")}} +- {{domxref("document.styleSheets")}} +- {{domxref("document.lastStyleSheetSet")}} +- {{domxref("document.preferredStyleSheetSet")}} +- {{domxref("document.selectedStyleSheetSet")}} +- {{domxref("document.enableStyleSheetsForSet()")}} diff --git a/files/fr/web/api/document/title/index.md b/files/fr/web/api/document/title/index.md index 8744193915..abcabe2e9a 100644 --- a/files/fr/web/api/document/title/index.md +++ b/files/fr/web/api/document/title/index.md @@ -3,52 +3,49 @@ title: Document.title slug: Web/API/Document/title translation_of: Web/API/Document/title --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>Obtient ou défini le titre de la page.</p> +Obtient ou défini le titre de la page. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>var docTitle</em> = <em>document</em>.title; -</pre> + var docTitle = document.title; -<p><code>title</code> est la chaîne contenant le titre de la page. Si le titre a déjà été modifié par <code>document.title</code>, cela retournera cette valeur. Sinon cela retournera le titre par défaut de la page (voir les {{Anch("Notes")}} ci-dessous).</p> +`title` est la chaîne contenant le titre de la page. Si le titre a déjà été modifié par `document.title`, cela retournera cette valeur. Sinon cela retournera le titre par défaut de la page (voir les {{Anch("Notes")}} ci-dessous). -<pre class="syntaxbox"><em>document</em>.title = <em>newTitle</em>; -</pre> + document.title = newTitle; -<p><code>newTitle</code> sera le nouveau titre de la page. Le changement de titre affectera également la valeur de retour de <code>document.title</code>, le titre de la page dans le navigateur (généralement le nom de l'onglet dans votre navigateur), et affectera également le DOM de la page (le contenu de la balise HTML <code><title></code>).</p> +`newTitle` sera le nouveau titre de la page. Le changement de titre affectera également la valeur de retour de `document.title`, le titre de la page dans le navigateur (généralement le nom de l'onglet dans votre navigateur), et affectera également le DOM de la page (le contenu de la balise HTML `<title>`). -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:html"><!DOCTYPE html> -<html> -<head> -<title>Hello World!</title> -</head> -<body> +```html +<!DOCTYPE html> +<html> +<head> +<title>Hello World!</title> +</head> +<body> -<script> +<script> alert(document.title); // Affiche "Hello World!" document.title = "Goodbye World!"; alert(document.title); // Affiche "Goodbye World!" -</script> +</script> -</body> -</html> -</pre> +</body> +</html> +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>Cette propriété s'applique à HTML, SVG, XUL, et aux autres documents Gecko.</p> +Cette propriété s'applique à HTML, SVG, XUL, et aux autres documents Gecko. -<p>Pour les documents HTML, la valeur initiale de <code>document.title</code> est le texte de la balise <code><title></code>. Pour les documents XUL, c'est la valeur de l'attribut {{XULAttr("title")}} de {{XULElem("window")}} ou d'autres éléments parents de l'élément XUL.</p> +Pour les documents HTML, la valeur initiale de `document.title` est le texte de la balise `<title>`. Pour les documents XUL, c'est la valeur de l'attribut {{XULAttr("title")}} de {{XULElem("window")}} ou d'autres éléments parents de l'élément XUL. -<p>En XUL, accéder à <code>document.title</code> avant que le document soit complètement chargé a des conséquences variables (<code>document.title</code> peut retourner une chaîne vide et définir <code>document.title</code> peut n'avoir aucun effet).</p> +En XUL, accéder à `document.title` avant que le document soit complètement chargé a des conséquences variables (`document.title` peut retourner une chaîne vide et définir `document.title` peut n'avoir aucun effet). -<h2 id="Specification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-18446827">DOM Level 2 HTML: document.title</a></li> - <li><a href="http://www.whatwg.org/html/#document.title">HTML5</a></li> -</ul> +- [DOM Level 2 HTML: document.title](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-18446827) +- [HTML5](http://www.whatwg.org/html/#document.title) diff --git a/files/fr/web/api/document/tooltipnode/index.md b/files/fr/web/api/document/tooltipnode/index.md index 13c0927cff..b5f14bb18a 100644 --- a/files/fr/web/api/document/tooltipnode/index.md +++ b/files/fr/web/api/document/tooltipnode/index.md @@ -9,17 +9,16 @@ tags: - XUL translation_of: Web/API/Document/tooltipNode --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>{{draft}}</p> +{{draft}} -<p>Renvoie le noeud qui est la cible de l'actuel {{ XULElem("tooltip") }}.</p> +Renvoie le noeud qui est la cible de l'actuel {{ XULElem("tooltip") }}. -<h2 id="Usage">Syntaxe</h2> +## Syntaxe -<pre class="eval">document.tooltipNode; -</pre> + document.tooltipNode; -<h2 id="Specification">Spécification</h2> +## Spécification -<p>XUL-specific method. Not part of any specification. Defined in {{ Source("dom/public/idl/xul/nsIDOMXULDocument.idl#59", "nsIDOMXULDocument.idl") }}.</p> +XUL-specific method. Not part of any specification. Defined in {{ Source("dom/public/idl/xul/nsIDOMXULDocument.idl#59", "nsIDOMXULDocument.idl") }}. diff --git a/files/fr/web/api/document/touchend_event/index.md b/files/fr/web/api/document/touchend_event/index.md index a12b93005e..071d7824f2 100644 --- a/files/fr/web/api/document/touchend_event/index.md +++ b/files/fr/web/api/document/touchend_event/index.md @@ -7,119 +7,53 @@ tags: - events translation_of: Web/API/Document/touchend_event --- -<div>{{APIRef}}</div> - -<p>L'événement <code>touchend</code> est déclenché quand un point de contact est retiré de la surface.</p> - -<h2 id="Informations_générales">Informations générales</h2> - -<dl> - <dt style="float: left; text-align: right; width: 120px;">Spécification</dt> - <dd style="margin: 0 0 0 120px;"><a href="http://w3c.github.io/touch-events/#event-touchend">Touch Events</a></dd> - <dt style="float: left; text-align: right; width: 120px;">Interface</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("TouchEvent")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Bubbles</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Cancelable</dt> - <dd style="margin: 0 0 0 120px;">Oui</dd> - <dt style="float: left; text-align: right; width: 120px;">Target</dt> - <dd style="margin: 0 0 0 120px;">Document, Element</dd> - <dt style="float: left; text-align: right; width: 120px;">Default Action</dt> - <dd style="margin: 0 0 0 120px;">indéfinie</dd> -</dl> - -<h2 id="Propriétés">Propriétés</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>The event target (the topmost target in the DOM tree).</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td>DOMString</td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td>Boolean</td> - <td>Whether the event normally bubbles or not.</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td>Boolean</td> - <td>Whether the event is cancellable or not.</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td>WindowProxy</td> - <td><a href="/en-US/docs/Web/API/Document/defaultView"><code>document.defaultView</code></a> (<code>window</code> of the document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td>long (float)</td> - <td>0.</td> - </tr> - <tr> - <td><code>touches</code> {{readonlyInline}}</td> - <td>TouchList</td> - <td>A list of <a href="/en/DOM/Touch"><code>Touch</code></a>es for every point of contact currently touching the surface.</td> - </tr> - <tr> - <td><code>targetTouches</code> {{readonlyInline}}</td> - <td>TouchList</td> - <td>A list of <a href="/en/DOM/Touch"><code>Touch</code></a>es for every point of contact that is touching the surface and started on the element that is the target of the current event.</td> - </tr> - <tr> - <td><code>changedTouches</code> {{readonlyInline}}</td> - <td>TouchList</td> - <td>A list of <a href="/en-US/docs/DOM/Touch"><code>Touch</code></a>es for every point of contact which contributed to the event.<br> - For the touchstart event this must be a list of the touch points that just became active with the current event. For the touchmove event this must be a list of the touch points that have moved since the last event. For the touchend and touchcancel events this must be a list of the touch points that have just been removed from the surface.</td> - </tr> - <tr> - <td><code>ctrlKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the control key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>shiftKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the shift key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>altKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the alt key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>metaKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the meta key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemples">Exemples</h2> - -<p>Des exemples d'implémentation de cet événement sont disponibles : <a href="/en-US/docs/DOM/Touch_events">Touch events</a>.</p> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.touchend_event")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{ domxref("GlobalEventHandlers.ontouchleave","ontouchleave")}}</li> - <li>{{ domxref("GlobalEventHandlers.ontouchstart","ontouchstart")}}</li> - <li>{{ domxref("GlobalEventHandlers.ontouchmove","ontouchmove")}}</li> -</ul> +{{APIRef}} + +L'événement `touchend` est déclenché quand un point de contact est retiré de la surface. + +## Informations générales + +- Spécification + - : [Touch Events](http://w3c.github.io/touch-events/#event-touchend) +- Interface + - : {{domxref("TouchEvent")}} +- Bubbles + - : Oui +- Cancelable + - : Oui +- Target + - : Document, Element +- Default Action + - : indéfinie + +## Propriétés + +| Property | Type | Description | +| ----------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `target` {{readonlyInline}} | EventTarget | The event target (the topmost target in the DOM tree). | +| `type` {{readonlyInline}} | DOMString | The type of event. | +| `bubbles` {{readonlyInline}} | Boolean | Whether the event normally bubbles or not. | +| `cancelable` {{readonlyInline}} | Boolean | Whether the event is cancellable or not. | +| `view` {{readonlyInline}} | WindowProxy | [`document.defaultView`](/en-US/docs/Web/API/Document/defaultView) (`window` of the document) | +| `detail` {{readonlyInline}} | long (float) | 0. | +| `touches` {{readonlyInline}} | TouchList | A list of [`Touch`](/en/DOM/Touch)es for every point of contact currently touching the surface. | +| `targetTouches` {{readonlyInline}} | TouchList | A list of [`Touch`](/en/DOM/Touch)es for every point of contact that is touching the surface and started on the element that is the target of the current event. | +| `changedTouches` {{readonlyInline}} | TouchList | A list of [`Touch`](/en-US/docs/DOM/Touch)es for every point of contact which contributed to the event. For the touchstart event this must be a list of the touch points that just became active with the current event. For the touchmove event this must be a list of the touch points that have moved since the last event. For the touchend and touchcancel events this must be a list of the touch points that have just been removed from the surface. | +| `ctrlKey` {{readonlyInline}} | boolean | `true` if the control key was down when the event was fired. `false` otherwise. | +| `shiftKey` {{readonlyInline}} | boolean | `true` if the shift key was down when the event was fired. `false` otherwise. | +| `altKey` {{readonlyInline}} | boolean | `true` if the alt key was down when the event was fired. `false` otherwise. | +| `metaKey` {{readonlyInline}} | boolean | `true` if the meta key was down when the event was fired. `false` otherwise. | + +## Exemples + +Des exemples d'implémentation de cet événement sont disponibles : [Touch events](/en-US/docs/DOM/Touch_events). + +## Compatibilité des navigateurs + +{{Compat("api.Document.touchend_event")}} + +## Voir aussi + +- {{ domxref("GlobalEventHandlers.ontouchleave","ontouchleave")}} +- {{ domxref("GlobalEventHandlers.ontouchstart","ontouchstart")}} +- {{ domxref("GlobalEventHandlers.ontouchmove","ontouchmove")}} diff --git a/files/fr/web/api/document/transitionend_event/index.md b/files/fr/web/api/document/transitionend_event/index.md index 55916580ec..c962feeb7d 100644 --- a/files/fr/web/api/document/transitionend_event/index.md +++ b/files/fr/web/api/document/transitionend_event/index.md @@ -3,81 +3,76 @@ title: 'Document: évènement transitionend' slug: Web/API/Document/transitionend_event translation_of: Web/API/Document/transitionend_event --- -<div>{{APIRef}}</div> +{{APIRef}} -<p>L’évènement <strong><code>transitionend</code></strong> est émis quand une <a href="/fr/docs/Web/CSS/CSS_Transitions/Utiliser_transitions_CSS">transition CSS</a> a terminé. Dans le cas où une transition est supprimée avant d’avoir terminé, comme lorsqu’une {{cssxref("transition-property")}} est supprimée ou lorsque {{cssxref("display")}} reçoit la valeur <code>none</code>, l’évènement n’est pas généré.</p> +L’évènement **`transitionend`** est émis quand une [transition CSS](/fr/docs/Web/CSS/CSS_Transitions/Utiliser_transitions_CSS) a terminé. Dans le cas où une transition est supprimée avant d’avoir terminé, comme lorsqu’une {{cssxref("transition-property")}} est supprimée ou lorsque {{cssxref("display")}} reçoit la valeur `none`, l’évènement n’est pas généré. <table class="properties"> - <tbody> - <tr> - <th>Bouillonne</th> - <td>Oui</td> - </tr> - <tr> - <th>Est annulable</th> - <td>Oui</td> - </tr> - <tr> - <th>Interface</th> - <td>{{domxref("TransitionEvent")}}</td> - </tr> - <tr> - <th>Propriété gestionnaire d’évènement</th> - <td><code><a href="/en-US/docs/Web/API/GlobalEventHandlers/ontransitionend">ontransitionend</a></code></td> - </tr> - </tbody> + <tbody> + <tr> + <th>Bouillonne</th> + <td>Oui</td> + </tr> + <tr> + <th>Est annulable</th> + <td>Oui</td> + </tr> + <tr> + <th>Interface</th> + <td>{{domxref("TransitionEvent")}}</td> + </tr> + <tr> + <th>Propriété gestionnaire d’évènement</th> + <td> + <code + ><a href="/en-US/docs/Web/API/GlobalEventHandlers/ontransitionend" + >ontransitionend</a + ></code + > + </td> + </tr> + </tbody> </table> -<p>L’évènement <code>transitionend</code> est émis dans les deux directions : quand la transition se termine vers l’état modifié, et quand elle est complètement retournée à l’état par défaut ou non modifié. S’il n’y a pas de délai ou de durée de transition, si les deux sont 0 s ou ne sont pas déclarés, il n’y a pas de transition, et aucun évènement de transition n’est émis. Si l’évènement <code>transitioncancel</code> est émis, l’évènement <code>transitionend</code> ne se produira pas.</p> +L’évènement `transitionend` est émis dans les deux directions : quand la transition se termine vers l’état modifié, et quand elle est complètement retournée à l’état par défaut ou non modifié. S’il n’y a pas de délai ou de durée de transition, si les deux sont 0 s ou ne sont pas déclarés, il n’y a pas de transition, et aucun évènement de transition n’est émis. Si l’évènement `transitioncancel` est émis, l’évènement `transitionend` ne se produira pas. -<p>La cible originale pour cet évènement est l’<code><a href="/en-US/docs/Web/API/Element">Element</a></code> sur lequel la transition est appliquée. Vous pouvez écouter cet évènement sur l’interface <code>Window</code> pour le gérer durant les phases de capture ou de bouillonnement. Pour plus de détails sur cet évènement, veuillez consulter la page <a href="/fr/docs/Web/Events/transitionend">HTMLElement: transitionend</a>.</p> +La cible originale pour cet évènement est l’[`Element`](/en-US/docs/Web/API/Element) sur lequel la transition est appliquée. Vous pouvez écouter cet évènement sur l’interface `Window` pour le gérer durant les phases de capture ou de bouillonnement. Pour plus de détails sur cet évènement, veuillez consulter la page [HTMLElement: transitionend](/fr/docs/Web/Events/transitionend). -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Le code suivant ajoute un gestionnaire sur l’évènement <code>transitionend</code> :</p> +Le code suivant ajoute un gestionnaire sur l’évènement `transitionend` : -<pre class="brush: js">document.addEventListener('transitionend', () => { +```js +document.addEventListener('transitionend', () => { console.log('Transition terminée'); -});</pre> +}); +``` -<p>La même chose, mais en utilisant la propriété <code><a href="/en-US/docs/Web/API/GlobalEventHandlers/ontransitionend">ontransitionend</a></code> au lieu de <code>addEventListener()</code> :</p> +La même chose, mais en utilisant la propriété [`ontransitionend`](/en-US/docs/Web/API/GlobalEventHandlers/ontransitionend) au lieu de `addEventListener()` : -<pre class="brush: js">document.ontransitionend = () => { +```js +document.ontransitionend = () => { console.log('Transition terminée'); -};</pre> - -<p><a href="/en-US/docs/Web/API/HTMLElement/transitionend_event#Live_example">Voir un exemple en direct sur cet évènement.</a></p> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("CSS3 Transitions", "#transitionend", "transitionend")}}</td> - <td>{{Spec2('CSS3 Transitions')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +}; +``` + +[Voir un exemple en direct sur cet évènement.](/en-US/docs/Web/API/HTMLElement/transitionend_event#Live_example) + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------- | ---------------------------------------- | -------------------- | +| {{SpecName("CSS3 Transitions", "#transitionend", "transitionend")}} | {{Spec2('CSS3 Transitions')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.transitionend_event")}}</p> +{{Compat("api.Document.transitionend_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>Le gestionnaire d’évènement {{domxref("GlobalEventHandlers.ontransitionend")}}</li> - <li>L’interface {{domxref("TransitionEvent")}}</li> - <li>Les propriétés CSS : {{cssxref("transition")}}, {{cssxref("transition-delay")}}, {{cssxref("transition-duration")}}, {{cssxref("transition-property")}}, {{cssxref("transition-timing-function")}}</li> - <li>Des évènements associés : <code><a href="/en-US/docs/Web/API/Document/transitionrun_event">transitionrun</a></code>, <code><a href="/en-US/docs/Web/API/Document/transitionstart_event">transitionstart</a></code>, <code><a href="/en-US/docs/Web/API/Document/transitioncancel_event">transitioncancel</a></code></li> - <li>Cet évènement sur les cibles <code><a href="/en-US/docs/Web/API/HTMLElement">HTMLElement</a></code> : <code><a href="/en-US/docs/Web/API/HTMLElement/transitionend_event">transitionend</a></code></li> - <li>Cet évènement sur les cibles <code><a href="/en-US/docs/Web/API/Window">Window</a></code> : <code><a href="/en-US/docs/Web/API/Window/transitionend_event">transitionend</a></code></li> -</ul> +- Le gestionnaire d’évènement {{domxref("GlobalEventHandlers.ontransitionend")}} +- L’interface {{domxref("TransitionEvent")}} +- Les propriétés CSS : {{cssxref("transition")}}, {{cssxref("transition-delay")}}, {{cssxref("transition-duration")}}, {{cssxref("transition-property")}}, {{cssxref("transition-timing-function")}} +- Des évènements associés : [`transitionrun`](/en-US/docs/Web/API/Document/transitionrun_event), [`transitionstart`](/en-US/docs/Web/API/Document/transitionstart_event), [`transitioncancel`](/en-US/docs/Web/API/Document/transitioncancel_event) +- Cet évènement sur les cibles [`HTMLElement`](/en-US/docs/Web/API/HTMLElement) : [`transitionend`](/en-US/docs/Web/API/HTMLElement/transitionend_event) +- Cet évènement sur les cibles [`Window`](/en-US/docs/Web/API/Window) : [`transitionend`](/en-US/docs/Web/API/Window/transitionend_event) diff --git a/files/fr/web/api/document/url/index.md b/files/fr/web/api/document/url/index.md index 1b599ff794..454dde3afb 100644 --- a/files/fr/web/api/document/url/index.md +++ b/files/fr/web/api/document/url/index.md @@ -3,22 +3,21 @@ title: Document.URL slug: Web/API/Document/URL translation_of: Web/API/Document/URL --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>Retourne l'<code><strong>URL</strong></code> du {{domxref("Document")}} sous forme de string (lecture seule).</p> +Retourne l'**`URL`** du {{domxref("Document")}} sous forme de string (lecture seule). -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var <em>string</em> = document.URL -</pre> +```js +var string = document.URL +``` -<h2 id="Specification">Exemple</h2> +## Exemple -<pre><code>var currentURL = document.URL; -alert(currentURL);</code></pre> + var currentURL = document.URL; + alert(currentURL); -<h2 id="Specification">Specification</h2> +## Specification -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-46183437">DOM Level 2 HTML: URL</a></li> -</ul> +- [DOM Level 2 HTML: URL](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-46183437) diff --git a/files/fr/web/api/document/visibilitystate/index.md b/files/fr/web/api/document/visibilitystate/index.md index d8ea3d1139..51d43852c7 100644 --- a/files/fr/web/api/document/visibilitystate/index.md +++ b/files/fr/web/api/document/visibilitystate/index.md @@ -9,49 +9,38 @@ tags: - Visibilité translation_of: Web/API/Document/visibilityState --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>La propriété en lecture seule <code><strong>Document.visibilityState</strong></code> renvoie la visibilité du {{domxref('document')}}, c'est-à-dire informe si l'élément est visible dans son contexte. Il est utile de savoir si le document est en arrière-plan ou sur un onglet invisible ou seulement chargé pour le pré-rendu. Les valeurs possibles sont :</p> +La propriété en lecture seule **`Document.visibilityState`** renvoie la visibilité du {{domxref('document')}}, c'est-à-dire informe si l'élément est visible dans son contexte. Il est utile de savoir si le document est en arrière-plan ou sur un onglet invisible ou seulement chargé pour le pré-rendu. Les valeurs possibles sont : -<ul> - <li><strong><code>'visible'</code></strong> : le contenu de la page peut être au-moins partiellement visible. Dans la pratique, cela signifie que la page est l'onglet de premier plan d'une fenêtre non réduite.</li> - <li><strong><code>'hidden</code>'</strong> (<em>caché</em>) : le contenu de la page n'est pas visible pour l'utilisateur. Dans la pratique , cela signifie que le document est soit dans un onglet d'arrière-plan ou une partie d'une fenêtre réduite, soit que le verrouillage de l'écran du système d'exploitation est actif.</li> - <li><strong><code>'prerender'</code></strong> (<em>prérendu</em>) : le contenu de la page est prérendu et n'est pas visible par l'utilisateur (considéré caché aux fins de <code><a href="/en-US/docs/Web/API/Document/hidden">document.hidden</a></code>). Le document peut démarrer dans cet état mais ne changera jamais à partir d'une autre valeur. Note : le support du navigateur est facultatif.</li> - <li><strong><code>'unloaded</code>'</strong> (<em>déchargé</em>) : la page est en train d'être déchargée de la mémoire. Remarque : le support du navigateur est facultatif.</li> -</ul> +- **`'visible'`** : le contenu de la page peut être au-moins partiellement visible. Dans la pratique, cela signifie que la page est l'onglet de premier plan d'une fenêtre non réduite. +- **`'hidden`'** (_caché_) : le contenu de la page n'est pas visible pour l'utilisateur. Dans la pratique , cela signifie que le document est soit dans un onglet d'arrière-plan ou une partie d'une fenêtre réduite, soit que le verrouillage de l'écran du système d'exploitation est actif. +- **`'prerender'`** (_prérendu_) : le contenu de la page est prérendu et n'est pas visible par l'utilisateur (considéré caché aux fins de [`document.hidden`](/en-US/docs/Web/API/Document/hidden)). Le document peut démarrer dans cet état mais ne changera jamais à partir d'une autre valeur. Note : le support du navigateur est facultatif. +- **`'unloaded`'** (_déchargé_) : la page est en train d'être déchargée de la mémoire. Remarque : le support du navigateur est facultatif. -<p>Lorsque la valeur de cette propriété change, l'évènement {{event('visibilitychange')}} est envoyé au {{domxref("Document")}}.</p> +Lorsque la valeur de cette propriété change, l'évènement {{event('visibilitychange')}} est envoyé au {{domxref("Document")}}. -<p>L'utilisation typique de ceci peut être d'empêcher le téléchargement de certains éléments actifs lorsque le document est uniquement prérendu, ou d'arrêter certaines activités lorsque le document est en arrière-plan ou réduit au minimum.</p> +L'utilisation typique de ceci peut être d'empêcher le téléchargement de certains éléments actifs lorsque le document est uniquement prérendu, ou d'arrêter certaines activités lorsque le document est en arrière-plan ou réduit au minimum. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <em>string</em> = document.visibilityState</pre> + var string = document.visibilityState -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush:js">document.addEventListener("visibilitychange", function() { +```js +document.addEventListener("visibilitychange", function() { console.log( document.visibilityState ); // Modifier le comportement... -});</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th>Spécification</th> - <th>Statut</th> - <th>Commentaire</th> - </tr> - <tr> - <td>{{SpecName('Page Visibility API','#dom-document-visibilitystate', 'Document.visibilityState')}}</td> - <td>{{Spec2('Page Visibility API')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Document.visibilityState")}}</p> +}); +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | -------------------- | +| {{SpecName('Page Visibility API','#dom-document-visibilitystate', 'Document.visibilityState')}} | {{Spec2('Page Visibility API')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Document.visibilityState")}} diff --git a/files/fr/web/api/document/width/index.md b/files/fr/web/api/document/width/index.md index 8be64c2109..bd02da9607 100644 --- a/files/fr/web/api/document/width/index.md +++ b/files/fr/web/api/document/width/index.md @@ -3,43 +3,38 @@ title: Document.width slug: Web/API/Document/width translation_of: Web/API/Document/width --- -<div>{{APIRef("DOM")}} {{Obsolete_header}}</div> +{{APIRef("DOM")}} {{Obsolete_header}} -<div class="note"> -<p><strong>Note :</strong> À partir de {{Gecko("6.0")}},<code> document.width </code>n'est plus pris en charge. Au lieu de cela, utilisez document.body.clientWidth. Voir {{domxref("element.clientWidth")}}.</p> -</div> +> **Note :** À partir de {{Gecko("6.0")}},` document.width `n'est plus pris en charge. Au lieu de cela, utilisez document.body.clientWidth. Voir {{domxref("element.clientWidth")}}. -<p>Renvoie la largeur de l'élément {{HTMLElement("body")}} du document courrent en pixels.</p> +Renvoie la largeur de l'élément {{HTMLElement("body")}} du document courrent en pixels. -<p>Non pris en charge par Internet Explorer.</p> +Non pris en charge par Internet Explorer. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>pixels</em> = document.width; -</pre> + pixels = document.width; -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush:js">function init() { +```js +function init() { alert("La largeur du document est " + document.width + " pixels."); } -</pre> +``` -<h2 id="Alternatives">Alternatives</h2> +## Alternatives -<pre class="syntaxbox">document.body.clientWidth /* largeur de <body> */ -document.documentElement.clientWidth /* largeur de <html> */ -window.innerWidth /* largeur de la fenêtre */ -</pre> + document.body.clientWidth /* largeur de <body> */ + document.documentElement.clientWidth /* largeur de <html> */ + window.innerWidth /* largeur de la fenêtre */ -<h2 id="Specification">Spécification</h2> +## Spécification -<p>HTML5</p> +HTML5 -<h2 id="See_also">Voir également</h2> +## Voir également -<ul> - <li>{{domxref("document.height")}}</li> - <li>{{domxref("Element.clientWidth")}}</li> - <li>{{domxref("Element.scrollWidth")}}</li> -</ul> +- {{domxref("document.height")}} +- {{domxref("Element.clientWidth")}} +- {{domxref("Element.scrollWidth")}} diff --git a/files/fr/web/api/document/write/index.md b/files/fr/web/api/document/write/index.md index deac04e6b3..fd54354baf 100644 --- a/files/fr/web/api/document/write/index.md +++ b/files/fr/web/api/document/write/index.md @@ -9,88 +9,74 @@ tags: - Rérérence translation_of: Web/API/Document/write --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>Écrit une chaîne de texte dans un document ouvert par <a href="/fr/docs/Web/API/Document/open">document.open()</a>.</p> +Écrit une chaîne de texte dans un document ouvert par [document.open()](/fr/docs/Web/API/Document/open). -<div class="note"> -<p><strong>Note :</strong> comme <code>document.write</code> écrit dans le flux de documents, appeler <code>document.write</code> sur un document fermé (chargé) appelle automatiquement <code>document.open</code>, ce qui efface le document.</p> -</div> +> **Note :** comme `document.write` écrit dans le flux de documents, appeler `document.write` sur un document fermé (chargé) appelle automatiquement `document.open`, ce qui efface le document. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="eval">document.write(<em>balisage</em>); -</pre> + document.write(balisage); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>markup</code></dt> - <dd>est une chaîne de caractères contenant le texte à écrire dans le document.</dd> -</dl> +- `markup` + - : est une chaîne de caractères contenant le texte à écrire dans le document. -<h3 id="Exemple">Exemple</h3> +### Exemple -<pre class="brush: html"><html> +```html +<html> -<head> -<title>Exemple de document.write</title> +<head> +<title>Exemple de document.write</title> -<script type="text/javascript"> +<script type="text/javascript"> function nouveauContenu() { alert("chargement du nouveau contenu"); document.open(); -document.write("<h1>Assez de l'ancien contenu, passons au nouveau !</h1>"); +document.write("<h1>Assez de l'ancien contenu, passons au nouveau !</h1>"); document.close(); } -</script> -</head> +</script> +</head> -<body onload="nouveauContenu();"> -<p>Ceci est le contenu original du document.</p> -</body> -</html> -</pre> +<body onload="nouveauContenu();"> +<p>Ceci est le contenu original du document.</p> +</body> +</html> +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>Écrire dans un document qui a déjà été chargé sans appeler <a href="/fr/docs/Web/API/Document/open">document.open()</a> provoquera un appel automatique à <code>document.open</code>. Une fois l'écriture terminée, il est recommandé d'appeler <a href="/fr/docs/Web/API/Document/close">document.close()</a> pour indiquer au navigateur qu'il peut terminer de charger la page. Le texte fourni est analysé et intégré à la structure du modèle de document. Dans l'exemple ci-dessus, l'élément <code>h1</code> devient un nœud dans le document.</p> +Écrire dans un document qui a déjà été chargé sans appeler [document.open()](/fr/docs/Web/API/Document/open) provoquera un appel automatique à `document.open`. Une fois l'écriture terminée, il est recommandé d'appeler [document.close()](/fr/docs/Web/API/Document/close) pour indiquer au navigateur qu'il peut terminer de charger la page. Le texte fourni est analysé et intégré à la structure du modèle de document. Dans l'exemple ci-dessus, l'élément `h1` devient un nœud dans le document. -<p>Si l'appel à <code>document.write()</code> est intégré directement dans le code HTML, il n'appellera pas <code>document.open()</code>. Par exemple :</p> +Si l'appel à `document.write()` est intégré directement dans le code HTML, il n'appellera pas `document.open()`. Par exemple : -<pre class="brush: html"><script> - document.write("<h1>Main title</h1>") -</script></pre> +```html +<script> + document.write("<h1>Main title</h1>") +</script> +``` -<div class="note"> -<p><strong>Note :</strong> <code>document.write</code> et <code>document.writeln <a href="/fr/docs/Archive/Web/Writing_JavaScript_for_HTML">ne fonctionnent pas dans les documents XHTML</a> (vous obtiendrez une erreur </code> "Operation is not supported" [<code>NS_ERROR_DOM_NOT_SUPPORTED_ERR</code>] dans la console d'erreurs). Cela arrive lors de l'ouverture d'un fichier local avec l'extension de fichier .xhtm ou pour tout document servi avec une <code>application/xhtml+xml</code> de <a href="/fr/docs/Glossaire/Type_MIME">type MIME</a>. Plus d'informations disponibles dans la <a href="http://www.w3.org/MarkUp/2004/xhtml-faq#docwrite">foire aux questions W3C XHTML (en)</a>.</p> -</div> +> **Note :** `document.write` et `document.writeln ne fonctionnent pas dans les documents XHTML (vous obtiendrez une erreur ` "Operation is not supported" \[`NS_ERROR_DOM_NOT_SUPPORTED_ERR`] dans la console d'erreurs). Cela arrive lors de l'ouverture d'un fichier local avec l'extension de fichier .xhtm ou pour tout document servi avec une `application/xhtml+xml` de [type MIME](/fr/docs/Glossaire/Type_MIME). Plus d'informations disponibles dans la [foire aux questions W3C XHTML (en)](http://www.w3.org/MarkUp/2004/xhtml-faq#docwrite). -<div class="note"> -<p><strong>Note :</strong> <code>document.write</code> dans les scripts <a href="/en-US/docs/Web/HTML/Element/script#attr-defer">deferred (<em>différé</em>)</a> ou <a href="/en-US/docs/Web/HTML/Element/script#attr-async">asynchronous (<em>asynchrone</em>)</a> sera ignoré et vous recevrez un message comme "A call to <code>document.write()</code> from an asynchronously-loaded external script was ignored" dans la console d'erreurs.</p> -</div> +> **Note :** `document.write` dans les scripts [deferred (_différé_)](/en-US/docs/Web/HTML/Element/script#attr-defer) ou [asynchronous (_asynchrone_)](/en-US/docs/Web/HTML/Element/script#attr-async) sera ignoré et vous recevrez un message comme "A call to `document.write()` from an asynchronously-loaded external script was ignored" dans la console d'erreurs. -<div class="note"> -<p><strong>Note :</strong> Dans Edge seulement, appeler plusieurs fois <code>document.write</code> dans un "iframe" déclenche une erreur "SCRIPT70: Permission denied." <em>(autorisation refusée)</em>.</p> -</div> +> **Note :** Dans Edge seulement, appeler plusieurs fois `document.write` dans un "iframe" déclenche une erreur "SCRIPT70: Permission denied." _(autorisation refusée)_. -<div class="note"> -<p><strong>Note :</strong> À partir de la version 55, Chrome n'exécute pas les éléments <code><script></code> injectés via <code>document.write()</code> en cas d'échec de cache HTTP pour les utilisateurs sur une connexion 2G.</p> -</div> +> **Note :** À partir de la version 55, Chrome n'exécute pas les éléments `<script>` injectés via `document.write()` en cas d'échec de cache HTTP pour les utilisateurs sur une connexion 2G. -<h2 id="Sp.C3.A9cification">Spécification</h2> +## Spécification -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-75233634">DOM Level 2 HTML: <code>write()</code> Method</a></li> - <li><a href="http://www.w3.org/TR/2011/WD-html5-author-20110705/apis-in-html-documents.html#dynamic-markup-insertion">Dynamic markup insertion in HTML</a></li> -</ul> +- [DOM Level 2 HTML: `write()` Method](http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-75233634) +- [Dynamic markup insertion in HTML](http://www.w3.org/TR/2011/WD-html5-author-20110705/apis-in-html-documents.html#dynamic-markup-insertion) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{ domxref("element.innerHTML") }}</li> - <li>{{ domxref("document.createElement()") }}</li> -</ul> +- {{ domxref("element.innerHTML") }} +- {{ domxref("document.createElement()") }} diff --git a/files/fr/web/api/document/writeln/index.md b/files/fr/web/api/document/writeln/index.md index eb06d11321..8c69f2caa7 100644 --- a/files/fr/web/api/document/writeln/index.md +++ b/files/fr/web/api/document/writeln/index.md @@ -8,49 +8,49 @@ tags: - Reference translation_of: Web/API/Document/writeln --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>Écrit une chaine de caractères suivie d'un retour de ligne.</p> +Écrit une chaine de caractères suivie d'un retour de ligne. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval">document.writeln(<em>ligne</em>); -</pre> + document.writeln(ligne); -<h3 id="Parameters">Paramètres</h3> +### Paramètres -<ul> - <li><code>ligne</code> est la chaine de caractère contenant le texte.</li> -</ul> +- `ligne` est la chaine de caractère contenant le texte. -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="notranslate">document.writeln("<p>Entrez votre mot de passe :</p>"); -</pre> + document.writeln("<p>Entrez votre mot de passe :</p>"); -<h2 id="Notes">Notes</h2> +## Notes -<p><strong>document.writeln </strong>est identique à <a href="/en-US/docs/Web/API/Document/write">{{domxref("document.write")}}</a>, mais ajoute une nouvelle ligne.</p> +**document.writeln** est identique à [{{domxref("document.write")}}](/en-US/docs/Web/API/Document/write), mais ajoute une nouvelle ligne. -<h2 id="Specification">Spécifications</h2> +## Spécifications <table class="standard-table"> - <tbody> - <tr> - <td><strong>Spécification</strong></td> - <td><strong>État</strong></td> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "#dom-document-writeln", "document.writeln()")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - </tr> - <tr> - <td>{{SpecName("DOM2 HTML", "html.html#ID-35318390", "document.writeln()")}}</td> - <td>{{Spec2("DOM2 HTML")}}</td> - </tr> - </tbody> + <tbody> + <tr> + <td><strong>Spécification</strong></td> + <td><strong>État</strong></td> + </tr> + <tr> + <td> + {{SpecName("HTML WHATWG", "#dom-document-writeln", "document.writeln()")}} + </td> + <td>{{Spec2("HTML WHATWG")}}</td> + </tr> + <tr> + <td> + {{SpecName("DOM2 HTML", "html.html#ID-35318390", "document.writeln()")}} + </td> + <td>{{Spec2("DOM2 HTML")}}</td> + </tr> + </tbody> </table> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Document.writeln")}}</p> +{{Compat("api.Document.writeln")}} diff --git a/files/fr/web/api/document/xmlencoding/index.md b/files/fr/web/api/document/xmlencoding/index.md index a7236fc2f6..78f8172253 100644 --- a/files/fr/web/api/document/xmlencoding/index.md +++ b/files/fr/web/api/document/xmlencoding/index.md @@ -10,26 +10,21 @@ tags: - XML translation_of: Web/API/Document/xmlEncoding --- -<p>{{APIRef("DOM")}}{{ obsolete_header("10.0") }}</p> +{{APIRef("DOM")}}{{ obsolete_header("10.0") }} -<p>Renvoie le codage déterminé par la déclaration XML. Devrait être <code>null</code> si non précisé ou inconnu.</p> +Renvoie le codage déterminé par la déclaration XML. Devrait être `null` si non précisé ou inconnu. -<div class="warning"> - <p><strong>Attention :</strong> N'utilisez pas cet attribut ; il a été supprimé de la spécification DOM Niveau 4 et n'est plus pris en charge dans Gecko 10.0 {{ geckoRelease("10.0") }}.</p> -</div> +> **Attention :** N'utilisez pas cet attribut ; il a été supprimé de la spécification DOM Niveau 4 et n'est plus pris en charge dans Gecko 10.0 {{ geckoRelease("10.0") }}. -<p>Si la déclaration XML indique :</p> +Si la déclaration XML indique : -<pre><?xml version="1.0" encoding="UTF-16"?> -</pre> + <?xml version="1.0" encoding="UTF-16"?> -<p>... le résultat doit être "UTF-16".</p> +... le résultat doit être "UTF-16". -<p>Cependant, Firefox 3.0 inclut des informations sur l'"endianness" (par exemple, UTF-16BE pour le codage "big endian") et, tandis que cette information supplémentaire est supprimée à partir de Firefox 3.1b3, Firefox 3.1b3 consulte toujours l'encodage du fichier plutôt que la déclaration XML, comme la spécification le prévoit ("Un attribut spécifiant, <em>dans le cadre de la déclaration XML</em>, l'encodage de ce document.").</p> +Cependant, Firefox 3.0 inclut des informations sur l'"endianness" (par exemple, UTF-16BE pour le codage "big endian") et, tandis que cette information supplémentaire est supprimée à partir de Firefox 3.1b3, Firefox 3.1b3 consulte toujours l'encodage du fichier plutôt que la déclaration XML, comme la spécification le prévoit ("Un attribut spécifiant, _dans le cadre de la déclaration XML_, l'encodage de ce document."). -<h3 id="Spécification">Spécification</h3> +### Spécification -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#Document3-encoding">http://www.w3.org/TR/DOM-Level-3-Cor...ment3-encoding</a></li> - <li>A été supprimé de {{ spec("http://www.w3.org/TR/domcore/","DOM Core Level 4","WD") }}</li> -</ul> +- [http://www.w3.org/TR/DOM-Level-3-Cor...ment3-encoding](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Document3-encoding) +- A été supprimé de {{ spec("http://www.w3.org/TR/domcore/","DOM Core Level 4","WD") }} diff --git a/files/fr/web/api/document/xmlversion/index.md b/files/fr/web/api/document/xmlversion/index.md index 4145a61548..73b9895781 100644 --- a/files/fr/web/api/document/xmlversion/index.md +++ b/files/fr/web/api/document/xmlversion/index.md @@ -10,20 +10,17 @@ tags: - version translation_of: Web/API/Document/xmlVersion --- -<p>{{APIRef("DOM")}}{{ obsolete_header("10.0") }}</p> +{{APIRef("DOM")}}{{ obsolete_header("10.0") }} -<p>Renvoie le numéro de version comme spécifié dans la déclaration XML (par exemple, <code><?xml version="1.0"?></code>) ou "1.0" si la déclaration est absente.</p> +Renvoie le numéro de version comme spécifié dans la déclaration XML (par exemple, `<?xml version="1.0"?>`) ou "1.0" si la déclaration est absente. -<p>Cet attribut n'a jamais été réellement utile, parce qu'il a toujours renvoyé 1.0, et a été supprimé dans la spécification DOM Niveau 4. En conséquence, Firefox 10 ne l'implémente plus. Son utilisation principale dans le passé consistait à détecter si le document était rendu en XML plutôt qu'en HTML. Pour ce faire, vous pouvez créer un élément avec son nom en minuscule, puis vérifier s'il est converti en majuscules (auquel cas le document est en mode HTML non XML) :</p> +Cet attribut n'a jamais été réellement utile, parce qu'il a toujours renvoyé 1.0, et a été supprimé dans la spécification DOM Niveau 4. En conséquence, Firefox 10 ne l'implémente plus. Son utilisation principale dans le passé consistait à détecter si le document était rendu en XML plutôt qu'en HTML. Pour ce faire, vous pouvez créer un élément avec son nom en minuscule, puis vérifier s'il est converti en majuscules (auquel cas le document est en mode HTML non XML) : -<pre>if (document.createElement("foo").tagName == "FOO") { - /* le document n'est pas XML */ -} -</pre> + if (document.createElement("foo").tagName == "FOO") { + /* le document n'est pas XML */ + } -<h2 id="Specification">Spécifications</h2> +## Spécifications -<ul> - <li><a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#Document3-version">http://www.w3.org/TR/DOM-Level-3-Cor...ument3-version</a></li> - <li>A été supprimée de {{ spec("http://www.w3.org/TR/domcore/","DOM Core Level 4","WD") }}</li> -</ul> +- [http://www.w3.org/TR/DOM-Level-3-Cor...ument3-version](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Document3-version) +- A été supprimée de {{ spec("http://www.w3.org/TR/domcore/","DOM Core Level 4","WD") }} |