diff options
Diffstat (limited to 'files/fr/web/api/document/keypress_event/index.html')
| -rw-r--r-- | files/fr/web/api/document/keypress_event/index.html | 102 |
1 files changed, 102 insertions, 0 deletions
diff --git a/files/fr/web/api/document/keypress_event/index.html b/files/fr/web/api/document/keypress_event/index.html new file mode 100644 index 0000000000..e0560ef1df --- /dev/null +++ b/files/fr/web/api/document/keypress_event/index.html @@ -0,0 +1,102 @@ +--- +title: keypress +slug: Web/API/Document/keypress_event +tags: + - DOM + - Déprécié + - Evènement + - KeyboardEvent + - Reference +translation_of: Web/API/Document/keypress_event +--- +<div>{{APIRef}} {{deprecated_header}}</div> + +<p><span class="seoSummary">L'évènement <strong><code>keypress</code></strong> est déclenché lorsqu'une touche produisant un caractère est pressée.</span> Cela concerne les touches qui produisent des caractères alphabétiques, des caractères numériques et des signes de ponctuations. Les touches <kbd>Alt</kbd>, <kbd>Shift</kbd>, <kbd>Ctrl</kbd> ou <kbd>Meta</kbd> ne sont pas concernées.</p> + +<div class="blockIndicator warning"> +<p><strong>Attention !</strong> Cet évènement est déprécié et il faudrait plutôt utiliser <code><a href="/fr/docs/Web/API/HTMLElement/beforeinput_event">beforeinput</a></code> ou <code><a href="/fr/docs/Web/API/Document/keydown_event">keydown</a></code>.</p> +</div> + +<table class="properties"> + <thead> + </thead> + <tbody> + <tr> + <th>Interface</th> + <td>{{domxref("KeyboardEvent")}}</td> + </tr> + <tr> + <th>Remonte sur les parents (<em>bubbles</em>)</th> + <td>Oui</td> + </tr> + <tr> + <th>Annulable</th> + <td>Oui</td> + </tr> + <tr> + <th>Action par défaut</th> + <td>Cela peut varier : évènement <code>keypress</code> ; ouverture du système de composition du texte ; évènements <code><a href="/fr/docs/Web/API/Element/blur_event">blur</a></code> et <code><a href="/fr/docs/Web/API/Element/focus_event">focus</a></code> ; évènement <a href="/fr/docs/Web/API/Element/DOMActivate_event"><code>DOMActivate</code> </a>{{deprecated_inline}}; autre évènement.</td> + </tr> + </tbody> +</table> + +<h2 id="Exemples">Exemples</h2> + +<h3 id="Ajout_d'un_addEventListener">Ajout d'un <code>addEventListener</code></h3> + +<p>Dans cet exemple, on affiche la valeur de {{domxref("KeyboardEvent.code")}} lorsqu'on appuie sur une touche :</p> + +<pre class="brush: html"><p> + Cliquez dans l'iframe pour lui passer le focus + puis appuyez sur des touches du clavier. +</p> +<p id="log"></p></pre> + +<pre class="brush: js">const log = document.getElementById('log'); + +document.addEventListener('keypress', logKey); + +function logKey(e) { + log.textContent += ` ${e.code}`; +}</pre> + +<p>{{EmbedLiveSample("addEventListener_keypress_example")}}</p> + +<h3 id="Équivalent_onkeypress">Équivalent <code>onkeypress</code></h3> + +<pre class="brush: js">document.onkeypress = logKey;</pre> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">État</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('UI Events', '#event-type-keypress')}}</td> + <td>{{Spec2('UI Events')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.Document.keypress_event")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{domxref("GlobalEventHandlers.onkeypress")}}</li> + <li>L'interface {{domxref("Element")}} que cet évènement cible</li> + <li>Les évènements associés : + <ul> + <li><code><a href="/fr/docs/Web/API/Document/keydown_event">keydown</a></code></li> + <li><code><a href="/fr/docs/Web/API/Document/keyup_event">keyup</a></code></li> + <li><code><a href="/fr/docs/Web/API/HTMLElement/beforeinput_event">beforeinput</a></code></li> + </ul> + </li> +</ul> |
