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/keyboardevent/charcode/index.html |  26 +-
 files/fr/web/api/keyboardevent/code/index.html     |  14 +-
 files/fr/web/api/keyboardevent/index.html          |  38 ++-
 files/fr/web/api/keyboardevent/key/index.html      | 150 +++++-----
 .../api/keyboardevent/key/key_values/index.html    | 308 ++++++++++-----------
 .../web/api/keyboardevent/keyboardevent/index.html |  46 ++-
 6 files changed, 278 insertions(+), 304 deletions(-)

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

diff --git a/files/fr/web/api/keyboardevent/charcode/index.html b/files/fr/web/api/keyboardevent/charcode/index.html
index 34335deca5..523257e055 100644
--- a/files/fr/web/api/keyboardevent/charcode/index.html
+++ b/files/fr/web/api/keyboardevent/charcode/index.html
@@ -18,12 +18,10 @@ translation_of: Web/API/KeyboardEvent/charCode
 

Pour des constantes équivalant ces codes numériques, voir {{ domxref("KeyboardEvent", "KeyEvent") }}.

-

N'utilisez plus cette propriété, elle est dépréciée.

- -

Utilisez plutôt {{domxref("KeyboardEvent.key")}}.

+

Note : N'utilisez plus cette propriété, elle est dépréciée. Utilisez plutôt {{domxref("KeyboardEvent.key")}}.

-

Syntaxe

+

Syntaxe

var value = event.charCode;
 
