diff options
Diffstat (limited to 'files/fr/web/api/document/index.html')
| -rw-r--r-- | files/fr/web/api/document/index.html | 62 |
1 files changed, 31 insertions, 31 deletions
diff --git a/files/fr/web/api/document/index.html b/files/fr/web/api/document/index.html index 795b4fc76d..186904db9e 100644 --- a/files/fr/web/api/document/index.html +++ b/files/fr/web/api/document/index.html @@ -11,26 +11,26 @@ translation_of: Web/API/Document --- <p>{{ApiRef}}</p> -<p><span id="result_box" lang="fr"><span>L'interface <strong><code>Document</code></strong> représente n'importe quelle page Web chargée dans le navigateur et sert de point d'entrée dans le contenu de la page Web, qui est l'arborescence DOM.</span> <span>L'arborescence DOM inclut des éléments tels que {{HTMLElement ("body")}} <em>(corps)</em> et {{HTMLElement ("table")}} <em>(tableau)</em>, parmi beaucoup d'autres.</span> <span>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.</span></span></p> +<p>L'interface <strong><code>Document</code></strong> représente n'importe quelle page Web chargée dans le navigateur et sert de point d'entrée dans le contenu de la page Web, qui est l'arborescence DOM. L'arborescence DOM inclut des éléments tels que {{HTMLElement ("body")}} <em>(corps)</em> et {{HTMLElement ("table")}} <em>(tableau)</em>, parmi beaucoup d'autres. Il fournit des fonctionnalités globales au document, comme le moyen d'obtenir l'URL de la page et de créer de nouveaux éléments dans le document.</p> <p>{{inheritanceDiagram}}</p> -<p><span id="result_box" lang="fr"><span>L'interface Document décrit les propriétés et méthodes communes à tout type de document.</span> <span>En fonction du type de document (HTML, XML, SVG, ...), une API plus grande est disponible : les documents HTML, servis avec le type <code>text/html</code>, implémentent également l'interface {{domxref ("HTMLDocument")}}, alors que</span> l<span>es documents XML et SVG implémentent l'interface {{domxref ("XMLDocument")}}.</span></span></p> +<p>L'interface Document décrit les propriétés et méthodes communes à tout type de document. En fonction du type de document (HTML, XML, SVG, ...), une API plus grande est disponible : les documents HTML, servis avec le type <code>text/html</code>, implémentent également l'interface {{domxref ("HTMLDocument")}}, alors que les documents XML et SVG implémentent l'interface {{domxref ("XMLDocument")}}.</p> -<h2 id="Constructeur"><span lang="fr"><span>Constructeur</span></span></h2> +<h2 id="Constructeur">Constructeur</h2> <dl> <dt>{{domxref("Document.Document","Document()")}}{{non-standard_inline}}</dt> <dd>crée un nouvel objet <code>Document</code> .</dd> </dl> -<h2 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s">Propriétés</h2> +<h2 id="Propri.C3.A9t.C3.A9s">Propriétés</h2> <p><em>Cette interface hérite aussi des interfaces {{domxref("Node")}} et {{domxref("EventTarget")}} .</em></p> <dl> <dt>{{domxref("Document.all")}} {{Deprecated_inline}} {{non-standard_inline}}</dt> - <dd>fournit un accès à tous les éléments du document. <span id="result_box" lang="fr"><span>C'est une interface héritée non standard qui ne doit pas être utilisée.</span></span></dd> + <dd>fournit un accès à tous les éléments du document. C'est une interface héritée non standard qui ne doit pas être utilisée.</dd> </dl> <dl> @@ -74,15 +74,15 @@ translation_of: Web/API/Document <dt>{{domxref("Document.inputEncoding")}} {{readonlyinline}} {{Deprecated_inline}}</dt> <dd>alias de {{domxref("Document.characterSet")}}. Utilisez cette propriété à la place.</dd> <dt>{{domxref("Document.lastStyleSheetSet")}} {{readonlyinline}}</dt> - <dd>retourne le nom de l'ensemble de feuilles de style qui a été activé en dernier. <span id="result_box" lang="fr"><span>A la valeur <code>null</code> jusqu'à ce que la feuille de style soit modifiée en définissant la valeur de </span></span> {{domxref("document.selectedStyleSheetSet","selectedStyleSheetSet")}}.</dd> + <dd>retourne le nom de l'ensemble de feuilles de style qui a été activé en dernier. A la valeur <code>null</code> jusqu'à ce que la feuille de style soit modifiée en définissant la valeur de {{domxref("document.selectedStyleSheetSet","selectedStyleSheetSet")}}.</dd> <dt>{{domxref("Document.mozSyntheticDocument")}} {{non-standard_inline}} {{gecko_minversion_inline("8.0")}}</dt> - <dd>retourne un {{jsxref("Boolean")}} qui est <code>true</code> <em>(vrai)</em> seulement si le document est synthétique, <span id="result_box" lang="fr"><span>tel qu'une image autonome, une vidéo, un fichier audio ou similaire.</span></span></dd> + <dd>retourne un {{jsxref("Boolean")}} qui est <code>true</code> <em>(vrai)</em> seulement si le document est synthétique, tel qu'une image autonome, une vidéo, un fichier audio ou similaire.</dd> <dt>{{domxref("Document.mozFullScreenElement")}} {{readonlyinline}} {{non-standard_inline}} {{gecko_minversion_inline("9.0")}}</dt> <dd>L'élément qui est actuellement affiché en mode plein écran pour ce document.</dd> <dt>{{domxref("Document.mozFullScreenEnabled")}} {{readonlyinline}} {{non-standard_inline}} {{gecko_minversion_inline("9.0")}}</dt> <dd><code>true</code> <em>(vrai)</em> si l'appel {{domxref("Element.mozRequestFullscreen()")}} est réussi dans le document courant.</dd> <dt>{{domxref("Document.pointerLockElement")}} {{readonlyinline}} {{experimental_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>renvoie l'ensemble d'éléments en tant que cible pour les événements de la souris lorsque le pointeur est verrouillé.</span> <span><code>null</code> si le verrouillage est en attente, le pointeur est déverrouillé ou la cible se trouve dans un autre document.</span></span></dd> + <dd>renvoie l'ensemble d'éléments en tant que cible pour les événements de la souris lorsque le pointeur est verrouillé. <code>null</code> si le verrouillage est en attente, le pointeur est déverrouillé ou la cible se trouve dans un autre document.</dd> <dt>{{domxref("Document.preferredStyleSheetSet")}} {{readonlyinline}}</dt> <dd>renvoie la page de style préférée spécifiée par l'auteur de la page.</dd> <dt>{{domxref("Document.scrollingElement")}} {{experimental_inline}} {{readonlyinline}}</dt> @@ -96,7 +96,7 @@ translation_of: Web/API/Document <dt>{{domxref("Document.undoManager")}} {{readonlyinline}} {{experimental_inline}}</dt> <dd>...</dd> <dt>{{domxref("Document.visibilityState")}} {{readonlyinline}}</dt> - <dd>renvoie une <code>string</code> <em>(chaîne de caractères)</em> <span id="result_box" lang="fr"><span>indiquant l'état de visibilité du document.</span> <span>Les valeurs possibles sont </span></span> <code>visible</code> <span lang="fr"><span>, </span></span> <code>hidden <em>(masqué)</em></code> <span lang="fr"><span>, prerender <em>(pré-rendu)</em> et </span></span> <code>unloaded</code> <em>(</em><span lang="fr"><span><em>déchargées</em>).</span></span></dd> + <dd>renvoie une <code>string</code> <em>(chaîne de caractères)</em> indiquant l'état de visibilité du document. Les valeurs possibles sont <code>visible</code> , <code>hidden <em>(masqué)</em></code> , prerender <em>(pré-rendu)</em> et <code>unloaded</code> <em>(</em><em>déchargées</em>).</dd> <dt>{{domxref("Document.xmlEncoding")}} {{Deprecated_inline}}</dt> <dd>retourne le codage déterminé par une déclaration XML.</dd> <dt>{{domxref("Document.xmlStandalone")}} {{obsolete_inline("10.0")}}</dt> @@ -137,7 +137,7 @@ translation_of: Web/API/Document <dt>{{domxref("Document.defaultView")}} {{readonlyinline}}</dt> <dd>Renvoie une référence à l'objet window.</dd> <dt>{{domxref("Document.designMode")}}</dt> - <dd>renvoie ou définit les capacités d'édition <span class="short_text" id="result_box" lang="fr"><span>du document entier.</span></span></dd> + <dd>renvoie ou définit les capacités d'édition du document entier.</dd> <dt>{{domxref("Document.dir")}} {{readonlyinline}}</dt> <dd>Assigne / renvoie le sens du texte (rtl/ltr) <em>(de gauche à droite / de droite à gauche)</em> du document.</dd> <dt>{{domxref("Document.domain")}}</dt> @@ -224,17 +224,17 @@ translation_of: Web/API/Document <h2 id="Méthodes">Méthodes</h2> -<p><em><span id="result_box" lang="fr"><span>Cette interface hérite également des interfaces {{domxref ("Node")}} et {{domxref ("EventTarget")}}.</span></span></em></p> +<p><em>Cette interface hérite également des interfaces {{domxref ("Node")}} et {{domxref ("EventTarget")}}.</em></p> <dl> <dt>{{domxref("Document.adoptNode()")}}</dt> - <dd><span class="short_text" id="result_box" lang="fr"><span>adopte le noeud d'un document externe.</span></span></dd> + <dd>adopte le noeud d'un document externe.</dd> <dt>{{domxref("Document.captureEvents()")}} {{Deprecated_inline}}</dt> <dd>voir {{domxref("Window.captureEvents")}}.</dd> <dt>{{domxref("Document.caretPositionFromPoint()")}}{{experimental_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>obtient le {{domxref ("CaretPosition")}} aux ou près des coordonnées spécifiées.</span></span></dd> + <dd>obtient le {{domxref ("CaretPosition")}} aux ou près des coordonnées spécifiées.</dd> <dt>{{domxref("Document.caretRangeFromPoint()")}}{{non-standard_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>Obtient un objet {{Domxref ("Range")}} pour le fragment de document sous les coordonnées spécifiées.</span></span></dd> + <dd>Obtient un objet {{Domxref ("Range")}} pour le fragment de document sous les coordonnées spécifiées.</dd> <dt>{{domxref("Document.createAttribute()")}}</dt> <dd>Crée un nouvel objet {{domxref("Attr")}} et le renvoie.</dd> <dt>{{domxref("Document.createAttributeNS()")}}</dt> @@ -300,15 +300,15 @@ translation_of: Web/API/Document <dt>{{domxref("Document.normalizeDocument()")}} {{obsolete_inline}}</dt> <dd>remplace les entités, normalise les noeuds de texte, etc.</dd> <dt>{{domxref("Document.registerElement()")}} {{experimental_inline}}</dt> - <dd><span class="short_text" id="result_box" lang="fr"><span>Enregistre un composant Web.</span></span></dd> + <dd>Enregistre un composant Web.</dd> <dt>{{domxref("Document.releaseCapture()")}} {{non-standard_inline}} {{gecko_minversion_inline("2.0")}}</dt> - <dd><span id="result_box" lang="fr"><span>Libère la capture de la souris en cours s'il s'agit d'un élément de ce document.</span></span></dd> + <dd>Libère la capture de la souris en cours s'il s'agit d'un élément de ce document.</dd> <dt>{{domxref("Document.releaseEvents()")}} {{non-standard_inline}} {{Deprecated_inline}}</dt> <dd>voir {{domxref("Window.releaseEvents()")}}.</dd> <dt>{{domxref("Document.routeEvent()")}} {{non-standard_inline}} {{obsolete_inline(24)}}</dt> <dd>Voir {{domxref("Window.routeEvent()")}}.</dd> <dt>{{domxref("Document.mozSetImageElement()")}} {{non-standard_inline}} {{gecko_minversion_inline("2.0")}}</dt> - <dd><span id="result_box" lang="fr"><span>Vous permet de modifier l'élément utilisé comme image d'arrière-plan pour un ID d'élément spécifié.</span></span></dd> + <dd>Vous permet de modifier l'élément utilisé comme image d'arrière-plan pour un ID d'élément spécifié.</dd> </dl> <p>L'interface <code>Document</code> est étendue avec l'interface {{domxref("ParentNode")}} :</p> @@ -317,7 +317,7 @@ translation_of: Web/API/Document <dt>{{domxref("document.getElementById","document.getElementById(String id)")}}</dt> <dd>retourne une référence d'objet à l'élément identifié.</dd> <dt>{{domxref("document.querySelector","document.querySelector(String selector)")}} {{gecko_minversion_inline("1.9.1")}}</dt> - <dd><span id="result_box" lang="fr"><span>Renvoie le premier noeud <code>Element</code> dans le document, dans l'ordre du document, qui correspond aux sélecteurs spécifiés.</span></span></dd> + <dd>Renvoie le premier noeud <code>Element</code> dans le document, dans l'ordre du document, qui correspond aux sélecteurs spécifiés.</dd> <dt>{{domxref("document.querySelectorAll","document.querySelectorAll(String selector)")}} {{gecko_minversion_inline("1.9.1")}}</dt> <dd>retourne une liste de tous les noeuds éléments inclus dans le document qui correspondent aux sélecteurs spécifiés.</dd> </dl> @@ -326,7 +326,7 @@ translation_of: Web/API/Document <dl> <dt>{{domxref("document.createExpression","document.createExpression(String expression, XPathNSResolver resolver)")}}</dt> - <dd>compile une <code><a href="https://developer.mozilla.org/fr/docs/Web/API/XPathExpression" title="XPathExpression">XPathExpression</a></code> qui peut ensuite être utilisée pour des évaluations (répétées).</dd> + <dd>compile une <code><a href="/fr/docs/Web/API/XPathExpression">XPathExpression</a></code> qui peut ensuite être utilisée pour des évaluations (répétées).</dd> <dt>{{domxref("document.createNSResolver","document.createNSResolver(Node resolver)")}}</dt> <dd>crée un objet {{domxref("XPathNSResolver")}} .</dd> <dt>{{domxref("document.evaluate","document.evaluate(String expression, Node contextNode, XPathNSResolver resolver, Number type, Object result)")}}</dt> @@ -337,9 +337,9 @@ translation_of: Web/API/Document <dl> <dt>{{domxref("document.clear()")}} {{non-standard_inline}} {{Deprecated_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>dans la majorité des navigateurs modernes, y compris les versions récentes de Firefox et Internet Explorer, cette méthode ne fait rien.</span></span></dd> + <dd>dans la majorité des navigateurs modernes, y compris les versions récentes de Firefox et Internet Explorer, cette méthode ne fait rien.</dd> <dt>{{domxref("document.close()")}}</dt> - <dd><span class="short_text" id="result_box" lang="fr"><span>ferme un flux de document pour l'écriture.</span></span></dd> + <dd>ferme un flux de document pour l'écriture.</dd> <dt>{{domxref("document.execCommand","document.execCommand(String command[, Boolean showUI[, String value]])")}}</dt> <dd>Sur un document modifiable, exécute une commande de formatage.</dd> <dt>{{domxref("document.getElementsByName","document.getElementsByName(String name)")}}</dt> @@ -453,38 +453,38 @@ translation_of: Web/API/Document <dt>{{domxref("document.currentScript")}} {{non-standard_inline}} {{gecko_minversion_inline("2.0")}}</dt> <dd>retourne l'élément {{HTMLElement("script")}} qui est en cours d'exécution.</dd> <dt>{{domxref("document.documentURIObject")}} {{gecko_minversion_inline("1.9")}}</dt> - <dd>(extensions Mozilla seulement) retourne l'objet {{Interface("nsIURI")}} représentant l'URI du document. Cette propriété <span id="result_box" lang="fr"><span>a seulement une signification spéciale dans le code JavaScript privilégié (avec les privilèges UniversalXPConnect).</span></span></dd> + <dd>(extensions Mozilla seulement) retourne l'objet {{Interface("nsIURI")}} représentant l'URI du document. Cette propriété a seulement une signification spéciale dans le code JavaScript privilégié (avec les privilèges UniversalXPConnect).</dd> <dt>{{domxref("document.popupNode")}}</dt> <dd>retourne le noeud ouvert lors de l'appel d'une fenêtre contextuelle.</dd> <dt>{{domxref("document.tooltipNode")}}</dt> - <dd>retourne le noeud <span class="short_text" id="result_box" lang="fr"><span>qui est la cible de l'info-bulle actuelle.</span></span></dd> + <dd>retourne le noeud qui est la cible de l'info-bulle actuelle.</dd> </dl> <p>Mozilla a également défini quelques méthodes non standard :</p> <dl> <dt>{{domxref("document.execCommandShowHelp")}} {{obsolete_inline("14.0")}}</dt> - <dd><span id="result_box" lang="fr"><span>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")}}.</span></span></dd> + <dd>Cette méthode n'a jamais rien fait et a toujours lancé une exception, elle a donc été supprimée dans Gecko 14.0 {{geckoRelease ("14.0")}}.</dd> <dt>{{domxref("document.getBoxObjectFor")}} {{obsolete_inline}}</dt> <dd>Utiliser la méthode {{domxref("Element.getBoundingClientRect()")}} à la place.</dd> <dt>{{domxref("document.loadOverlay")}}</dt> - <dd>charge dynamiquement un <a href="https://developer.mozilla.org/fr/docs/Overlays_XUL" title="XUL_Overlays">XUL overlay</a> . Celui-ci fonctionne seulement dans les documents XUL.</dd> + <dd>charge dynamiquement un <a href="/fr/docs/Overlays_XUL">XUL overlay</a> . Celui-ci fonctionne seulement dans les documents XUL.</dd> <dt>{{domxref("document.queryCommandText")}} {{obsolete_inline("14.0")}}</dt> - <dd><span id="result_box" lang="fr"><span>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")}}.</span></span></dd> + <dd>Cette méthode n'a jamais rien fait d'autre que de lancer une exception, elle a donc été supprimée dans Gecko 14.0 {{geckoRelease ("14.0")}}.</dd> </dl> -<h3 id="Notes_concernant_Internet_Explorer"><span lang="fr"><span>Notes concernant Internet Explorer</span></span></h3> +<h3 id="Notes_concernant_Internet_Explorer">Notes concernant Internet Explorer</h3> -<p><span lang="fr"><span>Microsoft a défini quelques propriétés non standard :</span></span></p> +<p>Microsoft a défini quelques propriétés non standard :</p> <dl> <dt>{{domxref("document.fileSize")}}* {{non-standard_inline}} {{obsolete_inline}}</dt> - <dd><span id="result_box" lang="fr"><span>Retourne la taille en octets du document.</span> <span>À partir d'Internet Explorer 11, cette propriété n'est plus prise en charge.</span> <span>Voir </span></span> <a href="http://msdn.microsoft.com/en-us/library/ms533752%28v=VS.85%29.aspx" title="http://msdn.microsoft.com/en-us/library/ms533752%28v=VS.85%29.aspx">MSDN</a>.</dd> + <dd>Retourne la taille en octets du document. À partir d'Internet Explorer 11, cette propriété n'est plus prise en charge. Voir <a href="http://msdn.microsoft.com/en-us/library/ms533752%28v=VS.85%29.aspx">MSDN</a>.</dd> </dl> -<p><span id="result_box" lang="fr"><span>Internet Explorer ne prend pas en charge toutes les méthodes de l'interface Node dans l'interface Document :</span></span></p> +<p>Internet Explorer ne prend pas en charge toutes les méthodes de l'interface Node dans l'interface Document :</p> <dl> <dt>{{domxref("document.contains")}}</dt> - <dd><span id="result_box" lang="fr"><span>Pour contourner le problème, <code>document.body.contains ()</code> peut être utilisé.</span></span></dd> + <dd>Pour contourner le problème, <code>document.body.contains ()</code> peut être utilisé.</dd> </dl> |