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()
:
var element = document.createElement('div'); +```js +var element = document.createElement('div'); element.id = 'testqq'; -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 ou 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
- -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 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). -
{{APIRef("DOM")}}
+{{APIRef("DOM")}} -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.
+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. -Syntaxe
+## Syntaxe -var elements = document.getElementsByClassName(names); // or: -var elements = rootElement.getElementsByClassName(names);+ var elements = document.getElementsByClassName(names); // or: + var elements = rootElement.getElementsByClassName(names); -
-
-
- 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. -
Exemples
+## Exemples -Trouve tous les éléments ayant la classe « test » :
+Trouve tous les éléments ayant la classe « test » : -document.getElementsByClassName('test') -+ document.getElementsByClassName('test') -
Trouve tous les éléments ayant les classes « rouge » et « test » :
+Trouve tous les éléments ayant les classes « rouge » et « test » : -document.getElementsByClassName('rouge test') -+ document.getElementsByClassName('rouge test') -
Trouve tous les éléments qui ont la classe « test » à l'intérieur d'un élément ayant l'ID « main » :
+Trouve tous les éléments qui ont la classe « test » à l'intérieur d'un élément ayant l'ID « main » : -document.getElementById('main').getElementsByClassName('test') -+ document.getElementById('main').getElementsByClassName('test') -
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':
+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': -var testElements = document.getElementsByClassName('test'); +```js +var testElements = document.getElementsByClassName('test'); var testDivs = Array.prototype.filter.call(testElements, function(testElement){ return testElement.nodeName === 'DIV'; -});- -
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.
- -<!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 \+- [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 --- -Element\
+ +## Obtenir la classe des éléments test + +C'est la méthode d'opération la plus couramment utilisée. + +```html + + + + +Document + + +++ + + +``` -hello word1
+hello word2
+hello word3
+hello word4
+Compatibilité des navigateurs
+## Compatibilité des navigateurs +{{Compat("api.Document.getElementsByClassName")}} -{{Compat("api.Document.getElementsByClassName")}}
+## Spécification - - -Spécification
- -
{{ ApiRef("DOM") }}
+{{ ApiRef("DOM") }} -Renvoie une liste des éléments portant un {{domxref("element.name","name")}} donné dans le document (X)HTML.
+Renvoie une liste des éléments portant un {{domxref("element.name","name")}} donné dans le document (X)HTML. -Syntaxe
+## Syntaxe -elements = document.getElementsByName(name) -+ elements = document.getElementsByName(name) -
-
-
elements
est une collection de {{domxref("NodeList")}}
- name
est la valeur de l'attributname
des éléments.
-
Exemple
+## Exemple -<!DOCTYPE html> -<html lang="en"> -<head> +```html + + + ... -</head> + -<body> -<form name="up"><input type="text"></form> -<div name="down"><input type="text"></div> + ++ -<script> + + + +``` + +## 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 --- -
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 ().
Syntaxe
+ var elements = document.getElementsByTagName(name); -var elements = document.getElementsByTagName(name);+- `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 ». -
-
-
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 ».
-
Note : La dernière spécification W3C 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.
Exemple
+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. -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.
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).
<!DOCTYPE html> -<html lang="en"> -<head> - <meta charset="UTF-8" /> - <title>getElementsByTagName example</title> - <script> +```html + + + + ++## Notes -getElementsByTagName example + + + +Some outer text
+Some outer text
+ ++- <div id="div2" style="border: solid red 3px"> - <p>Some div2 text</p> - <p>Some div2 text</p> - </div> - </div> +Some div1 text
+Some div1 text
+Some div1 text
- <div id="div1" style="border: solid blue 3px"> - <p>Some div1 text</p> - <p>Some div1 text</p> - <p>Some div1 text</p> +++Some div2 text
+Some div2 text
+Some outer text
+Some outer text
- <p>Some outer text</p> - <p>Some outer text</p> +
- <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="div2ParaElems();"> - show all p elements in div2 element</button> + + +``` -</body> -</html>
Notes
+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)}}. -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)}}.
-
- document.getElementsByTagName()
est similaire à {{domxref ("element.getElementsByTagName ()")}}, sauf que sa recherche englobe tout le document.
Spécifications
+## Spécifications --
-
- DOM Level 2 Core : getElementsByTagName — traduction (non normative) -
- HTML 5: APIs in HTML documents -
Voir aussi
+## Voir aussi --
-
- {{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'
-
{{ ApiRef("DOM") }}
+{{ ApiRef("DOM") }} -{{ fx_minversion_note("3.6","Voir la section Notes de element.getElementsByTagNameNS pour les changements qui s'appliquent aussi à cet API dans Firefox 3.6.") }}
+{{ fx_minversion_note("3.6","Voir la section Notes de element.getElementsByTagNameNS pour les changements qui s'appliquent aussi à cet API dans Firefox 3.6.") }} -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.
+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. -Syntaxe
+## Syntaxe -elements = document.getElementsByTagNameNS(namespace,name) -+ elements = document.getElementsByTagNameNS(namespace,name) -
-
-
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 (voirelement.namespaceURI
).
- name
est, soit le nom local des éléments à rechercher, soit la valeur spéciale"*"
pour tous les éléments (voirelement.localName
).
-
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 pour plus de détails.
Exemple
+## Exemple -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.
Notez que lorsque le noeud sur lequel getElementsByTagName
est invoqué n'est pas un noeud document
, la méthode element.getElementsByTagNameNS est en fait utilisée.
Pour utiliser l'exemple suivant, il suffit de le copier/coller dans un nouveau fichier enregistré avec l'extension .xhtml.
+Pour utiliser l'exemple suivant, il suffit de le copier/coller dans un nouveau fichier enregistré avec l'extension .xhtml. -http://www.w3.org/1999/xhtml"> +```html +http://www.w3.org/1999/xhtml"> -<head> -<title>getElementsByTagNameNS example</title> + ++ + +``` -getElementsByTagNameNS example -<script type="text/javascript"> + + -<body style="border: solid green 3px"> -<p>Some outer text</p> -<p>Some outer text</p> + +Some outer text
+Some outer text
- <div id="div1" style="border: solid blue 3px"> - <p>Some div1 text</p> - <p>Some div1 text</p> - <p>Some div1 text</p> ++-<p>Some outer text</p> -<p>Some outer text</p> +Some div1 text
+Some div1 text
+Some div1 text
- <div id="div2" style="border: solid red 3px"> - <p>Some div2 text</p> - <p>Some div2 text</p> - </div> - </div> +++Some div2 text
+Some div2 text
+Some outer text
+Some outer text
-<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="div2ParaElems();"> - show all p elements in div2 element</button> + -</body> -</html> -
Solution de contournement potentielle pour les navigateurs qui ne prennent pas en charge XPath
+## Solution de contournement potentielle pour les navigateurs qui ne prennent pas en charge XPath -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.)
+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).) -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; } -+``` -
Spécifications
+## Spécifications -DOM Level 2 Core: Document.getElementsByTagNameNS
+[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 --- -{{APIRef("DOM")}}
+{{APIRef("DOM")}} -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.
+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 --- -{{ ApiRef() }}
+{{ ApiRef() }} -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.
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.
-Syntaxe
+## Syntaxe -focused = document.hasFocus(); -+ focused = document.hasFocus(); -
Valeur retournée
+### Valeur retournée -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.
Exemple
+## Exemple -<!DOCTYPE html> -<html lang="en"> -<head> -<meta charset="UTF-8" /> -<title>TEST</title> -<style> +```html + + + + +TEST + + + + +JavaScript hasFocus example
+Waiting for user action+ + + +``` + +## 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 \, le premier est retourné. -Retourne l'élément {{HTMLElement("head")}} du document courant. S'il y a plus d'un élément <head>, le premier est retourné.
+## Syntaxe -Syntaxe
+ var objRef = document.head; -var objRef = document.head; -+## Exemple -Exemple
- -// en HTML: <head id="my-document-head"> +```js +// en HTML: var aHead = document.head; alert(aHead.id); // "my-document-head"; alert( document.head === document.querySelector("head") ); // true -+``` -Notes
+## Notes -+`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. -
document.head
est en lecture seule. Essayer d'assigner une valeur à cettre propriété échouera en silence ou lancera uneTypeError
si le mode strict d'ECMAScript est activé dans un navigateur Gecko.Spécifications
+## Spécifications -
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. | -
Compatibilité des navigateurs
+## Compatibilité des navigateurs -{{Compat("api.Document.head")}}
+{{Compat("api.Document.head")}} -Voir aussi
+## Voir aussi --
-
- {{domxref("document.body")}} -
Note: Apparu avec {{Gecko("6.0")}}, document.height n'est plus supporté
. Utilisez à la place document.body.clientHeight
. Voir {{domxref("element.clientHeight")}}.
Résumé
+## Résumé -Retourne la hauteur de l'objet {{domxref("document")}}. Dans la plupart des cas, ceci est égal à l'élément {{HTMLElement("body")}} du document courant.
+Retourne la hauteur de l'objet {{domxref("document")}}. Dans la plupart des cas, ceci est égal à l'élément {{HTMLElement("body")}} du document courant. -Syntaxe
+## Syntaxe -height_value = document.height -+ height_value = document.height -
Exemple
+## Exemple -// alert document height +```js +// alert document height alert(document.height); -+``` -
Alternatives
+## Alternatives -document.body.clientHeight -document.documentElement.clientHeight -document.documentElement.scrollHeight -+ document.body.clientHeight + document.documentElement.clientHeight + document.documentElement.scrollHeight -
Spécification
+## Spécification -HTML5
+HTML5 -Voir aussi
+## Voir aussi --
-
- {{domxref("document.width")}} -
- {{domxref("Element.clientHeight")}} -
- {{domxref("Element.scrollHeight")}} -
{{ ApiRef("DOM") }}
+{{ ApiRef("DOM") }} -La propriété Document.hidden
retourne un Booléen qui indique si la page est considérée cachée ou pas.
Syntaxe
+## Syntaxe -var boolean = document.hidden+ var boolean = document.hidden -
Exemples
+## Exemples -document.addEventListener("visibilitychange", function() { +```js +document.addEventListener("visibilitychange", function() { console.log( document.hidden ); // Modifier le comportement... }); -- -
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")}}
+``` + +## 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 --- -{{ ApiRef() }}
+{{ ApiRef() }} -document.images
renvoie une collection des images du document HTML courant.
Syntaxe
+## Syntaxe -HTMLCollection =document.images+```js +HTMLCollection =document.images +``` -
Exemple
+## Exemple -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 } } -+``` -
Notes
+## Notes -document.images
fait partie du DOM HTML, et fonctionne uniquement pour les document HTML.
Spécification
--
-
- Spécification DOM Level 2 HTML : HTMLDocument.images -
- Traduction en français (non normative) : HTMLDocument.images -
Résumé
+## Résumé -Retourne un objet {{domxref("DOMImplementation")}} associé avec le document courant.
+Retourne un objet {{domxref("DOMImplementation")}} associé avec le document courant. -Syntaxe
+## Syntaxe -DOMImpObj = document.implementation; -+ DOMImpObj = document.implementation; -
Exemple
+## Exemple -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.+// alerte avec : "DOM HTML 2.0 pris en charge ?: true" si le module DOM niveau 2 HTML est pris en charge. +``` -
Une liste de noms de modules (par exemple, Core, HTML, XML, etc.) est disponible dans la Conformance Section DOM niveau 2.
+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. -Notes
+## Notes -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.
Spécifications
+## Spécifications - +- [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) -Notes propres à Gecko
+## Notes propres à Gecko --
-
- À partir de Gecko 19.0 {{geckoRelease ("19.0")}} la méthode {{domxref ("DOMImplementation.hasFeature", "hasFeature")}} retournera toujours true. -
{{APIRef("DOM")}}
+{{APIRef("DOM")}} -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 ()")}}.
Syntaxe
+### Syntaxe -var node = document.importNode(externalNode, deep); -+ var node = document.importNode(externalNode, deep); -
-
-
externalNode
- - Le nouveau
Node
ouDocumentFragment
à importer dans le document courant. Après l'importation, le nouveauparentNode
du noeud estnull
, 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 esttrue
(vrai), alorsexternalNode
et tous ses descendants sont copiés; sifalse
(faux), seul le nœud unique,externalNode
, est importé.
-
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.
Exemple
+## Exemple -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);+document.getElementById("container").appendChild(newNode); +``` -
Notes
+## Notes -Le noeud d'origine n'est pas supprimé du document d'origine. Le noeud importé est un clone de l'original.
+Le noeud d'origine n'est pas supprimé du document d'origine. Le noeud importé est un clone de l'original. --
Les nœuds provenant de documents externes doivent être clonés à l'aide de document.importNode()
(ou adoptés avec document.adoptNode()
) avant de pouvoir être insérés dans le document courant. Pour en savoir plus sur les problèmes de Node.ownerDocument
, consultez la FAQ DOM du W3C (en anglais).
Gecko n'obligeait pas à utiliser document.importNode()
et 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.
+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). -
Spécifications
-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
+## Spécifications -{{Compat("api.Document.importNode")}}
-Voir aussi
+## Voir aussi --
-
- {{domxref("document.adoptNode()")}} -
- {{domxref("Node.appendChild()")}} -
- {{domxref("Node.insertBefore()")}} -
+- {{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 --- -
{{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 sontvisible
,hidden (masqué)
, prerender (pré-rendu) etunloaded
(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), sinonfalse
(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
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 . 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. -
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é.
-
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 Alt, Shift, Ctrl ou Meta ne sont pas concernées.
Attention : Cet évènement est déprécié et il faudrait plutôt utiliser beforeinput
ou keydown
.
Interface | -{{domxref("KeyboardEvent")}} | -
---|---|
Remonte sur les parents (bubbles) | -Oui | -
Annulable | -Oui | -
Action par défaut | -Cela peut varier : évènement keypress ; ouverture du système de composition du texte ; évènements blur et focus ; évènement DOMActivate {{deprecated_inline}}; autre évènement. |
-
Interface | +{{domxref("KeyboardEvent")}} | +
Remonte sur les parents (bubbles) | +Oui | +
Annulable | +Oui | +
Action par défaut | +
+ Cela peut varier : évènement keypress ; ouverture du
+ système de composition du texte ; évènements
+ blur et
+ focus ;
+ évènement
+ DOMActivate {{deprecated_inline}}; autre évènement.
+ |
+
Exemples
+## Exemples -Ajout d'un addEventListener
+### Ajout d'un `addEventListener`
-Dans cet exemple, on affiche la valeur de {{domxref("KeyboardEvent.code")}} lorsqu'on appuie sur une touche :
+Dans cet exemple, on affiche la valeur de {{domxref("KeyboardEvent.code")}} lorsqu'on appuie sur une touche : -<p> +```html ++ + +``` -Cliquez dans l'iframe pour lui passer le focus puis appuyez sur des touches du clavier. -</p> -<p id="log"></p>
const log = document.getElementById('log'); +```js +const log = document.getElementById('log'); document.addEventListener('keypress', logKey); function logKey(e) { log.textContent += ` ${e.code}`; -}+} +``` -
{{EmbedLiveSample("addEventListener_keypress_example")}}
+{{EmbedLiveSample("addEventListener_keypress_example")}} -Équivalent onkeypress
+### Équivalent `onkeypress`
-document.onkeypress = logKey;+```js +document.onkeypress = logKey; +``` -
Spécifications
+## Spécifications -Spécification | -État | -
---|---|
{{SpecName('UI Events', '#event-type-keypress')}} | -{{Spec2('UI Events')}} | -
Compatibilité des navigateurs
+{{Compat("api.Document.keypress_event")}} -{{Compat("api.Document.keypress_event")}}
+## Voir aussi -Voir aussi
+- {{domxref("GlobalEventHandlers.onkeypress")}} +- L'interface {{domxref("Element")}} que cet évènement cible +- Les évènements associés : --
-
- {{domxref("GlobalEventHandlers.onkeypress")}} -
- L'interface {{domxref("Element")}} que cet évènement cible -
- Les évènements associés :
-
-
-
keydown
- keyup
- beforeinput
-
-
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.
+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. -Syntaxe
+## Syntaxe -string = document.lastModified; -+ string = document.lastModified; -
Exemples
+## Exemples -Exemple #1: Utilisation simple
+### Exemple #1: Utilisation simple -alert(document.lastModified); +```js +alert(document.lastModified); // renvoie: 11/28/2015 16:11:15 -+``` -
Exemple #2: Transformer lastModified
en un objet de type Date
+### Exemple #2: Transformer `lastModified` en un objet de type [`Date`](/en-US/docs/JavaScript/Reference/Global_Objects/Date)
-var oLastModif = new Date(document.lastModified); -+```js +var oLastModif = new Date(document.lastModified); +``` -
Exemple #3: Transformer lastModified
en un nombre de millisecondes passées depuis le 1 Janvier 1970 à 00:00:00, heure locale.
+### Exemple #3: Transformer `lastModified` en un nombre de millisecondes passées depuis le 1 Janvier 1970 à 00:00:00, heure locale.
-var nLastModif = Date.parse(document.lastModified); -+```js +var nLastModif = Date.parse(document.lastModified); +``` -
Notes
+## Notes -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):
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é !"); -}+} +``` -
… le même exemple, mais en ignorant la première visite:
+… le même exemple, mais en ignorant la première visite: -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é !"); } -}+} +``` -
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)
-Si vous voulez savoir si une page externe a changé, veuillez lire ce paragraphe à propos de l'API XMLHttpRequest()
.
Spécification
+## Spécification -HTML5
+HTML5 -Compatibilité des navigateurs
+## Compatibilité des navigateurs -{{Compat("api.Document.lastModified")}}
+{{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 --- -{{ APIRef("DOM") }}{{ gecko_minversion_header("1.9") }}
+{{ APIRef("DOM") }}{{ gecko_minversion_header("1.9") }} -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.
+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. -Syntaxe
+## Syntaxe -lastStyleSheetSet = document.lastStyleSheetSet -+ lastStyleSheetSet = document.lastStyleSheetSet -
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
.
Note : Cette valeur ne doit pas changer lorsque {{ domxref("document.enableStyleSheetsForSet()") }} est appelé.
-Exemple
+## Exemple -var lastSheetSet = document.lastStyleSheetSet; +```js +var lastSheetSet = document.lastStyleSheetSet; if (!lastSheetSet) { lastSheetSet = "Sheet not yet changed"; } console.log("The last sheet set is: " + lastSheetSet); -+``` -
Voir aussi
+## Voir aussi --
-
- {{ domxref("document.preferredStyleSheetSet") }} -
- {{ domxref("document.selectedStyleSheetSet") }} -
- {{ domxref("document.styleSheetSets") }} -
- {{ domxref("document.enableStyleSheetsForSet()") }} -
Spécifications
+## Spécifications - +- [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 --- -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.
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'
.
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.
+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. -Si le document courant n'est pas un contexte de navigation, la valeur renvoyée est null.
+Si le document courant n'est pas un contexte de navigation, la valeur renvoyée est _null_. -Syntaxe
+## Syntaxe -locationObj = document.location -document.location = 'http://www.mozilla.org' // équivalent à document.location.href = 'http://www.mozilla.org' -+ locationObj = document.location + document.location = 'http://www.mozilla.org' // équivalent à document.location.href = 'http://www.mozilla.org' -
Exemple
+## Exemple -console.log(document.location); +```js +console.log(document.location); // Affiche un string-like // "http://www.example.com/juicybits.html" dans la console -+``` -
Spécification
+## Spécification -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. | -
Compatibilité des navigateurs
+## Compatibilité des navigateurs -{{Compat("api.Document.location")}}
+{{Compat("api.Document.location")}} -Voir également
+## Voir également --
-
- L'interface de la valeur renvoyée, {{domxref("Location")}}. -
- Une information similaire mais attachée au contexte de navigation, {{domxref("Window.location")}} -
{{ ApiRef("DOM") }}
+{{ ApiRef("DOM") }} -{{ gecko_minversion_header("2.0") }}{{ non-standard_header() }}
+{{ gecko_minversion_header("2.0") }}{{ non-standard_header() }} -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é.
+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é. -Syntaxe
+## Syntaxe -document.mozSetImageElement(imageElementId, imageElement); -+ document.mozSetImageElement(imageElementId, imageElement); -
Paramètres
+### Paramètres --
-
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écifieznull
pour supprimer l'élément d'arrière-plan.
-
Exemple
+## Exemple -Cet exemple change l'arrière-plan d'un bloc {{ HTMLElement("div") }} chaque fois que l'utilisateur clique sur le bloc.
+Cet exemple change l'arrière-plan d'un bloc {{ HTMLElement("div") }} chaque fois que l'utilisateur clique sur le bloc. - +[Vue de cet exemple en direct](/samples/domref/mozSetImageElement.html). -<style type="text/css"> +```html + +``` -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.
+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. -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); } -+``` -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.
+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. -Une fois le canvas dessiné,
+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. -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.Spécifications
+## Spécifications -Ne fait partie d'aucune spécification.
+Ne fait partie d'aucune spécification. -Voir aussi
+## Voir aussi -
-
-
- {{ cssxref("-moz-element") }} -
{{ ApiRef("DOM") }}
+{{ ApiRef("DOM") }} -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.
+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. -Syntaxe
+## Syntaxe -var isSynthetic = document.mozSyntheticDocument; -+ var isSynthetic = document.mozSyntheticDocument; -
En retour, isSynthetic
est true
(vrai) si le document est synthétique ; sinon, false
(faux).
Exemple
+## Exemple -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).
+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). -var isSynthetic = document.mozSyntheticDocument; + var isSynthetic = document.mozSyntheticDocument; -if (isSynthetic) { - /* insert your menu item here */ -} -+ if (isSynthetic) { + /* insert your menu item here */ + } -
Spécifications
+## Spécifications -Ne fait partie d'aucune spécification.
+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 --- -Résumé
+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(). -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().
+## Syntaxe -Syntaxe
+ document.onafterscriptexecute = funcRef; -document.onafterscriptexecute = funcRef; -+_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. -
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.
Exemple
- -function finished(e) { +```js +function finished(e) { logMessage("Finished script with ID: " + e.target.id); } document.addEventListener("afterscriptexecute", finished, true); -+``` - +[Voir l'exemple sur une page](/samples/html/currentScript.html) -
Spécification
+## Spécification --
-
- HTML5 -
Voir aussi
+## Voir aussi --
-
- {{domxref("Document.onbeforescriptexecute")}} -
- {{domxref("Document.currentScript")}} -
Résumé
+## Résumé -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().
+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(). -Syntaxe
+## Syntaxe -document.onbeforescriptexecute = funcRef; -+ document.onbeforescriptexecute = funcRef; -
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é.
Exemple
+## Exemple -function starting(e) { +```js +function starting(e) { logMessage("Starting script with ID: " + e.target.id); } document.addEventListener("beforescriptexecute", starting, true); -+``` - +[Voir l'exemple sur une page](/samples/html/currentScript.html) -
Spécification
+## Spécification --
-
- HTML5 -
Voir aussi
+## Voir aussi --
-
- {{domxref("Document.onafterscriptexecute")}} -
- {{domxref("Document.currentScript")}} -
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.
Syntaxe
+## Syntaxe -targetDocument.onfullscreenchange = fullscreenChangeHandler; -+ targetDocument.onfullscreenchange = fullscreenChangeHandler; -
Exemple
+## Exemple -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(); } -- -
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")}} -
{{APIRef("DOM")}}
+{{APIRef("DOM")}} -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 change et devient false
(fausse).
{{APIRef("DOM")}}
+{{APIRef("DOM")}} -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).
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.
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.
-Vous pouvez enregistrer les écouteurs de ces événements de plusieurs manières habituelles :
+Vous pouvez enregistrer les écouteurs de ces événements de plusieurs manières habituelles : --
-
- en utilisant
addEventListener
surwindow
,document
oudocument.body
- - en définissant les propriétés
.ononline
ou.onoffline
surdocument
oudocument.body
sur un objetFunction
JavaScript. (Note : l'utilisation dewindow.ononline
ouwindow.onoffline
ne fonctionnera pas pour des raisons de compatibilité).
- - en spécifiant les attributs
ononline="..."
ouonoffline="..."
sur la balise<body>
dans le balisage HTML.
-
Exemple
+## Exemple -Il existe un cas de test simple que vous pouvez exécuter pour vérifier le fonctionnement des évènements.
+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. -Références
+## Références - +- [É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 --- -La méthode document.open()
ouvre un document pour l'écriture.
Syntaxe
+ document.open(); -document.open(); -+## Exemple -
Exemple
+ // Dans cet exemple, le contenu du document est + // écrasé au cours de la réinitialisation avec open() + document.write("supprimez-moi
"); + document.open(); + // Le document est vide. -// 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. -+## Notes -
Notes
+Si un document existe dans la cible, cette méthode le supprime (voir l'exemple ci-dessus). -Si un document existe dans la cible, cette méthode le supprime (voir l'exemple ci-dessus).
+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 -Par ailleurs, un appel automatique à document.open()
est réalisé lorsque 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
Cette méthode ne doit pas être confondue avec 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().
Voir Security check basics pour plus d'informations sur les principaux.
+Si vous ne voulez pas créer une entrée d'historique, remplacez `open()` par `open("text/html", "replace")`. -Si vous ne voulez pas créer une entrée d'historique, remplacez open()
par open("text/html", "replace")
.
Spécifications
+| 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. | -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. | -
Compatibilité des navigateurs
+{{Compat("api.Document.open")}} -{{Compat("api.Document.open")}}
+## Voir aussi -Voir aussi
- --
-
- {{domxref("Document")}} -
- {{domxref("Window.open()")}} -
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
.
Exemples
+## Exemples -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' -- -
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
- -Voir aussi
- --
-
- La propriété {{domxref("URLUtils.origin")}}. -
Note : À partir de {{Gecko("2.0")}}, les auteurs sont encouragés à utiliser la propriété menupopup triggerNode à la place.
-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.
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 de la fenêtre contextuelle, vous pouvez définir la propriété popupNode
directement au préalable.
Cette propriété s'applique seulement aux documents XUL.
+Cette propriété s'applique seulement aux documents XUL. -Syntaxe
+## Syntaxe -var node = document.popupNode; -+ var node = document.popupNode; -
Exemple
+## Exemple -<menupopup id="toolbarContextMenu"> +```xml ++ +``` -... - <menuitem oncommand="mailNewsCore.deleteButton(document.popupNode)"> +
Voir http://www.mozilla.org/xpfe/xptoolkit/popups.html
+VoirVoir aussi
+## Voir aussi --
-
- 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. -
Retourne la feuille de style préférée, telle que définie par l'auteur de la page.
+Retourne la feuille de style préférée, telle que définie par l'auteur de la page. -Syntaxe
+## Syntaxe -preferredStyleSheetSet = document.preferredStyleSheetSet -+ preferredStyleSheetSet = document.preferredStyleSheetSet -
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
.
En l'absence de feuille de style préférée, une chaine vide ("") est retournée.
+En l'absence de feuille de style préférée, une chaine vide ("") est retournée. -Exemple
+## Exemple -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."); } -+``` -
Spécifications
+## Spécifications - +- [HTML5: Alternate Style Sheets](http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets) -Voir aussi
+## Voir aussi --
-
- {{domxref("document.lastStyleSheetSet")}} -
- {{domxref("document.selectedStyleSheetSet")}} -
- {{domxref("document.styleSheetSets")}} -
- {{domxref("document.enableStyleSheetsForSet()")}} -
Syntaxe
+## Syntaxe -queryCommandState(String command) -+```js +queryCommandState(String command) +``` -
Exemple
+## Exemple -TBD
+TBD -Spécifications
+## Spécifications -Spécification | -Statut | -Commentaire | -
---|---|---|
{{SpecName('HTML Editing','#execcommand()','execCommand')}} | -{{Spec2('HTML Editing')}} | -Définition initiale. | -
Compatibilité des navigateurs
+## Compatibilité des navigateurs -{{Compat("api.Document.queryCommandState")}}
+{{Compat("api.Document.queryCommandState")}} -Voir aussi
+## Voir aussi --
-
- {{domxref("HTMLElement.contentEditable")}} -
- {{domxref("document.designMode")}} -
- Rich-Text Editing in Mozilla -
- Les bogues du navigateur liés à
queryCommandState()
: Scribe's "Browser Inconsistencies" documentation
-
La méthode Document.queryCommandSupported()
indique si la commande d'éditeur spécifiée est prise en charge par le navigateur.
Syntaxe
+## Syntaxe -isSupported = document.queryCommandSupported(command); -+ isSupported = document.queryCommandSupported(command); -
Paramètres
+### Paramètres --
-
command
- - La commande pour laquelle on veut déterminer si elle est prise en charge. -
Valeur de retour
+### Valeur de retour -Renvoie un {{jsxref("Boolean")}} qui est true
(vrai) si la commande est prise en charge et false
(faux) sinon.
Notes
+## Notes -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].
Exemple
+## Exemple -var flg = document.queryCommandSupported("SelectAll"); +```js +var flg = document.queryCommandSupported("SelectAll"); if(flg) { // ...Faire quelque chose } -- -
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()")}} -
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.
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.
-Syntaxe
+## Syntaxe -element = document.querySelector(sélecteurs); -+```js +element = document.querySelector(sélecteurs); +``` -
Paramètres
+### Paramètres --
-
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 pour plus d'informations sur les sélecteurs et leur gestion.
-
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.
-Valeur retournée
+### Valeur retournée -Un objet {{domxref("Element")}} représentant le premier élément dans le document qui corresponde au jeu de sélecteurs CSS spécifié, ou null
s'il n'y a pas de correspondances.
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.
+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. -Exception
+### Exception --
-
SYNTAX_ERR
- - La syntaxe des sélecteurs spécifiés est invalide. -
Notes d'utilisation
+## Notes d'utilisation -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é.
+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é. -Les pseudo-éléments CSS ne retourneront jamais aucun élément, comme spécifié dans l'API des sélecteurs (en).
+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). -Caractère spécial d'échappement
+### Caractère spécial d'échappement -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
) :
<div id="machin\bidule"></div> -<div id="machin:bidule"></div> +```html + + -<script> - console.log('#machin\bidule') // "#machinidule"(\b est le caractère de contrôle retour arrière)
+ +``` -Exemples
+## Exemples -Trouver le premier élément correspondant à une classe
+### Trouver le premier élément correspondant à une classe -Dans cet exemple, le premier élément dans le document qui contient la classe "
+Dans cet exemple, le premier élément dans le document qui contient la classe "`maclasse`" est retourné : -maclasse
" est retourné :var el = document.querySelector(".maclasse");+```js +var el = document.querySelector(".maclasse"); +``` -Un sélecteur plus complexe
+### Un sélecteur plus complexe -Les sélecteurs peuvent également être réellement puissants comme le montre l'exemple suivant. Ici, le premier élément
+Les _sélecteurs_ peuvent également être réellement puissants comme le montre l'exemple suivant. Ici, le premier élément `` dans un `<input name="identifiant"/>
dans un<div class="panneau-utilisateur principal">
dans le document est retourné :` dans le document est retourné : -var el = document.querySelector("div.panneau-utilisateur.principal input[name='+```js +var el = document.querySelector("div.panneau-utilisateur.principal input[name='identifiant']"); +``` -identifiant
']");Spécifications
+## Spécifications -- -
+| 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 | -- -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 -Compatibilité des navigateurs
+## Compatibilité des navigateurs -{{Compat("api.Document.querySelector")}}+{{Compat("api.Document.querySelector")}} -Voir aussi
+## Voir aussi --
+- [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 --- -- Localisation des éléments DOM avec les sélecteurs
-- {{domxref("document.querySelectorAll()")}} ;
-- {{domxref("element.querySelector()")}} ;
-- {{domxref("element.querySelectorAll()")}} ;
-- Extraits de code pour
-querySelector
{{APIRef("DOM")}}+{{APIRef("DOM")}} -La méthode
+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. -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.-+> **Note :** Cette méthode est implémentée à partir de {{domxref("ParentNode")}}, méthode du mixin {{domxref("ParentNode.querySelectorAll", "querySelectorAll()")}} . -Note : Cette méthode est implémentée à partir de {{domxref("ParentNode")}}, méthode du mixin {{domxref("ParentNode.querySelectorAll", "querySelectorAll()")}} .
-Syntaxe
+## Syntaxe -elementList = parentNode.querySelectorAll(selectors); -+```js +elementList = parentNode.querySelectorAll(selectors); +``` -Paramètres
+### Paramètres --
+- `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. -- -
selecteurs
- une {{domxref("DOMString")}} (chaîne de caractères) qui contient un ou plusieurs sélecteurs CSS ; s'il n'y en a pas, une exception
-SyntaxError
est lancée. Voir localisation des éléments DOM avec les sélecteurs 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.-+> **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. -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.
-Valeur renvoyée
+### Valeur renvoyée -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 .
+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 . --+> **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. -Note : Si les
-selectors
spécifiés contiennent un pseudo-element CSS, la liste retournée sera toujours vide.Exceptions
+### Exceptions --
+- `SyntaxError` + - : la syntaxe des chaînes `selectors` spécifiés n'est pas valide. -- -
SyntaxError
- la syntaxe des chaînes
-selectors
spécifiés n'est pas valide.Exemples
+## Exemples -Pour obtenir une {{domxref("NodeList")}} (liste de noeuds) de tous les éléments {{HTMLElement("p")}} dans le document :
+Pour obtenir une {{domxref("NodeList")}} (_liste de noeuds_) de tous les éléments {{HTMLElement("p")}} dans le document : -const matches = document.querySelectorAll("p");+```js +const matches = document.querySelectorAll("p"); +``` -Cet exemple renvoie la liste de tous les éléments
+Cet exemple renvoie la liste de tous les éléments `div` du `document` dont l'attribut de classe a pour valeur "`note`" ou "`alert`" : -div
dudocument
dont l'attribut de classe a pour valeur "note
" ou "alert
" :const matches = document.querySelectorAll("div.note, div.alert"); -+```js +const matches = document.querySelectorAll("div.note, div.alert"); +``` -Ici, nous obtenons une liste des éléments
+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"
.` 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"`. -
const container = document.querySelector("#test"); -const matches = container.querySelectorAll("div.highlighted > p");+```js +const container = document.querySelector("#test"); +const matches = container.querySelectorAll("div.highlighted > p"); +``` -Cet exemple utilise un sélecteur d'attribut pour renvoyer une liste d'éléments {{domxref("iframe")}} dans le document qui contient un attribut nommé
+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"` : -"data-src"
:const matches = document.querySelectorAll("iframe[data-src]");+```js +const matches = document.querySelectorAll("iframe[data-src]"); +``` -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
+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"`: -"userlist"
lequel a un attribut"data-active"
dont la valeur est"1"
:const container = document.querySelector("#userlist"); -const matches = container.querySelectorAll("li[data-active='1']");+```js +const container = document.querySelector("#userlist"); +const matches = container.querySelectorAll("li[data-active='1']"); +``` -Accès aux correspondances
+### Accès aux correspondances -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é
+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. -length
est 0), alors aucune correspondance n'a été trouvée.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 :
+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 : -const highlightedItems = userList.querySelectorAll(".highlighted"); +```js +const highlightedItems = userList.querySelectorAll(".highlighted"); highlightedItems.forEach(function(userItem) { deleteUser(userItem); -});+}); +``` -Notes d'utilisation
+## Notes d'utilisation -+`querySelectorAll()` se comporte différemment des bibliothèques DOM JavaScript les plus courantes, ce qui peut entraîner des résultats inattendus. -
querySelectorAll()
se comporte différemment des bibliothèques DOM JavaScript les plus courantes, ce qui peut entraîner des résultats inattendus.HTML
+### HTML -Considérez ce HTML, avec ses trois blocs {{HTMLElement("div")}} imbriqués.
+Considérez ce HTML, avec ses trois blocs {{HTMLElement("div")}} imbriqués. -<div class="outer"> - <div class="select"> - <div class="inner"> - </div> - </div> -</div>+```html +++``` -++++JavaScript
+### JavaScript -const select = document.querySelector('.select'); +```js +const select = document.querySelector('.select'); const inner = select.querySelectorAll('.outer .inner'); -inner.length; // 1, not 0!+inner.length; // 1, not 0! +``` -Dans cet exemple, lors de la sélection de
+Dans cet exemple, lors de la sélection de `".outer .inner"` dans le contexte, le `".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.` 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. -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 :
+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 : -const select = document.querySelector('.select'); +```js +const select = document.querySelector('.select'); const inner = select.querySelectorAll(':scope .outer .inner'); -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
- --
+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 --- -- Localisation des éléments DOM avec les sélecteurs
-- Sélecteurs d'attribut dans le guide CSS
-- Sélecteurs d'attribut 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
{{APIRef("DOM")}} {{ gecko_minversion_header("1.9.2") }}+{{APIRef("DOM")}} {{ gecko_minversion_header("1.9.2") }} -La valeur Document.readyState est une propriété de {{ domxref("document") }} qui décrit l'état de chargement du document.
+La valeur **Document.readyState** est une propriété de {{ domxref("document") }} qui décrit l'état de chargement du document. -À chaque évolution de la valeur, un évenement {{event("readystatechange")}} est émis dans l'objet {{ domxref("document") }}.
+À chaque évolution de la valeur, un évenement {{event("readystatechange")}} est émis dans l'objet {{ domxref("document") }}. -Syntaxe
+## Syntaxe -var string = document.readyState; -+ var string = document.readyState; -Valeurs
+### Valeurs -La variable
+La variable `readyState`\*\* \*\*peut valoir : -readyState
peut valoir :-
+- **`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. -- -
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.
-Exemples
+## Exemples -Différents états de chargement
+### Différents états de chargement -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 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; } -
+``` -readystatechange comme alternative à DOMContentLoaded
+### readystatechange comme alternative à DOMContentLoaded -// alternative à DOMContentLoaded +```js +// alternative à DOMContentLoaded document.onreadystatechange = function () { if (document.readyState == "interactive") { initApplication(); } -}+} +``` -readystatechange comme alternative à load
+### readystatechange comme alternative à load -// alternative à load +```js +// alternative à load document.onreadystatechange = function () { if (document.readyState == "complete") { initApplication(); } -}+} +``` -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 -// Modification du document <body> dès que possible en utilisant un script externe +```js +// Modification du document 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); -- -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 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
- --
+``` + +## 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 --- -- L'événement {{event("readystatechange")}}
-- L'événement {{event("DOMContentLoaded")}}
-- L'événement {{event("load")}}
-{{ApiRef}}
- -L'événement
- -readystatechange
est déclenché lorsque l'attributreadyState
d'un document a changé.Information générale
- --
- -- Specification
-- HTML5
-- 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
- -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(); } } -+``` -Navigateur compatible
+## Navigateur compatible -Cet événement a longtemps été soutenue par Internet Explorer et peut être utilisé comme une alternative à l'evenement
+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)). -DOMContentLoaded
(voir la note [2] de la section Navigateurs compatibles).Les événements liés
+## Les événements liés --
+- {{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 --- -- {{event("DOMContentLoaded")}}
-- {{event("readystatechange")}}
-- {{event("load")}}
-- {{event("beforeunload")}}
-- {{event("unload")}}
-- {{APIRef}}-Résumé
-Renvoie l'URI 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
- +{{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 --- -{{APIRef("DOM")}} {{Deprecated_header}}
+{{APIRef("DOM")}} {{Deprecated_header}} --+> **Attention :** document.registerElement() est déprécié en faveur de [customElements.define()](/fr/docs/Web/API/CustomElementRegistry/define). -Attention : document.registerElement() est déprécié en faveur de customElements.define().
-{{draft}}
+{{draft}} -La méthode
+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. -Document.registerElement()
permet d'enregistrer un nouvel élément personnalisé dans le navigateur, et retourne un constructeur pour ce nouvel élément.-+> **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). -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.
-Syntaxe
+## Syntaxe -var constructeur = document.registerElement(nom-tag, options);+ var constructeur = document.registerElement(nom-tag, options); -Paramètres
+### Paramètres --
+- _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. -- 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.
-Exemple
+## Exemple -Voici un exemple très simple :
+Voici un exemple très simple : -var Montag = document.registerElement('mon-tag'); -+```js +var Montag = document.registerElement('mon-tag'); +``` -Le nouveau tag est désormais enregistré dans le navigateur. La variable
+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 : -Montag
contient un constructeur que vous pouvez utiliser pour créer des élémentsmon-tag
dans le document de la façon suivante :document.body.appendChild(new Montag());+```js +document.body.appendChild(new Montag()); +``` -Ceci insert un élément
+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 : -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 :var montag = document.getElementsByTagName("mon-tag")[0]; +```js +var montag = document.getElementsByTagName("mon-tag")[0]; montag.textContent = "Je suis un élément mon-tag."; -+``` -Compatibilité avec les navigateurs
+## Compatibilité avec les navigateurs -{{Compat("api.Document.registerElement")}}
+{{Compat("api.Document.registerElement")}} -Voir aussi
+## Voir aussi - +- [É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 --- -{{ ApiRef("DOM") }} {{gecko_minversion_header("2.0")}}+{{ ApiRef("DOM") }} {{gecko_minversion_header("2.0")}} -+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()")}}. -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()")}}.
+## Syntaxe -Syntaxe
+ document.releaseCapture() -document.releaseCapture() -+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. -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.
+## Exemple -Exemple
+Voir l'[exemple](/en-US/docs/Web/API/element.setCapture#Example) pour {{domxref("element.setCapture()")}}. -Voir l'exemple pour {{domxref("element.setCapture()")}}.
+## Spécifications -Spécifications
+Basé sur l'implémentation Internet Explorer. -Basé sur l'implémentation Internet Explorer.
+## Voir aussi -Voir aussi
- --
+- {{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 --- -- {{domxref("element.setCapture()")}}
-{{ApiRef}}+{{ApiRef}} -Retourne une liste des scripts (éléments {{HTMLElement("script")}}) présents dans le document. L'objet retourné est une liste du type {{domxref("HTMLCollection")}}.
+Retourne une liste des scripts (éléments {{HTMLElement("script")}}) présents dans le document. L'objet retourné est une liste du type {{domxref("HTMLCollection")}}. -Syntaxe
+## Syntaxe -var scriptList = document.scripts; -+```js +var scriptList = document.scripts; +``` -La liste
+La liste `scriptList` est un objet {{domxref("HTMLCollection")}} qu'on peut utiliser comme un tableau pour accéder aux éléments qu'elle contient. -scriptList
est un objet {{domxref("HTMLCollection")}} qu'on peut utiliser comme un tableau pour accéder aux éléments qu'elle contient.Exemple
+## Exemple -Cet exemple détecte la présence d'éléments {{HTMLElement("script")}} dans le document.
+Cet exemple détecte la présence d'éléments {{HTMLElement("script")}} dans le document. -var scripts = document.scripts; +```js +var scripts = document.scripts; if (scripts.length) { alert("This page has scripts!"); } -- -Spécifications
- -- -
- -- - - -Spécification -Statut -Commentaire -- - -{{SpecName('HTML WHATWG', '#dom-document-scripts', 'Document.scripts')}} -{{ Spec2('HTML WHATWG') }} -- Compatibilité des navigateurs
- -{{Compat("api.Document.scripts")}}+``` + +## 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 --- -{{APIRef}}+{{APIRef}} -L’évènement
+L’évènement **`scroll`** (défilement) est émis lorsque l’on fait défiler le document ou un élément. -scroll
(défilement) est émis lorsque l’on fait défiler le document ou un élément.Informations générales
+## Informations générales- -
-- -Bouillonne -Pas sur les éléments, mais bouillonne vers la defaultView si émis sur le document -- -Annulable -Non -- -Interface -{{domxref("UIEvent")}} -- -Cible -DefaultView, {{domxref("Document")}}, {{domxref("Element")}} -- - + +Action par défaut -Aucune -+ +Bouillonne ++ Pas sur les éléments, mais bouillonne vers la defaultView si émis sur le + document + ++ +Annulable +Non ++ +Interface +{{domxref("UIEvent")}} ++ +Cible ++ DefaultView, {{domxref("Document")}}, + {{domxref("Element")}} + ++ +Action par défaut +Aucune +-+> **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. -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. Safari et WKWebViews ne sont pas affectés par ce bogue.Propriétés
+## Propriétés -- -
+| 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. | -- - - -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. -Exemple
+## Exemple -Temporisation des évènements scroll
+### Temporisation des évènements scroll -Comme les évènements
+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. -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.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
+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`. -scroll
avecrequestAnimationFrame
.// 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; -});+}); +``` -Autres exemples
+### Autres exemples -Pour plus d’exemples similaires, voir l’évènement resize.
+Pour plus d’exemples similaires, voir l’évènement [resize](/en-US/docs/Web/Events/resize#Example). -Spécifications
+## Spécifications- -
-- -Spécification -État -- - + +{{SpecName('CSSOM View', '#scrolling-events')}} -{{Spec2('CSSOM View')}} -+ +Spécification +État ++ +{{SpecName('CSSOM View', '#scrolling-events')}} +{{Spec2('CSSOM View')}} +Compatibilité des navigateurs
+## Compatibilité des navigateurs -{{Compat("api.Document.scroll_event")}}
+{{Compat("api.Document.scroll_event")}} -Voir aussi
+## Voir aussi --
+- {{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 --- -- {{domxref("GlobalEventHandlers.onscroll")}}
-{{ APIRef("DOM") }}{{ gecko_minversion_header("1.9") }}
+{{ APIRef("DOM") }}{{ gecko_minversion_header("1.9") }} -Indique le nom du jeu de feuilles de styles actuellement utilisé.
+Indique le nom du jeu de feuilles de styles actuellement utilisé. -Syntaxe
+## Syntaxe -currentStyleSheetSet = document.selectedStyleSheetSet + currentStyleSheetSet = document.selectedStyleSheetSet -document.selectedStyleSheet = newStyleSheetSet -+ document.selectedStyleSheet = newStyleSheetSet -En retour,
+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é. -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é.La définition de la valeur de cette propriété équivaut à appeler {{ domxref("document.enableStyleSheetsForSet()") }} avec la valeur de
+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. -currentStyleSheetSet
, puis de définir la valeur delastStyleSheetSet
sur cette valeur.-+> **Note :** Cette valeur d'attribut est directe : sa modification affectera la valeur de l'attribut. -Note : Cette valeur d'attribut est directe : sa modification affectera la valeur de l'attribut.
-Exemple
+## Exemple -console.log("Current style sheet set: " + document.selectedStyleSheetSet); +```js +console.log("Current style sheet set: " + document.selectedStyleSheetSet); document.selectedStyleSheetSet = "Some other style sheet"; -+``` --+> **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()") }}. -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()") }}.Voir aussi
+## Voir aussi --
+- {{ domxref("document.lastStyleSheetSet") }} +- {{ domxref("document.preferredStyleSheetSet") }} +- {{ domxref("document.styleSheetSets") }} +- {{ domxref("document.enableStyleSheetsForSet()") }} -- {{ domxref("document.lastStyleSheetSet") }}
-- {{ domxref("document.preferredStyleSheetSet") }}
-- {{ domxref("document.styleSheetSets") }}
-- {{ domxref("document.enableStyleSheetsForSet()") }}
-Spécifications
+## Spécifications - +- [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 --- -{{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)
oustyleSheetList{{ mediawiki.External('index') }}
retourne un seul objet stylesheet par sonindex
(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
- --
- - +{{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('index') }}` 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 --- -- {{Link("/en-US/docs/Web/API/CSS_Object_Model/Using_dynamic_styling_information")}}
-{{APIRef("DOM")}}{{gecko_minversion_header("1.9")}}+{{APIRef("DOM")}}{{gecko_minversion_header("1.9")}} -Renvoie une liste active de tous les jeux de feuilles de styles actuellement disponibles.
+Renvoie une liste active de tous les jeux de feuilles de styles actuellement disponibles. -Syntaxe
+## Syntaxe -sets = document.styleSheetSets -+ sets = document.styleSheetSets -En retour,
+En retour, `sets` est une liste de jeux de feuilles de styles disponibles. -sets
est une liste de jeux de feuilles de styles disponibles.Exemple
+## Exemple -É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 :
+É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 : -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); -}+} +``` -Notes
+## Notes -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
+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). -title
(titre) de chacune de celles en ayant un. Les doublons sont supprimés de la liste (en utilisant une comparaison sensible à la casse).Spécifications
+## Spécifications - +- [HTML5 : Alternate Style Sheets](http://www.whatwg.org/specs/web-apps/current-work/#alternate-style-sheets) -Voir aussi
+## Voir aussi --
+- {{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 --- -- {{domxref("Stylesheet")}}
-- {{domxref("document.styleSheets")}}
-- {{domxref("document.lastStyleSheetSet")}}
-- {{domxref("document.preferredStyleSheetSet")}}
-- {{domxref("document.selectedStyleSheetSet")}}
-- {{domxref("document.enableStyleSheetsForSet()")}}
-{{APIRef("DOM")}}+{{APIRef("DOM")}} -Obtient ou défini le titre de la page.
+Obtient ou défini le titre de la page. -Syntaxe
+## Syntaxe -var docTitle = document.title; -+ var docTitle = document.title; -+`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). -
title
est la chaîne contenant le titre de la page. Si le titre a déjà été modifié pardocument.title
, cela retournera cette valeur. Sinon cela retournera le titre par défaut de la page (voir les {{Anch("Notes")}} ci-dessous).document.title = newTitle; -+ document.title = newTitle; -+`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 `
newTitle
sera le nouveau titre de la page. Le changement de titre affectera également la valeur de retour dedocument.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>
).`). - */ + document.documentElement.clientWidth /* largeur de */ + window.innerWidth /* largeur de la fenêtre */ -Exemple
+## Exemple -<!DOCTYPE html> -<html> -<head> -<title>Hello World!</title> -</head> -<body> +```html + + + ++ + +``` -Hello World! + + -<script> + -</body> -</html> -Notes
+## Notes -Cette propriété s'applique à HTML, SVG, XUL, et aux autres documents Gecko.
+Cette propriété s'applique à HTML, SVG, XUL, et aux autres documents Gecko. -Pour les documents HTML, la valeur initiale de
+Pour les documents HTML, la valeur initiale de `document.title` est le texte de la balise `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.`. 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. - En XUL, accéder à
+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). -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éfinirdocument.title
peut n'avoir aucun effet).Spécification
+## Spécification - +- [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 --- -{{ ApiRef("DOM") }}
+{{ ApiRef("DOM") }} -{{draft}}
+{{draft}} -Renvoie le noeud qui est la cible de l'actuel {{ XULElem("tooltip") }}.
+Renvoie le noeud qui est la cible de l'actuel {{ XULElem("tooltip") }}. -Syntaxe
+## Syntaxe -document.tooltipNode; -+ document.tooltipNode; -Spécification
+## Spécification -XUL-specific method. Not part of any specification. Defined in {{ Source("dom/public/idl/xul/nsIDOMXULDocument.idl#59", "nsIDOMXULDocument.idl") }}.
+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 --- -{{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
-- 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
(window
of the document)- -- detail
{{readonlyInline}}long (float) -0. -- -- touches
{{readonlyInline}}TouchList -A list of -Touch
es for every point of contact currently touching the surface.- -- targetTouches
{{readonlyInline}}TouchList -A list of -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
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.
- -Compatibilité des navigateurs
- -{{Compat("api.Document.touchend_event")}}
- -Voir aussi
- --
+{{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 --- -- {{ domxref("GlobalEventHandlers.ontouchleave","ontouchleave")}}
-- {{ domxref("GlobalEventHandlers.ontouchstart","ontouchstart")}}
-- {{ domxref("GlobalEventHandlers.ontouchmove","ontouchmove")}}
-{{APIRef}}+{{APIRef}} -L’évènement
+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é.transitionend
est émis quand une transition 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 valeurnone
, l’évènement n’est pas généré.- -
-- -Bouillonne -Oui -- -Est annulable -Oui -- -Interface -{{domxref("TransitionEvent")}} -- - + +Propriété gestionnaire d’évènement -- ontransitionend
+ +Bouillonne +Oui ++ +Est annulable +Oui ++ +Interface +{{domxref("TransitionEvent")}} ++ +Propriété gestionnaire d’évènement ++ +ontransitionend
+L’évènement
+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. -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ènementtransitioncancel
est émis, l’évènementtransitionend
ne se produira pas.La cible originale pour cet évènement est l’
+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). -Element
sur lequel la transition est appliquée. Vous pouvez écouter cet évènement sur l’interfaceWindow
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.Exemples
+## Exemples -Le code suivant ajoute un gestionnaire sur l’évènement
+Le code suivant ajoute un gestionnaire sur l’évènement `transitionend` : -transitionend
:document.addEventListener('transitionend', () => { +```js +document.addEventListener('transitionend', () => { console.log('Transition terminée'); -});+}); +``` -La même chose, mais en utilisant la propriété
+La même chose, mais en utilisant la propriété [`ontransitionend`](/en-US/docs/Web/API/GlobalEventHandlers/ontransitionend) au lieu de `addEventListener()` : -ontransitionend
au lieu deaddEventListener()
:document.ontransitionend = () => { +```js +document.ontransitionend = () => { console.log('Transition terminée'); -};- -Voir un exemple en direct sur cet évènement.
- -Spécifications
- -- -
+}; +``` + +[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. | -- - - -Spécification -Statut -Commentaire -- - -{{SpecName("CSS3 Transitions", "#transitionend", "transitionend")}} -{{Spec2('CSS3 Transitions')}} -Définition initiale. -Compatibilité des navigateurs
+## Compatibilité des navigateurs -{{Compat("api.Document.transitionend_event")}}
+{{Compat("api.Document.transitionend_event")}} -Voir aussi
+## Voir aussi --
+- 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 --- -- 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
,transitionstart
,transitioncancel
- Cet évènement sur les cibles
-HTMLElement
:transitionend
- Cet évènement sur les cibles
-Window
:transitionend
{{APIRef("DOM")}}+{{APIRef("DOM")}} -Retourne l'
+Retourne l'**`URL`** du {{domxref("Document")}} sous forme de string (lecture seule). -URL
du {{domxref("Document")}} sous forme de string (lecture seule).Syntaxe
+## Syntaxe -var string = document.URL -+```js +var string = document.URL +``` -Exemple
+## Exemple -+ var currentURL = document.URL; + alert(currentURL); -var currentURL = document.URL; -alert(currentURL);
Specification
+## Specification - +- [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 --- -{{ ApiRef("DOM") }}
+{{ ApiRef("DOM") }} -La propriété en lecture seule
+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 : -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 :-
+- **`'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. -- -
'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 dedocument.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.Lorsque la valeur de cette propriété change, l'évènement {{event('visibilitychange')}} est envoyé au {{domxref("Document")}}.
+Lorsque la valeur de cette propriété change, l'évènement {{event('visibilitychange')}} est envoyé au {{domxref("Document")}}. -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.
+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. -Syntaxe
+## Syntaxe -var string = document.visibilityState+ var string = document.visibilityState -Exemples
+## Exemples -document.addEventListener("visibilitychange", function() { +```js +document.addEventListener("visibilitychange", function() { console.log( document.visibilityState ); // Modifier le comportement... -});- -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")}}
+}); +``` + +## 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 --- -{{APIRef("DOM")}} {{Obsolete_header}}+{{APIRef("DOM")}} {{Obsolete_header}} --+> **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")}}. -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")}}.Renvoie la largeur de l'élément {{HTMLElement("body")}} du document courrent en pixels.
+Renvoie la largeur de l'élément {{HTMLElement("body")}} du document courrent en pixels. -Non pris en charge par Internet Explorer.
+Non pris en charge par Internet Explorer. -Syntaxe
+## Syntaxe -pixels = document.width; -+ pixels = document.width; -Exemple
+## Exemple -function init() { +```js +function init() { alert("La largeur du document est " + document.width + " pixels."); } -+``` -Alternatives
+## Alternatives -document.body.clientWidth /* largeur de <body> */ -document.documentElement.clientWidth /* largeur de <html> */ -window.innerWidth /* largeur de la fenêtre */ -+ document.body.clientWidth /* largeur deSpécification
+## Spécification -HTML5
+HTML5 -Voir également
+## Voir également --
+- {{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 --- -- {{domxref("document.height")}}
-- {{domxref("Element.clientWidth")}}
-- {{domxref("Element.scrollWidth")}}
-{{ ApiRef("DOM") }}
+{{ ApiRef("DOM") }} -Écrit une chaîne de texte dans un document ouvert par document.open().
+Écrit une chaîne de texte dans un document ouvert par [document.open()](/fr/docs/Web/API/Document/open). --+> **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. -Note : comme
-document.write
écrit dans le flux de documents, appelerdocument.write
sur un document fermé (chargé) appelle automatiquementdocument.open
, ce qui efface le document.Syntaxe
+## Syntaxe -document.write(balisage); -+ document.write(balisage); -Paramètres
+### Paramètres --
+- `markup` + - : est une chaîne de caractères contenant le texte à écrire dans le document. -- -
markup
- est une chaîne de caractères contenant le texte à écrire dans le document.
-Exemple
+### Exemple -<html> +```html + -<head> -<title>Exemple de document.write</title> + ++ +Exemple de document.write -<script type="text/javascript"> + + -<body onload="nouveauContenu();"> -<p>Ceci est le contenu original du document.</p> -</body> -</html> -Ceci est le contenu original du document.
+ + +``` -Notes
+## Notes -Écrire dans un document qui a déjà été chargé sans appeler document.open() provoquera un appel automatique à
+É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. -document.open
. Une fois l'écriture terminée, il est recommandé d'appeler 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émenth1
devient un nœud dans le document.Si l'appel à
+Si l'appel à `document.write()` est intégré directement dans le code HTML, il n'appellera pas `document.open()`. Par exemple : -document.write()
est intégré directement dans le code HTML, il n'appellera pasdocument.open()
. Par exemple :<script> - document.write("<h1>Main title</h1>") -</script>+```html + +``` --+> **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). -Note :
-document.write
etdocument.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 uneapplication/xhtml+xml
de type MIME. Plus d'informations disponibles dans la foire aux questions W3C XHTML (en).-+> **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. -Note :
-document.write
dans les scripts deferred (différé) ou asynchronous (asynchrone) sera ignoré et vous recevrez un message comme "A call todocument.write()
from an asynchronously-loaded external script was ignored" dans la console d'erreurs.-+> **Note :** Dans Edge seulement, appeler plusieurs fois `document.write` dans un "iframe" déclenche une erreur "SCRIPT70: Permission denied." _(autorisation refusée)_. -Note : Dans Edge seulement, appeler plusieurs fois
-document.write
dans un "iframe" déclenche une erreur "SCRIPT70: Permission denied." (autorisation refusée).-+> **Note :** À partir de la version 55, Chrome n'exécute pas les éléments `Note : À partir de la version 55, Chrome n'exécute pas les éléments
-<script>
injectés viadocument.write()
en cas d'échec de cache HTTP pour les utilisateurs sur une connexion 2G.