@@ -32,7 +30,7 @@ translation_of: Web/API/KeyboardEvent/charCode
  • value est la valeur Unicode du caractère associé à la touche pressée.
  • -

    Exemple

    +

    Exemple

    <html>
       <head>
    @@ -58,21 +56,21 @@ translation_of: Web/API/KeyboardEvent/charCode
     </html>
     
    -

    Notes

    +

    Notes

    Après un évènement {{ domxref("element.onkeypress", "keypress") }}, la valeur Unicode de la touche pressée est stockée dans l'une ou l'autre des propriétés {{ domxref("event.keyCode", "keyCode") }} et charCode, jamais les deux à la fois. Si la touche pressée génère un caractère (ex. 'a'), charCode prend la valeur du code de ce caractère, en respectant la casse. (i.e. charCode tient compte d'une touche Maj. enfoncée). Sinon, le code est stocké dans keyCode.

    -

    Quand une ou plusieurs touche modificatrices sont pressées, il y a quelques règles complexes pour charCode, jetez un oeil à Gecko Keypress Event (en anglais) pour le détail.

    +

    Quand une ou plusieurs touche modificatrices sont pressées, il y a quelques règles complexes pour charCode, jetez un oeil à Gecko Keypress Event (en anglais) pour le détail.

    charCode n'est jamais défini lors d'évènements {{ domxref("element.onkeydown", "keydown") }} et {{ domxref("element.onkeyup", "keyup") }}. Dans ces cas, keyCode is set instead.

    Pour obtenir le code de la touche qu'il soit stocké dans keyCode ou charCode, requêtez la propriété {{ domxref("event.which", "which") }}.

    -

    Les caractères entrés via IME ne s'enregistrent pas sous keyCode ou charCode. Actually with the Chinese IME I'm using, entering the IME results in a keypress event with keyCode = 229 and no other key events fire until the IME exits (which may happen after multiple characters are inputted). I'm not sure if other IME's work this way.

    +

    Les caractères entrés via IME ne s'enregistrent pas sous keyCode ou charCode. Actually with the Chinese IME I'm using, entering the IME results in a keypress event with keyCode = 229 and no other key events fire until the IME exits (which may happen after multiple characters are inputted). I'm not sure if other IME's work this way.

    -

    Pour une liste de valeurs de charCode associées à leurs touches, lancez l'exemple dans Gecko DOM Reference:Examples #Example 7: Displaying Event Object Constants (en anglais) et regardez le tableau HTML résultant.

    +

    Pour une liste de valeurs de charCode associées à leurs touches, lancez l'exemple dans Gecko DOM Reference:Examples #Example 7: Displaying Event Object Constants (en anglais) et regardez le tableau HTML résultant.

    -

    Spécifications

    +

    Spécifications

    @@ -93,10 +91,4 @@ translation_of: Web/API/KeyboardEvent/charCode

    Compatibilité des navigateurs

    - - -

    {{Compat("api.KeyboardEvent.charCode")}}

    - -
    - -
    +

    {{Compat("api.KeyboardEvent.charCode")}}

    \ No newline at end of file diff --git a/files/fr/web/api/keyboardevent/code/index.html b/files/fr/web/api/keyboardevent/code/index.html index 04ebfa99e7..d9d70d3e19 100644 --- a/files/fr/web/api/keyboardevent/code/index.html +++ b/files/fr/web/api/keyboardevent/code/index.html @@ -12,7 +12,7 @@ translation_of: Web/API/KeyboardEvent/code ---
    {{APIRef("DOM Events")}}
    -

    La propriété KeyboardEvent.code représente une touche physique du clavier (contrairement au caractère généré par celle-ci). En d'autres termes, cette propriété retourne une valeur qui n'est pas modifiée par la disposition du clavier ou l'état des touches de modification.

    +

    La propriété KeyboardEvent.code représente une touche physique du clavier (contrairement au caractère généré par celle-ci). En d'autres termes, cette propriété retourne une valeur qui n'est pas modifiée par la disposition du clavier ou l'état des touches de modification.

    Si le clavier n'est pas physique, la valeur retournée sera définie par le navigateur pour être le plus proche possible des valeurs retournées par un clavier physique afin de maximiser la compatibilité entre un clavier physique et virtuel.

    @@ -64,11 +64,9 @@ translation_of: Web/API/KeyboardEvent/code

    {{EmbedLiveSample('Pratiquer_KeyboardEvent', 600, 300) }}

    -

    Gérer les événements de clavier dans un jeu

    +

    Gérer les événements de clavier dans un jeu

    -
    -
    Cet exemple établit un écouteur d'événements pour l'événement {{event("keydown")}}  qui gère la saisie au clavier pour un jeu qui utilise la disposition de clavier typique "ZQSD" pour se déplacer en avant, à gauche, en arrière et à droite. Cela utilisera les quatre mêmes touches physiquement, quels que soient les caractères correspondants, par exemple si l'utilisateur utilise un clavier QWERTY.
    -
    +

    Cet exemple établit un écouteur d'événements pour l'événement {{event("keydown")}}  qui gère la saisie au clavier pour un jeu qui utilise la disposition de clavier typique "ZQSD" pour se déplacer en avant, à gauche, en arrière et à droite. Cela utilisera les quatre mêmes touches physiquement, quels que soient les caractères correspondants, par exemple si l'utilisateur utilise un clavier QWERTY.

    HTML

    @@ -138,7 +136,7 @@ let spaceship = document.getElementById("spaceship"); } -

    La fonction refresh() gère l'application de la rotation et de la position à l'aide d'un SVG transform.

    +

    La fonction refresh() gère l'application de la rotation et de la position à l'aide d'un SVG transform.

    function refresh() {
       let x = position.x - (shipSize.width/2);
    @@ -149,7 +147,7 @@ let spaceship = document.getElementById("spaceship");
     }
     
    -

    Enfin, la méthode addEventListener() est utilisée pour commencer à écouter les événements {{event ("keydown")}}, en mettant à jour chaque touche en mettant à jour la position et l’angle de rotation du vaisseau, puis en appelant la méthode refresh() pour tracer le navire dans sa nouvelle position et son nouvel angle.

    +

    Enfin, la méthode addEventListener() est utilisée pour commencer à écouter les événements {{event ("keydown")}}, en mettant à jour chaque touche en mettant à jour la position et l’angle de rotation du vaisseau, puis en appelant la méthode refresh() pour tracer le navire dans sa nouvelle position et son nouvel angle.

    window.addEventListener("keydown", function(event) {
       if (event.preventDefaulted) {
    @@ -191,7 +189,7 @@ let spaceship = document.getElementById("spaceship");
     
     

    {{EmbedLiveSample("Handle_keyboard_events_in_a_game", 420, 460)}}

    -

    Ce code peut être amélioré de plusieurs manières. La plupart des jeux réels surveillent les événements {{event("keydown")}}, démarrent le mouvement lorsque cela se produit et stoppent le mouvement lorsque l'événement {{event("keyup")}} se produit, au lieu de compter sur des répétitions de touches. Cela permettrait des mouvements plus fluides et plus rapides, mais permettrait également au joueur de bouger et de diriger en même temps. Des transitions ou des animations peuvent également être utilisées pour rendre le mouvement du navire plus fluide. Pour permettre cela, il ne faudrait pas utiliser de switch, ni de else if.ff

    +

    Ce code peut être amélioré de plusieurs manières. La plupart des jeux réels surveillent les événements {{event("keydown")}}, démarrent le mouvement lorsque cela se produit et stoppent le mouvement lorsque l'événement {{event("keyup")}} se produit, au lieu de compter sur des répétitions de touches. Cela permettrait des mouvements plus fluides et plus rapides, mais permettrait également au joueur de bouger et de diriger en même temps. Des transitions ou des animations peuvent également être utilisées pour rendre le mouvement du navire plus fluide. Pour permettre cela, il ne faudrait pas utiliser de switch, ni de else if.ff

    Spécifications

    diff --git a/files/fr/web/api/keyboardevent/index.html b/files/fr/web/api/keyboardevent/index.html index fe8ef03ea0..4ce7e9b411 100644 --- a/files/fr/web/api/keyboardevent/index.html +++ b/files/fr/web/api/keyboardevent/index.html @@ -14,7 +14,9 @@ translation_of: Web/API/KeyboardEvent

    Les objets KeyboardEvent décrivent l'interaction d'un utilisateur avec le clavier. Chaque événement décrit une touche ; le type d'événement (keydown, keypress, ou keyup) identifie quel type d'activité a été effectué.

    -
    Note : KeyboardEvent indique exactement ce qui est en train de se passer sur une touche. Lorsque vous devez gérer une saisie de texte, utilisez l'événement input HTML5 à la place. Par exemple, si un utilisateur saisit du texte à partir d'un système d'écriture à la main comme une tablette PC, les événements touche peuvent ne pas être déclenchés.
    +
    +

    Note : KeyboardEvent indique exactement ce qui est en train de se passer sur une touche. Lorsque vous devez gérer une saisie de texte, utilisez l'événement input HTML5 à la place. Par exemple, si un utilisateur saisit du texte à partir d'un système d'écriture à la main comme une tablette PC, les événements touche peuvent ne pas être déclenchés.

    +

    Constructeur

    @@ -44,22 +46,18 @@ translation_of: Web/API/KeyboardEvent
    {{domxref("KeyboardEvent.altKey")}} {{Readonlyinline}}
    Returne un {{jsxref("Boolean")}} qui est true si la touche Alt (Option ou  sous OS X) était active quand l'évènement touche a été généré.
    {{domxref("KeyboardEvent.char")}} {{Non-standard_inline}}{{Deprecated_inline}}{{Readonlyinline}}
    -
    Renvoie une {{domxref("DOMString")}} représentant la valeur de caractère de la touche. Si la touche correspond à un caractère imprimable, cette valeur est une chaîne Unicode non vide contenant ce caractère. Si la touche n'a pas de représentation imprimable, il s'agit d'une chaîne vide.
    -
    +

    Renvoie une {{domxref("DOMString")}} représentant la valeur de caractère de la touche. Si la touche correspond à un caractère imprimable, cette valeur est une chaîne Unicode non vide contenant ce caractère. Si la touche n'a pas de représentation imprimable, il s'agit d'une chaîne vide.

    Note : si la touche est utilisée comme une macro insérant plusieurs caractères, la valeur de cet attribut est la chaîne entière, pas seulement le premier caractère.

    -
    -
    -

    Avertissement : cela a été supprimé des DOM Level 3 Events. C'est pris en charge uniquement sur IE9 + et Microsoft Edge.

    +

    Attention : cela a été supprimé des DOM Level 3 Events. C'est pris en charge uniquement sur IE9 + et Microsoft Edge.

    {{domxref("KeyboardEvent.charCode")}} {{Deprecated_inline}}{{Readonlyinline}}
    -
    Retourne un {{jsxref ("Number")}} représentant le numéro de référence Unicode de la touche ; cet attribut est utilisé uniquement par l'événement keypress. Pour les touches dont l'attribut char contient plusieurs caractères, il s'agit de la valeur Unicode du premier caractère de cet attribut. Dans Firefox 26, cela retourne des codes pour les caractères imprimables.
    -
    +

    Retourne un {{jsxref ("Number")}} représentant le numéro de référence Unicode de la touche ; cet attribut est utilisé uniquement par l'événement keypress. Pour les touches dont l'attribut char contient plusieurs caractères, il s'agit de la valeur Unicode du premier caractère de cet attribut. Dans Firefox 26, cela retourne des codes pour les caractères imprimables.

    -

    Avertissement : cet attribut est obsolète : vous devriez utiliser {{domxref("KeyboardEvent.key")}} à la place, si disponible.

    +

    Attention : cet attribut est obsolète : vous devriez utiliser {{domxref("KeyboardEvent.key")}} à la place, si disponible.

    {{domxref("KeyboardEvent.code")}} {{Readonlyinline}}
    @@ -71,18 +69,18 @@ translation_of: Web/API/KeyboardEvent
    {{domxref("KeyboardEvent.key")}} {{Readonlyinline}}
    Retourne une {{domxref ("DOMString")}} représentant la valeur de touche de la touche représentée par l'événement.
    {{domxref("KeyboardEvent.keyCode")}} {{deprecated_inline}}{{Readonlyinline}}
    -
    Retourne un {{jsxref("Number")}} représentant un code numérique dépendant du système et de l'implémentation, identifiant la valeur non modifiée de la touche pressée. -
    Avertissement : cet attribut est obsolète. vous devriez utiliser {{domxref("KeyboardEvent.key")}} à la place, si disponible.
    +

    Retourne un {{jsxref("Number")}} représentant un code numérique dépendant du système et de l'implémentation, identifiant la valeur non modifiée de la touche pressée.

    +

    Attention : cet attribut est obsolète. vous devriez utiliser {{domxref("KeyboardEvent.key")}} à la place, si disponible.

    {{domxref("KeyboardEvent.keyIdentifier")}} {{Non-standard_inline}}{{deprecated_inline}}{{Readonlyinline}}
    Cette propriété n'est pas standard et a été abandonnée en faveur de {{domxref("KeyboardEvent.key")}}. Elle faisait partie d'une ancienne version de DOM Level 3 Events.
    {{domxref("KeyboardEvent.keyLocation")}} {{Non-standard_inline}}{{deprecated_inline}}{{Readonlyinline}}
    C'est un alias obsolète non standard pour {{domxref("KeyboardEvent.location")}}. Il faisait partie d'une ancienne version de DOM Level 3 Events.
    {{domxref("KeyboardEvent.locale")}} {{Readonlyinline}}
    -
    Retourne une {{domxref("DOMString")}} représentant une chaîne de paramètres régionaux indiquant les paramètres régionaux pour lesquels le clavier est configuré. Cela peut être une chaîne vide si le navigateur ou l'appareil ne connaît pas les paramètres régionaux du clavier. -
    Note : cela ne décrit pas les paramètres régionaux des données entrées. Un utilisateur peut utiliser une disposition du clavier donnée, tout en saisissant du texte dans une autre langue.
    +

    Retourne une {{domxref("DOMString")}} représentant une chaîne de paramètres régionaux indiquant les paramètres régionaux pour lesquels le clavier est configuré. Cela peut être une chaîne vide si le navigateur ou l'appareil ne connaît pas les paramètres régionaux du clavier.

    +

    Note : cela ne décrit pas les paramètres régionaux des données entrées. Un utilisateur peut utiliser une disposition du clavier donnée, tout en saisissant du texte dans une autre langue.

    -
    {{domxref("KeyboardEvent.location")}} {{Readonlyinline}}
    +
    {{domxref("KeyboardEvent.location")}}{{Readonlyinline}}
    Retourne un {{jsxref ("Number")}} représentant l'emplacement de la touche du clavier ou tout autre dispositif d'entrée.
    {{domxref("KeyboardEvent.metaKey")}} {{Readonlyinline}}
    Retourne un {{jsxref("Boolean")}} qui est true si la touche Meta (sur les claviers Mac, la touche ⌘ Command ; sur les claviers Windows, la touche Windows ()) était active quand l'évènement touche a été généré.
    @@ -91,8 +89,8 @@ translation_of: Web/API/KeyboardEvent
    {{domxref("KeyboardEvent.shiftKey")}} {{Readonlyinline}}
    Retourne un {{jsxref("Boolean")}} qui est true si la touche Shift était active quand l'évènement touche a été généré.
    {{domxref("KeyboardEvent.which")}} {{deprecated_inline}}{{Readonlyinline}}
    -
    Retourne un {{jsxref("Number")}} représentant un code numérique dépendant du système et de l'implémentation, identifiant la valeur non modifiée de la touche pressée ; c'est généralement le même que keyCode. -
    Avertissement : cet attribut est obsolète ; vous devriez utiliser {{domxref("KeyboardEvent.key")}} à la place, si disponible.
    +

    Retourne un {{jsxref("Number")}} représentant un code numérique dépendant du système et de l'implémentation, identifiant la valeur non modifiée de la touche pressée ; c'est généralement le même que keyCode.

    +

    Attention : cet attribut est obsolète ; vous devriez utiliser {{domxref("KeyboardEvent.key")}} à la place, si disponible.

    @@ -111,15 +109,13 @@ translation_of: Web/API/KeyboardEvent

    Certaines touches inversent l'état d'un voyant lumineux ; celles-ci comprennent des touches telles que Caps Lock, Num Lock et Scroll Lock. Sous Windows et Linux, ces touches génèrent uniquement les événements keydown et keyup.

    -

    Sous Linux, Firefox 12 et les versions antérieures ont également envoyé l'événement keypress pour ces touches.

    +

    Note : Sous Linux, Firefox 12 et les versions antérieures ont également envoyé l'événement keypress pour ces touches.

    Cependant, une limitation du modèle d'événement Mac OS X fait que Caps Lock ne génère que l'événement keydown. Num Lock était supporté sur certains modèles d'ordinateurs portables plus anciens (modèles 2007 et plus anciens), mais depuis lors, Mac OS X n'a pas supporté Num Lock même sur les claviers externes. Sur les MacBooks plus anciens avec une touche Num Lock, cette touche ne génère aucun événement touche. Gecko supporte la touche Scroll Lock si un clavier externe ayant une touche F14 est connecté. Dans certaines anciennes versions de Firefox, cette touche générait un événement keypress ; ce comportement incohérent était le {{bug(602812)}}.

    Gestion de l'auto-répétition

    -

     

    -

    Lorsqu'une touche est maintenue enfoncée, elle commence à se répéter automatiquement. Cela a pour résultat qu'une suite d'événements similaire à ce qui suit est générée :

      @@ -165,7 +161,9 @@ translation_of: Web/API/KeyboardEvent
      Le comportement de l'événement dépend de la plate-forme particulière. Il se comportera comme Windows ou Mac suivant ce que fait le modèle d'événement natif.
      -

      Note : le déclenchement manuel d'un événement ne génère pas l'action par défaut associée à cet événement. Par exemple, le déclenchement manuel d'un événement touche n'entraîne pas l'apparition de cette lettre dans une zone de saisie de texte ayant la focalisation. Dans le cas des événements de l'interface utilisateur, cela est important pour des raisons de sécurité, car cela empêche les scripts de simuler les actions de l'utilisateur interagissant avec le navigateur lui-même.

      +
      +

      Note : le déclenchement manuel d'un événement ne génère pas l'action par défaut associée à cet événement. Par exemple, le déclenchement manuel d'un événement touche n'entraîne pas l'apparition de cette lettre dans une zone de saisie de texte ayant la focalisation. Dans le cas des événements de l'interface utilisateur, cela est important pour des raisons de sécurité, car cela empêche les scripts de simuler les actions de l'utilisateur interagissant avec le navigateur lui-même.

      +

      Exemple

      diff --git a/files/fr/web/api/keyboardevent/key/index.html b/files/fr/web/api/keyboardevent/key/index.html index cf51e90dc4..bfd9846960 100644 --- a/files/fr/web/api/keyboardevent/key/index.html +++ b/files/fr/web/api/keyboardevent/key/index.html @@ -15,11 +15,9 @@ translation_of: Web/API/KeyboardEvent/key

      La propriété en lecture seule de key de l'interface {{domxref("KeyboardEvent")}} retourne la valeur d’une ou plusieurs touches pressées par l’utilisateur, tout en tenant compte de l'état des touches de modification telles que la touche Shift (majuscules) ainsi que les paramètres régionaux des clavier et mise en page. Ce peut être l’une des valeurs suivantes :

      -

      Valeurs des touches

      -

      Voir une liste complète des valeurs de touches

      -
      +

      Voir une liste complète des valeurs de touches

      • @@ -56,83 +54,83 @@ translation_of: Web/API/KeyboardEvent/key

        HTML

        -
        <div class="fx">
        -  <div>
        -    <textarea rows="5" name="test-target" id="test-target"></textarea>
        -    <button type="button" name="btn-clear-console" id="btn-clear-console">clear console</button>
        -  </div>
        -  <div class="flex">
        -    <div id="console-log"></div>
        -  </div>
        -</div>
        +
        <div class="fx">
        +  <div>
        +    <textarea rows="5" name="test-target" id="test-target"></textarea>
        +    <button type="button" name="btn-clear-console" id="btn-clear-console">clear console</button>
        +  </div>
        +  <div class="flex">
        +    <div id="console-log"></div>
        +  </div>
        +</div>

        CSS

        -
        .fx {
        -  -webkit-display: flex;
        -  display: flex;
        -  margin-left: -20px;
        -  margin-right: -20px;
        -}
        -
        -.fx > div {
        -  padding-left: 20px;
        -  padding-right: 20px;
        -}
        -
        -.fx > div:first-child {
        -   width: 30%;
        -}
        -
        -.flex {
        -  -webkit-flex: 1;
        -  flex: 1;
        -}
        -
        -#test-target {
        -  display: block;
        -  width: 100%;
        -  margin-bottom: 10px;
        -}
        +
        .fx {
        +  -webkit-display: flex;
        +  display: flex;
        +  margin-left: -20px;
        +  margin-right: -20px;
        +}
        +
        +.fx > div {
        +  padding-left: 20px;
        +  padding-right: 20px;
        +}
        +
        +.fx > div:first-child {
        +   width: 30%;
        +}
        +
        +.flex {
        +  -webkit-flex: 1;
        +  flex: 1;
        +}
        +
        +#test-target {
        +  display: block;
        +  width: 100%;
        +  margin-bottom: 10px;
        +}

        JavaScript

        -
        let textarea = document.getElementById('test-target'),
        -consoleLog = document.getElementById('console-log'),
        -btnClearConsole = document.getElementById('btn-clear-console');
        +
        let textarea = document.getElementById('test-target'),
        +consoleLog = document.getElementById('console-log'),
        +btnClearConsole = document.getElementById('btn-clear-console');
         
        -function logMessage(message) {
        -  let p = document.createElement('p');
        -  p.appendChild(document.createTextNode(message));
        -  consoleLog.appendChild(p);
        -}
        +function logMessage(message) {
        +  let p = document.createElement('p');
        +  p.appendChild(document.createTextNode(message));
        +  consoleLog.appendChild(p);
        +}
         
        -textarea.addEventListener('keydown', (e) => {
        -  if (!e.repeat)
        -    logMessage(`first keydown event. key property value is "${e.key}"`);
        +textarea.addEventListener('keydown', (e) => {
        +  if (!e.repeat)
        +    logMessage(`first keydown event. key property value is "${e.key}"`);
           else
        -    logMessage(`keydown event repeats. key property value is "${e.key}"`);
        -});
        -
        -textarea.addEventListener('beforeinput', (e) => {
        -  logMessage(`beforeinput event. you are about inputing "${e.data}"`);
        -});
        -
        -textarea.addEventListener('input', (e) => {
        -  logMessage(`input event. you have just inputed "${e.data}"`);
        -});
        -
        -textarea.addEventListener('keyup', (e) => {
        -  logMessage(`keyup event. key property value is "${e.key}"`);
        -});
        -
        -btnClearConsole.addEventListener('click', (e) => {
        -  let child = consoleLog.firstChild;
        -  while (child) {
        -   consoleLog.removeChild(child);
        -   child = consoleLog.firstChild;
        -  }
        -});
        + logMessage(`keydown event repeats. key property value is "${e.key}"`); +}); + +textarea.addEventListener('beforeinput', (e) => { + logMessage(`beforeinput event. you are about inputing "${e.data}"`); +}); + +textarea.addEventListener('input', (e) => { + logMessage(`input event. you have just inputed "${e.data}"`); +}); + +textarea.addEventListener('keyup', (e) => { + logMessage(`keyup event. key property value is "${e.key}"`); +}); + +btnClearConsole.addEventListener('click', (e) => { + let child = consoleLog.firstChild; + while (child) { + consoleLog.removeChild(child); + child = consoleLog.firstChild; + } +});

        Résultat

        @@ -164,7 +162,7 @@ btnClearConsole.Exemple -

        Cet exemple utilise {{domxref("EventTarget.addEventListener()")}} pour écouter les événements {{domxref("Element/keydown_event", "keydown")}} . Quand ils se produisent, la valeur de la touche est vérifiée pour voir si c'est l'une des touches qui intéressent le code, et si c'est le cas, elle est traitée (éventuellement en pilotant un vaisseau spatial, peut-être en changeant la cellule sélectionnée dans une feuille de calcul).

        +

        Cet exemple utilise {{domxref("EventTarget.addEventListener()")}} pour écouter les événements {{domxref("Element/keydown_event", "keydown")}} . Quand ils se produisent, la valeur de la touche est vérifiée pour voir si c'est l'une des touches qui intéressent le code, et si c'est le cas, elle est traitée (éventuellement en pilotant un vaisseau spatial, peut-être en changeant la cellule sélectionnée dans une feuille de calcul).

        window.addEventListener("keydown", function (event) {
           if (event.defaultPrevented) {
        @@ -218,10 +216,4 @@ btnClearConsole.Compatibilité des navigateurs
         
        -
        -
        -

        {{Compat("api.KeyboardEvent.key")}}

        - -
        - -
        +

        {{Compat("api.KeyboardEvent.key")}}

        \ No newline at end of file diff --git a/files/fr/web/api/keyboardevent/key/key_values/index.html b/files/fr/web/api/keyboardevent/key/key_values/index.html index a61f42654e..07c8ba499c 100644 --- a/files/fr/web/api/keyboardevent/key/key_values/index.html +++ b/files/fr/web/api/keyboardevent/key/key_values/index.html @@ -5,9 +5,7 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values ---

        Les tableaux ci-dessous énumèrent les valeurs clés standard dans différentes catégories de clés, avec une explication de l'utilisation habituelle de la clé. Les codes de clés virtuels correspondants pour les plateformes communes sont inclus lorsqu'ils sont disponibles.

        -
        -
        Apprenez à utiliser ces valeurs clés en JavaScript en utilisant KeyboardEvent.key
        -
        +

        Apprenez à utiliser ces valeurs clés en JavaScript en utilisant KeyboardEvent.key

        Special Values | Modifier Keys | Whitespace Keys | Navigation Keys | Editing Keys | UI Keys | Device Keys | IME and Composition Keys | Function Keys | Phone Keys | Multimedia Keys | Audio Control Keys | TV Control Keys | Media Controller Keys | Speech Recognition Keys | Document Keys | Application Selector Keys | Browser Control Keys | Numeric Keypad Keys

        @@ -18,15 +16,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    - - - + + + - - - - + + + + @@ -48,15 +46,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValeurDescriptionCode clé virtuelKeyboardEvent.key ValeurDescriptionCode clé virtuel
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    - - - + + + - - - - + + + + @@ -228,15 +226,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "Alt" [5]
    - - - + + + - - - - + + + + @@ -290,15 +288,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    - - - + + + - - - - + + + + @@ -392,15 +390,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    - - - + + + - - - - + + + + @@ -526,15 +524,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    - - - + + + - - - - + + + + @@ -625,7 +623,7 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values @@ -637,7 +635,7 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values @@ -699,15 +697,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "Pause" The Pause key. Pauses the current application or state, if applicable. -
    This shouldn't be confused with the "MediaPause" key value, which is used for media controllers, rather than to control applications and processes.
    +

    Note : This shouldn't be confused with the "MediaPause" key value, which is used for media controllers, rather than to control applications and processes.

    VK_PAUSE (0x13)
    "Play" The Play key. Resumes a previously paused application, if applicable. -
    This shouldn't be confused with the "MediaPlay" key value, which is used for media controllers, rather than to control applications and processes.
    +

    Note : This shouldn't be confused with the "MediaPlay" key value, which is used for media controllers, rather than to control applications and processes.

    VK_PLAY (0xFA)
    - - - + + + - - - - + + + + @@ -750,7 +748,7 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values @@ -829,15 +827,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "Power" The Power button or key, to toggle power on and off. -
    Not all systems pass this key through to to the user agent.
    +

    Note : Not all systems pass this key through to to the user agent.

    - - - + + + - - - - + + + + @@ -1010,15 +1008,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    - - - + + + - - - - + + + + @@ -1059,15 +1057,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "HangulMode"
    - - - + + + - - - - + + + + @@ -1463,15 +1461,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "Eisu" [1]
    - - - + + + - - - - + + + + @@ -1699,15 +1697,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key valueDescriptionVirtual KeycodeKeyboardEvent.key valueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "F1"
    - - - + + + - - - - + + + + @@ -1817,15 +1815,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "AppSwitch"
    - - - + + + - - - - + + + + @@ -1940,15 +1938,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "ChannelDown"
    - - - + + + - - - - + + + + @@ -2121,15 +2119,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "AudioBalanceLeft"
    - - - + + + - - - - + + + + @@ -2392,21 +2390,21 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    -

    Remote controls typically include keys whose values are already defined elsewhere, such as under {{anch("Multimedia keys")}} or {{anch("Audio control keys")}}. Those keys' values will match what's documented in those tables.

    +

    Note : Remote controls typically include keys whose values are already defined elsewhere, such as under {{anch("Multimedia keys")}} or {{anch("Audio control keys")}}. Those keys' values will match what's documented in those tables.

    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "TV" [1]
    - - - + + + - - - - + + + + @@ -3002,15 +3000,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "AVRInput" [3]
    - - - + + + - - - - + + + + @@ -3042,15 +3040,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "SpeechCorrectionList" [1]
    - - - + + + - - - - + + + + @@ -3145,15 +3143,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "Close" [1]
    - - - + + + - - - - + + + + @@ -3441,15 +3439,15 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values
    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "LaunchCalculator" [5]
    - - - + + + - - - - + + + + @@ -3532,21 +3530,21 @@ translation_of: Web/API/KeyboardEvent/key/Key_Values

    These keys are found on the keyboard's numeric keypad. However, not all are present on every keyboard. Although typical numeric keypads have numeric keys from 0 to 9 (encoded as "0" through "9"), some multimedia keyboards include additional number keys for higher numbers.

    -

    The 10 key, if present, generates events with the key value of "0".

    +

    Note :The 10 key, if present, generates events with the key value of "0".

    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "BrowserBack"
    - - - + + + - - - - + + + + diff --git a/files/fr/web/api/keyboardevent/keyboardevent/index.html b/files/fr/web/api/keyboardevent/keyboardevent/index.html index 2f63832ae4..f488108a15 100644 --- a/files/fr/web/api/keyboardevent/keyboardevent/index.html +++ b/files/fr/web/api/keyboardevent/keyboardevent/index.html @@ -15,41 +15,37 @@ translation_of: Web/API/KeyboardEvent/KeyboardEvent

    Syntaxe

    -
     event = new KeyboardEvent(typeArg, KeyboardEventInit);
    +
     event = new KeyboardEvent(typeArg, KeyboardEventInit);

    Valeurs

    -
    typeArg
    +
    typeArg
    Une représentation du nom de l'évènement sous forme de {{domxref("DOMString")}}.
    -
    KeyboardEventInit{{optional_inline}}
    -
    - -
    -
    Un dictionnaire KeyboardEventInit ayant les champs suivants : - +
    KeyboardEventInit{{optional_inline}}
    +

    Un dictionnaire KeyboardEventInit ayant les champs suivants :

      -
    • "key", optionnel et par défaut "", de type {{domxref("DOMString")}}, qui définit la valeur de {{domxref("KeyboardEvent.key")}}.
    • -
    • "code", optionnel et par défaut "", de type {{domxref("DOMString")}}, qui définit la valeur de {{domxref("KeyboardEvent.code")}}.
    • -
    • "location", optionnel et par défaut 0, de type unsigned long, qui définit la valeur de {{domxref("KeyboardEvent.location")}}.
    • -
    • "ctrlKey", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.ctrlKey")}}.
    • -
    • "shiftKey", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.shiftKey")}}.
    • -
    • "altKey", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.altKey")}}.
    • -
    • "metaKey", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.metaKey")}}.
    • -
    • "repeat", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.repeat")}}.
    • -
    • "isComposing", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.isComposing")}}.
    • -
    • "charCode", optionnel et par défaut 0, de type unsigned long, qui définit la valeur du déprécié {{domxref("KeyboardEvent.charCode")}}.
    • -
    • "keyCode", optionnel et par défaut 0, de type unsigned long, qui définit la valeur du déprécié {{domxref("KeyboardEvent.keyCode")}}.
    • -
    • "which", optionnel et par défaut 0, de type unsigned long, qui définit la valeur du déprécié {{domxref("KeyboardEvent.which")}}.
    • +
    • "key", optionnel et par défaut "", de type {{domxref("DOMString")}}, qui définit la valeur de {{domxref("KeyboardEvent.key")}}.
    • +
    • "code", optionnel et par défaut "", de type {{domxref("DOMString")}}, qui définit la valeur de {{domxref("KeyboardEvent.code")}}.
    • +
    • "location", optionnel et par défaut 0, de type unsigned long, qui définit la valeur de {{domxref("KeyboardEvent.location")}}.
    • +
    • "ctrlKey", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.ctrlKey")}}.
    • +
    • "shiftKey", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.shiftKey")}}.
    • +
    • "altKey", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.altKey")}}.
    • +
    • "metaKey", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.metaKey")}}.
    • +
    • "repeat", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.repeat")}}.
    • +
    • "isComposing", optionnel et par défaut false, de type {{jsxref("Boolean")}}, qui définit la valeur de {{domxref("KeyboardEvent.isComposing")}}.
    • +
    • "charCode", optionnel et par défaut 0, de type unsigned long, qui définit la valeur du déprécié {{domxref("KeyboardEvent.charCode")}}.
    • +
    • "keyCode", optionnel et par défaut 0, de type unsigned long, qui définit la valeur du déprécié {{domxref("KeyboardEvent.keyCode")}}.
    • +
    • "which", optionnel et par défaut 0, de type unsigned long, qui définit la valeur du déprécié {{domxref("KeyboardEvent.which")}}.
    - -
    -

    Le dictionnaire KeyboardEventInit accepte aussi les champs des dictionnaires  {{domxref("UIEvent.UIEvent", "UIEventInit")}} et {{domxref("Event.Event", "EventInit")}}.

    -
    -

    Spécifications

    +
    +

    Note : Le dictionnaire KeyboardEventInit accepte aussi les champs des dictionnaires {{domxref("UIEvent.UIEvent", "UIEventInit")}} et {{domxref("Event.Event", "EventInit")}}.

    +
    + +

    Spécifications

    KeyboardEvent.key ValueDescriptionVirtual KeycodeKeyboardEvent.key ValueDescriptionVirtual Keycode
    WindowsMacLinuxAndroidWindowsMacLinuxAndroid
    "Decimal" [1] {{obsolete_inline}}
    -- cgit v1.2.3-54-g00ecf