From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- files/fr/web/api/event/cancelable/index.html | 88 ---------------------------- files/fr/web/api/event/cancelable/index.md | 88 ++++++++++++++++++++++++++++ 2 files changed, 88 insertions(+), 88 deletions(-) delete mode 100644 files/fr/web/api/event/cancelable/index.html create mode 100644 files/fr/web/api/event/cancelable/index.md (limited to 'files/fr/web/api/event/cancelable') diff --git a/files/fr/web/api/event/cancelable/index.html b/files/fr/web/api/event/cancelable/index.html deleted file mode 100644 index 3f3b86744b..0000000000 --- a/files/fr/web/api/event/cancelable/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: Event.cancelable -slug: Web/API/Event/cancelable -tags: - - API - - Annulable - - DOM - - Propriétés - - évènements -translation_of: Web/API/Event/cancelable ---- -
{{ ApiRef("DOM") }}
- -

La propriété  cancelable (annulable) de "Event" Indique si l'événement peut être annulé et donc empêché, comme si l'événement ne s'était jamais produit. Si l'événement n'est pas annulable, alors sa propriété cancelable est à false (faux) et l'écouteur d'événement ne peut pas l'arrêter.

- -

L'appel de {{domxref("event.preventDefault", "preventDefault()")}} sur un évènement qui ne peut être annulé produit une erreur, aussi les écouteurs d'évènement qui gèrent de nombreux types d'évènements peuvent être vérifiés avec cancelable avant d'appeler leurs méthodes preventDefault().

- -

La plupart des événements natifs du navigateur qui peuvent être annulés sont ceux qui résultent de l'interaction de l'utilisateur avec la page. L'annulation des événements click, scroll ou beforeunload empêcherait l'utilisateur de cliquer sur un élément, de faire défiler la page ou de la quitter, respectivement.

- -

Syntaxe

- -
bool = event.cancelable
-
- - - -

Exemple

- -

Par exemple, les vendeurs de navigateurs proposent que l'évènement wheel puisse être annulable seulement  la première fois que l'écouteur est appelé (en) ; les évènements  wheel suivants ne peuvent être annulés.

- -
function preventScrollWheel(event) {
-  if (typeof event.cancelable !== 'boolean' || event.cancelable) {
-    // L'événement peut être annulé, alors nous le faisons.
-    event.preventDefault();
-  } else {
-    // L'évènement ne peut pas être annulé, il n'est donc pas sûr
-    // d'appeler preventDefault() sur lui.
-    console.warn(`The following event couldn't be canceled:`);
-    console.dir(event);
-  }
-}
-
-document.addEventListener('wheel', preventCancelableEvents);
- -

 

- -

Notes

- -

Si l'événement peut être annulé, ou non, est déterminé au moment de l'initialisation de celui-ci.

- -

Pour annuler un événement, utiliser la méthode {{domxref("event.preventDefault", "preventDefault()")}} sur celui-ci. Cela permet d'empêcher l'action par défaut associée à l'événement de s'exécuter.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-event-cancelable', 'Event.cancelable')}}{{ Spec2('DOM WHATWG') }} 
{{SpecName('DOM4', '#dom-event-cancelable', 'Event.cancelable')}}{{ Spec2('DOM4') }} 
{{SpecName('DOM2 Events', '#Events-Event-canCancel', 'Event.cancelable')}}{{ Spec2('DOM2 Events') }}Définition initiale.
- -

Compatibilité des navigateurs

- - - -

{{Compat("api.Event.cancelable")}}

diff --git a/files/fr/web/api/event/cancelable/index.md b/files/fr/web/api/event/cancelable/index.md new file mode 100644 index 0000000000..3f3b86744b --- /dev/null +++ b/files/fr/web/api/event/cancelable/index.md @@ -0,0 +1,88 @@ +--- +title: Event.cancelable +slug: Web/API/Event/cancelable +tags: + - API + - Annulable + - DOM + - Propriétés + - évènements +translation_of: Web/API/Event/cancelable +--- +
{{ ApiRef("DOM") }}
+ +

La propriété  cancelable (annulable) de "Event" Indique si l'événement peut être annulé et donc empêché, comme si l'événement ne s'était jamais produit. Si l'événement n'est pas annulable, alors sa propriété cancelable est à false (faux) et l'écouteur d'événement ne peut pas l'arrêter.

+ +

L'appel de {{domxref("event.preventDefault", "preventDefault()")}} sur un évènement qui ne peut être annulé produit une erreur, aussi les écouteurs d'évènement qui gèrent de nombreux types d'évènements peuvent être vérifiés avec cancelable avant d'appeler leurs méthodes preventDefault().

+ +

La plupart des événements natifs du navigateur qui peuvent être annulés sont ceux qui résultent de l'interaction de l'utilisateur avec la page. L'annulation des événements click, scroll ou beforeunload empêcherait l'utilisateur de cliquer sur un élément, de faire défiler la page ou de la quitter, respectivement.

+ +

Syntaxe

+ +
bool = event.cancelable
+
+ + + +

Exemple

+ +

Par exemple, les vendeurs de navigateurs proposent que l'évènement wheel puisse être annulable seulement  la première fois que l'écouteur est appelé (en) ; les évènements  wheel suivants ne peuvent être annulés.

+ +
function preventScrollWheel(event) {
+  if (typeof event.cancelable !== 'boolean' || event.cancelable) {
+    // L'événement peut être annulé, alors nous le faisons.
+    event.preventDefault();
+  } else {
+    // L'évènement ne peut pas être annulé, il n'est donc pas sûr
+    // d'appeler preventDefault() sur lui.
+    console.warn(`The following event couldn't be canceled:`);
+    console.dir(event);
+  }
+}
+
+document.addEventListener('wheel', preventCancelableEvents);
+ +

 

+ +

Notes

+ +

Si l'événement peut être annulé, ou non, est déterminé au moment de l'initialisation de celui-ci.

+ +

Pour annuler un événement, utiliser la méthode {{domxref("event.preventDefault", "preventDefault()")}} sur celui-ci. Cela permet d'empêcher l'action par défaut associée à l'événement de s'exécuter.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-event-cancelable', 'Event.cancelable')}}{{ Spec2('DOM WHATWG') }} 
{{SpecName('DOM4', '#dom-event-cancelable', 'Event.cancelable')}}{{ Spec2('DOM4') }} 
{{SpecName('DOM2 Events', '#Events-Event-canCancel', 'Event.cancelable')}}{{ Spec2('DOM2 Events') }}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.Event.cancelable")}}

-- cgit v1.2.3-54-g00ecf