-
Notifications
You must be signed in to change notification settings - Fork 8.1k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Remove macro and update pages * minor updates, typo/code fixes and nitpicking Co-authored-by: cw118 <[email protected]>
- Loading branch information
1 parent
8ef1b44
commit b03363e
Showing
3 changed files
with
277 additions
and
187 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,59 +1,61 @@ | ||
--- | ||
title: element.click | ||
title: HTMLElement.click() | ||
slug: Web/API/HTMLElement/click | ||
tags: | ||
- DOM | ||
- Référence_du_DOM_Gecko | ||
translation_of: Web/API/HTMLElement/click | ||
browser-compat: api.HTMLElement.click | ||
--- | ||
{{ ApiRef() }} | ||
{{APIRef("HTML DOM")}} | ||
|
||
## Résumé | ||
La méthode **`HTMLElement.click()`** simule un clic de souris sur un élément. | ||
|
||
La méthode **click** simule un clic sur un élément. | ||
Lorsque `click()` est appelée sur les éléments qui la prenne en charge (par exemple un élément [`<input>`](/fr/docs/Web/HTML/Element/Input)), elle déclenche l'évènement `click` de cet élément. L'évènement remonte alors vers les éléments situés plus haut dans l'arbre du document (ou le long de la chaîne d'évènement) et déclenche leurs évènements `click` respectifs. | ||
|
||
## Syntaxe | ||
|
||
element.click() | ||
```js | ||
click() | ||
``` | ||
|
||
## Notes | ||
### Paramètres | ||
|
||
Lorsque la méthode `click` est utilisée sur des éléments où elle est gérée (par exemple un {{HTMLElement("input")}}), elle déclenche également l'évènement `click` de l'élément qui se propagera aux éléments situés plus haut dans l'arbre du document (ou la chaîne évènementielle) et déclenchera aussi leurs évènements `click`. Cependant, la propagation d'un évènement `click` ne déclenchera pas la navigation à partir d'un élément {{HTMLElement("a")}} comme si un vrai clic de souris avait été reçu. | ||
Aucun. | ||
|
||
Au moment où sont écrites ces lignes (Opera Next est à la version 12.11), la méthode `click` d'Opera **sera ignorée silencieusement**, si executée sur un élément {{HTMLElement("input")}} avec un type "file", et une propriété [CSS](/fr/docs/CSS) {{cssxref('display')}} à "none". | ||
### Valeur de retour | ||
|
||
{{gecko_callout_heading("5.0")}} | ||
Aucune ([`undefined`](/fr/docs/Web/JavaScript/Reference/Global_Objects/undefined)). | ||
|
||
Avant Gecko 5.0 {{geckoRelease("5.0")}}, Gecko supportait la méthode `click` qu'avec des éléments {{HTMLElement("input")}} de type | ||
_button_ | ||
, | ||
_checkbox_ | ||
, | ||
_radio_ | ||
, | ||
_reset_ | ||
ou | ||
_submit_ | ||
. Gecko n'implémentait pas la méthode `click` sur d'autres éléments qui auraient pu répondre à des clics de souris comme les liens (éléments {{HTMLElement("a")}}), et ne déclenchait pas nécessairement l'évènement click d'autres éléments. | ||
## Exemples | ||
|
||
Cependant, maintenant Gecko supporte la méthode sur tous les éléments comme requis par [HTML5](/fr/docs/HTML/HTML5). | ||
Dans cet exemple, on simule un clic de souris lorsque le pointeur de la souris survole une case à cocher : | ||
|
||
D'autres implémentations du DOM peuvent se comporter différemment. | ||
### HTML | ||
|
||
```html | ||
<form> | ||
<input type="checkbox" id="maCaseACocher" onmouseover="maFonction()" onclick="console.log('un évènement click a eu lieu')"> | ||
</form> | ||
``` | ||
|
||
### JavaScript | ||
|
||
```js | ||
// Lorsque l'évènement mouseover est déclenché, exécuter maFonction | ||
function maFonction() { | ||
document.getElementById('maCaseACocher').click(); | ||
} | ||
``` | ||
|
||
## Spécifications | ||
|
||
| Spécification | Statut | Commentaires | | ||
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------ | | ||
| {{SpecName('DOM2 HTML', 'html.html#ID-2651361')}} — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2/html/html.html#ID-2651361) (non normative) | {{Spec2('DOM2 HTML')}} | | | ||
{{Specifications}} | ||
|
||
## Compatibilité des navigateurs | ||
|
||
p>{{Compat("api.HTMLElement.click")}} | ||
{{Compat}} | ||
|
||
## Voir aussi | ||
|
||
- Gestionnaires d'événements liés | ||
|
||
- {{domxref("GlobalEventHandlers.onclick")}} | ||
- {{domxref("GlobalEventHandlers.ondblclick")}} | ||
- {{domxref("GlobalEventHandlers.onauxclick")}} | ||
- Les gestionnaires d'évènements associés : | ||
- [`GlobalEventHandlers.onclick`](/fr/docs/Web/API/GlobalEventHandlers/onclick) | ||
- [`GlobalEventHandlers.ondblclick`](/fr/docs/Web/API/GlobalEventHandlers/ondblclick) | ||
- [`GlobalEventHandlers.onauxclick`](/fr/docs/Web/API/GlobalEventHandlers/onauxclick) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,50 +1,51 @@ | ||
--- | ||
title: element.dir | ||
title: HTMLElement.dir | ||
slug: Web/API/HTMLElement/dir | ||
tags: | ||
- DOM | ||
- Référence_du_DOM_Gecko | ||
translation_of: Web/API/HTMLElement/dir | ||
browser-compat: api.HTMLElement.dir | ||
--- | ||
{{ ApiRef() }} | ||
{{ApiRef("HTML DOM")}} | ||
|
||
## Résumé | ||
La propriété **`HTMLElement.dir`** permet d'obtenir ou de modifier la direction d'écriture du texte du contenu de l'élément courant. | ||
|
||
L'attribut **`dir`** obtient ou définit la direction d'écriture du texte pour le contenu de l'élément courant. | ||
La direction d'écriture du texte d'un élément est celle selon laquelle le texte est écrit, ce qui permet de prendre en charge différents systèmes d'écriture. Les langues arabes et hébraïques sont notamment écrites de droite à gauche. | ||
|
||
## Syntaxe et valeurs | ||
Lorsque la propriété `dir` d'une image vaut `rtl`, ce qui indique que les attributs HTML `title` et `alt` seront mis en forme avec un mode d'écriture de droite à gauche. | ||
|
||
```js | ||
var DirectionActuelle = referenceElement.dir; | ||
referenceElement.dir = NouvelleDirection; | ||
``` | ||
Lorsque la propriété `dir` d'un tableau vaut `rtl`, l'ordre des colonnes est arrangé de droite à gauche. | ||
|
||
_DirectionActuelle_ est une variable chaîne de caractères représentant la direction d'écriture du texte pour l'élément courant. _NouvelleDirection_ est une variable chaîne de caractères représentant la nouvelle direction d'écriture du texte souhaitée pour l'élément. | ||
Lorsqua la propriété `dir` d'un élément vaut `auto`, la direction de l'élément est déterminée selon son premier caractère de direction fort ou, par défaut, la direction d'écriture de son élément parent. | ||
|
||
Les valeurs possibles pour **`dir`** sont **`ltr`**, pour de gauche à droite (_left-to-right_), et **`rtl`**, pour de droite à gauche (_right-to-left_). | ||
> **Note :** Les navigateurs peuvent permettre aux utilisatrices et utilisateurs de modifier la direction d'écriture des éléments [`<input>`](/fr/docs/Web/HTML/Element/input) et [`<textarea>`](/fr/docs/Web/HTML/Element/textarea) afin de faciliter l'édition du contenu. Chrome et Safari fournissent une option via le menu contextuel des champs de saisie, Internet Explorer et Edge (ancienne version) utilisent la combinaison de touches <kbd>Ctrl</kbd> + <kbd>Maj gauche</kbd> et <kbd>Ctrl</kbd> + <kbd>Maj droit</kbd>. Firefox utilise <kbd>Ctrl</kbd> / <kbd>Cmd</kbd> + <kbd>Maj</kbd> + <kbd>X</kbd> mais *ne* met *pas* à jour la valeur de l'attribut **`dir`**. | ||
## Exemple | ||
## Valeur | ||
|
||
```js | ||
var para = document.getElementById("para1"); | ||
para.dir = "rtl"; | ||
// change la direction du texte sur un paragraphe identifié par "para1" | ||
``` | ||
Cette propriété peut avoir une de ces valeurs : | ||
|
||
## Notes | ||
- `ltr`, pour l'écriture de gauche à droite (<i lang="en">left-to-right</i> en anglais qui donne `ltr`) | ||
- `rtl`, pour l'écriture de droite à gauche (<i lang="en">right-to-left</i> en anglais qui donne `rtl`) | ||
- `auto` pour indiquer la direction de l'élément, telle que déterminée par le moteur selon le contenu de l'élément. | ||
|
||
La direction d'écriture du texte sur un élément est celle dans laquelle le texte est disposé (pour permettre le support de systèmes multilingues). Les langues arabes et l'hébreu sont des exemples typiques de langues qui utiliseront la direction « rtl » (de droite à gauche). | ||
## Exemples | ||
|
||
```js | ||
const parg = document.getElementById('para1'); | ||
parg.dir = 'rtl'; | ||
// on modifie la direction du texte d'un paragraphe | ||
// portant l'identifiant "para1" | ||
``` | ||
|
||
Une image peut avoir sont attribut `dir` positionné à « rtl », auquel cas les attributs `title` et `alt` seront formatés et définis comme allant de droite à gauche. | ||
## Spécifications | ||
|
||
Lorsqu'un tableau a sa direction définie comme « rtl », l'ordre des colonnes va de droite à gauche. | ||
{{Specifications}} | ||
|
||
{{ gecko_callout_heading("7.0") }} | ||
## Compatibilité des navigateurs | ||
|
||
Avant Gecko 7.0 {{ geckoRelease("7.0") }}, il était possible que la valeur renvoyée ne soit pas toujours en minuscule. A partir de Gecko 7.0, la valeur renvoyée est toujours en minuscule, comme défini dans la spécification. | ||
{{Compat}} | ||
|
||
## Spécification | ||
## Voir aussi | ||
|
||
| Spécification | Statut | Commentaire | | ||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------- | | ||
| {{SpecName('DOM2 HTML', 'html.html#ID-52460740', 'dir')}} — [traduction](http://www.yoyodesign.org/doc/w3c/dom2-html/html.html#ID-52460740) (non normative) | {{Spec2('DOM2 HTML')}} | | | ||
- [`document.dir`](/fr/docs/Web/API/document/dir) | ||
- L'attribut universel HTML [`dir`](/fr/docs/Web/HTML/Global_attributes/dir) | ||
- La propriété CSS [`direction`](/fr/docs/Web/CSS/direction) | ||
- La pseudo-classe CSS [`:dir`](/fr/docs/Web/CSS/:dir) |
Oops, something went wrong.