From 6772831200d14c2436aea2d0c837f40dbf12156f Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sun, 26 Sep 2021 13:11:47 +0200 Subject: Prepare Web API section for Markdown conversion (#2464) * Remove summary classes and ids * Remove unecessary hidden * Remove useless span filled with useless attributes / ids * Remove useless font * Remove notranslate * Remove id in other elements than headings * Remove name attributes * Remove
 for JS w/ language-js class

* Remove 
 for HTML w/ language-html class

* Remove 
 for other lang w/ language-* class

* Rm highlighted line in code samples

* fix links, internal, external, absolute URLs

* missing file from last commit

* Fix styles errors apart from table + some classes

* Fix notes and warnings (+ some other :x)

* fix typo during merge which broke a doc

* aand forgot a conflict

* fix remaining classes of errors except dls and images

* Fix dls

* Fix images (deki/mozillademos) and remaining style issues

* Remove script tag from svg file

* Remove script tag from svg fileS

* Compress SVG files for CI
---
 files/fr/web/api/document/activeelement/index.html |  17 +-
 files/fr/web/api/document/adoptnode/index.html     |  24 +--
 files/fr/web/api/document/alinkcolor/index.html    |   4 +-
 files/fr/web/api/document/anchors/index.html       |   8 +-
 files/fr/web/api/document/applets/index.html       |  10 +-
 files/fr/web/api/document/body/index.html          |  11 +-
 .../api/document/caretrangefrompoint/index.html    |   4 +-
 files/fr/web/api/document/characterset/index.html  |   2 +-
 files/fr/web/api/document/clear/index.html         |   2 +-
 files/fr/web/api/document/compatmode/index.html    |  16 +-
 files/fr/web/api/document/contenttype/index.html   |   6 +-
 .../fr/web/api/document/createattribute/index.html |   8 +-
 .../web/api/document/createcdatasection/index.html |  10 +-
 files/fr/web/api/document/createcomment/index.html |   8 +-
 .../api/document/createdocumentfragment/index.html |  28 ++--
 files/fr/web/api/document/createelement/index.html |   4 +-
 .../fr/web/api/document/createelementns/index.html |  55 +++----
 .../api/document/createentityreference/index.html  |   6 +-
 files/fr/web/api/document/createevent/index.html   |  24 ++-
 .../web/api/document/createexpression/index.html   |  10 +-
 .../web/api/document/createnodeiterator/index.html |  24 +--
 .../web/api/document/creatensresolver/index.html   |  18 +--
 .../createprocessinginstruction/index.html         |  14 +-
 files/fr/web/api/document/createrange/index.html   |  10 +-
 .../fr/web/api/document/createtextnode/index.html  |  46 +++---
 files/fr/web/api/document/defaultview/index.html   |  17 +-
 files/fr/web/api/document/designmode/index.html    |   8 +-
 files/fr/web/api/document/dir/index.html           |   4 +-
 files/fr/web/api/document/document/index.html      |   2 +-
 .../fr/web/api/document/documentelement/index.html |  14 +-
 .../web/api/document/documenturiobject/index.html  |  12 +-
 files/fr/web/api/document/domain/index.html        |  26 ++-
 .../api/document/domcontentloaded_event/index.html |   6 +-
 files/fr/web/api/document/drag_event/index.html    |  14 +-
 files/fr/web/api/document/dragend_event/index.html |  58 +++----
 .../fr/web/api/document/dragenter_event/index.html |  58 +++----
 .../fr/web/api/document/dragleave_event/index.html |  38 ++---
 .../fr/web/api/document/dragover_event/index.html  | 144 ++++++++---------
 .../fr/web/api/document/dragstart_event/index.html |  14 +-
 files/fr/web/api/document/drop_event/index.html    | 148 +++++++++--------
 .../web/api/document/elementfrompoint/index.html   |  18 +--
 .../web/api/document/elementsfrompoint/index.html  |   6 +-
 .../document/enablestylesheetsforset/index.html    |  10 +-
 files/fr/web/api/document/evaluate/index.html      |  16 +-
 files/fr/web/api/document/execcommand/index.html   | 175 ++++++---------------
 .../fr/web/api/document/exitfullscreen/index.html  |   6 +-
 files/fr/web/api/document/forms/index.html         |  52 +++---
 .../api/document/fullscreenchange_event/index.html |   2 +-
 .../api/document/fullscreenerror_event/index.html  |   2 +-
 .../fr/web/api/document/getboxobjectfor/index.html |  12 +-
 .../fr/web/api/document/getelementbyid/index.html  |  99 ++++++------
 .../api/document/getelementsbyclassname/index.html |  74 ++++-----
 .../web/api/document/getelementsbyname/index.html  |  44 +++---
 .../api/document/getelementsbytagname/index.html   | 142 ++++++++---------
 .../api/document/getelementsbytagnamens/index.html |  30 ++--
 files/fr/web/api/document/getselection/index.html  |   2 +-
 files/fr/web/api/document/hasfocus/index.html      |  84 +++++-----
 files/fr/web/api/document/head/index.html          |   7 +-
 files/fr/web/api/document/height/index.html        |   2 +-
 files/fr/web/api/document/images/index.html        |  29 ++--
 .../fr/web/api/document/implementation/index.html  |  20 +--
 files/fr/web/api/document/importnode/index.html    |  30 ++--
 files/fr/web/api/document/index.html               |  62 ++++----
 .../fr/web/api/document/keypress_event/index.html  |   6 +-
 files/fr/web/api/document/lastmodified/index.html  |  19 +--
 .../web/api/document/laststylesheetset/index.html  |  14 +-
 files/fr/web/api/document/location/index.html      |  16 +-
 .../web/api/document/mozsetimageelement/index.html |  10 +-
 .../api/document/mozsyntheticdocument/index.html   |   6 +-
 .../api/document/onafterscriptexecute/index.html   |   2 +-
 .../api/document/onbeforescriptexecute/index.html  |   2 +-
 files/fr/web/api/document/onoffline/index.html     |   2 +-
 files/fr/web/api/document/ononline/index.html      |  12 +-
 files/fr/web/api/document/open/index.html          |  14 +-
 files/fr/web/api/document/popupnode/index.html     |   8 +-
 .../api/document/preferredstylesheetset/index.html |  10 +-
 .../web/api/document/querycommandstate/index.html  |   2 +-
 .../api/document/querycommandsupported/index.html  |   5 +-
 files/fr/web/api/document/queryselector/index.html |  28 ++--
 .../web/api/document/queryselectorall/index.html   |  12 +-
 files/fr/web/api/document/readystate/index.html    |  20 +--
 .../api/document/readystatechange_event/index.html |   4 +-
 files/fr/web/api/document/referrer/index.html      |   8 +-
 .../fr/web/api/document/registerelement/index.html |  12 +-
 .../fr/web/api/document/releasecapture/index.html  |   8 +-
 files/fr/web/api/document/scripts/index.html       |   2 +-
 files/fr/web/api/document/scroll_event/index.html  |  11 +-
 .../api/document/selectedstylesheetset/index.html  |  20 ++-
 files/fr/web/api/document/stylesheets/index.html   |   8 +-
 .../fr/web/api/document/stylesheetsets/index.html  |  10 +-
 files/fr/web/api/document/title/index.html         |  12 +-
 files/fr/web/api/document/tooltipnode/index.html   |   4 +-
 .../fr/web/api/document/touchend_event/index.html  |   6 +-
 .../api/document/transitionend_event/index.html    |  12 +-
 files/fr/web/api/document/url/index.html           |   6 +-
 .../fr/web/api/document/visibilitystate/index.html |   8 +-
 files/fr/web/api/document/width/index.html         |  12 +-
 files/fr/web/api/document/write/index.html         |  30 ++--
 files/fr/web/api/document/writeln/index.html       |  14 +-
 files/fr/web/api/document/xmlencoding/index.html   |  10 +-
 files/fr/web/api/document/xmlversion/index.html    |   4 +-
 101 files changed, 1077 insertions(+), 1168 deletions(-)

(limited to 'files/fr/web/api/document')

diff --git a/files/fr/web/api/document/activeelement/index.html b/files/fr/web/api/document/activeelement/index.html
index fe982e77d7..2b09fac218 100644
--- a/files/fr/web/api/document/activeelement/index.html
+++ b/files/fr/web/api/document/activeelement/index.html
@@ -8,19 +8,14 @@ translation_of_original: Web/API/Document/activeElement
 original_slug: Web/API/DocumentOrShadowRoot/activeElement
 ---
 

{{ ApiRef() }}

-

Résumé

+

Résumé

Renvoie l'élément qui dispose actuellement du focus.

{{ Note("Cet attribut fait partie de la spécification HTML 5 encore en développement.") }}

-

Syntaxe

+

Syntaxe

var elemCourant = document.activeElement;
 
-

Exemple

-

Spécification

+

Exemple

+

Spécification

-

 

-

 

-
-  
-

{{ languages( { "en": "en/DOM/document.activeElement", "es": "es/DOM/element.activeElement", "ja": "ja/DOM/document.activeElement", "pl": "pl/DOM/document.activeElement" } ) }}

+
  • Focus management (brouillon de travail HTML 5)
  • + \ No newline at end of file diff --git a/files/fr/web/api/document/adoptnode/index.html b/files/fr/web/api/document/adoptnode/index.html index 16b8760df2..3c5270aa80 100644 --- a/files/fr/web/api/document/adoptnode/index.html +++ b/files/fr/web/api/document/adoptnode/index.html @@ -14,23 +14,23 @@ translation_of: Web/API/Document/adoptNode
     
    -

    Adopte un noeud. Le noeud (et son sous-arbre) est supprimé du document dans lequel il se trouve (le cas échéant) et son ownerDocument (document propriétaire) est remplacé par le document en cours. Le noeud peut ensuite être inséré dans le document en cours.

    +

    Adopte un noeud. Le noeud (et son sous-arbre) est supprimé du document dans lequel il se trouve (le cas échéant) et son ownerDocument (document propriétaire) est remplacé par le document en cours. Le noeud peut ensuite être inséré dans le document en cours.

    Pris en charge depuis Gecko 1.9 (Firefox 3)

    -

    Syntaxe

    +

    Syntaxe

    node = document.adoptNode(externalNode);
     
    -
    node
    -
    est le noeud adopté  qui a maintenant ce document en tant que son ownerDocument (document propriétaire). Le parentNode du noeud est null, car il n'a pas encore été inséré dans l'arborescence du document.  Notez que node et externalNode sont le même objet après cet appel.
    +
       node
    +
    est le noeud adopté  qui a maintenant ce document en tant que son ownerDocument (document propriétaire). Le parentNode du noeud est null, car il n'a pas encore été inséré dans l'arborescence du document.  Notez que node et externalNode sont le même objet après cet appel.  
    externalNode
    est le noeud à adopter existant dans un autre document.
    -

    Exemple

    +

    Exemple

    var iframe = document.getElementById('my-iframe');
     var iframeImages = iframe.contentDocument.getElementsByTagName('img');
    @@ -42,20 +42,20 @@ for (var i = 0; i < iframeImages.length; i++) {
     }
     
    -

    Notes

    +

    Notes

    En général l'appel de adoptNode peut échouer en raison du nœud source provenant d'une implémentation différente, mais cela ne devrait pas poser de problème avec les implémentations du navigateur.

    -

    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).

    +

    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 +

    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.

    + WRONG_DOCUMENT_ERR est déclenchée (NS_ERROR_DOM_WRONG_DOCUMENT_ERR). implémentation dans le bug 47903.

    -

    Spécification

    +

    Spécification

    • DOM Level 3 Core: Document.adoptNode
    • diff --git a/files/fr/web/api/document/alinkcolor/index.html b/files/fr/web/api/document/alinkcolor/index.html index d80fd7c834..5f8b845548 100644 --- a/files/fr/web/api/document/alinkcolor/index.html +++ b/files/fr/web/api/document/alinkcolor/index.html @@ -25,9 +25,9 @@ translation_of: Web/API/Document/alinkColor

      La valeur par défaut pour cette propriété est rouge (#ee000 en hexadécimal) sur Mozilla Firefox.

      -

      document.alinkColor est obsolète dans DOM Level 2 HTML (lien en anglais). Une alternative est le sélecteur CSS {{Cssxref(":active")}}.

      +

      document.alinkColor est obsolète dans DOM Level 2 HTML (lien en anglais). Une alternative est le sélecteur CSS {{Cssxref(":active")}}.

      -

      Une autre alternative est document.body.aLink, même si elle est obsolète dans HTML 4.01 (lien en anglais) en faveur de l'alternative CSS ci-dessus.

      +

      Une autre alternative est document.body.aLink, même si elle est obsolète dans HTML 4.01 (lien en anglais) en faveur de l'alternative CSS ci-dessus.

      Gecko supporte alinkColor/:active et {{Cssxref(":focus")}}. Internet Explorer 6 et 7 supportent alinkColor/:active seulement pour la balise HTML des liens (<a>) et le comportement est le même que :focus sur Gecko. Il n'y a pas de support pour :focus sur IE.

      diff --git a/files/fr/web/api/document/anchors/index.html b/files/fr/web/api/document/anchors/index.html index 0fc1039a41..ea16e0f96f 100644 --- a/files/fr/web/api/document/anchors/index.html +++ b/files/fr/web/api/document/anchors/index.html @@ -8,12 +8,12 @@ original_slug: Web/API/Document/Document.anchors

      anchors retourne une liste de toutes les ancres du document.

      -

      Syntaxe

      +

      Syntaxe

      nodeList = document.anchors;
       
      -

      Exemple

      +

      Exemple

      if ( document.anchors.length >= 5 ) {
         dump("Trop d'ancres trouvées !");
      @@ -70,11 +70,11 @@ function init() {
       
       

      Voir dans JSFiddle

      -

      Notes

      +

      Notes

      Pour des raisons de rétrocompatibilité, la liste d'ancres retournée contient seulement les ancres créées avec l'attribut name, pas celles créées avec l'attribut id.

      -

      Spécification

      +

      Spécification

      • DOM Level 2 HTML: anchors
      • diff --git a/files/fr/web/api/document/applets/index.html b/files/fr/web/api/document/applets/index.html index dfbb22d9b7..ea763af9a4 100644 --- a/files/fr/web/api/document/applets/index.html +++ b/files/fr/web/api/document/applets/index.html @@ -4,14 +4,14 @@ slug: Web/API/Document/applets translation_of: Web/API/Document/applets ---

        {{ ApiRef() }}

        -

        Résumé

        +

        applets retourne une liste ordonnée des applets contenus dans un document.

        -

        Syntaxe

        +

        Syntaxe

        nodeList = document.applets
         
        -

        Exemple

        +

        Exemple

        // ( Si vous savez que le second applet est celui que vous voulez )
         my_java_app = document.applets[1];
         
        -

        Spécification

        -

        DOM Level 2 HTML: applets

        +

        Spécification

        +

        DOM Level 2 HTML: applets

        diff --git a/files/fr/web/api/document/body/index.html b/files/fr/web/api/document/body/index.html index 65b872d225..57a6cdfe79 100644 --- a/files/fr/web/api/document/body/index.html +++ b/files/fr/web/api/document/body/index.html @@ -8,12 +8,11 @@ translation_of: Web/API/Document/body ---
        {{ApiRef}}
        -

        Résumé

        Retourne l'élément <body> ou <frameset> du document courant.

        -

        Syntaxe

        +

        Syntaxe

        var objRef = document.body;
         document.body = objRef;
        -

        Exemple

        +

        Exemple

        // dans le HTML: <body id="ancienElementBody"></body>
         alert(document.body.id); // "ancienElementBody"
         
        @@ -23,10 +22,10 @@ unNouvelElementBody .id = "nouvelElementBody";
         document.body = unNouvelElementBody ;
         alert(document.body.id); // "nouvelElementBody"
         
        -

        Notes

        +

        Notes

        document.body est l'élément dans lequel le contenu du document est situé. Dans les documents avec un élément <body> celui-ci est retourné, et dans les documents de type frameset l'élément <frameset> le plus extérieur est retourné.

        Même si body est modifiable, lui affecter une nouvelle valeur retire tous les éléments enfants du <body> existant.

        -

        Spécification

        +

        Spécification

        diff --git a/files/fr/web/api/document/caretrangefrompoint/index.html b/files/fr/web/api/document/caretrangefrompoint/index.html index e0166becb3..ed72fe6bd7 100644 --- a/files/fr/web/api/document/caretrangefrompoint/index.html +++ b/files/fr/web/api/document/caretrangefrompoint/index.html @@ -33,10 +33,10 @@ translation_of: Web/API/Document/caretRangeFromPoint
        x
        Une position horizontale dans la fenêtre courante.
        y
        -
        Une position verticale dans la fenêtre courante.
        +
        Une position verticale dans la fenêtre courante.
        -

        Exemple

        +

        Exemple

        Démonstration de base : lorsque vous cliquez dans un paragraphe, insérez un saut de ligne à la position du curseur :

        diff --git a/files/fr/web/api/document/characterset/index.html b/files/fr/web/api/document/characterset/index.html index fb023e7871..d43772b7fb 100644 --- a/files/fr/web/api/document/characterset/index.html +++ b/files/fr/web/api/document/characterset/index.html @@ -12,7 +12,7 @@ translation_of: Web/API/Document/characterSet ---

        {{ApiRef("DOM")}}

        -

        Document.characterSet propriété en lecture seule, renvoie l'encodage du document en cours. Un encodage décrit l'ensemble des caractères possibles et la façon de décoder les octets en ces caractères.

        +

        Document.characterSet propriété en lecture seule, renvoie l'encodage du document en cours. Un encodage décrit l'ensemble des caractères possibles et la façon de décoder les octets en ces caractères.

        Note : La propriété document.charset et document.inputEncoding sont les alias de document.characterSet. Ne plus les utiliser.

        diff --git a/files/fr/web/api/document/clear/index.html b/files/fr/web/api/document/clear/index.html index a8489b0248..24fab67361 100644 --- a/files/fr/web/api/document/clear/index.html +++ b/files/fr/web/api/document/clear/index.html @@ -27,7 +27,7 @@ translation_of: Web/API/Document/clear

        Spécifications

        Compatibilité des navigateurs

        diff --git a/files/fr/web/api/document/compatmode/index.html b/files/fr/web/api/document/compatmode/index.html index 0197c02c50..fd984565fe 100644 --- a/files/fr/web/api/document/compatmode/index.html +++ b/files/fr/web/api/document/compatmode/index.html @@ -10,9 +10,9 @@ translation_of: Web/API/Document/compatMode ---

        {{ ApiRef("DOM") }}

        -

        Indique si le document est affiché en mode dégradé (Quirks mode) ou dans le respect des standards.

        +

        Indique si le document est affiché en mode dégradé (Quirks mode) ou dans le respect des standards.

        -

        Syntaxe

        +

        Syntaxe

        mode = document.compatMode
         
        @@ -20,7 +20,7 @@ translation_of: Web/API/Document/compatMode

        Valeurs

          -
        • "BackCompat" si le document est affiché en mode "quirks" ;
        • +
        • "BackCompat" si le document est a ffiché en mode   "quirks" ; 
        @@ -29,25 +29,25 @@ translation_of: Web/API/Document/compatMode
          -
        • "CSS1Compat" si le document est affiché en mode "no-quirks" (aussi connu sous le nom de mode "standard") ou "limited-quirks" (mode "proche du standard").
        • +
        • "CSS1Compat" si le document est affiché en mode "no-quirks" (aussi connu sous le nom de mode "standard") ou "limited-quirks" (mo de "proche du standard").
        -

        Note : tous ces modes sont maintenant définis dans les normes, de sorte que les anciens «standards» et «presque standards» sont absurdes et ne sont plus utilisés dans les normes.

        +

        Note : tous ces modes sont maintenant définis dans les normes, de sorte que les anciens «standards» et «presque standards» sont absurdes et ne sont plus utilisés dans les normes.

        -

        Exemple

        +

        Exemple

        if (document.compatMode == "BackCompat") {
           // en mode Quirks
         }
         
        -

        Spécifications

        +

        Spécifications

        diff --git a/files/fr/web/api/document/contenttype/index.html b/files/fr/web/api/document/contenttype/index.html index 3301c615c1..32d072bbae 100644 --- a/files/fr/web/api/document/contenttype/index.html +++ b/files/fr/web/api/document/contenttype/index.html @@ -14,17 +14,17 @@ translation_of: Web/API/Document/contentType

        Renvoie le type MIME dans lequel le document est rendu. Il peut provenir d'en-têtes HTTP ou d'autres sources d'informations MIME et peut être affecté par les conversions automatiques de type effectuées par le navigateur ou les extensions.

        -

        Syntaxe

        +

        Syntaxe

        contentType = document.contentType;
         

        contentType est une propriété en lecture seule.

        -

        Notes

        +

        Notes

        La  propriété n'est pas affectée par les balises META.

        -

        Spécifications

        +

        Spécifications

        {{SpecName('DOM WHATWG','#dom-document-contenttype','Document.contenttype')}}

        diff --git a/files/fr/web/api/document/createattribute/index.html b/files/fr/web/api/document/createattribute/index.html index fa0f93d1e0..bfec33bfa2 100644 --- a/files/fr/web/api/document/createattribute/index.html +++ b/files/fr/web/api/document/createattribute/index.html @@ -13,15 +13,15 @@ translation_of: Web/API/Document/createAttribute

        La méthode Document.createAttribute() crée un nouveau nœud d'attribut et le renvoie. L'objet a créé un noeud implémentant l'interface {{domxref("Attr")}}. Le DOM n'impose pas le type d'attribut à ajouter à un élément particulier de cette manière.

        -

        Note : La chaîne de caractères donnée dans le paramètre est convertie en minuscules.

        +

        Note : La chaîne de caractères donnée dans le paramètre est convertie en minuscules.

        -

        Syntaxe

        +

        Syntaxe

        attribut = document.createAttribute(nom)
         
        -

        Paramètres

        +

        Paramètres

        • nom est une chaîne de caractères contenant le nom de l'attribut.
        • @@ -48,7 +48,7 @@ console.log(node.getAttribute("my_attrib")); // "newVal"

      Spécifications

      - +
      diff --git a/files/fr/web/api/document/createcdatasection/index.html b/files/fr/web/api/document/createcdatasection/index.html index ea4fb083ea..f1a44c9a07 100644 --- a/files/fr/web/api/document/createcdatasection/index.html +++ b/files/fr/web/api/document/createcdatasection/index.html @@ -16,17 +16,17 @@ translation_of: Web/API/Document/createCDATASection

      createCDATASection() crée un nouveau noeud de section CDATA et le renvoie.

      -

      Syntaxe

      +

      Syntaxe

      CDATASectionNode = document.createCDATASection(data)
       
        -
      • CDATASectionNode est un noeud de Section CDATA.
      • +
      • CDATASectionNode est un noeud de Section CDATA.
      • data est une string (chaîne de caractères) contenant les données à ajouter à la section CDATA.
      -

      Exemple

      +

      Exemple

      var docu = new DOMParser().parseFromString('<xml></xml>',  "application/xml")
       
      @@ -38,14 +38,14 @@ alert(new XMLSerializer().serializeToString(docu));
       // Affiche : <xml><![CDATA[Some <CDATA> data & then some]]></xml>
       
      -

      Notes

      +

      Notes

      • Cela fonctionnera uniquement avec XML, pas avec les documents HTML (car les documents HTML ne supportent pas les sections CDATA) ; le tenter sur un document HTML va lancer une exception NOT_SUPPORTED_ERR.
      • Va lancer une exception NS_ERROR_DOM_INVALID_CHARACTER_ERR si on essaye de soumettre la séquence CDATA de fermeture ("]]>") en tant que partie des données ; les données fournies par l'utilisateur non échappées, ne peuvent pas être utilisées en toute sécurité sans qu'avec cette méthode on obtienne cette exception (createTextNode() peut souvent être utilisé à sa place).
      -

      Spécification

      +

      Spécification

      • createCDATASection
      • diff --git a/files/fr/web/api/document/createcomment/index.html b/files/fr/web/api/document/createcomment/index.html index 8aaa2be9f3..5e16be2ecb 100644 --- a/files/fr/web/api/document/createcomment/index.html +++ b/files/fr/web/api/document/createcomment/index.html @@ -12,19 +12,19 @@ translation_of: Web/API/Document/createComment

        createComment() crée et retourne un nouveau noeud de type commentaire.

        -

        Syntaxe

        +

        Syntaxe

        CommentNode = document.createComment(data)
         
        -

        Paramètres

        +

        Paramètres

        data
        Une chaîne de caractères représentant le contenu du commentaire.
        -

        Exemple

        +

        Exemple

        var docu = new DOMParser().parseFromString('<xml></xml>',  "application/xml");
         var comment = docu.createComment('Voici un commentaire pas très bien caché');
        @@ -37,5 +37,5 @@ alert(new XMLSerializer().serializeToString(docu));
         

        Spécification

        diff --git a/files/fr/web/api/document/createdocumentfragment/index.html b/files/fr/web/api/document/createdocumentfragment/index.html index 806a9db921..629d26ed27 100644 --- a/files/fr/web/api/document/createdocumentfragment/index.html +++ b/files/fr/web/api/document/createdocumentfragment/index.html @@ -14,7 +14,7 @@ translation_of: Web/API/Document/createDocumentFragment

        Crée un nouvel objet vide de type {{domxref("DocumentFragment")}}.

        -

        Syntaxe

        +

        Syntaxe

        var fragment = document.createDocumentFragment();
         
        @@ -27,29 +27,29 @@ translation_of: Web/API/Document/createDocumentFragment

        Le principal avantage de cette méthode de mise à jour du DOM vient du fait que le fragment est stocké en mémoire, et pas dans l'arbre DOM lui-même, de sorte que le modifier ne déclenche pas de reflow (le calcul des positions et de la géométrie de chacun des éléments de la page affichée). Par conséquent, l´utilisation de fragments pour effectuer des mises à jour du DOM donne souvent lieu à une amélioration des performances.

        -

        Exemple

        +

        Exemple

        Cet exemple crée une liste des principaux navigateurs du web.

        HTML

        -
        <ul id="ul">
        -</ul>
        +
        <ul id="ul">
        +</ul>

        JavaScript

        -
        var element  = document.getElementById('ul'); // en supposant qu'ul existe
        -var fragment = document.createDocumentFragment();
        -var browsers = ['Firefox', 'Chrome', 'Opera',
        -    'Safari', 'Internet Explorer'];
        +
        var element  = document.getElementById('ul'); // en supposant qu'ul existe
        +var fragment = document.createDocumentFragment();
        +var browsers = ['Firefox', 'Chrome', 'Opera',
        +    'Safari', 'Internet Explorer'];
         
        -browsers.forEach(function(browser) {
        -    var li = document.createElement('li');
        -    li.textContent = browser;
        -    fragment.appendChild(li);
        -});
        +browsers.forEach(function(browser) {
        +    var li = document.createElement('li');
        +    li.textContent = browser;
        +    fragment.appendChild(li);
        +});
         
        -element.appendChild(fragment);
        +element.appendChild(fragment);

        Résultat

        diff --git a/files/fr/web/api/document/createelement/index.html b/files/fr/web/api/document/createelement/index.html index e62a086f10..aaf9bf831b 100644 --- a/files/fr/web/api/document/createelement/index.html +++ b/files/fr/web/api/document/createelement/index.html @@ -12,7 +12,7 @@ translation_of: Web/API/Document/createElement ---
        {{APIRef("DOM")}}
        -

        Dans un document HTML, la méthode document.createElement() crée un élément HTML du type spécifié par tagName ou un {{domxref("HTMLUnknownElement")}} si tagName n’est pas reconnu.

        +

        Dans un document HTML, la méthode document.createElement() crée un élément HTML du type spécifié par tagName ou un {{domxref("HTMLUnknownElement")}} si tagName n’est pas reconnu.

        Syntaxe

        @@ -95,7 +95,7 @@ customElements.define('expanding-list', ExpandingList, { extends: 'ul' });

        Le nouvel élément donnera un attribut is dont la valeur est la balise de nom de l’élément personnalisé.

        -

        Note : Pour la rétrocompatibilité avec les versions précédentes de la spécification des éléments personnalisés, quelques navigateurs permettent de passer une chaîne de caractères ici, à la place d’un objet, dont la valeur est la balise de nom de l’élément personnalisé.

        +

        Note : Pour la rétrocompatibilité avec les versions précédentes de la spécification des éléments personnalisés, quelques navigateurs permettent de passer une chaîne de caractères ici, à la place d’un objet, dont la valeur est la balise de nom de l’élément personnalisé.

        Spécification

        diff --git a/files/fr/web/api/document/createelementns/index.html b/files/fr/web/api/document/createelementns/index.html index 74f17956dd..4949f5203e 100644 --- a/files/fr/web/api/document/createelementns/index.html +++ b/files/fr/web/api/document/createelementns/index.html @@ -15,31 +15,28 @@ translation_of: Web/API/Document/createElementNS

        Crée un élément avec l'URI de l'espace de noms spécifié et un nom qualifié.

        -

        Pour créer un élément sans spécifier d'URI d'espace de noms, utilisez la méthode createElement .

        +

        Pour créer un élément sans spécifier d'URI d'espace de noms, utilisez la méthode createElement .

        -

        Syntaxe

        +

        Syntaxe

        -
        var element = document.createElementNS(namespaceURI, qualifiedName[, options]);
        +
        var element = document.createElementNS(namespaceURI, qualifiedName[, options]);

        Paramètres

        namespaceURI
        -
        est une chaîne de caractères qui spécifie l'URI de l'espace de noms à associer à l'élément. La propriété namespaceURI de l'élément créé est initialisée avec la valeur de namespaceURI. voir URI d'espaces de nom valides
        +
        est une chaîne de caractères qui spécifie l'URI de l'espace de noms à associer à l'élément. La propriété namespaceURI de l'élément créé est initialisée avec la valeur de namespaceURI. voir URI d'espaces de nom valides
        qualifiedName
        -
        est une chaîne de caractères qui spécifie le type de l'élément à créer. La propriété nodeName de l'élément créé est initialisée avec la valeur de qualifiedName
        -
        Options Facultatif
        -
        Un objet facultatif ElementCreationOptions contient une propriété unique nommée is, dont la valeur est le nom de la balise pour un élément personnalisé défini précédemment à l'aide de  customElements.define() . Pour la rétro-compatibilité avec les versions précédentes de la spécification des éléments personnalisés, quelques navigateurs vous permettront de passer ici une chaîne de caractères à la place d'un objet, pour laquelle la valeur est un nom d'élément personnalisé. Voir  Extending native HTML elements  pour plus d'informations sur la façon d'utiliser ce paramètre.
        -
        Le nouvel élément recevra un attribut is dont la valeur est le nom de la balise de l'élément personnalisé. Les éléments personnalisés sont une fonctionnalité expérimentale disponible uniquement dans certains navigateurs.
        +
        est une chaîne de caractères qui spécifie le type de l'élément à créer. La propriété nodeName de l'élément créé est initialisée avec la valeur de qualifiedName
        +
        Options Facultatif
        +

        Un objet facultatif ElementCreationOptions contient une propriété unique nommée is, dont la valeur est le nom de la balise pour un élément personnalisé défini précédemment à l'aide de  customElements.define() . Pour la rétro-compatibilité avec les versions précédentes de la spécification des éléments personnalisés, quelques navigateurs vous permettront de passer ici une chaîne de caractères à la place d'un objet, pour laquelle la valeur est un nom d'élément personnalisé. Voir  Extending native HTML elements  pour plus d'informations sur la façon d'utiliser ce paramètre. Le nouvel élément recevra un attribut is dont la valeur est le nom de la balise de l'élément personnalisé. Les éléments personnalisés sont une fonctionnalité expérimentale disponible uniquement dans certains navigateurs.

        Valeur de retour

        -
        -
        Le nouvel element.
        -
        +

        Le nouvel element.

        -

        URI d'espaces de nom valides

        +

        URI d'espaces de nom valides

        • HTML - Utiliser http://www.w3.org/1999/xhtml
        • @@ -48,17 +45,17 @@ translation_of: Web/API/Document/createElementNS
        • XUL - Utiliser http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul
        -

        Exemple

        +

        Exemple

        -

        Cet exemple crée un nouvel élément <div> dans l'espace de noms XHTML et l'ajoute à l'élément vbox. Bien que ce ne soit pas un document XUL très utile, cela montre l'utilisation d'éléments de deux espaces de noms différents au sein d'un même document :

        +

        Cet exemple crée un nouvel élément <div> dans l'espace de noms XHTML et l'ajoute à l'élément vbox. Bien que ce ne soit pas un document XUL très utile, cela montre l'utilisation d'éléments de deux espaces de noms différents au sein d'un même document :

        -
        <?xml version="1.0"?>
        -<page xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
        -      xmlns:html="http://www.w3.org/1999/xhtml"
        -      title="||Working with elements||"
        -      onload="init()">
        +
        <?xml version="1.0"?>
        +<page xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
        +      xmlns:html="http://www.w3.org/1999/xhtml"
        +      title="||Working with elements||"
        +      onload="init()">
         
        -<script type="text/javascript"><![CDATA[
        +<script type="text/javascript"><![CDATA[
          var container;
          var newdiv;
          var txtnode;
        @@ -71,21 +68,21 @@ translation_of: Web/API/Document/createElementNS
            container.appendChild(newdiv);
          }
         
        -]]></script>
        +]]></script>
         
        - <vbox id='ContainerBox' flex='1'>
        -  <html:div>
        + <vbox id='ContainerBox' flex='1'>
        +  <html:div>
            Le script sur cette page ajoutera du contenu dynamique ci-dessous :
        -  </html:div>
        - </vbox>
        +  </html:div>
        + </vbox>
         
        -</page>
        +</page>

        Note : Cet exemple utilise un script interne, ce qui n'est pas recommandé dans les documents XHTML. Cet exemple particulier est en fait un document XUL intégrant du XHTML. Cependant, la recommandation s'applique quand même.

        -

        Spécifications

        +

        Spécifications

      Spécification
      @@ -111,6 +108,6 @@ translation_of: Web/API/Document/createElementNS diff --git a/files/fr/web/api/document/createentityreference/index.html b/files/fr/web/api/document/createentityreference/index.html index c8881dddcb..46269f94bc 100644 --- a/files/fr/web/api/document/createentityreference/index.html +++ b/files/fr/web/api/document/createentityreference/index.html @@ -7,8 +7,8 @@ translation_of: Web/API/Document/createEntityReference

      {{ obsolete_header("7.0") }}

      -

      Avant {{ gecko("7.0") }} cette méthode apparaissait présente mais en raison du bogue {{bug("9850")}}, elle renvoyait toujours uniquement "null". La seule solution consiste à créer un noeud de texte, une section CDATA, une valeur de noeud d'attribut, etc., qui ont la valeur référencée par l'entité, en utilisant Les caractères d'échappement ou fromCharCode() si nécessaire.

      +

      Avant {{ gecko("7.0") }} cette méthode apparaissait présente mais en raison du bogue {{bug("9850")}}, elle renvoyait toujours uniquement "null". La seule solution consiste à créer un noeud de texte, une section CDATA, une valeur de noeud d'attribut, etc., qui ont la valeur référencée par l'entité, en utilisant Les caractères d'échappement ou fromCharCode() si nécessaire.

      -

      Spécifications

      +

      Spécifications

      -

      createEntityReference

      +

      createEntityReference

      diff --git a/files/fr/web/api/document/createevent/index.html b/files/fr/web/api/document/createevent/index.html index b07312c314..3cccde91e3 100644 --- a/files/fr/web/api/document/createevent/index.html +++ b/files/fr/web/api/document/createevent/index.html @@ -9,26 +9,24 @@ tags: translation_of: Web/API/Document/createEvent ---
      -

      De nombreuses méthodes utilisées avec createEvent, tels que initCustomEvent, sont obsolètes. Utilisez le constructeur d'événement à la place.

      +

      Attention : De nombreuses méthodes utilisées avec createEvent, tels que initCustomEvent, sont obsolètes. Utilisez le constructeur d'événement à la place.

      {{ ApiRef("DOM") }}
      -
       
      +

      Crée un event du type spécifié. L'objet retourné doit être intialisé et peut être passé ensuite à element.dispatchEvent.

      -

      Crée un event du type spécifié. L'objet retourné doit être intialisé et peut être passé ensuite à element.dispatchEvent.

      - -

      Syntaxe

      +

      Syntaxe

      var event = document.createEvent(type);
       
        -
      • event est l'objet Event créé.
      • +
      • event est l'objet Event créé.
      • type est une chaîne de caractères qui représente le type d'événement à créer. Les types possibles d'événement incluent "UIEvents", "MouseEvents", "MutationEvents" et "HTMLEvents". Voir la section {{Anch("Notes")}} pour plus de détails.
      -

      Exemple

      +

      Exemple

      // Crée l'événement.
       var event = document.createEvent('Event');
      @@ -36,7 +34,7 @@ var event = document.createEvent('Event');
       // Nomme l'événement 'build'.
       event.initEvent('build', true, true);
       
      -//  Écoute l'événement.
      +//  Écoute l'événement.
       elem.addEventListener('build', function (e) {
         // e.target correspond à elem
       }, false);
      @@ -47,9 +45,9 @@ elem.dispatchEvent(event);
       
       

      Notes

      -

      Les chaînes de type d'événement appropriées pour passer à createEvent () sont répertoriées dans la norme DOM - voir le tableau à l'étape 2. Gardez à l'esprit que la plupart des objets événement ont maintenant des constructeurs, qui sont la méthode recommandée pour créer des occurrences d'objet événement.

      +

      Les chaînes de type d'événement appropriées pour passer à createEvent () sont répertoriées dans la norme DOM - voir le tableau à l'étape 2. Gardez à l'esprit que la plupart des objets événement ont maintenant des constructeurs, qui sont la méthode recommandée pour créer des occurrences d'objet événement.

      -

      Gecko prend en charge certains alias d'objet événement non standard, répertoriés ci-dessous :

      +

      Gecko prend en charge certains alias d'objet événement non standard, répertoriés ci-dessous :

      @@ -79,12 +77,12 @@ elem.dispatchEvent(event);

      Spécification

      Voir aussi

      diff --git a/files/fr/web/api/document/createexpression/index.html b/files/fr/web/api/document/createexpression/index.html index 57bd734923..778ef4bdd4 100644 --- a/files/fr/web/api/document/createexpression/index.html +++ b/files/fr/web/api/document/createexpression/index.html @@ -10,14 +10,14 @@ translation_of: Web/API/Document/createExpression ---

      {{ ApiRef("DOM") }}

      -

      Cette méthode compile une XPathExpression qui peut ensuite être utilisée pour des évaluations (répétées).

      +

      Cette méthode compile une XPathExpression qui peut ensuite être utilisée pour des évaluations (répétées).

      -

      Syntaxe

      +

      Syntaxe

      xpathExpr = document.createExpression(xpathText, namespaceURLMapper);
       
      -

      Paramètres

      +

      Paramètres

      • String (chaîne de caractères) xpathText (l'expression XPath à compiler)
      • @@ -26,6 +26,6 @@ translation_of: Web/API/Document/createExpression

        {{ Fx_minversion_note(3, "Avant Firefox 3, vous pouviez appeler cette méthode sur des documents autres que celui que vous aviez prévu d'exécuter avec XPath. Sous Firefox 3, vous devez l'appeler sur le même document.") }}

        -

        Valeur retournée

        +

        Valeur retournée

        -

        XPathExpression

        +

        XPathExpression

        diff --git a/files/fr/web/api/document/createnodeiterator/index.html b/files/fr/web/api/document/createnodeiterator/index.html index b43b427f36..7183969144 100644 --- a/files/fr/web/api/document/createnodeiterator/index.html +++ b/files/fr/web/api/document/createnodeiterator/index.html @@ -9,11 +9,11 @@ translation_of: Web/API/Document/createNodeIterator ---

        {{APIRef("DOM")}}

        -

        Renvoie un  nouvel objet NodeIterator.

        +

        Renvoie un  nouvel objet NodeIterator.

        -

        Syntaxe

        +

        Syntaxe

        -
        var nodeIterator = document.createNodeIterator(root, whatToShow, filter);
        +
        var nodeIterator = document.createNodeIterator(root, whatToShow, filter);
         

        Valeurs

        @@ -22,7 +22,7 @@ translation_of: Web/API/Document/createNodeIterator
        root
        Le noeud racine à partir duquel commencer la traversée de {{domxref("NodeIterator")}}.
        whatToShow {{ optional_inline() }}
        -
        Est un unsigned long (long non signé) facultatif représentant un masque de bits créé par la combinaison des constantes de la propriété NodeFilter. C'est un moyen pratique de filtrage pour certains types de noeuds. Il est par défaut 0xFFFFFFFF représentant la constante SHOW_ALL. +
        Est un unsigned long (long non signé) facultatif représentant un masque de bits créé par la combinaison des constantes de la propriété NodeFilter. C'est un moyen pratique de filtrage pour certains types de noeuds. Il est par défaut 0xFFFFFFFF représentant la constante SHOW_ALL.
      @@ -102,9 +102,11 @@ translation_of: Web/API/Document/createNodeIterator
      Un objet implémentant l'interface {{ domxref("NodeFilter") }} ; sa méthode acceptNode() sera appelée pour chaque nœud du sous-arbre basé à la racine qui est accepté comme inclus par l'indicateur whatToShow pour déterminer s'il faut ou non l'inclure dans la liste des nœuds iterables (une simple fonction de rappel peut également être utilisée à la place). La méthode devrait retourner l'un des NodeFilter.FILTER_ACCEPT, NodeFilter.FILTER_REJECT ou NodeFilter.FILTER_SKIP. Voir l'{{anch("Exemple")}}.
      -
      Note : Avant Gecko 12.0 {{geckoRelease("12.0")}}, cette méthode acceptait un quatrième paramètre facultatif (entityReferenceExpansion). Cela ne faisait pas partie de la spécification DOM4 et a donc été supprimé. Ce paramètre indiquait si les enfants des nœuds de référence d'entité étaient visibles ou non par l'itérateur. Puisque de tels noeuds n'ont jamais été créés dans les navigateurs, ce paramètre n'a eu aucun effet.
      +
      +

      Note : Avant Gecko 12.0 {{geckoRelease("12.0")}}, cette méthode acceptait un quatrième paramètre facultatif (entityReferenceExpansion). Cela ne faisait pas partie de la spécification DOM4 et a donc été supprimé. Ce paramètre indiquait si les enfants des nœuds de référence d'entité étaient visibles ou non par l'itérateur. Puisque de tels noeuds n'ont jamais été créés dans les navigateurs, ce paramètre n'a eu aucun effet.

      +
      -

      Exemple

      +

      Exemple

      var nodeIterator = document.createNodeIterator(
           document.body,
      @@ -122,16 +124,16 @@ while (currentNode = nodeIterator.nextNode()) {
       
       
      -

      Compatibilité des navigateurs

      +

      Compatibilité des navigateurs

      Pris en charge dans FF 3.5+, Chrome 1+, Opera 9+, Safari 3+, IE9+, Edge

      -

      Voir aussi

      +

      Voir aussi

      -

      Spécifications

      +

      Spécifications

      -

      DOM Level 2 Traversal : NodeIterator

      +

      DOM Level 2 Traversal : NodeIterator

      diff --git a/files/fr/web/api/document/creatensresolver/index.html b/files/fr/web/api/document/creatensresolver/index.html index d9546328ae..1311c87a86 100644 --- a/files/fr/web/api/document/creatensresolver/index.html +++ b/files/fr/web/api/document/creatensresolver/index.html @@ -12,7 +12,7 @@ translation_of: Web/API/Document/createNSResolver

      Crée un XPathNSResolver qui résout les espaces de noms en respectant les définitions dans la portée pour un noeud spécifié.

      -

      Syntaxe

      +

      Syntaxe

      nsResolver = document.createNSResolver(node);
       
      @@ -29,21 +29,21 @@ translation_of: Web/API/Document/createNSResolver
    • nsResolver est un objet XPathNSResolver.
    • -

      Notes

      +

      Notes

      -

      Adapte n'importe quel noeud DOM pour résoudre les espaces de noms afin qu'une expression XPath puisse être facilement évaluée par rapport au contexte du nœud et son emplacement dans le document. Cet adaptateur fonctionne comme la méthode  lookupNamespaceURI  du DOM de niveau 3 sur les noeuds lors de la résolution de namespaceURI à partir d'un préfixe donné en utilisant l'information disponible dans la hiérarchie des noeuds au moment de l'appel de lookupNamespaceURI. Résout aussi correctement le préfixe implicite xml.

      +

      Adapte n'importe quel noeud DOM pour résoudre les espaces de noms afin qu'une expression XPath puisse être facilement évaluée par rapport au contexte du nœud et son emplacement dans le document. Cet adaptateur fonctionne comme la méthode  lookupNamespaceURI  du DOM de niveau 3 sur les noeuds lors de la résolution de namespaceURI à partir d'un préfixe donné en utilisant l'information disponible dans la hiérarchie des noeuds au moment de l'appel de lookupNamespaceURI. Résout aussi correctement le préfixe implicite xml.

      -

      Notez que XPath définit QNames sans préfixe pour correspondre uniquement aux éléments d'un espace de noms null. XPath n'a aucun moyen de récupérer l'espace de noms par défaut tel qu'il est appliqué à une référence d'élément régulier (par exemple, p[@id='_myid'] pour xmlns='http://www.w3.org/1999/xhtml'). Pour faire correspondre les éléments par défaut dans un espace de noms non nul, vous devez soit faire référence à un élément particulier en utilisant un format tel que *namespace-uri()=http://www.w3.org/1999/xhtml and name()=p[@id='_myid'] (cette approche fonctionne bien pour les expressions XPath dynamiques dans lesquelles les espaces de noms pourraient ne pas être connus), soit utiliser des tests de noms préfixés et créer un résolveur d'espace de nom mappant le préfixe à l'espace de nom. Pour en savoir plus sur comment créer un résolveur d'espace de nom défini par l'utilisateur si vous souhaitez adopter cette dernière approche.

      +

      Notez que XPath définit QNames sans préfixe pour correspondre uniquement aux éléments d'un espace de noms null. XPath n'a aucun moyen de récupérer l'espace de noms par défaut tel qu'il est appliqué à une référence d'élément régulier (par exemple, p[@id='_myid'] pour xmlns='http://www.w3.org/1999/xhtml'). Pour faire correspondre les éléments par défaut dans un espace de noms non nul, vous devez soit faire référence à un élément particulier en utilisant un format tel que *namespace-uri()=http://www.w3.org/1999/xhtml and name()=p[@id='_myid'] (cette approche fonctionne bien pour les expressions XPath dynamiques dans lesquelles les espaces de noms pourraient ne pas être connus), soit utiliser des tests de noms préfixés et créer un résolveur d'espace de nom mappant le préfixe à l'espace de nom. Pour en savoir plus sur comment créer un résolveur d'espace de nom défini par l'utilisateur si vous souhaitez adopter cette dernière approche.

      createNSResolver a été introduit dans DOM Niveau 3.

      -

      Voir aussi

      +

      Voir aussi

      -

      Spécifications

      +

      Spécifications

      -

      DOM Level 3 XPath Specification : createNSResolver

      +

      DOM Level 3 XPath Specification : createNSResolver

      diff --git a/files/fr/web/api/document/createprocessinginstruction/index.html b/files/fr/web/api/document/createprocessinginstruction/index.html index 91c7652457..0bdd5ee83f 100644 --- a/files/fr/web/api/document/createprocessinginstruction/index.html +++ b/files/fr/web/api/document/createprocessinginstruction/index.html @@ -12,16 +12,16 @@ tags: - instructions translation_of: Web/API/Document/createProcessingInstruction --- -

      {{APIRef("DOM")}}

      +
      {{APIRef("DOM")}}

      createProcessingInstruction() crée un nouveau noeud d'instruction de traitement et le renvoie.

      -

      Syntaxe

      +

      Syntaxe

      Processing instruction node = document.createProcessingInstruction(target, data)
       
      -

      Paramètres

      +

      Paramètres

      • Processing Instruction node est un noeud {{domxref("ProcessingInstruction")}}.
      • @@ -29,7 +29,7 @@ translation_of: Web/API/Document/createProcessingInstruction
      • data est une string (chaîne de caractères) contenant les données à ajouter aux données du noeud.
      -

      Exceptions

      +

      Exceptions

      NOT_SUPPORTED_ERR
      @@ -38,7 +38,7 @@ translation_of: Web/API/Document/createProcessingInstruction
      Lancée si vous essayez d'ajouter une cible d'instruction de traitement invalide (ce devrait être le cas avec le nom XML et toutes les combinaisons des lettres "xml"), ou si la séquence d'instructions de traitement de fermeture ("?>") est ajoutée aux données. Les données fournies par l'utilisateur ne peuvent donc pas être utilisées en toute sécurité sans échappement ou autres moyens de faire face à de telles situations.
      -

      Exemple

      +

      Exemple

      var docu = new DOMParser().parseFromString('<xml></xml>',  "application/xml")
       
      @@ -50,6 +50,6 @@ alert(new XMLSerializer().serializeToString(docu));
       // Affiche: <?xml-stylesheet href="mycss.css" type="text/css"?><xml/>
       
      -

      Spécifications

      +

      Spécifications

      -

      DOM 4: createProcessingInstruction

      +

      DOM 4: createProcessingInstruction

      diff --git a/files/fr/web/api/document/createrange/index.html b/files/fr/web/api/document/createrange/index.html index 5a187c5f3a..9ef3bffc27 100644 --- a/files/fr/web/api/document/createrange/index.html +++ b/files/fr/web/api/document/createrange/index.html @@ -12,14 +12,14 @@ translation_of: Web/API/Document/createRange

      Retourne un objet {{domxref("Range")}}.

      -

      Syntaxe

      +

      Syntaxe

      range = document.createRange();
       

      range devient un objet {{domxref("Range")}}.

      -

      Exemple

      +

      Exemple

      var range = document.createRange();
       
      @@ -27,12 +27,12 @@ range.setStart(startNode, startOffset);
       range.setEnd(endNode, endOffset);
       
      -

      Notes

      +

      Notes

      Une fois un objet Range créé, il est nécessaire de spécifier les limites de départ et de fin avant de pouvoir utiliser la plupart des méthodes.

      -

      Spécification

      +

      Spécification

      diff --git a/files/fr/web/api/document/createtextnode/index.html b/files/fr/web/api/document/createtextnode/index.html index 2455a75c30..7fc4bfe701 100644 --- a/files/fr/web/api/document/createtextnode/index.html +++ b/files/fr/web/api/document/createtextnode/index.html @@ -12,7 +12,7 @@ translation_of: Web/API/Document/createTextNode

      Crée un nouveau nœud de texte.

      -

      Syntaxe

      +

      Syntaxe

      var text = document.createTextNode(données);
       
      @@ -22,34 +22,34 @@ translation_of: Web/API/Document/createTextNode
    • donnees est une chaîne contenant les données à placer dans le nœud de texte.
    • -

      Exemple

      +

      Exemple

      -
      <!DOCTYPE html>
      -<html lang="en">
      -<head>
      -<title>createTextNode example</title>
      -<script>
      -function addTextNode(text) {
      -  var newtext = document.createTextNode(text),
      -      p1 = document.getElementById("p1");
      +
      <!DOCTYPE html>
      +<html lang="en">
      +<head>
      +<title>createTextNode example</title>
      +<script>
      +function addTextNode(text) {
      +  var newtext = document.createTextNode(text),
      +      p1 = document.getElementById("p1");
       
      -  p1.appendChild(newtext);
      -}
      -</script>
      -</head>
      +  p1.appendChild(newtext);
      +}
      +</script>
      +</head>
       
      -<body>
      -  <button onclick="addTextNode('YES! ');">YES!</button>
      -  <button onclick="addTextNode('NO! ');">NO!</button>
      -  <button onclick="addTextNode('WE CAN! ');">WE CAN!</button>
      +<body>
      +  <button onclick="addTextNode('YES! ');">YES!</button>
      +  <button onclick="addTextNode('NO! ');">NO!</button>
      +  <button onclick="addTextNode('WE CAN! ');">WE CAN!</button>
       
      -  <hr />
      +  <hr />
       
      -  <p id="p1">First line of paragraph.</p>
      -</body>
      -</html>
      + <p id="p1">First line of paragraph.</p> +</body> +</html>
      -

      Spécifications

      +

      Spécifications

      diff --git a/files/fr/web/api/document/defaultview/index.html b/files/fr/web/api/document/defaultview/index.html index e956485e62..fce4d88134 100644 --- a/files/fr/web/api/document/defaultview/index.html +++ b/files/fr/web/api/document/defaultview/index.html @@ -3,16 +3,15 @@ title: document.defaultView slug: Web/API/Document/defaultView translation_of: Web/API/Document/defaultView --- -

      Résumé

      -

      Dans les navigateurs, cette propriété renvoie l'objet window associé au document ou null si non disponible.

      -

      Syntaxe

      +

      Dans les navigateurs, cette propriété renvoie l'objet window associé au document ou null si non disponible.

      +

      Syntaxe

      var win = document.defaultView;

      Cette propriété est en lecture seule.

      -

      Notes

      -

      D'après quirksmode, defaultView n'est pas supporté dans les versions d'IE inférieures à 9.

      -

      Spécification

      +

      Notes

      +

      D'après quirksmode, defaultView n'est pas supporté dans les versions d'IE inférieures à 9.

      +

      Spécification

      diff --git a/files/fr/web/api/document/designmode/index.html b/files/fr/web/api/document/designmode/index.html index e91fdfdf7a..0a4edb5920 100644 --- a/files/fr/web/api/document/designmode/index.html +++ b/files/fr/web/api/document/designmode/index.html @@ -5,11 +5,7 @@ translation_of: Web/API/Document/designMode ---
      {{ ApiRef() }}
      -
       
      - -

      Résumé

      - -

      document.designMode contrôle si l'ensemble du document est modifiable. Les valeurs valides sont "on" et "off". Conformément à la spécification, cette propriété est par défaut sur "off". Firefox suit cette norme. Les versions antérieures de Chrome et IE ont par défaut la valeur "inherit". Pour les versions entre IE6-10, la valeur est en majuscule.

      +

      document.designMode contrôle si l'ensemble du document est modifiable. Les valeurs valides sont "on" et "off". Conformément à la spécification, cette propriété est par défaut sur "off". Firefox suit cette norme. Les versions antérieures de Chrome et IE ont par défaut la valeur "inherit". Pour les versions entre IE6-10, la valeur est en majuscule.

      Syntaxe

      @@ -17,7 +13,7 @@ translation_of: Web/API/Document/designMode document.designMode = "on"; document.designMode = "off"; -

      Exemple

      +

      Exemple

      Rendre un document {{HTMLElement("iframe")}} éditable

      diff --git a/files/fr/web/api/document/dir/index.html b/files/fr/web/api/document/dir/index.html index e1a40ecb59..03e94f3230 100644 --- a/files/fr/web/api/document/dir/index.html +++ b/files/fr/web/api/document/dir/index.html @@ -10,7 +10,7 @@ translation_of: Web/API/Document/dir ---

      {{ApiRef("")}}

      -

      La propriété Document.dir est une chaîne de caractères {{domxref("DOMString")}} représentant la direction du texte du document : de gauche à droite (par défaut) ou de droite à gauche. Les valeurs possibles sont 'rtl', droite vers gauche, et 'ltr', gauche vers droite.

      +

      La propriété Document.dir est une chaîne de caractères {{domxref("DOMString")}} représentant la direction du texte du document : de gauche à droite (par défaut) ou de droite à gauche. Les valeurs possibles sont 'rtl', droite vers gauche, et 'ltr', gauche vers droite.

      Syntaxe

      @@ -18,7 +18,7 @@ translation_of: Web/API/Document/dir document.dir = dirStr; -

      Spécifications

      +

      Spécifications

      diff --git a/files/fr/web/api/document/document/index.html b/files/fr/web/api/document/document/index.html index b3da3b5f6b..7b0e3c2501 100644 --- a/files/fr/web/api/document/document/index.html +++ b/files/fr/web/api/document/document/index.html @@ -21,7 +21,7 @@ translation_of: Web/API/Document/Document

      None.

      -

      Spécifications

      +

      Spécifications

      diff --git a/files/fr/web/api/document/documentelement/index.html b/files/fr/web/api/document/documentelement/index.html index e345027b13..84e62d8bea 100644 --- a/files/fr/web/api/document/documentelement/index.html +++ b/files/fr/web/api/document/documentelement/index.html @@ -12,14 +12,14 @@ translation_of: Web/API/Document/documentElement ---

      {{ ApiRef("DOM") }}

      -

      Document.documentElementrenvoie l'Element qui est l'élément racine du document (par exemple, l'élément <html> pour les documents HTML).

      +

      Document.documentElementrenvoie l'Element qui est l'élément racine du document (par exemple, l'élément <html> pour les documents HTML).

      -

      Syntaxe

      +

      Syntaxe

      var element = document.documentElement;
       
      -

      Exemple

      +

      Exemple

      var racine = document.documentElement;
       var premierNiveau = racine.childNodes;
      @@ -30,13 +30,13 @@ for (var i = 0; i < premierNiveau.length; i++) {
       }
       
      -

      Notes

      +

      Notes

      -

      Pour tout document HTML non vide, document.documentElement sera toujours un élément {{HTMLElement ("html")}}. Pour tout document XML non vide, document.documentElement sera toujours l'élément racine du document.

      +

      Pour tout document HTML non vide, document.documentElement sera toujours un élément {{HTMLElement ("html")}}. Pour tout document XML non vide, document.documentElement sera toujours l'élément racine du document.

      -

      Spécifications

      +

      Spécifications

      -
      +
      diff --git a/files/fr/web/api/document/documenturiobject/index.html b/files/fr/web/api/document/documenturiobject/index.html index 3c9f6fcb6f..cc5030a977 100644 --- a/files/fr/web/api/document/documenturiobject/index.html +++ b/files/fr/web/api/document/documenturiobject/index.html @@ -10,17 +10,17 @@ translation_of: Web/API/Document/documentURIObject ---

      {{ ApiRef("DOM") }}

      -

      La propriété en lecture seule Document.documentURIObject renvoie un objet {{ Interface("nsIURI") }} représentant l'URI du document.

      +

      La propriété en lecture seule Document.documentURIObject renvoie un objet {{ Interface("nsIURI") }} représentant l'URI du document.

      Cette propriété fonctionne uniquement pour les scripts privilégiés (UniversalXPConnect), comme le code des extensions. Pour le contenu Web, elle n'a aucune signification particulière et peut être utilisée comme n'importe quelle propriété personnalisée.

      -

      Dans le cas d'un code privilégié, il convient de faire attention à ne pas essayer d'obtenir ou modifier cette propriété sur un objet de contenu non enveloppé (par exemple sur l'objet wrappedJSObject d'un XPCNativeWrapper). Consultez les commentaires du {{ Bug(324464) }} pour plus de détails.

      +

      Dans le cas d'un code privilégié, il convient de faire attention à ne pas essayer d'obtenir ou modifier cette propriété sur un objet de contenu non enveloppé (par exemple sur l'objet wrappedJSObject d'un XPCNativeWrapper). Consultez les commentaires du {{ Bug(324464) }} pour plus de détails.

      -

      Syntaxe

      +

      Syntaxe

      -
      var uri = doc.documentURIObject;
      +
      var uri = doc.documentURIObject;
      -

      Exemple

      +

      Exemple

      // Vérifie que le schéma d'URI pour l'onglet courant dans Firefox est « http »,
       // en supposant que ce code s'exécute dans le contexte de browser.xul
      @@ -33,6 +33,6 @@ if (uriObj.schemeIs('http')) {
       }
       
      -

      Spécifications

      +

      Spécifications

      Ne fait partie d'aucune spécification.

      diff --git a/files/fr/web/api/document/domain/index.html b/files/fr/web/api/document/domain/index.html index 94d4f1775b..94575c1b4b 100644 --- a/files/fr/web/api/document/domain/index.html +++ b/files/fr/web/api/document/domain/index.html @@ -14,48 +14,46 @@ translation_of: Web/API/Document/domain ---
      {{ApiRef}}
      -

      Résumé

      +

      Retourne/définit la partie domaine de l'origine du document courant, telle qu'utilisée par la politique d'origine identique.

      -

      Retourne/définit la partie domaine de l'origine du document courant, telle qu'utilisée par la politique d'origine identique.

      - -

      Syntaxe

      +

      Syntaxe

      var chaineDomaine = document.domain; document.domain = chaine;
       
      -

      Exemple

      +

      Exemple

      -
      // Pour le document www.example.xxx/good.html,
      +
      // Pour le document www.example.xxx/good.html,
       // ce script ferme la fenêtre
       var mauvaisDomaine = "www.example.xxx";
       
       if (document.domain == mauvaisDomaine )
          window.close(); // juste un exemple - window.close() n'a parfois aucun effet.
      -
      // Pour l'URI http://developer.mozilla.org/en-US/docs/Web, ce qui
      +
      // Pour l'URI https://developer.mozilla.org/en-US/docs/Web, ce qui
       // suit définit le domaine comme étant la chaîne "developer.mozilla.org"
       var domaine = document.domain;
       
      -

      Notes

      +

      Notes

      Cette propriété retourne null si le domaine du document ne peut pas être identifié.

      -

      Mozilla vous laissera la définir à un superdomaine de la valeur courante, contraint par son domaine de base. Par exemple, sur developer.mozilla.org, il est possible de la définir à "mozilla.org" mais pas à "mozilla.com" ou "org".

      +

      Mozilla vous laissera la définir à un superdomaine de la valeur courante, contraint par son domaine de base. Par exemple, sur developer.mozilla.org, il est possible de la définir à "mozilla.org" mais pas à "mozilla.com" ou "org".

      Si cette propriété est définie avec succès, la partie "port" de l'origine est également définie à null.

      -

      Mozilla fait la distinction entre la propriété d'un document.domain qui n'a jamais été modifiée d'une explicitement définie avec le même domaine que l'URL du document, même si la propriété renvoie la même valeur dans les deux cas. Un document est autorisé à accéder à un autre si il ont tous deux défini document.domain à la même valeur, indiquant leur intention de coopérer, ou si aucun des deux n'a défini document.domain et que les domaines dans les URLs sont les mêmes (implementation). Sans cette politique spéciale, chaque site serait sujet au Cross-Site-Scripting (XSS)  depuis ses sous-domaines (par exemple, https://bugzilla.mozilla.org pourrait être attaqué par des pièces jointes de bugs sur https://bug*.bugzilla.mozilla.org).

      +

      Mozilla fait la distinction entre la propriété d'un document.domain qui n'a jamais été modifiée d'une explicitement définie avec le même domaine que l'URL du document, même si la propriété renvoie la même valeur dans les deux cas. Un document est autorisé à accéder à un autre si il ont tous deux défini document.domain à la même valeur, indiquant leur intention de coopérer, ou si aucun des deux n'a défini document.domain et que les domaines dans les URLs sont les mêmes (implementation). Sans cette politique spéciale, chaque site serait sujet au Cross-Site-Scripting (XSS)  depuis ses sous-domaines (par exemple, https://bugzilla.mozilla.org pourrait être attaqué par des pièces jointes de bugs sur https://bug*.bugzilla.mozilla.org).

      -

      Spécification

      +

      Spécification

      -

      Voir aussi

      +

      Voir aussi

      diff --git a/files/fr/web/api/document/domcontentloaded_event/index.html b/files/fr/web/api/document/domcontentloaded_event/index.html index 29c8b67905..516c713b20 100644 --- a/files/fr/web/api/document/domcontentloaded_event/index.html +++ b/files/fr/web/api/document/domcontentloaded_event/index.html @@ -82,10 +82,7 @@ if (document.readyState === 'loading') { // Loading hasn't finished yet <textarea readonly class="event-log-contents" rows="8" cols="30"></textarea> </div>
      -

      JS

      diff --git a/files/fr/web/api/document/drag_event/index.html b/files/fr/web/api/document/drag_event/index.html index 958df729b3..e244f365a0 100644 --- a/files/fr/web/api/document/drag_event/index.html +++ b/files/fr/web/api/document/drag_event/index.html @@ -35,28 +35,28 @@ translation_of: Web/API/Document/drag_event
      - + - + - + - + - - + + @@ -207,7 +207,7 @@ translation_of: Web/API/Document/drag_event }, false); document.addEventListener("drop", function( event ) { - // Empêche l'action par défaut (ouvrir comme lien pour certains éléments) + // Empêche l'action par défaut (ouvrir comme lien pour certains éléments) event.preventDefault(); // Déplace l'élément traîné vers la cible du drop sélectionnée if ( event.target.className == "dropzone" ) { diff --git a/files/fr/web/api/document/dragend_event/index.html b/files/fr/web/api/document/dragend_event/index.html index ac2681db24..ce28cf1673 100644 --- a/files/fr/web/api/document/dragend_event/index.html +++ b/files/fr/web/api/document/dragend_event/index.html @@ -5,19 +5,19 @@ translation_of: Web/API/Document/dragend_event ---

      L'événement dragend est déclenché lorsque une opération de glissement est terminée (en relâchant le bouton de la souris ou en appuyant sur la touche Echap).

      -

      Informations généralesEdit

      +

      Informations générales

      -
      Interface
      -
      {{domxref("DragEvent")}}
      -
      Propagation
      -
      Oui
      -
      Annulable
      -
      Non
      -
      Cible
      -
      {{domxref("Document")}}, {{domxref("Element")}}
      -
      Action par défaut
      -
      Varie
      +
      Interface
      +
      {{domxref("DragEvent")}}
      +
      Propagation
      +
      Oui
      +
      Annulable
      +
      Non
      +
      Cible
      +
      {{domxref("Document")}}, {{domxref("Element")}}
      +
      Action par défaut
      +
      Varie

      Propriétés

      @@ -33,28 +33,28 @@ translation_of: Web/API/Document/dragend_event - + - + - + - + - - + + @@ -163,33 +163,33 @@ translation_of: Web/API/Document/dragend_event </style> <script> - var dragged; + var dragged; - /* Les événements sont déclenchés sur les objets glissables */ + /* Les événements sont déclenchés sur les objets glissables */ document.addEventListener("drag", function( event ) { }, false); document.addEventListener("dragstart", function( event ) { - // Stocke une référence sur l'objet glissable + // Stocke une référence sur l'objet glissable dragged = event.target; - // transparence 50% + // transparence 50% event.target.style.opacity = .5; }, false); document.addEventListener("dragend", function( event ) { - // reset de la transparence + // reset de la transparence event.target.style.opacity = ""; }, false); - /* Les événements sont déclenchés sur les cibles du drop */ + /* Les événements sont déclenchés sur les cibles du drop */ document.addEventListener("dragover", function( event ) { - // Empêche default d'autoriser le drop + // Empêche default d'autoriser le drop event.preventDefault(); }, false); document.addEventListener("dragenter", function( event ) { - // Met en surbrillance la cible de drop potentielle lorsque l'élément glissable y entre + // Met en surbrillance la cible de drop potentielle lorsque l'élément glissable y entre if ( event.target.className == "dropzone" ) { event.target.style.background = "purple"; } @@ -197,7 +197,7 @@ translation_of: Web/API/Document/dragend_event }, false); document.addEventListener("dragleave", function( event ) { - // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent + // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent if ( event.target.className == "dropzone" ) { event.target.style.background = ""; } @@ -205,16 +205,16 @@ translation_of: Web/API/Document/dragend_event }, false); document.addEventListener("drop", function( event ) { - // Empêche l'action par défaut (ouvrir comme lien pour certains éléments) + // Empêche l'action par défaut (ouvrir comme lien pour certains éléments) event.preventDefault(); - // Déplace l'élément traîné vers la cible du drop sélectionnée + // Déplace l'élément traîné vers la cible du drop sélectionnée if ( event.target.className == "dropzone" ) { event.target.style.background = ""; dragged.parentNode.removeChild( dragged ); event.target.appendChild( dragged ); } - }, false); + }, false); </script> diff --git a/files/fr/web/api/document/dragenter_event/index.html b/files/fr/web/api/document/dragenter_event/index.html index 2bdc66e42e..7f95865724 100644 --- a/files/fr/web/api/document/dragenter_event/index.html +++ b/files/fr/web/api/document/dragenter_event/index.html @@ -7,19 +7,19 @@ translation_of: Web/API/Document/dragenter_event

      L'événement dragenter est déclenché lorsqu'un élément glissé ou une sélection de texte entre dans une cible de drop valide.

      -

      Informations généralesEdit

      +

      Informations générales

      -
      Interface
      -
      {{domxref("DragEvent")}}
      -
      Propagation
      -
      Oui
      -
      Annulable
      -
      Oui
      -
      Cible
      -
      La sélection immédiate de l'utilisateur (l'élément présentement indiqué par l'utilisateur comme cible pour le drop), ou l'élément {{HTMLElement("body")}}.
      -
      Action par défaut
      -
      Rejette la sélection immédiate de l'utilisateur comme élément cible potentiel
      +
      Interface
      +
      {{domxref("DragEvent")}}
      +
      Propagation
      +
      Oui
      +
      Annulable
      +
      Oui
      +
      Cible
      +
      La sélection immédiate de l'utilisateur (l'élément présentement indiqué par l'utilisateur comme cible pour le drop), ou l'élément {{HTMLElement("body")}}.
      +
      Action par défaut
      +
      Rejette la sélection immédiate de l'utilisateur comme élément cible potentiel

      Properties

      @@ -35,28 +35,28 @@ translation_of: Web/API/Document/dragenter_event - + - + - + - + - - + + @@ -165,33 +165,33 @@ translation_of: Web/API/Document/dragenter_event </style> <script> - var dragged; + var dragged; - /* Les événements sont déclenchés sur les objets glissables */ + /* Les événements sont déclenchés sur les objets glissables */ document.addEventListener("drag", function( event ) { }, false); document.addEventListener("dragstart", function( event ) { - // Stocke une référence sur l'objet glissable + // Stocke une référence sur l'objet glissable dragged = event.target; - // transparence 50% + // transparence 50% event.target.style.opacity = .5; }, false); document.addEventListener("dragend", function( event ) { - // reset de la transparence + // reset de la transparence event.target.style.opacity = ""; }, false); - /* Les événements sont déclenchés sur les cibles du drop */ + /* Les événements sont déclenchés sur les cibles du drop */ document.addEventListener("dragover", function( event ) { - // Empêche default d'autoriser le drop + // Empêche default d'autoriser le drop event.preventDefault(); }, false); document.addEventListener("dragenter", function( event ) { - // Met en surbrillance la cible de drop potentielle lorsque l'élément glissable y entre + // Met en surbrillance la cible de drop potentielle lorsque l'élément glissable y entre if ( event.target.className == "dropzone" ) { event.target.style.background = "purple"; } @@ -199,7 +199,7 @@ translation_of: Web/API/Document/dragenter_event }, false); document.addEventListener("dragleave", function( event ) { - // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent + // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent if ( event.target.className == "dropzone" ) { event.target.style.background = ""; } @@ -207,16 +207,16 @@ translation_of: Web/API/Document/dragenter_event }, false); document.addEventListener("drop", function( event ) { - // Empêche l'action par défaut (ouvrir comme lien pour certains éléments) + // Empêche l'action par défaut (ouvrir comme lien pour certains éléments) event.preventDefault(); - // Déplace l'élément traîné vers la cible du drop sélectionnée + // Déplace l'élément traîné vers la cible du drop sélectionnée if ( event.target.className == "dropzone" ) { event.target.style.background = ""; dragged.parentNode.removeChild( dragged ); event.target.appendChild( dragged ); } - }, false); + }, false); </script> diff --git a/files/fr/web/api/document/dragleave_event/index.html b/files/fr/web/api/document/dragleave_event/index.html index dfccbbc044..9221441d5f 100644 --- a/files/fr/web/api/document/dragleave_event/index.html +++ b/files/fr/web/api/document/dragleave_event/index.html @@ -9,7 +9,7 @@ translation_of: Web/API/Document/dragleave_event
      Interface
      -
      DragEvent
      +
      DragEvent
      Propagation
      Oui
      Annulable
      @@ -33,28 +33,28 @@ translation_of: Web/API/Document/dragleave_event
      - + - + - + - + - - + + @@ -163,33 +163,33 @@ translation_of: Web/API/Document/dragleave_event </style> <script> - var dragged; + var dragged; - /* Les événements sont déclenchés sur les objets glissables */ + /* Les événements sont déclenchés sur les objets glissables */ document.addEventListener("drag", function( event ) { }, false); document.addEventListener("dragstart", function( event ) { - // Stocke une référence sur l'objet glissable + // Stocke une référence sur l'objet glissable dragged = event.target; - // transparence 50% + // transparence 50% event.target.style.opacity = .5; }, false); document.addEventListener("dragend", function( event ) { - // reset de la transparence + // reset de la transparence event.target.style.opacity = ""; }, false); - /* Les événements sont déclenchés sur les cibles du drop */ + /* Les événements sont déclenchés sur les cibles du drop */ document.addEventListener("dragover", function( event ) { - // Empêche default d'autoriser le drop + // Empêche default d'autoriser le drop event.preventDefault(); }, false); document.addEventListener("dragenter", function( event ) { - // Met en surbrillance la cible de drop potentielle lorsque l'élément glissable y entre + // Met en surbrillance la cible de drop potentielle lorsque l'élément glissable y entre if ( event.target.className == "dropzone" ) { event.target.style.background = "purple"; } @@ -197,7 +197,7 @@ translation_of: Web/API/Document/dragleave_event }, false); document.addEventListener("dragleave", function( event ) { - // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent + // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent if ( event.target.className == "dropzone" ) { event.target.style.background = ""; } @@ -205,16 +205,16 @@ translation_of: Web/API/Document/dragleave_event }, false); document.addEventListener("drop", function( event ) { - // Empêche l'action par défaut (ouvrir comme lien pour certains éléments) + // Empêche l'action par défaut (ouvrir comme lien pour certains éléments) event.preventDefault(); - // Déplace l'élément traîné vers la cible du drop sélectionnée + // Déplace l'élément traîné vers la cible du drop sélectionnée if ( event.target.className == "dropzone" ) { event.target.style.background = ""; dragged.parentNode.removeChild( dragged ); event.target.appendChild( dragged ); } - }, false); + }, false); </script> diff --git a/files/fr/web/api/document/dragover_event/index.html b/files/fr/web/api/document/dragover_event/index.html index 86df0e5440..aca2e8a435 100644 --- a/files/fr/web/api/document/dragover_event/index.html +++ b/files/fr/web/api/document/dragover_event/index.html @@ -11,7 +11,7 @@ translation_of: Web/API/Document/dragover_event
      Interface
      -
      DragEvent
      +
      DragEvent
      Propagation
      Oui
      Annulable
      @@ -35,28 +35,28 @@ translation_of: Web/API/Document/dragover_event
      - + - + - + - + - - + + @@ -138,86 +138,86 @@ translation_of: Web/API/Document/dragover_event

      Exemple

      -
      <div class="dropzone">
      -  <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)">
      +
      <div class="dropzone">
      +  <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)">
           This div is draggable
      -  </div>
      -</div>
      -<div class="dropzone"></div>
      -<div class="dropzone"></div>
      -<div class="dropzone"></div>
      +  </div>
      +</div>
      +<div class="dropzone"></div>
      +<div class="dropzone"></div>
      +<div class="dropzone"></div>
       
      -<style>
      -  #draggable {
      -    width: 200px;
      -    height: 20px;
      -    text-align: center;
      -    background: white;
      -  }
      +<style>
      +  #draggable {
      +    width: 200px;
      +    height: 20px;
      +    text-align: center;
      +    background: white;
      +  }
       
      -  .dropzone {
      -    width: 200px;
      -    height: 20px;
      -    background: blueviolet;
      -    margin-bottom: 10px;
      -    padding: 10px;
      -  }
      -</style>
      +  .dropzone {
      +    width: 200px;
      +    height: 20px;
      +    background: blueviolet;
      +    margin-bottom: 10px;
      +    padding: 10px;
      +  }
      +</style>
       
      -<script>
      -  var dragged;
      +<script>
      +  var dragged;
       
      -  /* Les événements sont déclenchés sur les objets glissables */
      -  document.addEventListener("drag", function( event ) {
      +  /* Les événements sont déclenchés sur les objets glissables */
      +  document.addEventListener("drag", function( event ) {
       
      -  }, false);
      +  }, false);
       
      -  document.addEventListener("dragstart", function( event ) {
      -      // Stocke une référence sur l'objet glissable
      -      dragged = event.target;
      -      // transparence 50%
      -      event.target.style.opacity = .5;
      -  }, false);
      +  document.addEventListener("dragstart", function( event ) {
      +      // Stocke une référence sur l'objet glissable
      +      dragged = event.target;
      +      // transparence 50%
      +      event.target.style.opacity = .5;
      +  }, false);
       
      -  document.addEventListener("dragend", function( event ) {
      -      // reset de la transparence
      -      event.target.style.opacity = "";
      -  }, false);
      +  document.addEventListener("dragend", function( event ) {
      +      // reset de la transparence
      +      event.target.style.opacity = "";
      +  }, false);
       
      -  /* Les événements sont déclenchés sur les cibles du drop */
      -  document.addEventListener("dragover", function( event ) {
      -      // Empêche default d'autoriser le drop
      -      event.preventDefault();
      -  }, false);
      +  /* Les événements sont déclenchés sur les cibles du drop */
      +  document.addEventListener("dragover", function( event ) {
      +      // Empêche default d'autoriser le drop
      +      event.preventDefault();
      +  }, false);
       
      -  document.addEventListener("dragenter", function( event ) {
      -      // Met en surbrillance la cible de drop potentielle lorsque l'élément glissable y entre
      -      if ( event.target.className == "dropzone" ) {
      -          event.target.style.background = "purple";
      -      }
      +  document.addEventListener("dragenter", function( event ) {
      +      // Met en surbrillance la cible de drop potentielle lorsque l'élément glissable y entre
      +      if ( event.target.className == "dropzone" ) {
      +          event.target.style.background = "purple";
      +      }
       
      -  }, false);
      +  }, false);
       
      -  document.addEventListener("dragleave", function( event ) {
      -      // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent 
      -      if ( event.target.className == "dropzone" ) {
      -          event.target.style.background = "";
      -      }
      +  document.addEventListener("dragleave", function( event ) {
      +      // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent 
      +      if ( event.target.className == "dropzone" ) {
      +          event.target.style.background = "";
      +      }
       
      -  }, false);
      +  }, false);
       
      -  document.addEventListener("drop", function( event ) {
      -      // Empêche l'action par défaut (ouvrir comme lien pour certains éléments)
      -      event.preventDefault();
      -      // Déplace l'élément traîné vers la cible du drop sélectionnée
      -      if ( event.target.className == "dropzone" ) {
      -          event.target.style.background = "";
      -          dragged.parentNode.removeChild( dragged );
      -          event.target.appendChild( dragged );
      -      }
      +  document.addEventListener("drop", function( event ) {
      +      // Empêche l'action par défaut (ouvrir comme lien pour certains éléments)
      +      event.preventDefault();
      +      // Déplace l'élément traîné vers la cible du drop sélectionnée
      +      if ( event.target.className == "dropzone" ) {
      +          event.target.style.background = "";
      +          dragged.parentNode.removeChild( dragged );
      +          event.target.appendChild( dragged );
      +      }
       
      -  }, false);
      -</script>
      + }, false); +</script>

      Spécifications

      diff --git a/files/fr/web/api/document/dragstart_event/index.html b/files/fr/web/api/document/dragstart_event/index.html index 4eed44888d..f45827df5c 100644 --- a/files/fr/web/api/document/dragstart_event/index.html +++ b/files/fr/web/api/document/dragstart_event/index.html @@ -9,7 +9,7 @@ translation_of: Web/API/Document/dragstart_event
      Interface
      -
      DragEvent
      +
      DragEvent
      Propagation
      Oui
      Annulable
      @@ -33,28 +33,28 @@ translation_of: Web/API/Document/dragstart_event
      - + - + - + - + - - + + diff --git a/files/fr/web/api/document/drop_event/index.html b/files/fr/web/api/document/drop_event/index.html index 68d66c8116..bb3c695f26 100644 --- a/files/fr/web/api/document/drop_event/index.html +++ b/files/fr/web/api/document/drop_event/index.html @@ -11,13 +11,13 @@ translation_of: Web/API/Document/drop_event
      Interface
      -
      DragEvent
      +
      DragEvent
      Propagation
      Oui
      Annulable
      Oui
      Cible
      -
      Document, Element
      +
      Document, Element
      Action par défaut
      Varie
      @@ -35,28 +35,28 @@ translation_of: Web/API/Document/drop_event - + - + - + - + - - + + @@ -138,88 +138,86 @@ translation_of: Web/API/Document/drop_event

      Exemple

      -
      <div class="dropzone">
      -  <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)">
      +
      <div class="dropzone">
      +  <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)">
           Cette div peut être glissée
      -  </div>
      -</div>
      -<div class="dropzone"></div>
      -<div class="dropzone"></div>
      -<div class="dropzone"></div>
      +  </div>
      +</div>
      +<div class="dropzone"></div>
      +<div class="dropzone"></div>
      +<div class="dropzone"></div>
       
      -<style>
      -  #draggable {
      -    width: 200px;
      -    height: 20px;
      -    text-align: center;
      -    background: white;
      -  }
      +<style>
      +  #draggable {
      +    width: 200px;
      +    height: 20px;
      +    text-align: center;
      +    background: white;
      +  }
       
      -  .dropzone {
      -    width: 200px;
      -    height: 20px;
      -    background: blueviolet;
      -    margin-bottom: 10px;
      -    padding: 10px;
      -  }
      -</style>
      +  .dropzone {
      +    width: 200px;
      +    height: 20px;
      +    background: blueviolet;
      +    margin-bottom: 10px;
      +    padding: 10px;
      +  }
      +</style>
       
      -<script>
      -  var dragged;
      +<script>
      +  var dragged;
       
      -  /* Les événements sont déclenchés sur les objets glissables */
      -  document.addEventListener("drag", function( event ) {
      +  /* Les événements sont déclenchés sur les objets glissables */
      +  document.addEventListener("drag", function( event ) {
       
      -  }, false);
      +  }, false);
       
      -  document.addEventListener("dragstart", function( event ) {
      -      // Stocke une référence sur l'objet glissable
      -      dragged = event.target;
      -      // transparence 50%
      -      event.target.style.opacity = .5;
      -  }, false);
      +  document.addEventListener("dragstart", function( event ) {
      +      // Stocke une référence sur l'objet glissable
      +      dragged = event.target;
      +      // transparence 50%
      +      event.target.style.opacity = .5;
      +  }, false);
       
      -  document.addEventListener("dragend", function( event ) {
      -      // réinitialisation de la transparence
      -      event.target.style.opacity = "";
      -  }, false);
      +  document.addEventListener("dragend", function( event ) {
      +      // réinitialisation de la transparence
      +      event.target.style.opacity = "";
      +  }, false);
       
      -  /* Les événements sont déclenchés sur les cibles du drop */
      -  document.addEventListener("dragover", function( event ) {
      -      // Empêche le comportement par défaut afin d'autoriser le drop
      -      event.preventDefault();
      -  }, false);
      +  /* Les événements sont déclenchés sur les cibles du drop */
      +  document.addEventListener("dragover", function( event ) {
      +      // Empêche le comportement par défaut afin d'autoriser le drop
      +      event.preventDefault();
      +  }, false);
       
      -  document.addEventListener("dragenter", function( event ) {
      -      // Met en surbrillance la cible de drop potentielle lorsque l'élément glissable y entre
      -      if ( event.target.className == "dropzone" ) {
      -          event.target.style.background = "purple";
      -      }
      +  document.addEventListener("dragenter", function( event ) {
      +      // Met en surbrillance la cible de drop potentielle lorsque l'élément glissable y entre
      +      if ( event.target.className == "dropzone" ) {
      +          event.target.style.background = "purple";
      +      }
       
      -  }, false);
      +  }, false);
       
      -  document.addEventListener("dragleave", function( event ) {
      -      // réinitialisation de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent 
      -      if ( event.target.className == "dropzone" ) {
      -          event.target.style.background = "";
      -      }
      +  document.addEventListener("dragleave", function( event ) {
      +      // réinitialisation de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent 
      +      if ( event.target.className == "dropzone" ) {
      +          event.target.style.background = "";
      +      }
       
      -  }, false);
      +  }, false);
       
      -  document.addEventListener("drop", function( event ) {
      -      // Empêche l'action par défaut (ouvrir comme lien pour certains éléments)
      -      event.preventDefault();
      -      // Déplace l'élément traîné vers la cible du drop sélectionnée
      -      if ( event.target.className == "dropzone" ) {
      -          event.target.style.background = "";
      -          dragged.parentNode.removeChild( dragged );
      -          event.target.appendChild( dragged );
      -      }
      +  document.addEventListener("drop", function( event ) {
      +      // Empêche l'action par défaut (ouvrir comme lien pour certains éléments)
      +      event.preventDefault();
      +      // Déplace l'élément traîné vers la cible du drop sélectionnée
      +      if ( event.target.className == "dropzone" ) {
      +          event.target.style.background = "";
      +          dragged.parentNode.removeChild( dragged );
      +          event.target.appendChild( dragged );
      +      }
       
      -  }, false);
      -</script>
      - -

       

      + }, false); +</script>

      Spécifications

      diff --git a/files/fr/web/api/document/elementfrompoint/index.html b/files/fr/web/api/document/elementfrompoint/index.html index 8da838500d..6a4a1f9dfd 100644 --- a/files/fr/web/api/document/elementfrompoint/index.html +++ b/files/fr/web/api/document/elementfrompoint/index.html @@ -8,9 +8,9 @@ translation_of_original: Web/API/Document/elementFromPoint original_slug: Web/API/DocumentOrShadowRoot/elementFromPoint ---

      {{ ApiRef() }}

      -

      Résumé

      +

      Résumé

      Renvoie l'élément visible au point donné, spécifié relativement au point supérieur gauche visible dans le document.

      -

      Syntaxe

      +

      Syntaxe

      element = document.elementFromPoint(x,y);
       

      where

      @@ -18,7 +18,7 @@ original_slug: Web/API/DocumentOrShadowRoot/elementFromPoint
    • element est un objet element.
    • x et y spécifient les coordonnées à vérifier.
    • -

      Exemple

      +

      Exemple

      <html>
       <head>
       <title>Exemple d'utilisation d'elementFromPoint</title>
      @@ -40,15 +40,11 @@ function changeColor(newColor)
       </body>
       </html>
       
      -

      Notes

      +

      Notes

      Si l'élément au point spécifié appartient à un autre document (par exemple, les sous-document d'un iframe), l'élément dans le DOM du document appelant (l'iframe lui-même) est renvoyé. Si l'élément au point donné est anonyme ou du contenu généré par XBL, comme la barre de défilement d'une boîte de texte, le premier élément parent non anonyme (par exemple, la boîte de texte) est renvoyé.

      Si le point spécifié est en dehors de la portion visible du document ou que l'une ou l'autre des coordonnées est négative, le résultat est NULL.

      {{ Note("Les appelants qui sont des documents XUL devraient attendre que l\'évènement onload se soit déclenché avant d\'appeler cette méthode.") }}

      -

      Spécification

      +

      Spécification

      -

       

      -
      -  
      -

      {{ languages( { "en": "en/DOM/document.elementFromPoint", "es": "es/DOM/document.elementFromPoint", "ja": "ja/DOM/document.elementFromPoint" } ) }}

      +
    • Spécification préliminaire : elementFromPoint
    • + \ No newline at end of file diff --git a/files/fr/web/api/document/elementsfrompoint/index.html b/files/fr/web/api/document/elementsfrompoint/index.html index 106b80d8f1..259d9da6fc 100644 --- a/files/fr/web/api/document/elementsfrompoint/index.html +++ b/files/fr/web/api/document/elementsfrompoint/index.html @@ -16,7 +16,7 @@ original_slug: Web/API/DocumentOrShadowRoot/elementsFromPoint ---
      {{APIRef("DOM")}}{{SeeCompatTable}}
      -

      La propriété elementsFromPoint() de l'interface {{domxref("DocumentOrShadowRoot")}}  renvoie un tableau (array) de tous les éléments présents sous le point fourni en paramètre (relatif au viewport).

      +

      La propriété elementsFromPoint() de l'interface {{domxref("DocumentOrShadowRoot")}}  renvoie un tableau (array) de tous les éléments présents sous le point fourni en paramètre (relatif au viewport).

      Syntaxe

      @@ -35,7 +35,7 @@ original_slug: Web/API/DocumentOrShadowRoot/elementsFromPoint

      Un tableau (array) d'objets {{domxref('element')}} représentants les éléments du DOM concernés.

      -

      Exemples

      +

      Exemples

      HTML

      @@ -48,7 +48,7 @@ original_slug: Web/API/DocumentOrShadowRoot/elementsFromPoint

      JavaScript

      -
      var output = document.getElementById("output");
      +
      var output = document.getElementById("output");
       if (document.elementsFromPoint) {
         var elements = document.elementsFromPoint(30, 20);
         for(var i = 0; i < elements.length; i++) {
      diff --git a/files/fr/web/api/document/enablestylesheetsforset/index.html b/files/fr/web/api/document/enablestylesheetsforset/index.html
      index d6fb8bc63f..f0aca39903 100644
      --- a/files/fr/web/api/document/enablestylesheetsforset/index.html
      +++ b/files/fr/web/api/document/enablestylesheetsforset/index.html
      @@ -14,7 +14,7 @@ translation_of: Web/API/Document/enableStyleSheetsForSet
       
       

      Active les feuilles de styles correspondant au nom spécifié dans l'ensemble de feuilles de styles en cours et désactive toutes les autres (à l'exception de celles sans titre qui sont toujours activées).

      -

      Syntaxe

      +

      Syntaxe

      document.enableStyleSheetsForSet(name)
       
      @@ -35,15 +35,15 @@ translation_of: Web/API/Document/enableStyleSheetsForSet
    • Cette méthode n'affecte jamais les valeurs de {{ domxref("document.lastStyleSheetSet") }} ou {{ domxref("document.preferredStyleSheetSet") }}.
    • -

      Exemple

      +

      Exemple

      document.enableStyleSheetsForSet("Some style sheet set name");
       
      -

      Spécifications

      +

      Spécifications

      Voir aussi

      @@ -55,5 +55,5 @@ translation_of: Web/API/Document/enableStyleSheetsForSet
    • {{ domxref("document.preferredStyleSheetSet") }}
    • {{ domxref("document.selectedStyleSheetSet") }}
    • {{ domxref("document.enableStyleSheetsForSet()") }}
    • -
    • Utiliser des titres corrects avec des feuilles de styles externes
    • +
    • Utiliser des titres corrects avec des feuilles de styles externes
    • diff --git a/files/fr/web/api/document/evaluate/index.html b/files/fr/web/api/document/evaluate/index.html index 3cdf394e5b..03cc732e3e 100644 --- a/files/fr/web/api/document/evaluate/index.html +++ b/files/fr/web/api/document/evaluate/index.html @@ -11,7 +11,7 @@ translation_of: Web/API/Document/evaluate ---

      {{ ApiRef("DOM") }}

      -

      La méthode evaluate() renvoie un {{domxref("XPathResult")}} basé sur une expression XPath et d'autres paramètres donnés.

      +

      La méthode evaluate() renvoie un {{domxref("XPathResult")}} basé sur une expression XPath et d'autres paramètres donnés.

      Syntaxe

      @@ -25,7 +25,7 @@ translation_of: Web/API/Document/evaluate
      • xpathExpression est une chaîne de caractères représentant le XPath à évaluer.
      • -
      • contextNode spécifie le noeud de contexte pour la requête (voir XPath specification) . Il est courant de transmettre un document en tant que nœud de contexte.
      • +
      • contextNode spécifie le noeud de contexte pour la requête (voir XPath specification) . Il est courant de transmettre un document en tant que nœud de contexte.
      • namespaceResolver est une fonction qui recevra tous les préfixes d'espace de noms et devrait renvoyer une chaîne représentant l'URI de l'espace de noms associé à ce préfixe. Il sera utilisé pour résoudre les préfixes dans le XPath lui-même, afin qu'ils puissent être mis en correspondance avec le document. null est commun pour les documents HTML ou lorsque aucun préfixe d'espace de noms n'est utilisé.
      • resultType est un nombre entier qui correspond au type de résultat XPathResult à retourner. Utilisez des propriétés de constantes nommées, comme XPathResult.ANY_TYPE  du constructeur de XPathResult , lequel correspond à un nombre entier compris entre 0 et 9.
      • result est un XPathResult existant à utiliser pour les résultats.  null est le plus commun et va créer un nouveau XPathResult
      • @@ -33,7 +33,7 @@ translation_of: Web/API/Document/evaluate

        Exemples

        -
         var  headings  =  document .  evaluate  ( " / html / body //h2", document, null, XPathResult.ANY_TYPE, null);
        +
         var  headings  =  document .  evaluate  ( " / html / body //h2", document, null, XPathResult.ANY_TYPE, null);
          /* Cherche le document pour tout élément h2.
          * Le résultat sera probablement un itérateur de noeuds non ordonné. */
          var  thisHeading  =  headings .  iterateNext  (  )  ;
        @@ -42,17 +42,17 @@ translation_of: Web/API/Document/evaluate
           alertText  +  =  thisHeading . textContent  +   "\n"  ;
           thisHeading  =  headings .  iterateNext  (  )  ;
          }
        - alert  ( alertText )  ;   // Alerte le texte de tout élément h2 
        + alert ( alertText ) ; // Alerte le texte de tout élément h2

        Note : dans l'exemple ci-dessus, un XPath plus verbeux est préféré aux raccourcis communs tels que //h2. Généralement, des sélecteurs XPath plus spécifiques, comme dans l'exemple ci-dessus, améliorent de façon significative les performances, en particulier pour les documents très volumineux. C'est parce que l'évaluation de la requête ne perd pas de temps à visiter des noeuds inutiles. L'utilisation de // est généralement lente car elle visite tous les nœuds de la racine et tous les sous-nœuds à la recherche de correspondances possibles.

        Une optimisation supplémentaire peut être obtenue en utilisant soigneusement le paramètre de contexte. Par exemple, si vous savez que le contenu que vous recherchez se trouve quelque part dans la balise body, vous pouvez utiliser ceci :

        -
        document .  evaluate  ( " .  //h2", document.body, null, XPathResult.ANY_TYPE, null); 
        +
        document .  evaluate  ( " .  //h2", document.body, null, XPathResult.ANY_TYPE, null); 

        Remarquez ci-dessus,  document.body a été utilisé comme contexte plutôt que comme document, de sorte que le XPath commence à partir de l'élément body. (Dans cet exemple, le "." est important pour indiquer que l'interrogation doit commencer à partir du noeud contextuel, document.body . Si le "." est omis (en quittant //h2), la requête démarrera à partir du noeud racine ( html) ce qui serait plus inutile.)

        -

        Voir Introduction à l'utilisation de XPath avec JavaScript  pour plus d'informations.

        +

        Voir Introduction à l'utilisation de XPath avec JavaScript  pour plus d'informations.

        Notes

        @@ -155,7 +155,7 @@ translation_of: Web/API/Document/evaluate

        Voir aussi

        diff --git a/files/fr/web/api/document/execcommand/index.html b/files/fr/web/api/document/execcommand/index.html index 77a39c36d2..c581db094d 100644 --- a/files/fr/web/api/document/execcommand/index.html +++ b/files/fr/web/api/document/execcommand/index.html @@ -11,13 +11,7 @@ translation_of: Web/API/Document/execCommand ---
        {{ApiRef("DOM")}}{{deprecated_header}}
        -

        Lorsqu'un document HTML passe en - designMode, l'objet - document correspondant expose une méthode execCommand() - permettant d'exécuter des commandes manipulant la région éditable courante tels que les champs de formulaire ou les éléments - contentEditable - .

        +

        Lorsqu'un document HTML passe en designMode, l'objet document correspondant expose une méthode execCommand() permettant d'exécuter des commandes manipulant la région éditable courante tels que les champs de formulaire ou les éléments contentEditable.

        La plupart des commandes affectent la sélection du document (mise en gras, italique, etc.), tandis que @@ -36,7 +30,7 @@ translation_of: Web/API/Document/execCommand prise en charge ou si elle est désactivée.

        -

        Note : document.execCommand() ne renvoie +

        Note : document.execCommand() ne renvoie true que s'il est appelé à partir d'une interaction utilisateur. On ne peut pas l'invoquer dans un script afin de vérifier la prise en charge navigateur avant d'appeler une commande. À partir de Firefox 82, les appels imbriqués à @@ -62,169 +56,100 @@ translation_of: Web/API/Document/execCommand

        backColor
        -
        Modifie la couleur d'arrière-plan du document. Avec le mode styleWithCss - cela affecte la couleur d'arrière-plan du bloc englobant. Une chaîne de caractères décrivant - une valeur {{cssxref("<color>")}} doit être passée en argument. - On notera qu'Internet Explorer utilise ceci pour la couleur d'arrière-plan du texte.
        +

        Modifie la couleur d'arrière-plan du document. Avec le mode styleWithCss cela affecte la couleur d'arrière-plan du bloc englobant. Une chaîne de caractères décrivant une valeur {{cssxref("<color>")}} doit être passée en argument. On notera qu'Internet Explorer utilise ceci pour la couleur d'arrière-plan du texte.

        bold
        -
        Active ou désactive la mise en gras pour la sélection ou à partir du point d'insertion - Internet Explorer utilise la balise {{HTMLElement("strong")}} plutôt que {{HTMLElement("b")}}.
        +

        Active ou désactive la mise en gras pour la sélection ou à partir du point d'insertion Internet Explorer utilise la balise {{HTMLElement("strong")}} plutôt que {{HTMLElement("b")}}.

        ClearAuthenticationCache
        -
        Supprime toutes les informations d'authentification (credentials) du cache.
        +

        Supprime toutes les informations d'authentification credentials) du cache.

        contentReadOnly
        -
        Rend le contenu du document en lecture seule ou éditable en fonction du booléen passé - en argument (n'est pas pris en charge par Internet Explorer)
        +

        Rend le contenu du document en lecture seule ou éditable en fonction du booléen passé en argument (n'est pas pris en charge par Internet Explorer)

        copy
        -
        Copie la sélection courante vers le presse-papier. Les conditions pour obtenir ce - comportement peuvent varier d'un navigateur à l'autre. Veuillez voir le tableau de - compatibilité ci-après.
        +

        Copie la sélection courante vers le presse-papier. Les conditions pour obtenir ce comportement peuvent varier d'un navigateur à l'autre. Veuillez voir le tableau de compatibilité ci-après.

        createLink
        -
        Crée un hyperlien à partir de la sélection (sous réserve qu'il y en ait une). Une - chaîne de caractères formant un URI est nécessaire comme argument afin de fournir - la valeur de l'attribut href. L'URI doit contenir au moins un caractère - (qui peut être un blanc). (Internet Explorer créera un lien avec une valeur - null.)
        +

        Crée un hyperlien à partir de la sélection (sous réserve qu'il y en ait une). Une chaîne de caractères formant un URI est nécessaire comme argument afin de fournir la valeur de l'attribut href. L'URI doit contenir au moins un caractère (qui peut être un blanc). (Internet Explorer créera un lien avec une valeur null.)

        cut
        -
        Coupe le contenu de la sélection courante et le copie dans le presse-papier. - Les conditions pour obtenir ce comportement peuvent varier d'un navigateur à l'autre. - Veuillez voir le tableau de compatibilité ci-après.
        +

        Coupe le contenu de la sélection courante et le copie dans le presse-papier. Les conditions pour obtenir ce comportement peuvent varier d'un navigateur à l'autre. Veuillez voir le tableau de compatibilité ci-après.

        decreaseFontSize
        -
        Ajoute une balise {{HTMLElement("small")}} autour de la sélection ou au point - d'insertion. (Non pris en charge par Internet Explorer.)
        +

        Ajoute une balise {{HTMLElement("small")}} autour de la sélection ou au point d'insertion. (Non pris en charge par Internet Explorer.)

        defaultParagraphSeparator
        -
        Modifie le séparateur de paragraphe utilisé lorsque de nouveaux paragraphes sont - créés dans les zones de texte éditables. Voir - Différences dans la génération du balisage pour plus de détails.
        +

        Modifie le séparateur de paragraphe utilisé lorsque de nouveaux paragraphes sont créés dans les zones de texte éditables. Voir Différences dans la génération du balisage pour plus de détails.

        delete
        -
        Supprimer la sélection courante.
        +

        Supprimer la sélection courante.

        enableAbsolutePositionEditor
        -
        Active ou désactive la poignée qui permet de déplacer les éléments positionnés de - façon absolue. Celle-ci est désactivée par défaut depuis Firefox 64 ({{bug(1490641)}}). -
        +

        Active ou désactive la poignée qui permet de déplacer les éléments positionnés de façon absolue. Celle-ci est désactivée par défaut depuis Firefox 64 ({{bug(1490641)}}).

        enableInlineTableEditing
        -
        Active ou désactive les contrôles pour l'insertion ou la suppression des lignes ou - colonnes de tableau. Les contrôles sont désactivés par défaut depuis Firefox 64 - ({{bug(1490641)}}).
        +

        Active ou désactive les contrôles pour l'insertion ou la suppression des lignes ou colonnes de tableau. Les contrôles sont désactivés par défaut depuis Firefox 64 ({{bug(1490641)}}).

        enableObjectResizing
        -
        Active ou désactive les contrôles permettant de redimensionner les images, tableaux - ou les éléments positionnés de façon absolue. Les poignées sont désactivées par défaut - depuis Firefox 64 ({{bug(1490641)}}).
        +

        Active ou désactive les contrôles permettant de redimensionner les images, tableaux ou les éléments positionnés de façon absolue. Les poignées sont désactivées par défaut depuis Firefox 64 ({{bug(1490641)}}).

        fontName
        -
        Modifie le nom de la police pour la sélection ou à partir du point d'insertion. La - valeur fournie en argument doit être un nom de police (ex. "Arial").
        +

        Modifie le nom de la police pour la sélection ou à partir du point d'insertion. La valeur fournie en argument doit être un nom de police (ex. "Arial").

        fontSize
        -
        Modifie la taille de la police pour la sélection ou à partir du point d'insertion. - La valeur fournie en argument doit être un entier compris entre 1 et 7.
        +

        Modifie la taille de la police pour la sélection ou à partir du point d'insertion. La valeur fournie en argument doit être un entier compris entre 1 et 7.

        foreColor
        -
        Modifie la couleur de la police pour la sélection ou à partir du point d'insertion. - La valeur passée en argument doit être une chaîne de caractères décrivant une couleur - exprimée en notation hexadécimale.
        +

        Modifie la couleur de la police pour la sélection ou à partir du point d'insertion. La valeur passée en argument doit être une chaîne de caractères décrivant une couleur exprimée en notation hexadécimale.

        formatBlock
        -
        Ajoute un élément HTML de bloc autour de la ligne contenant la sélection courante et - remplace l'éventuel élément de bloc englobant s'il en existe un (pour Firefox, - {{HTMLElement("blockquote")}} fera exception et englobera n'importe quel bloc). - L'argument passé doit être un nom de balise. Tous les éléments de bloc peuvent en - théorie être utilisés. (Internet Explorer et Edge ne prennent en charge que les - balises H1H6, ADDRESS, et PRE qui - doivent être passées entre chevrons : "<H1>".)
        +

        Ajoute un élément HTML de bloc autour de la ligne contenant la sélection courante et remplace l'éventuel élément de bloc englobant s'il en existe un (pour Firefox, {{HTMLElement("blockquote")}} fera exception et englobera n'importe quel bloc). L'argument passé doit être un nom de balise. Tous les éléments de bloc peuvent en théorie être utilisés. (Internet Explorer et Edge ne prennent en charge que les balises H1H6, ADDRESS, et PRE qui doivent être passées entre chevrons : "<H1>".)

        forwardDelete
        -
        Supprime un caractère à la position du curseur. Le comportement obtenu est le même - que lorsqu'on appuie sur la touche Suppr d'un clavier Windows.
        +

        Supprime un caractère à la position du curseur. Le comportement obtenu est le même que lorsqu'on appuie sur la touche Suppr d'un clavier Windows.

        heading
        -
        Ajoute un élément de titre autour de la sélection ou au niveau du point d'insertion. - L'argument doit être le nom d'une balise de titre ("H1" à "H6"). - (Non pris en charge par Internet Explorer et Safari.)
        +

        Ajoute un élément de titre autour de la sélection ou au niveau du point d'insertion. L'argument doit être le nom d'une balise de titre ("H1" à "H6"). (Non pris en charge par Internet Explorer et Safari.)

        hiliteColor
        -
        Modifie la couleur d'arrière-plan pour la sélection ou à partir du point d'insertion. - La valeur passée en argument doit être une chaîne de caractères définissant une couleur - et useCSS doit valoir true. (Non pris en charge par Internet - Explorer.)
        +

        Modifie la couleur d'arrière-plan pour la sélection ou à partir du point d'insertion. La valeur passée en argument doit être une chaîne de caractères définissant une couleur et useCSS doit valoir true. (Non pris en charge par Internet Explorer.)

        increaseFontSize
        -
        Ajoute une balise {{HTMLElement("big")}} autour de la sélection ou à partir du point - d'insertion. (Non pris en charge par Internet Explorer).
        +

        Ajoute une balise {{HTMLElement("big")}} autour de la sélection ou à partir du point d'insertion. (Non pris en charge par Internet Explorer).

        indent
        -
        Augmente l'indentation de la ligne contenant la sélection ou le point d'insertion. - Pour Firefox, si la sélection s'étend sur plusieurs lignes ayant différents niveaux - d'indentation, seules les lignes les moins indentées seront décalées.
        +

        Augmente l'indentation de la ligne contenant la sélection ou le point d'insertion. Pour Firefox, si la sélection s'étend sur plusieurs lignes ayant différents niveaux d'indentation, seules les lignes les moins indentées seront décalées.

        insertBrOnReturn
        -
        Contrôle si la touche Entrée insère un élément {{HTMLElement("br")}} ou - si le bloc courant est scindé en deux. (Non pris en charge par Internet Explorer.)
        +

        Contrôle si la touche Entrée insère un élément {{HTMLElement("br")}} ou si le bloc courant est scindé en deux. (Non pris en charge par Internet Explorer.)

        insertHorizontalRule
        -
        Insère un élément {{HTMLElement("hr")}} au point d'insertion ou remplace la - sélection courante par cet élément.
        +

        Insère un élément {{HTMLElement("hr")}} au point d'insertion ou remplace la sélection courante par cet élément.

        insertHTML
        -
        Insère un élément au point d'insertion en supprimant la sélection. Une chaîne de - caractères HTML valide doit être fournie en argument. (Non pris en charge par Internet - Explorer.)
        +

        Insère un élément au point d'insertion en supprimant la sélection. Une chaîne de caractères HTML valide doit être fournie en argument. (Non pris en charge par Internet Explorer.)

        insertImage
        -
        Insère une image au point d'insertion en supprimant la sélection. L'argument doit - être une chaîne de caractères indiquant l'URL à utiliser pour l'attribut - src de l'image. Les prérequis de cette valeur sont les mêmes que pour - createLink.
        +

        Insère une image au point d'insertion en supprimant la sélection. L'argument doit être une chaîne de caractères indiquant l'URL à utiliser pour l'attribut src de l'image. Les prérequis de cette valeur sont les mêmes que pour createLink.

        insertOrderedList
        -
        Crée une liste numérotée ordonnée pour la - sélection ou à partir du point d'insertion.
        +

        Crée une liste numérotée ordonnée pour la sélection ou à partir du point d'insertion.

        insertUnorderedList
        -
        Crée une liste non-ordonnée pour la - sélection ou à partir du point d'insertion.
        +

        Crée une liste non-ordonnée pour la sélection ou à partir du point d'insertion.

        insertParagraph
        -
        Insère un paragraphe autour de la sélection - pour la ligne courante. (Internet Explorer insère un paragraphe au point d'insertion - et supprime la sélection.)
        +

        Insère un paragraphe autour de la sélection pour la ligne courante. (Internet Explorer insère un paragraphe au point d'insertion et supprime la sélection.)

        insertText
        -
        Insère le texte indiqué au point d'insertion (quitte à supprimer l'éventuelle - sélection courante).
        +

        Insère le texte indiqué au point d'insertion (quitte à supprimer l'éventuelle sélection courante).

        italic
        -
        Active ou désactive la mise en italique pour la sélection ou à partir du point - d'insertion. (Internet Explorer utilisera l'élément {{HTMLElement("em")}} plutôt que - {{HTMLElement("i")}}.)
        +

        Active ou désactive la mise en italique pour la sélection ou à partir du point d'insertion. (Internet Explorer utilisera l'élément {{HTMLElement("em")}} plutôt que {{HTMLElement("i")}}.)

        justifyCenter
        -
        Centre la sélection ou le point d'insertion.
        +

        Centre la sélection ou le point d'insertion.

        justifyFull
        -
        Justifie la sélection ou le point d'insertion.
        +

        Justifie la sélection ou le point d'insertion.

        justifyLeft
        -
        Justifie à gauche la sélection ou le point d'insertion.
        +

        Justifie à gauche la sélection ou le point d'insertion.

        justifyRight
        -
        Justifie à droite la sélection ou le point d'insertion.
        +

        Justifie à droite la sélection ou le point d'insertion.

        outdent
        -
        Effectue un retrait d'indentation pour la ligne courante.
        +

        Effectue un retrait d'indentation pour la ligne courante.

        paste
        -
        Colle le contenu du presse-papier au point d'insertion (et remplace éventuellement - la sélection actuelle). Fonctionnalité désactivée pour le contenu web.
        +

        Colle le contenu du presse-papier au point d'insertion (et remplace éventuellement la sélection actuelle). Fonctionnalité désactivée pour le contenu web.

        redo
        -
        Rejoue l'action annulée par la précédente commande undo.
        +

        Rejoue l'action annulée par la précédente commande undo.

        removeFormat
        -
        Supprime toute mise en forme pour la sélection courante.
        +

        Supprime toute mise en forme pour la sélection courante.

        selectAll
        -
        Sélectionne l'ensemble du contenu de la région éditable.
        +

        Sélectionne l'ensemble du contenu de la région éditable.

        strikeThrough
        -
        Active ou désactive la rayure de la sélection ou à partir d'un point d'insertion.
        +

        Active ou désactive la rayure de la sélection ou à partir d'un point d'insertion.

        subscript
        -
        Active ou désactive la mise en indice - pour la sélection ou au point d'insertion
        +

        Active ou désactive la mise en indice pour la sélection ou au point d'insertion

        superscript
        -
        Active ou désactive la mise en exposant - pour la sélection ou au point d'insertion
        +

        Active ou désactive la mise en exposant pour la sélection ou au point d'insertion

        underline
        -
        Active ou désactive le soulignement pour - la sélection ou au point d'insertion.
        +

        Active ou désactive le soulignement pour la sélection ou au point d'insertion.

        undo
        -
        Annule la dernière commande exécutée.
        +

        Annule la dernière commande exécutée.

        unlink
        -
        Retire l'ancre de l'hyperlien sélectionné. -
        +

        Retire l'ancre de l'hyperlien sélectionné.

        useCSS {{Deprecated_inline}}
        -
        Active/désactive l'utilisation de balises HTML ou de CSS pour le balisage généré. La - valeur de l'argument doit être un booléen.
        -
        Note : cet argument possède une logique inversée (false permet - d'utiliser CSS et true permet d'utiliser HTML). Cette valeur n'est pas - prise en charge par Internet Explorer et a été dépréciée en faveur de - styleWithCSS.
        -
        styleWithCSS
        -
        Remplace la commande useCSS. true modifie/génère des - attributs style dans le balisage tandis que false génère des - éléments HTML de présentation.
        +

        Active/désactive l'utilisation de balises HTML ou de CSS pour le balisage généré. La valeur de l'argument doit être un booléen. Note : cet argument possède une logique inversée (false permet d'utiliser CSS et true permet d'utiliser HTML). Cette valeur n'est pas prise en charge par Internet Explorer et a été dépréciée en faveur de styleWithCSS.

        styleWithCSS
        +

        Remplace la commande useCSS. true modifie/génère des attributs style dans le balisage tandis que false génère des éléments HTML de présentation.

        Exemple

        diff --git a/files/fr/web/api/document/exitfullscreen/index.html b/files/fr/web/api/document/exitfullscreen/index.html index e91d987e34..5bff1f4f8c 100644 --- a/files/fr/web/api/document/exitfullscreen/index.html +++ b/files/fr/web/api/document/exitfullscreen/index.html @@ -13,7 +13,9 @@ translation_of: Web/API/Document/exitFullscreen

        La méthode Document.exitFullscreen() extrait le document du mode plein écran ; elle est utilisée pour inverser les effets d'un appel au mode plein écran réalisé avec la méthode {{domxref("Element.requestFullscreen()")}}.

        -
        Note : Si un autre élément était précédemment en mode plein écran lorsque l'élément en cours a été placé en mode plein écran, cet élément précédent reprend le mode plein écran. Une "pile" d'éléments en plein écran est maintenue par le navigateur à cette fin.
        +
        +

        Note : Si un autre élément était précédemment en mode plein écran lorsque l'élément en cours a été placé en mode plein écran, cet élément précédent reprend le mode plein écran. Une "pile" d'éléments en plein écran est maintenue par le navigateur à cette fin.

        +

        Syntaxe

        @@ -55,7 +57,7 @@ document.onclick = function (event) {

        Voir aussi

          -
        • Utiliser le mode plein écran
        • +
        • Utiliser le mode plein écran
        • {{ domxref("Element.requestFullscreen()") }}
        • {{ domxref("Document.exitFullscreen()") }}
        • {{ domxref("Document.fullscreen") }}
        • diff --git a/files/fr/web/api/document/forms/index.html b/files/fr/web/api/document/forms/index.html index c892b63976..69a310feb2 100644 --- a/files/fr/web/api/document/forms/index.html +++ b/files/fr/web/api/document/forms/index.html @@ -17,17 +17,17 @@ translation_of: Web/API/Document/forms

          Note : De même, vous pouvez accéder à une liste des éléments d'entrée utilisateur d'un formulaire à l'aide de la propriété {{domxref ("HTMLFormElement.elements")}}.

        -

        Syntaxe

        +

        Syntaxe

        collection = document.forms;
        -

        Valeur

        +

        Valeur

        Un objet {{domxref("HTMLCollection")}} listant tous les formulaires du document. Chaque élément de la collection est un {{domxref("HTMLFormElement")}} représentant un seul élément <form>.

        -

        Exemples

        +

        Exemples

        -

        Récupérer les informations d'un formulaire

        +

        Récupérer les informations d'un formulaire

        <!DOCTYPE html>
         <html lang="en">
        @@ -60,31 +60,31 @@ translation_of: Web/API/Document/forms
         var selectFormElement = document.forms[index].elements[index];
         
        -

        Accéder aux formulaires nommés

        +

        Accéder aux formulaires nommés

        -
        <!DOCTYPE html>
        -<html lang="en">
        -<head>
        -  <title>document.forms example</title>
        -</head>
        +
        <!DOCTYPE html>
        +<html lang="en">
        +<head>
        +  <title>document.forms example</title>
        +</head>
         
        -<body>
        +<body>
         
        -<form name="login">
        -  <input name="email" type="email">
        -  <input name="password" type="password">
        -  <button type="submit">Log in</button>
        -</form>
        +<form name="login">
        +  <input name="email" type="email">
        +  <input name="password" type="password">
        +  <button type="submit">Log in</button>
        +</form>
         
        -<script>
        -  var loginForm = document.forms.login; // Ou document.forms['login']
        -  loginForm.elements.email.placeholder = 'test@example.com';
        -  loginForm.elements.password.placeholder = 'password';
        -</script>
        -</body>
        -</html>
        +<script> + var loginForm = document.forms.login; // Ou document.forms['login'] + loginForm.elements.email.placeholder = 'test@example.com'; + loginForm.elements.password.placeholder = 'password'; +</script> +</body> +</html>
        -

        Spécifications

        +

        Spécifications

      Spécification
      target {{readonlyInline}}EventTargetEventTarget The element that was underneath the element being dragged.
      type {{readonlyInline}}DOMStringDOMString The type of event.
      bubbles {{readonlyInline}}BooleanBoolean Whether the event normally bubbles or not
      cancelable {{readonlyInline}}BooleanBoolean Whether the event is cancellable or not?
      view {{readonlyInline}}WindowProxydocument.defaultView (window of the document)WindowProxydocument.defaultView (window of the document)
      detail {{readonlyInline}}
      target {{readonlyInline}}EventTargetEventTarget The element that was underneath the element being dragged.
      type {{readonlyInline}}DOMStringDOMString The type of event.
      bubbles {{readonlyInline}}BooleanBoolean Whether the event normally bubbles or not
      cancelable {{readonlyInline}}BooleanBoolean Whether the event is cancellable or not?
      view {{readonlyInline}}WindowProxydocument.defaultView (window of the document)WindowProxydocument.defaultView (window of the document)
      detail {{readonlyInline}}
      target {{readonlyInline}}EventTargetEventTarget The element that was underneath the element being dragged.
      type {{readonlyInline}}DOMStringDOMString The type of event.
      bubbles {{readonlyInline}}BooleanBoolean Whether the event normally bubbles or not
      cancelable {{readonlyInline}}BooleanBoolean Whether the event is cancellable or not?
      view {{readonlyInline}}WindowProxydocument.defaultView (window of the document)WindowProxydocument.defaultView (window of the document)
      detail {{readonlyInline}}
      target {{readonlyInline}}EventTargetEventTarget The element that was underneath the element being dragged.
      type {{readonlyInline}}DOMStringDOMString The type of event.
      bubbles {{readonlyInline}}BooleanBoolean Whether the event normally bubbles or not
      cancelable {{readonlyInline}}BooleanBoolean Whether the event is cancellable or not?
      view {{readonlyInline}}WindowProxydocument.defaultView (window of the document)WindowProxydocument.defaultView (window of the document)
      detail {{readonlyInline}}
      target {{readonlyInline}}EventTargetEventTarget The element that was underneath the element being dragged.
      type {{readonlyInline}}DOMStringDOMString The type of event.
      bubbles {{readonlyInline}}BooleanBoolean Whether the event normally bubbles or not
      cancelable {{readonlyInline}}BooleanBoolean Whether the event is cancellable or not?
      view {{readonlyInline}}WindowProxydocument.defaultView (window of the document)WindowProxydocument.defaultView (window of the document)
      detail {{readonlyInline}}
      target {{readonlyInline}}EventTargetEventTarget The element that was underneath the element being dragged.
      type {{readonlyInline}}DOMStringDOMString The type of event.
      bubbles {{readonlyInline}}BooleanBoolean Whether the event normally bubbles or not
      cancelable {{readonlyInline}}BooleanBoolean Whether the event is cancellable or not?
      view {{readonlyInline}}WindowProxydocument.defaultView (window of the document)WindowProxydocument.defaultView (window of the document)
      detail {{readonlyInline}}
      target {{readonlyInline}}EventTargetEventTarget The element that was underneath the element being dragged.
      type {{readonlyInline}}DOMStringDOMString The type of event.
      bubbles {{readonlyInline}}BooleanBoolean Whether the event normally bubbles or not
      cancelable {{readonlyInline}}BooleanBoolean Whether the event is cancellable or not?
      view {{readonlyInline}}WindowProxydocument.defaultView (window of the document)WindowProxydocument.defaultView (window of the document)
      detail {{readonlyInline}}
      @@ -108,9 +108,9 @@ var selectFormElement = document.forms[index].elements[index];
      -

      Voir aussi

      +

      Voir aussi

      diff --git a/files/fr/web/api/document/fullscreenchange_event/index.html b/files/fr/web/api/document/fullscreenchange_event/index.html index ca78a615cd..a2606c65b2 100644 --- a/files/fr/web/api/document/fullscreenchange_event/index.html +++ b/files/fr/web/api/document/fullscreenchange_event/index.html @@ -9,7 +9,7 @@ translation_of: Web/API/Document/fullscreenchange_event
      Spécification
      -
      Fullscreen
      +
      Fullscreen
      Interface
      {{domxref("Event")}}
      Propagation
      diff --git a/files/fr/web/api/document/fullscreenerror_event/index.html b/files/fr/web/api/document/fullscreenerror_event/index.html index 5f88b26992..dafb34cf85 100644 --- a/files/fr/web/api/document/fullscreenerror_event/index.html +++ b/files/fr/web/api/document/fullscreenerror_event/index.html @@ -9,7 +9,7 @@ translation_of: Web/API/Document/fullscreenerror_event
      Spécification
      -
      Fullscreen
      +
      Fullscreen
      Interface
      {{domxref("Event")}}
      Propagation
      diff --git a/files/fr/web/api/document/getboxobjectfor/index.html b/files/fr/web/api/document/getboxobjectfor/index.html index 97b613781e..5160c98e2a 100644 --- a/files/fr/web/api/document/getboxobjectfor/index.html +++ b/files/fr/web/api/document/getboxobjectfor/index.html @@ -13,9 +13,11 @@ translation_of: Web/API/Document/getBoxObjectFor

      Renvoie un boxObject (x, y, largeur, hauteur) pour un élément spécifié.

      -
      Note : Cette méthode est obsolète. Vous devez utiliser la méthode {{domxref("element.getBoundingClientRect()")}} à la place.
      +
      +

      Note : Cette méthode est obsolète. Vous devez utiliser la méthode {{domxref("element.getBoundingClientRect()")}} à la place.

      +
      -

      Syntaxe

      +

      Syntaxe

      boxObject = document.getBoxObjectFor(element);
       
      @@ -25,7 +27,7 @@ translation_of: Web/API/Document/getBoxObjectFor
    • element est un {{domxref("element","DOMElement")}}
    -

    Exemple

    +

    Exemple

    var myDiv = document.getElementById("myDiv"),
         boxObj = document.getBoxObjectFor (myDiv);
    @@ -37,6 +39,6 @@ alert (
       ", Height:" + boxObj.height
     );
    -

    Notes

    +

    Notes

    -

    Spécifié dans nsIXULDocument.idl

    +

    Spécifié dans nsIXULDocument.idl

    diff --git a/files/fr/web/api/document/getelementbyid/index.html b/files/fr/web/api/document/getelementbyid/index.html index 74f004989b..eacf9ef0a2 100644 --- a/files/fr/web/api/document/getelementbyid/index.html +++ b/files/fr/web/api/document/getelementbyid/index.html @@ -16,7 +16,7 @@ translation_of: Web/API/Document/getElementById

    Si vous avez besoin d'accéder à un élément qui n'a pas d'ID, vous pouvez utiliser {{domxref("Document.querySelector","querySelector()")}} pour trouver l'élément en utilisant un {{Glossary("CSS selector","sélecteur")}}.

    -

    Syntaxe

    +

    Syntaxe

    var element = document.getElementById(id);
     
    @@ -25,41 +25,40 @@ translation_of: Web/API/Document/getElementById
    id
    -
    L'ID (identifiant) de l'élément à localiser. Il est une chaîne de caractères sensible à la casse qui est unique ; un seul élément peut avoir un ID donné.
    -
    -

    Valeur de retour

    -
    +

    L'ID (identifiant) de l'élément à localiser. Il est une chaîne de caractères sensible à la casse qui est unique ; un seul élément peut avoir un ID donné.

    +

    Valeur de retour

    +

    Un objet {{domxref("Element")}} décrivant l'objet élément du DOM correspondant à l'ID spécifié ou null si aucun n'a été trouvé dans le document.

    -

    Exemple

    +

    Exemple

    Contenu HTML

    -
    <html>
    -<head>
    -  <title>getElementById example</title>
    -</head>
    -<body>
    -  <p id="para">Some text here</p>
    -  <button onclick="changeColor('blue');">blue</button>
    -  <button onclick="changeColor('red');">red</button>
    -</body>
    -</html>
    +
    <html>
    +<head>
    +  <title>getElementById example</title>
    +</head>
    +<body>
    +  <p id="para">Some text here</p>
    +  <button onclick="changeColor('blue');">blue</button>
    +  <button onclick="changeColor('red');">red</button>
    +</body>
    +</html>

    Contenu JavaScript

    -
    function changeColor(newColor) {
    -  var elem = document.getElementById('para');
    -  elem.style.color = newColor;
    -}
    +
    function changeColor(newColor) {
    +  var elem = document.getElementById('para');
    +  elem.style.color = newColor;
    +}
    -

    Résultat

    +

    Résultat

    {{ EmbedLiveSample('Example1', 250, 100) }}

    -

    Notes d'utilisation

    +

    Notes d'utilisation

    L'écriture de la lettre capitale de « Id » dans le nom de cette méthode doit être respectée pour que le code fonctionne ; getElementByID() n'est pas valide et ne fonctionnera pas, même si elle semble naturelle.

    @@ -67,39 +66,39 @@ translation_of: Web/API/Document/getElementById

    Exemple

    -
    <!doctype html>
    -<html>
    -<head>
    -    <meta charset="UTF-8">
    -    <title>Document</title>
    -</head>
    -<body>
    -    <div id="parent-id">
    -        <p>hello word1</p>
    -        <p id="test1">hello word2</p>
    -        <p>hello word3</p>
    -        <p>hello word4</p>
    -    </div>
    -    <script>
    -        var parentDOM = document.getElementById('parent-id');
    -        var test1=parentDOM.getElementById('test1');
    -        //erreur de lancement 
    -        //TypeError inattendu : parentDOM.getElementById n'est pas une fonction 
    -    </script>
    -</body>
    -</html>
    +
    <!doctype html>
    +<html>
    +<head>
    +    <meta charset="UTF-8">
    +    <title>Document</title>
    +</head>
    +<body>
    +    <div id="parent-id">
    +        <p>hello word1</p>
    +        <p id="test1">hello word2</p>
    +        <p>hello word3</p>
    +        <p>hello word4</p>
    +    </div>
    +    <script>
    +        var parentDOM = document.getElementById('parent-id');
    +        var test1=parentDOM.getElementById('test1');
    +        //erreur de lancement 
    +        //TypeError inattendu : parentDOM.getElementById n'est pas une fonction 
    +    </script>
    +</body>
    +</html>

    S'il n'y a pas d'élément avec l'id fourni, cette fonction retourne null. A noter que le paramètre id est sensible à la casse, ainsi document.getElementById("Main") retournera null au lieu de l'élément <div id="main"> étant donné que "M" et "m" sont différents pour cette méthode.

    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');
    -element.id = 'testqq';
    -var el = document.getElementById('testqq'); // el vaudra null !
    +
    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.

    +

    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

    @@ -131,7 +130,7 @@ element.id =
    -

    Traduction en français (non normative) : getElementById

    +

    Traduction en français (non normative) : getElementById

    Compatibilité des navigateurs

    @@ -142,5 +141,5 @@ element.id =
    • {{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).
    • +
    • xml:id dispose d'une méthode utilitaire permettant à getElementById d'obtenir les valeur 'xml:id' dans les documents XML (comme ceux qui pourraient être renvoyés par des appels Ajax).
    diff --git a/files/fr/web/api/document/getelementsbyclassname/index.html b/files/fr/web/api/document/getelementsbyclassname/index.html index 7296b18b88..43ff0fb18a 100644 --- a/files/fr/web/api/document/getelementsbyclassname/index.html +++ b/files/fr/web/api/document/getelementsbyclassname/index.html @@ -10,20 +10,20 @@ translation_of: Web/API/Document/getElementsByClassName ---

    {{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);
      -
    • elements est une {{domxref ("HTMLCollection")}} des éléments trouvés.
    • +
    • 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.
    • +
    • 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 » :

    @@ -40,43 +40,43 @@ translation_of: Web/API/Document/getElementsByClassName
     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');
    -var testDivs = Array.prototype.filter.call(testElements, function(testElement){
    -    return testElement.nodeName === 'DIV';
    -});
    +
    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>

    +

    XXX writeme == Notes == Une méthode semblable existe pour <code>Element</code>

    -

    Obtenir la classe  des éléments test

    +

    Obtenir la classe  des éléments test

    -

    C'est la méthode d'opération la plus couramment utilisée.

    +

    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>
    -        var parentDOM = document.getElementById("parent-id");
    +
    <!doctype html>
    +<html>
    +<head>
    +    <meta charset="UTF-8">
    +    <title>Document</title>
    +</head>
    +<body>
    +    <div id="parent-id">
    +        <p>hello word1</p>
    +        <p class="test">hello word2</p>
    +        <p >hello word3</p>
    +        <p>hello word4</p>
    +    </div>
    +    <script>
    +        var parentDOM = document.getElementById("parent-id");
     
    -        var test=parentDOM.getElementsByClassName("test");//test is not target element
    -        console.log(test);//HTMLCollection[1]
    +        var test=parentDOM.getElementsByClassName("test");//test is not target element
    +        console.log(test);//HTMLCollection[1]
     
    -        var testTarget=parentDOM.getElementsByClassName("test")[0];//here , this element is target
    -        console.log(testTarget);//<p class="test">hello word2</p>
    -    </script>
    -</body>
    -</html>
    + var testTarget=parentDOM.getElementsByClassName("test")[0];//here , this element is target + console.log(testTarget);//<p class="test">hello word2</p> + </script> +</body> +</html>

    Compatibilité des navigateurs

    @@ -85,8 +85,8 @@ translation_of: Web/API/Document/getElementsByClassName -

    Spécification

    +

    Spécification

    diff --git a/files/fr/web/api/document/getelementsbyname/index.html b/files/fr/web/api/document/getelementsbyname/index.html index c8136c8de7..d2087a0d22 100644 --- a/files/fr/web/api/document/getelementsbyname/index.html +++ b/files/fr/web/api/document/getelementsbyname/index.html @@ -13,7 +13,7 @@ translation_of: Web/API/Document/getElementsByName

    Renvoie une liste des éléments portant un {{domxref("element.name","name")}} donné dans le document (X)HTML.

    -

    Syntaxe

    +

    Syntaxe

    elements = document.getElementsByName(name)
     
    @@ -23,36 +23,36 @@ translation_of: Web/API/Document/getElementsByName
  • name est la valeur de l'attribut name des éléments.
  • -

    Exemple

    +

    Exemple

    -
    <!DOCTYPE html>
    -<html lang="en">
    -<head>
    +
    <!DOCTYPE html>
    +<html lang="en">
    +<head>
      ...
    -</head>
    +</head>
     
    -<body>
    -<form name="up"><input type="text"></form>
    -<div name="down"><input type="text"></div>
    +<body>
    +<form name="up"><input type="text"></form>
    +<div name="down"><input type="text"></div>
     
    -<script>
    -var up_forms = document.getElementsByName("up");
    -console.log(up_forms[0].tagName); // retourne "FORM"
    -</script>
    -</body>
    -</html>
    +<script> +var up_forms = document.getElementsByName("up"); +console.log(up_forms[0].tagName); // retourne "FORM" +</script> +</body> +</html>
    -

    Notes

    +

    Notes

    -

    L'attribut 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.

    +

    L'attribut 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.

    +

    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

    +

    Spécifications

    @@ -75,7 +75,7 @@ console.log<
    -

    Voir aussi

    +

    Voir aussi

    • {{domxref("document.getElementById()")}} pour retourner une référence à un élément par son ID
    • diff --git a/files/fr/web/api/document/getelementsbytagname/index.html b/files/fr/web/api/document/getelementsbytagname/index.html index 268a5a6453..b90d19fbe0 100644 --- a/files/fr/web/api/document/getelementsbytagname/index.html +++ b/files/fr/web/api/document/getelementsbytagname/index.html @@ -12,9 +12,9 @@ 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 ().

      +

      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

      +

      Syntaxe

      var elements = document.getElementsByTagName(name);
      @@ -27,79 +27,79 @@ translation_of: Web/API/Document/getElementsByTagName

      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.

      - -

      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>
      -    function getAllParaElems() {
      -      var allParas = document.getElementsByTagName('p');
      -      var num = allParas.length;
      -      alert('There are ' + num + ' paragraph in this document');
      -    }
      -
      -    function div1ParaElems() {
      -      var div1 = document.getElementById('div1');
      -      var div1Paras = div1.getElementsByTagName('p');
      -      var num = div1Paras.length;
      -      alert('There are ' + num + ' paragraph in #div1');
      -    }
      -
      -    function div2ParaElems() {
      -      var div2 = document.getElementById('div2');
      -      var div2Paras = div2.getElementsByTagName('p');
      -      var num = div2Paras.length;
      -      alert('There are ' + num + ' paragraph in #div2');
      -    }
      -  </script>
      -</head>
      -<body style="border: solid green 3px">
      -  <p>Some outer text</p>
      -  <p>Some outer text</p>
      -
      -  <div id="div1" style="border: solid blue 3px">
      -    <p>Some div1 text</p>
      -    <p>Some div1 text</p>
      -    <p>Some div1 text</p>
      -
      -    <div id="div2" style="border: solid red 3px">
      -      <p>Some div2 text</p>
      -      <p>Some div2 text</p>
      -    </div>
      -  </div>
      -
      -  <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)}}.
      +

      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.

      + +

      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>
      +    function getAllParaElems() {
      +      var allParas = document.getElementsByTagName('p');
      +      var num = allParas.length;
      +      alert('There are ' + num + ' paragraph in this document');
      +    }
      +
      +    function div1ParaElems() {
      +      var div1 = document.getElementById('div1');
      +      var div1Paras = div1.getElementsByTagName('p');
      +      var num = div1Paras.length;
      +      alert('There are ' + num + ' paragraph in #div1');
      +    }
      +
      +    function div2ParaElems() {
      +      var div2 = document.getElementById('div2');
      +      var div2Paras = div2.getElementsByTagName('p');
      +      var num = div2Paras.length;
      +      alert('There are ' + num + ' paragraph in #div2');
      +    }
      +  </script>
      +</head>
      +<body style="border: solid green 3px">
      +  <p>Some outer text</p>
      +  <p>Some outer text</p>
      +
      +  <div id="div1" style="border: solid blue 3px">
      +    <p>Some div1 text</p>
      +    <p>Some div1 text</p>
      +    <p>Some div1 text</p>
      +
      +    <div id="div2" style="border: solid red 3px">
      +      <p>Some div2 text</p>
      +      <p>Some div2 text</p>
      +    </div>
      +  </div>
      +
      +  <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)}}.

      - document.getElementsByTagName() est similaire à {{domxref ("element.getElementsByTagName ()")}}, sauf que sa recherche englobe tout le document.

      + document.getElementsByTagName() est similaire à {{domxref ("element.getElementsByTagName ()")}}, sauf que sa recherche englobe tout le document.

      -

      Spécifications

      +

      Spécifications

      diff --git a/files/fr/web/api/document/getelementsbytagnamens/index.html b/files/fr/web/api/document/getelementsbytagnamens/index.html index 537bc24875..7397cc7507 100644 --- a/files/fr/web/api/document/getelementsbytagnamens/index.html +++ b/files/fr/web/api/document/getelementsbytagnamens/index.html @@ -16,28 +16,30 @@ translation_of: Web/API/Document/getElementsByTagNameNS

      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 est une {{domxref("NodeList")}} (liste de noeud) directe (mais voir le note ci-dessous) d'éléments trouvés dans l'ordre de leur apparition dans l'arbre.
      • -
      • namespace l'URI d'espace de noms des éléments à rechercher (voir element.namespaceURI).
      • -
      • name est, soit le nom local des éléments à rechercher, soit la valeur spéciale "*" pour tous les éléments (voir element.localName).
      • +
      • namespace l'URI d'espace de noms des éléments à rechercher (voir element.namespaceURI).
      • +
      • name est, soit le nom local des éléments à rechercher, soit la valeur spéciale "*" pour tous les éléments (voir element.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.
      +
      +

      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.

      +

      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.

      -
      <html xmlns="http://www.w3.org/1999/xhtml">
      +
      http://www.w3.org/1999/xhtml">
       
       <head>
       <title>getElementsByTagNameNS example</title>
      @@ -46,7 +48,7 @@ translation_of: Web/API/Document/getElementsByTagNameNS
       
       function getAllParaElems()
       {
      -  var allParas = document.getElementsByTagNameNS("http://www.w3.org/1999/xhtml", "p");
      +  var allParas = document.getElementsByTagNameNS("http://www.w3.org/1999/xhtml", "p");
       
         var num = allParas.length;
       
      @@ -57,7 +59,7 @@ function getAllParaElems()
       function div1ParaElems()
       {
         var div1 = document.getElementById("div1")
      -  var div1Paras = div1.getElementsByTagNameNS("http://www.w3.org/1999/xhtml", "p");
      +  var div1Paras = div1.getElementsByTagNameNS("http://www.w3.org/1999/xhtml", "p");
       
         var num = div1Paras.length;
       
      @@ -68,7 +70,7 @@ function div1ParaElems()
       function div2ParaElems()
       {
         var div2 = document.getElementById("div2")
      -  var div2Paras = div2.getElementsByTagNameNS("http://www.w3.org/1999/xhtml", "p");
      +  var div2Paras = div2.getElementsByTagNameNS("http://www.w3.org/1999/xhtml", "p");
       
         var num = div2Paras.length;
       
      @@ -109,9 +111,9 @@ function div2ParaElems()
       </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.)

      function getElementsByTagNameNSWrapper (ns, elName, doc, context) {
       	if (!doc) {
      @@ -131,6 +133,6 @@ function div2ParaElems()
       }
       
      -

      Spécifications

      +

      Spécifications

      -

      DOM Level 2 Core: Document.getElementsByTagNameNS

      +

      DOM Level 2 Core: Document.getElementsByTagNameNS

      diff --git a/files/fr/web/api/document/getselection/index.html b/files/fr/web/api/document/getselection/index.html index 676ba4d351..e485df22ae 100644 --- a/files/fr/web/api/document/getselection/index.html +++ b/files/fr/web/api/document/getselection/index.html @@ -13,4 +13,4 @@ original_slug: Web/API/DocumentOrShadowRoot/getSelection ---

      {{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.html b/files/fr/web/api/document/hasfocus/index.html index f33a56bb10..fb6088c0a9 100644 --- a/files/fr/web/api/document/hasfocus/index.html +++ b/files/fr/web/api/document/hasfocus/index.html @@ -11,59 +11,59 @@ translation_of: Web/API/Document/hasFocus ---

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

      +

      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.

      +

      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();
       
      -

      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

      - -
      <!DOCTYPE html>
      -<html lang="en">
      -<head>
      -<meta charset="UTF-8" />
      -<title>TEST</title>
      -<style>
      -#message { font-weight: bold; }
      -</style>
      -<script>
      -setInterval( checkPageFocus, 200 );
      -
      -function checkPageFocus() {
      -  var info = document.getElementById("message");
      -
      -  if ( document.hasFocus() ) {
      -    info.innerHTML = "The document has the focus.";
      -  } else {
      -    info.innerHTML = "The document doesn't have the focus.";
      -  }
      -}
      -
      -function openWindow() {
      -  window.open (
      -    "http://developer.mozilla.org/",
      -    "mozdev",
      -    "width=640,height=300,left=150,top=260"
      -  );
      -}
      -</script>
      -</head>
      -<body>
      -  <h1>JavaScript hasFocus example</h1>
      -  <div id="message">Waiting for user action</div>
      -  <div><button onclick="openWindow()">Open a new window</button></div>
      -</body>
      -</html>
      +

      Exemple

      + +
      <!DOCTYPE html>
      +<html lang="en">
      +<head>
      +<meta charset="UTF-8" />
      +<title>TEST</title>
      +<style>
      +#message { font-weight: bold; }
      +</style>
      +<script>
      +setInterval( checkPageFocus, 200 );
      +
      +function checkPageFocus() {
      +  var info = document.getElementById("message");
      +
      +  if ( document.hasFocus() ) {
      +    info.innerHTML = "The document has the focus.";
      +  } else {
      +    info.innerHTML = "The document doesn't have the focus.";
      +  }
      +}
      +
      +function openWindow() {
      +  window.open (
      +    "https://developer.mozilla.org/",
      +    "mozdev",
      +    "width=640,height=300,left=150,top=260"
      +  );
      +}
      +</script>
      +</head>
      +<body>
      +  <h1>JavaScript hasFocus example</h1>
      +  <div id="message">Waiting for user action</div>
      +  <div><button onclick="openWindow()">Open a new window</button></div>
      +</body>
      +</html>

      Spécification

      diff --git a/files/fr/web/api/document/head/index.html b/files/fr/web/api/document/head/index.html index 9927db3f3b..ef80950d76 100644 --- a/files/fr/web/api/document/head/index.html +++ b/files/fr/web/api/document/head/index.html @@ -7,16 +7,15 @@ tags: - HTML5 translation_of: Web/API/Document/head --- -

      Résumé

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

      Exemple

      +

      Exemple

      // en HTML: <head id="my-document-head">
       var aHead = document.head;
      @@ -26,7 +25,7 @@ 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.

      diff --git a/files/fr/web/api/document/height/index.html b/files/fr/web/api/document/height/index.html index 8f69f2dbbc..6dbe1f47e8 100644 --- a/files/fr/web/api/document/height/index.html +++ b/files/fr/web/api/document/height/index.html @@ -13,7 +13,7 @@ translation_of: Web/API/Document/height

      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
       
      diff --git a/files/fr/web/api/document/images/index.html b/files/fr/web/api/document/images/index.html index 56ae7fba48..1b127eb980 100644 --- a/files/fr/web/api/document/images/index.html +++ b/files/fr/web/api/document/images/index.html @@ -6,23 +6,28 @@ tags: translation_of: Web/API/Document/images ---

      {{ ApiRef() }}

      -

      Résumé

      -

      document.images renvoie une collection des images du document HTML courant.

      -

      Syntaxe

      -
      HTMLCollection = document.images
      -
      -

      Exemple

      -
      var listeimg = document.images;
      +
      +

      document.images renvoie une collection des images du document HTML courant.

      + +

      Syntaxe

      + +
      HTMLCollection =document.images
      + +

      Exemple

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

      -

      document.images fait partie du DOM HTML, et fonctionne uniquement pour les document HTML.

      -

      Spécification

      + +

      Notes

      + +

      document.images fait partie du DOM HTML, et fonctionne uniquement pour les document HTML.

      +

      Spécification

      diff --git a/files/fr/web/api/document/implementation/index.html b/files/fr/web/api/document/implementation/index.html index 5f7d1a8bff..f7684fa56f 100644 --- a/files/fr/web/api/document/implementation/index.html +++ b/files/fr/web/api/document/implementation/index.html @@ -19,21 +19,21 @@ translation_of: Web/API/Document/implementation

      Exemple

      -
      var modName = "HTML";
      -var modVer = "2.0";
      -var conformTest = document.implementation.hasFeature( modName, modVer );
      +
      var modName = "HTML";
      +var modVer = "2.0";
      +var conformTest = document.implementation.hasFeature( modName, modVer );
       
      -alert( "DOM " + modName + " " + modVer + " supported?: " + conformTest );
      +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 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.

      +

      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
      • @@ -43,5 +43,5 @@ translation_of: Web/API/Document/implementation

        Notes propres à Gecko

          -
        • À partir de Gecko 19.0 {{geckoRelease ("19.0")}} la méthode {{domxref ("DOMImplementation.hasFeature", "hasFeature")}} retournera toujours true.
        • +
        • À partir de Gecko 19.0 {{geckoRelease ("19.0")}} la méthode {{domxref ("DOMImplementation.hasFeature", "hasFeature")}} retournera toujours true.
        diff --git a/files/fr/web/api/document/importnode/index.html b/files/fr/web/api/document/importnode/index.html index 32bef68f4a..afda055041 100644 --- a/files/fr/web/api/document/importnode/index.html +++ b/files/fr/web/api/document/importnode/index.html @@ -12,46 +12,46 @@ translation_of: Web/API/Document/importNode ---

        {{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 ()")}}.

        +

        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);
         
        externalNode
        -
        Le nouveau Node ou DocumentFragment à importer dans le document courant. Après l'importation, le nouveau parentNode du noeud est null, car il n'a pas encore été inséré dans l'arborescence du document.
        +
        Le nouveau Node ou DocumentFragment à importer dans le document courant. Après l'importation, le nouveau parentNode du noeud est null, car il n'a pas encore été inséré dans l'arborescence du document.
        deep
        -
        Une valeur booléenne qui indique s'il faut ou non importer la totalité de la sous-arborescence DOM provenant de externalNode. Si ce paramètre est true (vrai), alors externalNode et tous ses descendants sont copiés; si false (faux), seul le nœud unique, externalNode, est importé.
        +
        Une valeur booléenne qui indique s'il faut ou non importer la totalité de la sous-arborescence DOM provenant de externalNode. Si ce paramètre est true (vrai), alors externalNode et tous ses descendants sont copiés; si false (faux), seul le nœud unique, externalNode, est importé.
        -

        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.
        +

        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.

        + 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

        -
        var iframe = document.getElementsByTagName("iframe")[0];
        -var oldNode = iframe.contentWindow.document.getElementById("myNode");
        -var newNode = document.importNode(oldNode, true);
        -document.getElementById("container").appendChild(newNode);
        +
        var iframe = document.getElementsByTagName("iframe")[0];
        +var oldNode = iframe.contentWindow.document.getElementById("myNode");
        +var newNode = document.importNode(oldNode, true);
        +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).

        +

        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() 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.

         

        -

        Spécifications

        +

        Spécifications

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

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

        +

        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")}}.

        +

        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

        +

        Constructeur

        {{domxref("Document.Document","Document()")}}{{non-standard_inline}}
        crée un nouvel objet Document .
        -

        Propriétés

        +

        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.
        +
        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.
        @@ -74,15 +74,15 @@ translation_of: Web/API/Document
        {{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")}}.
        +
        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.
        +
        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.
        +
        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}}
        @@ -96,7 +96,7 @@ translation_of: Web/API/Document
        {{domxref("Document.undoManager")}} {{readonlyinline}} {{experimental_inline}}
        ...
        {{domxref("Document.visibilityState")}} {{readonlyinline}}
        -
        renvoie une string (chaîne de caractères) indiquant l'état de visibilité du document. Les valeurs possibles sont visible , hidden (masqué) , prerender (pré-rendu) et unloaded (déchargées).
        +
        renvoie une string (chaîne de caractères) indiquant l'état de visibilité du document. Les valeurs possibles sont visible , hidden (masqué) , prerender (pré-rendu) et unloaded (déchargées).
        {{domxref("Document.xmlEncoding")}} {{Deprecated_inline}}
        retourne le codage déterminé par une déclaration XML.
        {{domxref("Document.xmlStandalone")}} {{obsolete_inline("10.0")}}
        @@ -137,7 +137,7 @@ translation_of: Web/API/Document
        {{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.
        +
        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")}}
        @@ -224,17 +224,17 @@ translation_of: Web/API/Document

        Méthodes

        -

        Cette interface hérite également des interfaces {{domxref ("Node")}} et {{domxref ("EventTarget")}}.

        +

        Cette interface hérite également des interfaces {{domxref ("Node")}} et {{domxref ("EventTarget")}}.

        {{domxref("Document.adoptNode()")}}
        -
        adopte le noeud d'un document externe.
        +
        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.
        +
        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.
        +
        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()")}}
        @@ -300,15 +300,15 @@ translation_of: Web/API/Document
        {{domxref("Document.normalizeDocument()")}} {{obsolete_inline}}
        remplace les entités, normalise les noeuds de texte, etc.
        {{domxref("Document.registerElement()")}} {{experimental_inline}}
        -
        Enregistre un composant Web.
        +
        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.
        +
        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é.
        +
        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")}} :

        @@ -317,7 +317,7 @@ translation_of: Web/API/Document
        {{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.
        +
        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.
        @@ -326,7 +326,7 @@ translation_of: Web/API/Document
        {{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).
        +
        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)")}}
        @@ -337,9 +337,9 @@ translation_of: Web/API/Document
        {{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.
        +
        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.
        +
        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)")}}
        @@ -453,38 +453,38 @@ translation_of: Web/API/Document
        {{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).
        +
        (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.
        +
        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")}}.
        +
        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.
        +
        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")}}.
        +
        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

        +

        Notes concernant Internet Explorer

        -

        Microsoft a défini quelques propriétés non standard :

        +

        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.
        +
        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 :

        +

        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é.
        +
        Pour contourner le problème, document.body.contains () peut être utilisé.
        diff --git a/files/fr/web/api/document/keypress_event/index.html b/files/fr/web/api/document/keypress_event/index.html index e0560ef1df..76807b1f92 100644 --- a/files/fr/web/api/document/keypress_event/index.html +++ b/files/fr/web/api/document/keypress_event/index.html @@ -11,10 +11,10 @@ translation_of: Web/API/Document/keypress_event ---
        {{APIRef}} {{deprecated_header}}
        -

        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.

        +

        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.

        +
        +

        Attention : Cet évènement est déprécié et il faudrait plutôt utiliser beforeinput ou keydown.

        diff --git a/files/fr/web/api/document/lastmodified/index.html b/files/fr/web/api/document/lastmodified/index.html index c9f26ad21b..90a7738bb3 100644 --- a/files/fr/web/api/document/lastmodified/index.html +++ b/files/fr/web/api/document/lastmodified/index.html @@ -7,12 +7,12 @@ translation_of: Web/API/Document/lastModified

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

        Exemples

        +

        Exemples

        Exemple #1: Utilisation simple

        @@ -20,7 +20,7 @@ translation_of: Web/API/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

        var oLastModif = new Date(document.lastModified);
         
        @@ -30,9 +30,9 @@ translation_of: Web/API/Document/lastModified
        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):

        +

        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")) {
             document.cookie = "last_modif=" + Date.now() + "; expires=Fri, 31 Dec 9999 23:59:59 GMT; path=" + location.pathname;
        @@ -53,12 +53,13 @@ if (isNaN(nLastVisit) || nLastModif > nLastVisit) {
             }
         }
        -
        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)
        +
        +

        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().

        +

        Si vous voulez savoir si une page externe a changé, veuillez lire ce paragraphe à propos de l'API XMLHttpRequest().

        -

        Spécification

        +

        Spécification

        HTML5

        diff --git a/files/fr/web/api/document/laststylesheetset/index.html b/files/fr/web/api/document/laststylesheetset/index.html index 2f24656c13..dce73ac17e 100644 --- a/files/fr/web/api/document/laststylesheetset/index.html +++ b/files/fr/web/api/document/laststylesheetset/index.html @@ -12,16 +12,18 @@ translation_of: Web/API/Document/lastStyleSheetSet

        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
         

        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é.
        +
        +

        Note : Cette valeur ne doit pas changer lorsque {{ domxref("document.enableStyleSheetsForSet()") }} est appelé.

        +
        -

        Exemple

        +

        Exemple

        var lastSheetSet = document.lastStyleSheetSet;
         if (!lastSheetSet) {
        @@ -30,7 +32,7 @@ if (!lastSheetSet) {
         console.log("The last sheet set is: " + lastSheetSet);
         
        -

        Voir aussi

        +

        Voir aussi

        • {{ domxref("document.preferredStyleSheetSet") }}
        • @@ -39,8 +41,8 @@ console.log("The last sheet set is: " + lastSheetSet);
        • {{ domxref("document.enableStyleSheetsForSet()") }}
        -

        Spécifications

        +

        Spécifications

        diff --git a/files/fr/web/api/document/location/index.html b/files/fr/web/api/document/location/index.html index 932929b720..2a6f3e51c3 100644 --- a/files/fr/web/api/document/location/index.html +++ b/files/fr/web/api/document/location/index.html @@ -10,23 +10,23 @@ 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.

        +

        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'.

        +

        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
        +
        locationObj = document.location
         document.location = 'http://www.mozilla.org' // équivalent à document.location.href = 'http://www.mozilla.org'
         
        -

        Exemple

        +

        Exemple

        -
        console.log(document.location);
        +
        console.log(document.location);
         // Affiche un string-like
         // "http://www.example.com/juicybits.html" dans la console
         
        diff --git a/files/fr/web/api/document/mozsetimageelement/index.html b/files/fr/web/api/document/mozsetimageelement/index.html index 1c35bcbcc5..aa70b99736 100644 --- a/files/fr/web/api/document/mozsetimageelement/index.html +++ b/files/fr/web/api/document/mozsetimageelement/index.html @@ -16,7 +16,7 @@ translation_of: Web/API/Document/mozSetImageElement

        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);
         
        @@ -28,11 +28,11 @@ translation_of: Web/API/Document/mozSetImageElement
      • imageElement est le nouvel élément à utiliser comme arrière-plan correspondant à cette chaîne d'élément image. Spécifiez null pour supprimer l'élément d'arrière-plan.
      • -

        Exemple

        +

        Exemple

        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.

        +

        Vue de cet exemple en direct.

        <style type="text/css">
           #mybox {
        @@ -70,11 +70,11 @@ function clicked() {
         
         

        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.

        -

        Spécifications

        +

        Spécifications

        Ne fait partie d'aucune spécification.

        -

        Voir aussi

        +

        Voir aussi

        • {{ cssxref("-moz-element") }}
        • diff --git a/files/fr/web/api/document/mozsyntheticdocument/index.html b/files/fr/web/api/document/mozsyntheticdocument/index.html index 443c3ca5e0..c8847269ca 100644 --- a/files/fr/web/api/document/mozsyntheticdocument/index.html +++ b/files/fr/web/api/document/mozsyntheticdocument/index.html @@ -12,14 +12,14 @@ translation_of: Web/API/Document/mozSyntheticDocument

          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;
           

          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).

          @@ -30,6 +30,6 @@ if (isSynthetic) { }
        -

        Spécifications

        +

        Spécifications

        Ne fait partie d'aucune spécification.

        diff --git a/files/fr/web/api/document/onafterscriptexecute/index.html b/files/fr/web/api/document/onafterscriptexecute/index.html index 52494ee50e..9c3d8d138a 100644 --- a/files/fr/web/api/document/onafterscriptexecute/index.html +++ b/files/fr/web/api/document/onafterscriptexecute/index.html @@ -37,7 +37,7 @@ document.addEventListener("afterscriptexecute", finished, true);

        Spécification

        Voir aussi

        diff --git a/files/fr/web/api/document/onbeforescriptexecute/index.html b/files/fr/web/api/document/onbeforescriptexecute/index.html index f0fc8ee381..8527a38555 100644 --- a/files/fr/web/api/document/onbeforescriptexecute/index.html +++ b/files/fr/web/api/document/onbeforescriptexecute/index.html @@ -35,7 +35,7 @@ document.addEventListener("beforescriptexecute", starting, true);

        Spécification

        Voir aussi

        diff --git a/files/fr/web/api/document/onoffline/index.html b/files/fr/web/api/document/onoffline/index.html index c8bfb9026a..4e9ac673aa 100644 --- a/files/fr/web/api/document/onoffline/index.html +++ b/files/fr/web/api/document/onoffline/index.html @@ -10,4 +10,4 @@ translation_of: Web/API/Document/onoffline ---

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

        +

        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).

        diff --git a/files/fr/web/api/document/ononline/index.html b/files/fr/web/api/document/ononline/index.html index ba10ffd969..251bf34aab 100644 --- a/files/fr/web/api/document/ononline/index.html +++ b/files/fr/web/api/document/ononline/index.html @@ -16,24 +16,24 @@ translation_of: Web/API/Document/ononline

        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.

        -

        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.

        +

        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 :

          -
        • en utilisant addEventListener sur window, document ou document.body
        • +
        • en utilisant addEventListener sur window, document ou document.body
        • en définissant les propriétés .ononline ou .onoffline sur document ou document.body sur un objet  Function JavaScript. (Note : l'utilisation de window.ononline ou window.onoffline ne fonctionnera pas pour des raisons de compatibilité).
        • en spécifiant les attributs ononline="..." ou onoffline="..." sur la balise <body>  dans le balisage HTML.
        -

        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 que vous pouvez exécuter pour vérifier le fonctionnement des évènements.

        -

        Références

        +

        Références

        diff --git a/files/fr/web/api/document/open/index.html b/files/fr/web/api/document/open/index.html index bb5aba9bc3..c8da92836a 100644 --- a/files/fr/web/api/document/open/index.html +++ b/files/fr/web/api/document/open/index.html @@ -12,14 +12,14 @@ translation_of: Web/API/Document/open
         
        -

        La méthode document.open() ouvre un document pour l'écriture.

        +

        La méthode document.open() ouvre un document pour l'écriture.

        -

        Syntaxe

        +

        Syntaxe

        document.open();
         
        -

        Exemple

        +

        Exemple

        // Dans cet exemple, le contenu du document est
         // écrasé au cours de la réinitialisation avec open()
        @@ -28,15 +28,15 @@ 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).

        -

        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

        +

        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().

        +

        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.

        +

        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").

        diff --git a/files/fr/web/api/document/popupnode/index.html b/files/fr/web/api/document/popupnode/index.html index 8b6af6e137..be0b64250e 100644 --- a/files/fr/web/api/document/popupnode/index.html +++ b/files/fr/web/api/document/popupnode/index.html @@ -12,9 +12,11 @@ translation_of: Web/API/Document/popupNode ---
        {{ApiRef("DOM")}}{{deprecated_header}}
        -
        Note : À partir de {{Gecko("2.0")}}, les auteurs sont encouragés à utiliser la propriété menupopup triggerNode à la place.
        +
        +

        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.

        +

        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.

        @@ -34,7 +36,7 @@ translation_of: Web/API/Document/popupNode </menupopup>
        -

        Voir http://www.mozilla.org/xpfe/xptoolkit/popups.html

        +

        Voir http://www.mozilla.org/xpfe/xptoolkit/popups.html

        Voir aussi

        diff --git a/files/fr/web/api/document/preferredstylesheetset/index.html b/files/fr/web/api/document/preferredstylesheetset/index.html index 969a9b39b0..ab47840dd3 100644 --- a/files/fr/web/api/document/preferredstylesheetset/index.html +++ b/files/fr/web/api/document/preferredstylesheetset/index.html @@ -14,7 +14,7 @@ translation_of: Web/API/Document/preferredStyleSheetSet

        Retourne la feuille de style préférée, telle que définie par l'auteur de la page.

        -

        Syntaxe

        +

        Syntaxe

        preferredStyleSheetSet = document.preferredStyleSheetSet
         
        @@ -23,7 +23,7 @@ translation_of: Web/API/Document/preferredStyleSheetSet

        En l'absence de feuille de style préférée, une chaine vide ("") est retournée.

        -

        Exemple

        +

        Exemple

        if (document.preferredStyleSheetSet) {
           console.log("La feuille de style préférée est : " + document.preferredStyleSheetSet);
        @@ -32,13 +32,13 @@ translation_of: Web/API/Document/preferredStyleSheetSet
         }
         
        -

        Spécifications

        +

        Spécifications

        -

        Voir aussi

        +

        Voir aussi

        • {{domxref("document.lastStyleSheetSet")}}
        • diff --git a/files/fr/web/api/document/querycommandstate/index.html b/files/fr/web/api/document/querycommandstate/index.html index ee8af716d0..ca874815cb 100644 --- a/files/fr/web/api/document/querycommandstate/index.html +++ b/files/fr/web/api/document/querycommandstate/index.html @@ -44,6 +44,6 @@ translation_of: Web/API/Document/queryCommandState diff --git a/files/fr/web/api/document/querycommandsupported/index.html b/files/fr/web/api/document/querycommandsupported/index.html index 986cbd52e3..ddd356a31b 100644 --- a/files/fr/web/api/document/querycommandsupported/index.html +++ b/files/fr/web/api/document/querycommandsupported/index.html @@ -19,10 +19,9 @@ translation_of: Web/API/Document/queryCommandSupported
          isSupported = document.queryCommandSupported(command);
           
          +

          Paramètres

          +
          -
          -

          Paramètres

          -
          command
          La commande pour laquelle on veut déterminer si elle est prise en charge.
          diff --git a/files/fr/web/api/document/queryselector/index.html b/files/fr/web/api/document/queryselector/index.html index 4d25c91d2b..bb81eb32c0 100644 --- a/files/fr/web/api/document/queryselector/index.html +++ b/files/fr/web/api/document/queryselector/index.html @@ -17,10 +17,10 @@ translation_of: Web/API/Document/querySelector

          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.

          +

          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);
           
          @@ -29,7 +29,7 @@ translation_of: Web/API/Document/querySelector
          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.
          +
          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.
          @@ -38,7 +38,7 @@ translation_of: Web/API/Document/querySelector

          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.

          +

          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.

          @@ -49,13 +49,13 @@ translation_of: Web/API/Document/querySelector
          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é.

          -

          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 CSS ne retourneront jamais aucun élément, comme spécifié dans l'API des sélecteurs (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) :

          @@ -75,7 +75,7 @@ translation_of: Web/API/Document/querySelector </script>
        -

        Exemples

        +

        Exemples

        Trouver le premier élément correspondant à une classe

        @@ -83,13 +83,13 @@ translation_of: Web/API/Document/querySelector
        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 <input name="identifiant"/> dans un <div class="panneau-utilisateur principal"> dans le document est retourné :

        +

        Les sélecteurs peuvent également être réellement puissants comme le montre l'exemple suivant. Ici, le premier élément <input name="identifiant"/> dans un <div class="panneau-utilisateur principal"> dans le document est retourné :

        -
        var el = document.querySelector("div.panneau-utilisateur.principal input[name='identifiant']");
        +
        var el = document.querySelector("div.panneau-utilisateur.principal input[name='identifiant']");
        -

        Spécifications

        +

        Spécifications

        @@ -118,9 +118,9 @@ translation_of: Web/API/Document/querySelector

        Voir aussi

        diff --git a/files/fr/web/api/document/queryselectorall/index.html b/files/fr/web/api/document/queryselectorall/index.html index 6347a584c8..7b73477245 100644 --- a/files/fr/web/api/document/queryselectorall/index.html +++ b/files/fr/web/api/document/queryselectorall/index.html @@ -17,7 +17,7 @@ translation_of: Web/API/Document/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);
         
        @@ -30,7 +30,7 @@ translation_of: Web/API/Document/querySelectorAll
        -

        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

        @@ -38,7 +38,7 @@ translation_of: Web/API/Document/querySelectorAll

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

        @@ -48,7 +48,7 @@ translation_of: Web/API/Document/querySelectorAll
        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 :

        @@ -64,7 +64,7 @@ translation_of: Web/API/Document/querySelectorAll
        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é "data-src" :

        +

        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é "data-src" :

        const matches = document.querySelectorAll("iframe[data-src]");
        @@ -85,7 +85,7 @@ 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.

        diff --git a/files/fr/web/api/document/readystate/index.html b/files/fr/web/api/document/readystate/index.html index 57f7b28538..36d01f7c11 100644 --- a/files/fr/web/api/document/readystate/index.html +++ b/files/fr/web/api/document/readystate/index.html @@ -16,7 +16,7 @@ translation_of: Web/API/Document/readyState

        Syntaxe

        -
        var string = document.readyState;
        +
        var string = document.readyState;
         

        Valeurs

        @@ -32,11 +32,11 @@ translation_of: Web/API/Document/readyState
        Le document et toutes les sous-ressources ont été chargés, et {{event("load")}} a été émis.
        -

        Exemples

        +

        Exemples

        Différents états de chargement

        -
        switch (document.readyState) {
        +
        switch (document.readyState) {
           case "loading":
             // Encore en chargement.
             break;
        @@ -50,12 +50,12 @@ translation_of: Web/API/Document/readyState
             // La page est pleinement chargée.
             console.log("The first CSS rule is: " + document.styleSheets[0].cssRules[0].cssText);
             break;
        -}
        +}
         

        readystatechange comme alternative à  DOMContentLoaded

        -
        // alternative à DOMContentLoaded
        +
        // alternative à DOMContentLoaded
         document.onreadystatechange = function () {
           if (document.readyState == "interactive") {
             initApplication();
        @@ -64,7 +64,7 @@ document.onreadystatechange = function () {
         
         

        readystatechange comme alternative à load

        -
        // alternative à load
        +
        // alternative à load
         document.onreadystatechange = function () {
           if (document.readyState == "complete") {
             initApplication();
        @@ -73,7 +73,7 @@ document.onreadystatechange = function () {
         
         

        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
        +
        // Modification du document <body> dès que possible en utilisant un script externe
         var bootstrap = function(evt){
           if (evt.target.readyState === "interactive") { initLoader(); }
           else if (evt.target.readyState === "complete") { initApp(); }
        @@ -83,7 +83,7 @@ document.addEventListener('readystatechange', bootstrap, false);
         
         

        Spécifications

        -
        +
        @@ -110,12 +110,8 @@ document.addEventListener('readystatechange', bootstrap, false);

        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é.

        diff --git a/files/fr/web/api/document/readystatechange_event/index.html b/files/fr/web/api/document/readystatechange_event/index.html index 251487fc4b..95c60dae30 100644 --- a/files/fr/web/api/document/readystatechange_event/index.html +++ b/files/fr/web/api/document/readystatechange_event/index.html @@ -6,13 +6,13 @@ original_slug: Web/Events/readystatechange ---

        {{ApiRef}}

        -

        L'événement readystatechange est déclenché lorsque l'attribut readyState d'un document a changé.

        +

        L'événement readystatechange est déclenché lorsque l'attribut readyState d'un document a changé.

        Information générale

        Specification
        -
        HTML5
        +
        HTML5
        Interface
        Event
        Bubbles
        diff --git a/files/fr/web/api/document/referrer/index.html b/files/fr/web/api/document/referrer/index.html index d8699ada15..075f837b2a 100644 --- a/files/fr/web/api/document/referrer/index.html +++ b/files/fr/web/api/document/referrer/index.html @@ -10,14 +10,14 @@ translation_of: Web/API/Document/referrer ---
        {{APIRef}}
        -

        Résumé

        +

        Résumé

        Renvoie l'URI de la page de provenance.

        -

        Syntaxe

        +

        Syntaxe

        string = document.referrer;
         
        -

        Notes

        +

        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

        +

        Spécification

        diff --git a/files/fr/web/api/document/registerelement/index.html b/files/fr/web/api/document/registerelement/index.html index 352cc8b6e9..8512a48f5f 100644 --- a/files/fr/web/api/document/registerelement/index.html +++ b/files/fr/web/api/document/registerelement/index.html @@ -13,15 +13,15 @@ translation_of: Web/API/Document/registerElement

        {{APIRef("DOM")}} {{Deprecated_header}}

        -

        Warning : document.registerElement() est déprécié en faveur de customElements.define().

        +

        Attention : document.registerElement() est déprécié en faveur de customElements.define().

        {{draft}}

        -

        La méthode Document.registerElement() permet d'enregistrer un nouvel élément personnalisé dans le navigateur, et retourne un constructeur pour ce nouvel élément.

        +

        La méthode 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.

        +

        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

        @@ -32,9 +32,7 @@ translation_of: Web/API/Document/registerElement
        nom-tag
        -
        -
        Le nom de l'élément personnalisé. Le nom doit contenir un tiret (-), par exemple mon-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.
        @@ -63,5 +61,5 @@ montag.textContent = "Je suis un élément mon-tag.";

        Voir aussi

        diff --git a/files/fr/web/api/document/releasecapture/index.html b/files/fr/web/api/document/releasecapture/index.html index 8c2a9d5bc5..bb7cafb599 100644 --- a/files/fr/web/api/document/releasecapture/index.html +++ b/files/fr/web/api/document/releasecapture/index.html @@ -16,22 +16,22 @@ translation_of: Web/API/Document/releaseCapture

        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()
         

        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 pour {{domxref("element.setCapture()")}}.

        -

        Spécifications

        +

        Spécifications

        Basé sur l'implémentation Internet Explorer.

        -

        Voir aussi

        +

        Voir aussi

        • {{domxref("element.setCapture()")}}
        • diff --git a/files/fr/web/api/document/scripts/index.html b/files/fr/web/api/document/scripts/index.html index e6b957e69d..cf019c81d2 100644 --- a/files/fr/web/api/document/scripts/index.html +++ b/files/fr/web/api/document/scripts/index.html @@ -11,7 +11,7 @@ translation_of: Web/API/Document/scripts ---
          {{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

          diff --git a/files/fr/web/api/document/scroll_event/index.html b/files/fr/web/api/document/scroll_event/index.html index 8e1a13b3db..21c5ba592e 100644 --- a/files/fr/web/api/document/scroll_event/index.html +++ b/files/fr/web/api/document/scroll_event/index.html @@ -9,8 +9,9 @@ tags: - requestAnimationFrame translation_of: Web/API/Document/scroll_event --- -

          {{APIRef}}
          - L’évènement scroll (défilement) est émis lorsque l’on fait défiler le document ou un élément.

          +
          {{APIRef}}
          + +

          L’évènement scroll (défilement) est émis lorsque l’on fait défiler le document ou un élément.

          Informations générales

          @@ -39,8 +40,8 @@ translation_of: Web/API/Document/scroll_event
        Spécifications
        -
        -

        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.

        +
        +

        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

        @@ -95,7 +96,7 @@ translation_of: Web/API/Document/scroll_event

        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.

        -
        // Référence: http://www.html5rocks.com/en/tutorials/speed/animations/
        +
        // Référence: http://www.html5rocks.com/en/tutorials/speed/animations/
         
         var derniere_position_de_scroll_connue = 0;
         var ticking = false;
        diff --git a/files/fr/web/api/document/selectedstylesheetset/index.html b/files/fr/web/api/document/selectedstylesheetset/index.html
        index 8c66beecb4..270c7d8821 100644
        --- a/files/fr/web/api/document/selectedstylesheetset/index.html
        +++ b/files/fr/web/api/document/selectedstylesheetset/index.html
        @@ -13,7 +13,7 @@ translation_of: Web/API/Document/selectedStyleSheetSet
         
         

        Indique le nom du jeu de feuilles de styles actuellement utilisé.

        -

        Syntaxe

        +

        Syntaxe

        currentStyleSheetSet = document.selectedStyleSheetSet
         
        @@ -22,20 +22,24 @@ document.selectedStyleSheet = newStyleSheetSet
         
         

        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é.

        -

        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.

        +

        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.

        -
        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);
         
         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") }}
        • @@ -44,8 +48,8 @@ document.selectedStyleSheetSet = "Some other style sheet";
        • {{ domxref("document.enableStyleSheetsForSet()") }}
        -

        Spécifications

        +

        Spécifications

        diff --git a/files/fr/web/api/document/stylesheets/index.html b/files/fr/web/api/document/stylesheets/index.html index 2965e4eb43..44b8d92e15 100644 --- a/files/fr/web/api/document/stylesheets/index.html +++ b/files/fr/web/api/document/stylesheets/index.html @@ -11,7 +11,7 @@ original_slug: Web/API/DocumentOrShadowRoot/styleSheets
         
        -

        Syntaxe

        +

        Syntaxe

        var styleSheetList = document.styleSheets;
         
        @@ -20,7 +20,7 @@ original_slug: Web/API/DocumentOrShadowRoot/styleSheets

        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

        @@ -46,12 +46,12 @@ original_slug: Web/API/DocumentOrShadowRoot/styleSheets
        -

        Voir aussi

        +

        Voir aussi

        • {{Link("/en-US/docs/Web/API/CSS_Object_Model/Using_dynamic_styling_information")}}
        diff --git a/files/fr/web/api/document/stylesheetsets/index.html b/files/fr/web/api/document/stylesheetsets/index.html index 14adac7a18..f584192df8 100644 --- a/files/fr/web/api/document/stylesheetsets/index.html +++ b/files/fr/web/api/document/stylesheetsets/index.html @@ -13,14 +13,14 @@ translation_of: Web/API/Document/styleSheetSets

        Renvoie une liste active de tous les jeux de feuilles de styles actuellement disponibles.

        -

        Syntaxe

        +

        Syntaxe

        sets = document.styleSheetSets
         

        En retour, 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 :

        @@ -40,13 +40,13 @@ for (var i = 0; i < sheets.length; i++) {

        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).

        -

        Spécifications

        +

        Spécifications

        -

        Voir aussi

        +

        Voir aussi

        • {{domxref("Stylesheet")}}
        • diff --git a/files/fr/web/api/document/title/index.html b/files/fr/web/api/document/title/index.html index 98cb79bb34..003f214380 100644 --- a/files/fr/web/api/document/title/index.html +++ b/files/fr/web/api/document/title/index.html @@ -7,7 +7,7 @@ translation_of: Web/API/Document/title

          Obtient ou défini le titre de la page.

          -

          Syntaxe

          +

          Syntaxe

          var docTitle = document.title;
           
          @@ -19,7 +19,7 @@ translation_of: Web/API/Document/title

          newTitle sera le nouveau titre de la page. Le changement de titre affectera également la valeur de retour de document.title, le titre de la page dans le navigateur (généralement le nom de l'onglet dans votre navigateur), et affectera également le DOM de la page (le contenu de la balise HTML <title>).

          -

          Exemple

          +

          Exemple

          <!DOCTYPE html>
           <html>
          @@ -38,7 +38,7 @@ alert(document.title); // Affiche "Goodbye World!"
           </html>
           
          -

          Notes

          +

          Notes

          Cette propriété s'applique à HTML, SVG, XUL, et aux autres documents Gecko.

          @@ -46,9 +46,9 @@ alert(document.title); // Affiche "Goodbye World!"

          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).

          -

          Spécification

          +

          Spécification

          diff --git a/files/fr/web/api/document/tooltipnode/index.html b/files/fr/web/api/document/tooltipnode/index.html index 681797c298..13c0927cff 100644 --- a/files/fr/web/api/document/tooltipnode/index.html +++ b/files/fr/web/api/document/tooltipnode/index.html @@ -15,11 +15,11 @@ translation_of: Web/API/Document/tooltipNode

          Renvoie le noeud qui est la cible de l'actuel {{ XULElem("tooltip") }}.

          -

          Syntaxe

          +

          Syntaxe

          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") }}.

          diff --git a/files/fr/web/api/document/touchend_event/index.html b/files/fr/web/api/document/touchend_event/index.html index f31ff40c44..a12b93005e 100644 --- a/files/fr/web/api/document/touchend_event/index.html +++ b/files/fr/web/api/document/touchend_event/index.html @@ -15,7 +15,7 @@ translation_of: Web/API/Document/touchend_event
          Spécification
          -
          Touch Events
          +
          Touch Events
          Interface
          {{domxref("TouchEvent")}}
          Bubbles
          @@ -62,7 +62,7 @@ translation_of: Web/API/Document/touchend_event view {{readonlyInline}} WindowProxy - document.defaultView (window of the document) + document.defaultView (window of the document) detail {{readonlyInline}} @@ -110,7 +110,7 @@ translation_of: Web/API/Document/touchend_event

          Exemples

          -

          Des exemples d'implémentation de cet événement sont disponibles : Touch events.

          +

          Des exemples d'implémentation de cet événement sont disponibles : Touch events.

          Compatibilité des navigateurs

          diff --git a/files/fr/web/api/document/transitionend_event/index.html b/files/fr/web/api/document/transitionend_event/index.html index 7b8d5c9395..55916580ec 100644 --- a/files/fr/web/api/document/transitionend_event/index.html +++ b/files/fr/web/api/document/transitionend_event/index.html @@ -30,7 +30,7 @@ translation_of: Web/API/Document/transitionend_event

          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.

          -

          La cible originale pour cet évènement est l’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.

          +

          La cible originale pour cet évènement est l’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.

          Exemples

          @@ -40,13 +40,13 @@ translation_of: Web/API/Document/transitionend_event console.log('Transition terminée'); });
        -

        La même chose, mais en utilisant la propriété ontransitionend au lieu de addEventListener() :

        +

        La même chose, mais en utilisant la propriété ontransitionend au lieu de addEventListener() :

        document.ontransitionend = () => {
           console.log('Transition terminée');
         };
        -

        Voir un exemple en direct sur cet évènement.

        +

        Voir un exemple en direct sur cet évènement.

        Spécifications

        @@ -77,7 +77,7 @@ translation_of: Web/API/Document/transitionend_event
      • 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
      • +
      • Des évènements associés : transitionrun, transitionstart, transitioncancel
      • +
      • Cet évènement sur les cibles HTMLElement : transitionend
      • +
      • Cet évènement sur les cibles Window : transitionend
      diff --git a/files/fr/web/api/document/url/index.html b/files/fr/web/api/document/url/index.html index 32b79c706d..1b599ff794 100644 --- a/files/fr/web/api/document/url/index.html +++ b/files/fr/web/api/document/url/index.html @@ -7,17 +7,17 @@ translation_of: Web/API/Document/URL

      Retourne l'URL du {{domxref("Document")}} sous forme de string (lecture seule).

      -

      Syntaxe

      +

      Syntaxe

      var string = document.URL
       
      -

      Exemple

      +

      Exemple

      var currentURL = document.URL;
       alert(currentURL);
      -

      Specification

      +

      Specification

      • DOM Level 2 HTML: URL
      • diff --git a/files/fr/web/api/document/visibilitystate/index.html b/files/fr/web/api/document/visibilitystate/index.html index 2ff5dcc883..d8ea3d1139 100644 --- a/files/fr/web/api/document/visibilitystate/index.html +++ b/files/fr/web/api/document/visibilitystate/index.html @@ -30,10 +30,10 @@ translation_of: Web/API/Document/visibilityState

        Exemples

        -
        document.addEventListener("visibilitychange", function() {
        -  console.log( document.visibilityState );
        -  // Modifier le comportement...
        -});
        +
        document.addEventListener("visibilitychange", function() {
        +  console.log( document.visibilityState );
        +  // Modifier le comportement...
        +});

        Spécifications

        diff --git a/files/fr/web/api/document/width/index.html b/files/fr/web/api/document/width/index.html index 94c91d793d..8be64c2109 100644 --- a/files/fr/web/api/document/width/index.html +++ b/files/fr/web/api/document/width/index.html @@ -6,37 +6,37 @@ translation_of: Web/API/Document/width
        {{APIRef("DOM")}} {{Obsolete_header}}
        -

        Remarque: À 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.

        Non pris en charge par Internet Explorer.

        -

        Syntaxe

        +

        Syntaxe

        pixels = document.width;
         
        -

        Exemple

        +

        Exemple

        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 */
         
        -

        Spécification

        +

        Spécification

        HTML5

        -

        Voir également

        +

        Voir également

        • {{domxref("document.height")}}
        • diff --git a/files/fr/web/api/document/write/index.html b/files/fr/web/api/document/write/index.html index e0aec07be3..30a3d4da6b 100644 --- a/files/fr/web/api/document/write/index.html +++ b/files/fr/web/api/document/write/index.html @@ -11,13 +11,13 @@ translation_of: Web/API/Document/write ---

          {{ 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().

          -

          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, appeler document.write sur un document fermé (chargé) appelle automatiquement document.open, ce qui efface le document.

          -

          Syntaxe

          +

          Syntaxe

          document.write(balisage);
           
          @@ -29,7 +29,7 @@ translation_of: Web/API/Document/write
          est une chaîne de caractères contenant le texte à écrire dans le document.
          -

          Exemple

          +

          Exemple

          <html>
           
          @@ -55,22 +55,22 @@ document.close();
           </html>
           
          -

          Notes

          +

          Notes

          -

          Écrire dans un document qui a déjà été chargé sans appeler document.open() provoquera un appel automatique à 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ément h1 devient un nœud dans le document.

          +

          Écrire dans un document qui a déjà été chargé sans appeler document.open() provoquera un appel automatique à 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ément h1 devient un nœud dans le document.

          Si l'appel à document.write() est intégré directement dans le code HTML, il n'appellera pas document.open(). Par exemple :

          -
          <script>
          -  document.write("<h1>Main title</h1>")
          -</script>
          +
          <script>
          +  document.write("<h1>Main title</h1>")
          +</script>
          -

          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. Plus d'informations disponibles dans la   foire aux questions W3C XHTML (en).

          +

          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. Plus d'informations disponibles dans la   foire aux questions W3C XHTML (en).

          -

          Note : document.write dans les scripts deferred (différé) ou asynchronous (asynchrone) 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 to document.write() from an asynchronously-loaded external script was ignored" dans la console d'erreurs.

          @@ -78,14 +78,14 @@ document.close();
          -

          Note : À partir de la version 55, Chrome n'exécute pas les éléments <script> injectés via document.write() en cas d'échec de cache HTTP pour les utilisateurs sur une connexion 2G.

          +

          Note : À partir de la version 55, Chrome n'exécute pas les éléments <script> injectés via document.write() en cas d'échec de cache HTTP pour les utilisateurs sur une connexion 2G.

          -

          Spécification

          +

          Spécification

          Voir aussi

          diff --git a/files/fr/web/api/document/writeln/index.html b/files/fr/web/api/document/writeln/index.html index 046c069cbc..eb06d11321 100644 --- a/files/fr/web/api/document/writeln/index.html +++ b/files/fr/web/api/document/writeln/index.html @@ -12,29 +12,27 @@ translation_of: Web/API/Document/writeln

          Écrit une chaine de caractères suivie d'un retour de ligne.

          -

          Syntaxe

          +

          Syntaxe

          -
          document.writeln(ligne);
          +
          document.writeln(ligne);
           
          -

          Paramètres

          +

          Paramètres

          • ligne est la chaine de caractère contenant le texte.
          -

          Exemple

          +

          Exemple

          document.writeln("<p>Entrez votre mot de passe :</p>");
           
          -

          Notes

          +

          Notes

          document.writeln est identique à {{domxref("document.write")}}, mais ajoute une nouvelle ligne.

          -
          Note : document.writeln (comme document.write) n'a aucun effet en XHTML documents (vous obtiendrez une erreur "Operation is not supported" (NS_ERROR_DOM_NOT_SUPPORTED_ERR) dans la console). Ceci est le cas si un fichier est ouvert en local avec l'extension .xhtml ou pour tous documents utilisant le type MIME application/xhtml+xml. Pour plus d'informations, visitez W3C XHTML FAQ.
          - -

          Spécifications

          +

          Spécifications

          diff --git a/files/fr/web/api/document/xmlencoding/index.html b/files/fr/web/api/document/xmlencoding/index.html index e3b98135f1..a7236fc2f6 100644 --- a/files/fr/web/api/document/xmlencoding/index.html +++ b/files/fr/web/api/document/xmlencoding/index.html @@ -14,7 +14,9 @@ translation_of: Web/API/Document/xmlEncoding

          Renvoie le codage déterminé par la déclaration XML. Devrait être null si non précisé ou inconnu.

          -
          Warning : N'utilisez pas cet attribut ; il a été supprimé de la spécification DOM Niveau 4 et n'est plus pris en charge dans Gecko 10.0 {{ geckoRelease("10.0") }}.
          +
          +

          Attention : N'utilisez pas cet attribut ; il a été supprimé de la spécification DOM Niveau 4 et n'est plus pris en charge dans Gecko 10.0 {{ geckoRelease("10.0") }}.

          +

          Si la déclaration XML indique :

          @@ -23,13 +25,11 @@ translation_of: Web/API/Document/xmlEncoding

          ... le résultat doit être "UTF-16".

          -

          Cependant, Firefox 3.0 inclut des informations sur l'"endianness" (par exemple, UTF-16BE pour le codage "big endian") et, tandis que cette information supplémentaire est supprimée à partir de Firefox 3.1b3, Firefox 3.1b3 consulte toujours l'encodage du fichier plutôt que la déclaration XML, comme la spécification le prévoit ("Un attribut spécifiant, dans le cadre de la déclaration XML, l'encodage de ce document.").

          - -

           

          +

          Cependant, Firefox 3.0 inclut des informations sur l'"endianness" (par exemple, UTF-16BE pour le codage "big endian") et, tandis que cette information supplémentaire est supprimée à partir de Firefox 3.1b3, Firefox 3.1b3 consulte toujours l'encodage du fichier plutôt que la déclaration XML, comme la spécification le prévoit ("Un attribut spécifiant, dans le cadre de la déclaration XML, l'encodage de ce document.").

          Spécification

          diff --git a/files/fr/web/api/document/xmlversion/index.html b/files/fr/web/api/document/xmlversion/index.html index ce2a197b51..4145a61548 100644 --- a/files/fr/web/api/document/xmlversion/index.html +++ b/files/fr/web/api/document/xmlversion/index.html @@ -21,9 +21,9 @@ translation_of: Web/API/Document/xmlVersion } -

          Spécifications

          +

          Spécifications

          -- cgit v1.2.3-54-g00ecf