From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001
From: julieng La propriété Element.accessKey définit la touche sur laquelle l'utilisateur doit appuyer pour accéder à l'élément. Note : La propriété L'événement L'événement L'événement L’évènement DOM Dans le cas de Cet exemple affiche la valeur de l’élément {{HtmlElement("input")}} juste avant qu’elle soit modifiée. {{EmbedLiveSample("Examples")}} {{Compat("api.HTMLElement.beforeinput_event")}} {{APIRef}} L'événement change est déclenché pour les éléments {{HTMLElement("input")}} (entrée), {{HTMLElement("select")}} (sélection) et {{HTMLElement("textarea")}} (zone de texte) lorsqu'un changement de leur valeur est réalisé par l'utilisateur. Contrairement à l'événement {{event("input")}}, change n'est pas nécessairement déclenché pour chaque changement de valeur. En fonction du type d'élément de formulaire modifié et de la manière dont l'utilisateur interagit avec cet élément, l'événement change se déclenche à un moment différent : Les différents navigateurs ne sont pas toujours d'accord sur le fait que l'événement change doit être déclenché pour certains types d'interactions. Par exemple, la navigation avec le clavier dans les éléments {{HTMLElement("select")}} ne déclenche jamais l'événement dans Gecko jusqu'à ce que l'utilisateur appuie sur la touche Entrée ou déplace le focus en dehors du <select> (voir {{bug("126379")}}).Element.accessKey
est rarement utilisée en raison de ses multiples conflits avec des raccourcis clavier déjà présents dans les navigateurs. Pour contourner ce problème, les navigateurs appliquent le comportement attendu de "accesskey" lorsqu'une autre touche est pressée simultanément (comme Alt + accesskey).animationend est déclenché quand une animation CSS est terminée.
Informations générales
-
-
-
-
-Propriétés
-
-
-
-
-
-
-
-
-
- Propriété
- Type
- Description
-
-
-
- target
{{ReadOnlyInline}}{{domxref("EventTarget")}}
- La cible de l'événement (la plus haute cible dans l'arbre du DOM).
-
-
-
- type
{{ReadOnlyInline}}{{domxref("DOMString")}}
- Le type de l'événement.
-
-
-
- bubbles
{{ReadOnlyInline}}
- boolean
Est-ce que l'événement se propage?
-
-
-
- cancelable
{{ReadOnlyInline}}
- boolean
Est-il possible d'annuler l'événement?
-
-
-
- animationName
{{ReadOnlyInline}}{{domxref("DOMString")}}
- Le nom de la propriété CSS associéee à la transition.
-
-
-
-
- elapsedTime
{{ReadOnlyInline}}Float
- Le temps durant lequel l'animation a durée, en secondes, quand l'événement est déclenché, excepté le temps lorsque l'animation était en pause. Pour un événement animationstart, elapsedTime vaut zéro à moins que animation-delay ne soit négatif, et dans ce cas, l'événement sera déclenché avec un elapsedTime de (-1 * delay).
- Evénements liés
-
-
-
-
-Voir aussi
-
-
+L'événement `animationend est déclenché quand une animation CSS est terminée.`
+
+## Informations générales
+
+- Spécification
+ - : [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)
+- Interface
+ - : AnimationEvent
+- Propagation
+ - : Oui
+- Annulable
+ - : Non
+- Cible
+ - : Document, Element, Window
+- Action par défaut
+ - : Aucune
+
+## Propriétés
+
+| Propriété | Type | Description |
+| ---------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `target` {{ReadOnlyInline}} | {{domxref("EventTarget")}} | La cible de l'événement (la plus haute cible dans l'arbre du DOM). |
+| `type` {{ReadOnlyInline}} | {{domxref("DOMString")}} | Le type de l'événement. |
+| `bubbles` {{ReadOnlyInline}} | `boolean` | Est-ce que l'événement se propage? |
+| `cancelable` {{ReadOnlyInline}} | `boolean` | Est-il possible d'annuler l'événement? |
+| `animationName` {{ReadOnlyInline}} | {{domxref("DOMString")}} | Le nom de la propriété CSS associéee à la transition. |
+| `elapsedTime` {{ReadOnlyInline}} | Float | Le temps durant lequel l'animation a durée, en secondes, quand l'événement est déclenché, excepté le temps lorsque l'animation était en pause. Pour un événement **animationstart**, _elapsedTime_ vaut zéro à moins que _animation-delay_ ne soit négatif, et dans ce cas, l'événement sera déclenché avec un _elapsedTime_ de (-1 \* delay). |
+
+## Evénements liés
+
+- {{Event("animationstart")}}
+- {{Event("animationend")}}
+- {{Event("animationiteration")}}
+
+## Voir aussi
+
+- [Utilisation des animations CSS](/fr/docs/CSS/Using_CSS_animations)
diff --git a/files/fr/web/api/htmlelement/animationiteration_event/index.md b/files/fr/web/api/htmlelement/animationiteration_event/index.md
index f0e8c058b7..82a21ad3be 100644
--- a/files/fr/web/api/htmlelement/animationiteration_event/index.md
+++ b/files/fr/web/api/htmlelement/animationiteration_event/index.md
@@ -4,81 +4,42 @@ slug: Web/API/HTMLElement/animationiteration_event
translation_of: Web/API/HTMLElement/animationiteration_event
original_slug: Web/Events/animationiteration
---
- animationiteration est déclenché lorsqu'une itération d'une animation se termine. Cet événement ne se produit pas pour les animations avec animation-iteration-count valant 1.
informations générales
-
-
-
-
-Propriétés
-
-
-
-
-
-
-
-
-
- Propriété
- Type
- Description
-
-
-
- target
{{ReadOnlyInline}}{{domxref("EventTarget")}}
- La cible de l'événement (la plus haute cible dans l'arbre du DOM).
-
-
-
- type
{{ReadOnlyInline}}{{domxref("DOMString")}}
- Le type de l'événement.
-
-
-
- bubbles
{{ReadOnlyInline}}
- boolean
Est-ce que l'événement se propage?
-
-
-
- cancelable
{{ReadOnlyInline}}
- boolean
Est-il possible d'annuler l'événement?
-
-
-
- animationName
{{ReadOnlyInline}}{{domxref("DOMString")}}
- Le nom de la propriété CSS associéee à la transition.
-
-
-
-
- elapsedTime
{{ReadOnlyInline}}Float
- Le temps durant lequel l'animation a durée, en secondes, quand l'événement est déclenché, excepté le temps lorsque l'animation était en pause. Pour un événement animationstart, elapsedTime vaut zéro à moins que animation-delay ne soit négatif, et dans ce cas, l'événement sera déclenché avec un elapsedTime de (-1 * delay).
- Evénements liés
-
-
-
-
-Voir aussi
-
-
+L'événement\*\* \*\*`animationiteration est déclenché lorsqu'une itération d'une animation se termine. Cet événement ne se produit pas pour les animations avec animation-iteration-count valant 1.`
+
+## informations générales
+
+- Spécification
+ - : [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)
+- Interface
+ - : AnimationEvent
+- Synchronisme
+ - : synchronous
+- Propagation
+ - : Oui
+- Annulable
+ - : Non
+- Cible
+ - : Document, Element
+- Action par défaut
+ - : Aucune
+
+## Propriétés
+
+| Propriété | Type | Description |
+| ---------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `target` {{ReadOnlyInline}} | {{domxref("EventTarget")}} | La cible de l'événement (la plus haute cible dans l'arbre du DOM). |
+| `type` {{ReadOnlyInline}} | {{domxref("DOMString")}} | Le type de l'événement. |
+| `bubbles` {{ReadOnlyInline}} | `boolean` | Est-ce que l'événement se propage? |
+| `cancelable` {{ReadOnlyInline}} | `boolean` | Est-il possible d'annuler l'événement? |
+| `animationName` {{ReadOnlyInline}} | {{domxref("DOMString")}} | Le nom de la propriété CSS associéee à la transition. |
+| `elapsedTime` {{ReadOnlyInline}} | Float | Le temps durant lequel l'animation a durée, en secondes, quand l'événement est déclenché, excepté le temps lorsque l'animation était en pause. Pour un événement **animationstart**, _elapsedTime_ vaut zéro à moins que _animation-delay_ ne soit négatif, et dans ce cas, l'événement sera déclenché avec un _elapsedTime_ de (-1 \* delay). |
+
+## Evénements liés
+
+- {{Event("animationstart")}}
+- {{Event("animationend")}}
+- {{Event("animationiteration")}}
+
+## Voir aussi
+
+- [Utilisation des animations CSS](/fr/docs/CSS/Using_CSS_animations)
diff --git a/files/fr/web/api/htmlelement/animationstart_event/index.md b/files/fr/web/api/htmlelement/animationstart_event/index.md
index f4dfb8d3cb..84d56e0b9a 100644
--- a/files/fr/web/api/htmlelement/animationstart_event/index.md
+++ b/files/fr/web/api/htmlelement/animationstart_event/index.md
@@ -4,79 +4,40 @@ slug: Web/API/HTMLElement/animationstart_event
translation_of: Web/API/HTMLElement/animationstart_event
original_slug: Web/Events/animationstart
---
-animationstart
est déclenché quand une animation CSS a commencé. Si animation-delay est défini alors le déclenchement se fera une fois le delai expiré. Un délai négatif causera un déclenchement de l'événement avec un
elapsedTime équivalent à la valeur absolue du délai.Informations générales
-
-
-
-
-Propriétés
-
-
-
-
-
-
-
-
-
- Propriété
- Type
- Description
-
-
-
- target
{{ReadOnlyInline}}{{domxref("EventTarget")}}
- La cible de l'événement (la plus haute cible dans l'arbre du DOM).
-
-
-
- type
{{ReadOnlyInline}}{{domxref("DOMString")}}
- Le type de l'événement.
-
-
-
- bubbles
{{ReadOnlyInline}}
- boolean
Est-ce que l'événement se propage?
-
-
-
- cancelable
{{ReadOnlyInline}}
- boolean
Est-il possible d'annuler l'événement?
-
-
-
- animationName
{{ReadOnlyInline}}{{domxref("DOMString")}}
- Le nom de la propriété CSS associéee à la transition.
-
-
-
-
- elapsedTime
{{ReadOnlyInline}}Float
- Le temps durant lequel l'animation a durée, en secondes, quand l'événement est déclenché, excepté le temps lorsque l'animation était en pause. Pour un événement animationstart, elapsedTime vaut zéro à moins que animation-delay ne soit négatif, et dans ce cas, l'événement sera déclenché avec un elapsedTime de (-1 * delay).
- Evénements liés
-
-
-
-
-Voir aussi
-
-
+L'événement **`animationstart `**`est déclenché quand une animation CSS a commencé. Si animation-delay est défini alors le déclenchement se fera une fois le delai expiré. Un délai négatif causera un déclenchement de l'événement avec un `_elapsedTime_ équivalent à la valeur absolue du délai.
+
+## Informations générales
+
+- Spécification
+ - : [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)
+- Interface
+ - : AnimationEvent
+- Propagation
+ - : Oui
+- Annulable
+ - : Non
+- Cible
+ - : Document, Element
+- Action par défaut
+ - : Aucune
+
+## Propriétés
+
+| Propriété | Type | Description |
+| ---------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `target` {{ReadOnlyInline}} | {{domxref("EventTarget")}} | La cible de l'événement (la plus haute cible dans l'arbre du DOM). |
+| `type` {{ReadOnlyInline}} | {{domxref("DOMString")}} | Le type de l'événement. |
+| `bubbles` {{ReadOnlyInline}} | `boolean` | Est-ce que l'événement se propage? |
+| `cancelable` {{ReadOnlyInline}} | `boolean` | Est-il possible d'annuler l'événement? |
+| `animationName` {{ReadOnlyInline}} | {{domxref("DOMString")}} | Le nom de la propriété CSS associéee à la transition. |
+| `elapsedTime` {{ReadOnlyInline}} | Float | Le temps durant lequel l'animation a durée, en secondes, quand l'événement est déclenché, excepté le temps lorsque l'animation était en pause. Pour un événement **animationstart**, _elapsedTime_ vaut zéro à moins que _animation-delay_ ne soit négatif, et dans ce cas, l'événement sera déclenché avec un _elapsedTime_ de (-1 \* delay). |
+
+## Evénements liés
+
+- {{Event("animationstart")}}
+- {{Event("animationend")}}
+- {{Event("animationiteration")}}
+
+## Voir aussi
+
+- [Utilisation des animations CSS](/fr/docs/CSS/Using_CSS_animations)
diff --git a/files/fr/web/api/htmlelement/beforeinput_event/index.md b/files/fr/web/api/htmlelement/beforeinput_event/index.md
index 8d34743cfd..de24c8836e 100644
--- a/files/fr/web/api/htmlelement/beforeinput_event/index.md
+++ b/files/fr/web/api/htmlelement/beforeinput_event/index.md
@@ -3,90 +3,83 @@ title: 'HTMLElement: beforeinput event'
slug: Web/API/HTMLElement/beforeinput_event
translation_of: Web/API/HTMLElement/beforeinput_event
---
-beforeinput
est émis quand la valeur d’un élément {{HTMLElement("input")}}, {{HTMLElement("select")}}, ou {{HTMLElement("textarea")}} est sur le point d’être modifié. L’évènement s’applique également aux éléments ayant l’attribut {{domxref("HTMLElement.contentEditable", "contenteditable")}} actif, et à tout élément quand le {{domxref("Document.designMode", "designMode")}} est activé.contenteditable
et designMode
, la cible de l’évènement est l’hôte d’édition. Si ces propriétés s’appliquent à plusieurs éléments, l’hôte d’édition est le plus proche ancêtre dont le parent n’est pas éditable.
-
-
-
-
- Bouillonne
- Oui
-
-
- Annulable
- Oui
-
-
- Interface
- {{DOMxRef("InputEvent")}}
-
-
- Propriété gestionnaire d’évènement
- Aucune
-
-
- Sync / Async
- Sync
-
-
- Composé
- Oui
-
-
-
+
+ Action par défaut
- Mettre à jour l’élément DOM
-
+
+ Bouillonne
+ Oui
+
+
+ Annulable
+ Oui
+
+
+ Interface
+ {{DOMxRef("InputEvent")}}
+
+
+ Propriété gestionnaire d’évènement
+ Aucune
+
+
+ Sync / Async
+ Sync
+
+
+ Composé
+ Oui
+
+
+
Action par défaut
+ Mettre à jour l’élément DOM
+ Exemples
+## Exemples
-HTML
+### HTML
-<input placeholder="Saisissez du texte" name="name"/>
-<p id="values"></p>
+```html
+
+
+```
-JavaScript
+### JavaScript
-const input = document.querySelector('input');
+```js
+const input = document.querySelector('input');
const log = document.getElementById('values');
input.addEventListener('beforeinput', updateValue);
function updateValue(e) {
log.textContent = e.target.value;
-}
+}
+```
-Résultat
+### Résultat
-Spécifications
+## Spécifications
-
-
-
+| Spécification | Statut |
+| ------------------------------------------------------------------------------------------------ | ---------------------------- |
+| {{SpecName('UI Events', "#event-type-beforeinput", "beforeinput event")}} | {{Spec2('UI Events')}} |
-
-
- Spécification
- Statut
-
-
-
-{{SpecName('UI Events', "#event-type-beforeinput", "beforeinput event")}}
- {{Spec2('UI Events')}}
- Compatibilité des navigateurs
+## Compatibilité des navigateurs
-Voir aussi
+## Voir aussi
-
-
+- Évènement associé : [`input`](/en-US/docs/Web/API/HTMLElement/input_event)
diff --git a/files/fr/web/api/htmlelement/change_event/index.md b/files/fr/web/api/htmlelement/change_event/index.md
index ba007c779b..9f239a8004 100644
--- a/files/fr/web/api/htmlelement/change_event/index.md
+++ b/files/fr/web/api/htmlelement/change_event/index.md
@@ -11,63 +11,66 @@ tags:
- Élément HTML
translation_of: Web/API/HTMLElement/change_event
---
-input
-
-
-
-
- Propagation
- Oui
-
-
- Annulable
- Non
-
-
- Interface
- {{domxref("Event")}}
-
-
-
+
+ Gestionnaire d'événements
- {{domxref("GlobalEventHandlers/onchange", "onchange")}}
-
+
+ Propagation
+ Oui
+
+
+ Annulable
+ Non
+
+
+ Interface
+ {{domxref("Event")}}
+
+
+
Gestionnaire d'événements
+
+ {{domxref("GlobalEventHandlers/onchange", "onchange")}}
+
+
-
+- Quand l'élément est activé (en cliquant ou en utilisant le clavier) pour `` et ``_(case à cocher_).
+- Quand l'utilisateur réalise le changement de manière explicite (par exemple, en sélectionnant une valeur venant d'un {{HTMLElement("select")}} d'un menu déroulant avec le clic d'une souris, en sélectionnant une date d'un "date picker" _(sélecteur de date)_ pour ``, en sélectionnant un fichier d'un "file picker" _(sélecteur de fichier)_ pour ``, etc.).
+- Quand l'élément perd le focus après que sa valeur a été changée, mais pas validée (par exemple, après l'édition d'une valeur de {{HTMLElement("textarea")}} ou ``).
-<input type="radio">
et <input type="checkbox">
(case à cocher).<input type="date">
, en sélectionnant un fichier d'un "file picker" (sélecteur de fichier) pour <input type="file">
, etc.).<input type="text">
).
La propriété
HTMLElement.contentEditable
est utilisée pour indiquer si un élément HTML est ou non éditable. Cet attribut peut avoir 3 valeurs :
"true"
(vrai) indique que l'élément est éditable."false"
(faux) indique que l'élément ne sera pas éditable."inherit"
(hérité) indique que l'élément héritera de l'état editable de son parent.Vous pouvez utiliser la propriété {{domxref("HTMLElement.isContentEditable")}} pour tester la valeur de la propriété {{domxref("Boolean")}}.
- -editable = element.contentEditable -element.contentEditable = "true" -- -
Specification | -Statut | -Commentaire | -
---|---|---|
{{SpecName('HTML WHATWG', 'interaction.html#contenteditable', 'contenteditable')}} | -{{Spec2('HTML WHATWG')}} | -Definition initiale | -
{{Compat("api.HTMLElement.contentEditable")}}
- -Dans Internet Explorer, le contentable
ne peut pas être appliqué aux {{htmlelement("table")}}, {{htmlelement("col")}}, {{htmlelement("colgroup")}}, {{htmlelement("tbody")}}, {{htmlelement("td")}}, {{htmlelement("tfoot")}}, {{htmlelement("th")}}, {{htmlelement("thead")}} et {{htmlelement("tr")}} directement. Un élément {{htmlelement("span")}} ou {{htmlelement("div")}} modifiable au niveau du contenu peut être placé à l'intérieur de chaque cellule du tableau.
{{ ApiRef() }}
-L'attribut dir
obtient ou définit la direction d'écriture du texte pour le contenu de l'élément courant.
var DirectionActuelle = referenceElement.dir; -referenceElement.dir = NouvelleDirection; --
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.
-Les valeurs possibles pour dir
sont ltr
, pour de gauche à droite (left-to-right), et rtl
, pour de droite à gauche (right-to-left).
var para = document.getElementById("para1"); +{{ ApiRef() }} + +## Résumé + +L'attribut **`dir`** obtient ou définit la direction d'écriture du texte pour le contenu de l'élément courant. + +## Syntaxe et valeurs + +```js +var DirectionActuelle = referenceElement.dir; +referenceElement.dir = NouvelleDirection; +``` + +_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. + +Les valeurs possibles pour **`dir`** sont **`ltr`**, pour de gauche à droite (_left-to-right_), et **`rtl`**, pour de droite à gauche (_right-to-left_). + +## Exemple + +```js +var para = document.getElementById("para1"); para.dir = "rtl"; // change la direction du texte sur un paragraphe identifié par "para1" --
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).
-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.
Lorsqu'un tableau a sa direction définie comme « rtl », l'ordre des colonnes va de droite à gauche.
-{{ gecko_callout_heading("7.0") }}
-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.
-Spécification | -Statut | -Commentaire | -
---|---|---|
{{SpecName('DOM2 HTML', 'html.html#ID-52460740', 'dir')}} — traduction (non normative) | -{{Spec2('DOM2 HTML')}} | -- |
+``` + +## Notes + +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). + +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. + +Lorsqu'un tableau a sa direction définie comme « rtl », l'ordre des colonnes va de droite à gauche. + +{{ gecko_callout_heading("7.0") }} + +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. + +## Spécification + +| 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')}} | | diff --git a/files/fr/web/api/htmlelement/hidden/index.md b/files/fr/web/api/htmlelement/hidden/index.md index f54affe844..8cbd7090df 100644 --- a/files/fr/web/api/htmlelement/hidden/index.md +++ b/files/fr/web/api/htmlelement/hidden/index.md @@ -3,86 +3,87 @@ title: HTMLElement.hidden slug: Web/API/HTMLElement/hidden translation_of: Web/API/HTMLElement/hidden --- -
La propriété hidden
de l'{{domxref("HTMLElement")}} est un {{jsxref("Boolean")}} qui vaut true
si l'élément est caché, sinon sa valeur est false
. Cela est très différent de l'utilisation de la propriété CSS {{cssxref("display")}} pour contrôler la visibilité d'un élément.
La propriété hidden
s'applique à tous les modes de présentation et ne doit pas être utilisée pour cacher du contenu qui est destiné à être directement accessible par l'utilisateur.
Des cas d'utilisation appropriés de hidden
comprennent :
Des cas inappropriés d'utilisation comprennent :
+Des cas inappropriés d'utilisation comprennent : -Note : Des éléments qui ne sont pas hidden
ne doivent pas faire référence à des éléments qui le sont.
estCaché = HTMLElement.hidden; + estCaché = HTMLElement.hidden; -HTMLElement.hidden = true | false;+ HTMLElement.hidden = true | false; -
Un Boolean qui est true
si l'élément est caché à la vue ; sinon, la valeur est false
.
Voici un exemple où un bloc caché est utilisé pour contenir un message de remerciement qui est affiché après qu'un utilisateur a accepté une demande inhabituelle.
+Voici un exemple où un bloc caché est utilisé pour contenir un message de remerciement qui est affiché après qu'un utilisateur a accepté une demande inhabituelle. -document.getElementById("boutonOk") +```js +document.getElementById("boutonOk") .addEventListener("click", function() { document.getElementById("bienvenue").hidden = true; document.getElementById("impressionnant").hidden = false; -}, false);+}, false); +``` -
Ce code installe une gestionnaire pour le bouton "OK" du panneau de bienvenue, gestionnaire qui cache le panneau de bienvenue et rend le panneau de suite — ayant le curieux nom d'"impressionnant" — visible à sa place.
+Ce code installe une gestionnaire pour le bouton "OK" du panneau de bienvenue, gestionnaire qui cache le panneau de bienvenue et rend le panneau de suite — ayant le curieux nom d'"impressionnant" — visible à sa place. -Le code HTML pour les deux boîtes est montré ci-dessous.
+Le code HTML pour les deux boîtes est montré ci-dessous. -<div id="bienvenue" class="panneau"> - <h1>Bienvenue à Machin.com !</h1> - <p>En cliquant sur "OK", vous acceptez d'être impressionnant chaque jour !</p> - <button class="bouton" id="boutonOk">OK</button> -</div>+```html +
En cliquant sur "OK", vous acceptez d'être impressionnant chaque jour !
+ +Ce code HTML crée un panneau (dans un bloc {{HTMLElement("div")}}) qui accueille les utilisateurs sur un site et leur dit ce qu'ils acceptent en cliquant sur le bouton OK.
+Ce code HTML crée un panneau (dans un bloc {{HTMLElement("div")}}) qui accueille les utilisateurs sur un site et leur dit ce qu'ils acceptent en cliquant sur le bouton OK. -Une fois que l'utilisateur a cliqué sur le bouton "OK" dans le panneau d'accueil, le code JavaScript échange les deux panneaux en changeant leurs valeurs respectives pour hidden
. Le panneau de suite ressemble à ce qui suit en HTML:
<div id="impressionnant" class="panneau" hidden> - <h1>Merci !</h1> - <p>Merci <strong>vraiment</strong> beaucoup d'avoir accepté d'être +```html +++``` -Merci !
+Merci vraiment beaucoup d'avoir accepté d'être impressionnant aujourd'hui ! Maintenant, sortez et faites des choses impressionnantes - d'une façon impressionnante pour rendre le monde plus impressionnant !</p> -</div> + d'une façon impressionnante pour rendre le monde plus impressionnant !
+CSS
+### CSS -Le contenu est mis en forme en utilisant le CSS ci-dessous.
+Le contenu est mis en forme en utilisant le CSS ci-dessous. -.panneau { +```css +.panneau { font: 16px "Open Sans", Helvetica, Arial, sans-serif; border: 1px solid #22d; padding: 12px; @@ -98,46 +99,26 @@ translation_of: Web/API/HTMLElement/hidden h1 { margin-top: 0; font-size: 175%; -}- -Résultat
- -{{ EmbedLiveSample('Example', 560, 200) }}
- -Spécifications
- -
Spécification | -Statut | -Commentaire | -
---|---|---|
{{SpecName('HTML WHATWG', "interaction.html#dom-hidden", "HTMLElement.hidden")}} | -{{Spec2('HTML WHATWG')}} | -- |
{{SpecName('HTML5.1', "editing.html#the-hidden-attribute", "HTMLElement.hidden")}} | -{{Spec2('HTML5.1')}} | -- |
{{SpecName('HTML5 W3C', "editing.html#the-hidden-attribute", "HTMLElement.hidden")}} | -{{Spec2('HTML5 W3C')}} | -- |
{{Compat("api.HTMLElement.hidden")}}
- -HTMLElement
est une interface abstraite pour le DOM, héritée par tous les éléments HTML.
Nom | -Type | -Description | -
---|---|---|
{{domxref("element.accessKey", "accessKey")}} {{HTMLVersionInline(5)}} | -{{domxref("DOMString")}} | -La touche de navigation clavier assignée à l'élément. | -
{{domxref("element.accessKeyLabel", "accessKeyLabel")}} {{HTMLVersionInline(5)}} | -{{domxref("DOMString")}} | -Une chaîne de caractères définissant la touche de navigation clavier assignée. | -
{{domxref("element.className", "className")}} | -{{domxref("DOMString")}} | -Le nom de la classe CSS définie pour l'élément. | -
{{domxref("element.dataset", "dataset")}} {{HTMLVersionInline(5)}} | -{{domxref("DOMStringMap")}} | -Un tableau associatif des attributs data-* de l'élément. |
-
{{domxref("element.dir", "dir")}} | -{{domxref("DOMString")}} | -L'attribut dir de l'élément. |
-
{{domxref("element.id", "id")}} | -{{domxref("DOMString")}} | -L'ID de l'élément. | -
{{domxref("element.lang", "lang")}} | -{{domxref("DOMString")}} | -L'attribut lang de l'élément. |
-
{{domxref("element.title", "title")}} | -{{domxref("DOMString")}} | -L'attribut title de l'élément. |
-
Nom et paramètres | -Renvoie | -Description | -
---|---|---|
{{domxref("element.blur()", "blur()")}} {{HTMLVersionInline(5)}} | -void |
- Retire le focus clavier de l'élément actuellement sélectionné. | -
{{domxref("element.click()", "click()")}} {{HTMLVersionInline(5)}} | -void |
- Envoie un évènement click à l'élément. |
-
{{domxref("element.focus()", "focus()")}} {{HTMLVersionInline(5)}} | -void |
- Place le focus clavier sur l'élément. | -
Spécification | -Statut | -Commentaires | -
---|---|---|
{{SpecName('HTML WHATWG', 'elements.html#htmlelement', 'HTMLElement')}} | -{{Spec2('HTML WHATWG')}} | -- |
{{Compat("api.HTMLElement")}}
+`HTMLElement` est une interface abstraite pour le [DOM](/fr/docs/DOM), héritée par tous les éléments HTML. -Node.innerText
est une propriété représentant le contenu textuel « visuellement rendu » d’un nœud. Utilisé en lecture, il renvoie une approximation du texte que l’utilisateur ou utilisatrice obtiendrait s’il ou elle sélectionnnait le contenu d’un élément avec le curseur, et le copiait dans le presse-papier.
{{domxref("Node.textContent")}} est une alternative similaire, bien qu’il y ait d’importantes différences entre les deux.
+{{domxref("Node.textContent")}} est une alternative similaire, bien qu’il y ait d’importantes différences entre les deux. -Spécification | -Statut | -Commentaire | -
---|---|---|
{{SpecName('HTML WHATWG', 'dom.html#the-innertext-idl-attribute', 'innerText')}} | -{{Spec2('HTML WHATWG')}} | -Introduction basée sur le brouillon de spécification de innerText. Voir whatwg/html#465 et whatwg/compat#5 pour l’histoire. | -
{{Compat("api.Node.innerText")}}
- -L'évènement DOM input
(entrée) est déclenché de façon synchrone quand la valeur d'un élément {{HTMLElement("input")}} (entrée), {{HTMLElement("select")}} (sélection) ou {{ HTMLElement("textarea") }} (zone de texte) est modifiée. (Pour les éléments input
avec type=checkbox
(case à cocher) ou type=radio
, l'évènement input
n'est pas lancé quand l'utilisateur clique sur le contrôle, parce que la valeur attribuée ne peut être changée).
De plus, l'évènement input
se déclenche sur les éditeurs contenteditable
quand son contenu est modifié. Dans ce cas, l'évènement cible est l'élément "editing host" (hôte de l'édition) . S'il y a deux éléments ou plus qui ont contenteditable
à true (vrai), "editing host" est l'élément ancêtre le plus proche dont le parent n'est pas modifiable . De même, il est déclenché sur l'élément racine des éditeurs designMode
.
-
Property | -Type | -Description | -
---|---|---|
target {{readonlyInline}} |
- {{domxref("EventTarget")}} | -The event target (the topmost target in the DOM tree). | -
type {{readonlyInline}} |
- {{domxref("DOMString")}} | -The type of event. | -
bubbles {{readonlyInline}} |
- {{jsxref("Boolean")}} | -Whether the event normally bubbles or not. | -
cancelable {{readonlyInline}} |
- {{jsxref("Boolean")}} | -Whether the event is cancellable or not. | -
Spécification | -Statut | -
---|---|
{{SpecName('HTML WHATWG', "forms.html#event-input-input", "input event")}} | -{{Spec2('HTML WHATWG')}} | -
{{SpecName('DOM3 Events', "#event-type-input", "input event")}} | -{{Spec2('DOM3 Events')}} | -
{{Compat("api.HTMLElement.input_event")}}
+## Compatibilité des navigateurs -La propriété en lecture seule HTMLElement.isContentEditable
renvoie un {{jsxref("Boolean")}} qui est true
(vrai) si le contenu de l'élément est éditable ; sinon elle renvoie false
(faux).
editable = element.isContentEditable -+ editable = element.isContentEditable -
document.getElementById("infoText1").innerHTML += document.getElementById("myText1").isContentEditable; -document.getElementById("infoText2").innerHTML += document.getElementById("myText2").isContentEditable;+```js +document.getElementById("infoText1").innerHTML += document.getElementById("myText1").isContentEditable; +document.getElementById("infoText2").innerHTML += document.getElementById("myText2").isContentEditable; +``` -
<p id="myText1">Uneditable Paragraph</p> -<p id="myText2" contentEditable="true">Editable Paragraph</p> +```html ++Uneditable Paragraph
+Editable Paragraph
-<p id="infoText1">Can edit the first paragraph? </p> -<p id="infoText2">Can edit the second paragraph? </p>
Can edit the first paragraph?
+Can edit the second paragraph?
+``` -{{ EmbedLiveSample('Example') }}
+{{ EmbedLiveSample('Example') }} -Specification | -Status | -Comment | -
---|---|---|
{{SpecName('HTML WHATWG', "editing.html#dom-iscontenteditable", "HTMLElement.contenteditable")}} | -{{Spec2('HTML WHATWG')}} | -Pas de changement de la dernière image, {{SpecName('HTML5.1')}} | -
{{SpecName('HTML5.1', "editing.html#dom-iscontenteditable", "HTMLElement.contenteditable")}} | -{{Spec2('HTML5.1')}} | -L'image de {{SpecName('HTML WHATWG')}}, n'est pas changée par {{SpecName('HTML5 W3C')}} | -
{{SpecName('HTML5 W3C', "editing.html#dom-iscontenteditable", "HTMLElement.contenteditable")}} | -{{Spec2('HTML5 W3C')}} | -Image de {{SpecName('HTML WHATWG')}}, definition initiale. | -
{{Compat("api.HTMLElement.isContentEditable")}}
+{{Compat("api.HTMLElement.isContentEditable")}} -{{ ApiRef() }}
-Cette propriété permet d'obtenir ou de définir la langue de base des valeurs d'attribut et du contenu textuel d'un élément.
-var langueUtilisee = référenceElement.lang; // Récupérer la valeur de lang -référenceElement.lang = NouvelleLangue; // Définir la valeur de lang --
langueUtilisee est une variable chaîne de caracteres recevant la langue dans laquelle le texte de l'élément courant est écrit. NouvelleLangue est une variable chaîne de caractères dont la valeur définit la langue dans laquelle le texte de l'élément courant est écrit.
-// ce bout de code compare la langue de base et +{{ ApiRef() }} + +## Résumé + +Cette propriété permet d'obtenir ou de définir la langue de base des valeurs d'attribut et du contenu textuel d'un élément. + +## Syntaxe et valeurs + +```js +var langueUtilisee = référenceElement.lang; // Récupérer la valeur de lang +référenceElement.lang = NouvelleLangue; // Définir la valeur de lang +``` + +_langueUtilisee_ est une variable chaîne de caracteres recevant la langue dans laquelle le texte de l'élément courant est écrit. _NouvelleLangue_ est une variable chaîne de caractères dont la valeur définit la langue dans laquelle le texte de l'élément courant est écrit. + +## Exemple + +```js +// ce bout de code compare la langue de base et // redirige vers une autre URL suivant la langue if (document.documentElement.lang === "en") { window.location.href = "un_document.html.en"; } else if(document.documentElement.lang === "ru") { window.location.href = "un_document.html.ru"; } --
Les codes de langues renvoyés par cette propriété sont définis dans la RFC 1766. Par exemple, « en » pour anglais, « ja » pour japonais, « es » pour espagnol, « fr » pour français, etc. La valeur par défaut de cet attribut est unknown
(inconnue). Notez que cet attribut, bien que valide au niveau de chaque élément individuel, et le plus souvent spécifié pour le nœud racine du document.
Ne marche qu'avec l'attribut lang
, et non avec xml:lang
.
Spécification | -Statut | -Commentaires | -
---|---|---|
{{SpecName('DOM2 HTML', 'html.html#ID-59132807', 'id')}} | -{{Spec2('DOM2 HTML')}} | -- |
+``` + +## Notes + +Les codes de langues renvoyés par cette propriété sont définis dans la [RFC 1766](http://tools.ietf.org/html/rfc1766). Par exemple, « en » pour anglais, « ja » pour japonais, « es » pour espagnol, « fr » pour français, etc. La valeur par défaut de cet attribut est `unknown` (inconnue). Notez que cet attribut, bien que valide au niveau de chaque élément individuel, et le plus souvent spécifié pour le nœud racine du document. + +Ne marche qu'avec l'attribut `lang`, et non avec `xml:lang`. + +## Spécification + +| Spécification | Statut | Commentaires | +| ---------------------------------------------------------------------------- | ---------------------------- | ------------ | +| {{SpecName('DOM2 HTML', 'html.html#ID-59132807', 'id')}} | {{Spec2('DOM2 HTML')}} | | diff --git a/files/fr/web/api/htmlelement/offsetheight/index.md b/files/fr/web/api/htmlelement/offsetheight/index.md index 5ceee19bcc..9ea5546329 100644 --- a/files/fr/web/api/htmlelement/offsetheight/index.md +++ b/files/fr/web/api/htmlelement/offsetheight/index.md @@ -5,50 +5,45 @@ tags: - Référence_du_DOM_Gecko translation_of: Web/API/HTMLElement/offsetHeight --- -
{{ ApiRef() }}
+{{ ApiRef() }} -Propriété DHTML permettant d'obtenir la hauteur d'un élément par rapport à la mise en page.
+Propriété DHTML permettant d'obtenir la hauteur d'un élément par rapport à la mise en page. -var hauteurTotaleElem = document.getElementById(id).offsetHeight; -+ var hauteurTotaleElem = document.getElementById(id).offsetHeight; -
hauteurTotalElem est une variable stockant un entier correspondant à la valeur en pixels de la hauteur totale de l'élément identifé par id
. offsetHeight
est une propriété en lecture seule.
Typiquement, la propriété offsetHeight d'un élément est une mesure qui comprend les bordures de l'élément, ses marges internes verticales (padding), la barre de défilement horizontale si présente et affichée, et la hauteur CSS de l'élément.
+Typiquement, la propriété **offsetHeight** d'un élément est une mesure qui comprend les bordures de l'élément, ses marges internes verticales (padding), la barre de défilement horizontale si présente et affichée, et la hauteur CSS de l'élément. -L'exemple d'image ci-avant montre une barre de défilement et un décalage offsetHeight
qui rentre dans la fenêtre. Toutefois, les éléments non-défilables peuvent avoir des valeurs offsetHeight
élevées, voire plus élevéesque le contenu visible. Ces éléments sont généralement contenu au sein d'éléments défilables et, de fait, les éléments non-défilables peuvent être partiellement ou complètement invisible, selon la valeur de scrollTop
pour le conteneur.
offsetHeight
fait partie du modèle objet DHTML de Microsoft Internet Explorer. Elle ne fait partie d'aucune spécification ou recommandation technique du W3C.
offsetHeight
est une propriété du modèle objet DHTML introduite par Microsoft Internet Explorer. On l'appelle parfois la hauteur physique ou graphique d'un élément, ou sa hauteur « border-box » (bordure et boîte).
{{ ApiRef() }}
-Renvoie le nombre de pixels dont le
-
- coin supérieur gauche
- de l'élément courant est décalé vers là gauche au sein du nœud offsetParent
.
left =element.offsetLeft; --
left
est un entier représentant le décalage vers la gauche en pixels.
offsetLeft
renvoie la position du coin supérieur gauche de l'élément ; pas nécessairement du « vrai » bord gauche de l'élément. C'est important pour les éléments span dans les textes continus qui s'étendent sur plusieurs lignes. Le span peut commencer au milieu de la page et continuer au début de la ligne suivante. La propriété offsetLeft
fera référence au coin gauche de départ du span, pas le bord gauche du texte au début de la seconde ligne. Par conséquent, une boîte avec les valeurs left, top, width et height correspondant à offsetLeft, offsetTop, offsetWidth
et offsetHeight
ne contiendra pas forcément un span avec débordement de texte.
var colorTable = document.getElementById("t1"); -var tOLeft = colorTable.offsetLeft; - -if (tOLeft > 5) { - // grand décalage à gauche : faire quelque chose ici -} --
Comme noté plus haut, cet exemple montre une « longue » phrase qui déborde dans un div avec une bordure bleue, et une boîte rouge dont on pourrait croire qu'elle décrit les limites du span.
- -Note : il s'agit d'une image de l'exemple, pas d'un rendu direct dans le navigateur. En effet, il n'est pas possible d'intégrer des scripts dans la page du wiki.
-<div style="width: 300px; border-color:blue; - border-style:solid; border-width:1;"> - <span>Short span. </span> - <span id="long">Long span that wraps withing this div.</span> -</div> - -<div id="box" style="position: absolute; border-color: red; - border-width: 1; border-style: solid; z-index: 10"> -</div> - -<script> +{{ ApiRef() }} + +### Résumé + +Renvoie le nombre de pixels dont le +_coin supérieur gauche_ +de l'élément courant est décalé vers là gauche au sein du nœud [`offsetParent`](fr/DOM/element.offsetParent). + +### Syntaxe + + left =element.offsetLeft; + +`left` est un entier représentant le décalage vers la gauche en pixels. + +### Note + +`offsetLeft` renvoie la position du coin supérieur gauche de l'élément ; pas nécessairement du « vrai » bord gauche de l'élément. C'est important pour les éléments **span** dans les textes continus qui s'étendent sur plusieurs lignes. Le span peut commencer au milieu de la page et continuer au début de la ligne suivante. La propriété `offsetLeft` fera référence au coin gauche de départ du span, pas le bord gauche du texte au début de la seconde ligne. Par conséquent, une boîte avec les valeurs left, top, width et height correspondant à `offsetLeft, offsetTop, offsetWidth` et `offsetHeight` ne contiendra pas forcément un span avec débordement de texte. + +### Exemple + + var colorTable = document.getElementById("t1"); + var tOLeft = colorTable.offsetLeft; + + if (tOLeft > 5) { + // grand décalage à gauche : faire quelque chose ici + } + +### Exemple + +Comme noté plus haut, cet exemple montre une « longue » phrase qui déborde dans un div avec une bordure bleue, et une boîte rouge dont on pourrait croire qu'elle décrit les limites du span. + + + +Note : il s'agit d'une image de l'exemple, pas d'un rendu direct dans le navigateur. En effet, il n'est pas possible d'intégrer des scripts dans la page du wiki. + +```html ++ Short span. + Long span that wraps withing this div. ++ +++ + +``` + +### Voir aussi + +[`offsetParent`](fr/DOM/element.offsetParent), [`offsetTop`](fr/DOM/element.offsetTop), [`offsetWidth`](fr/DOM/element.offsetWidth), [`offsetHeight`](fr/DOM/element.offsetHeight) + +### Spécification + +Cette propriété ne fait partie d'aucun standard ou recommandation technique du W3C. + +[MSDN: offsetLeft](http://msdn.microsoft.com/workshop/author/dhtml/reference/properties/offsetleft.asp) diff --git a/files/fr/web/api/htmlelement/offsetparent/index.md b/files/fr/web/api/htmlelement/offsetparent/index.md index 4f3775191e..93a25485bf 100644 --- a/files/fr/web/api/htmlelement/offsetparent/index.md +++ b/files/fr/web/api/htmlelement/offsetparent/index.md @@ -7,15 +7,20 @@ tags: - Référence_du_DOM_Gecko translation_of: Web/API/HTMLElement/offsetParent --- -{{ ApiRef() }}
-Résumé
-Renvoie une référence à l'objet qui est l'élément conteneur positionné le plus proche (dans la hiérarchie de positionnement). Si l'élément n'est pas positionné, c'est l'élément racine (html en mode de respect des standards ; body en mode de rendu quirks) qui est l'offsetParent.
-Syntaxe
-objetParent = element.offsetParent --Paramètres
-
objetParent
est une référence à l'élément dans lequel l'élément courant est positionné.{{ DOM0() }}
\ No newline at end of file +{{ ApiRef() }} + +### Résumé + +Renvoie une référence à l'objet qui est l'élément conteneur positionné le plus proche (dans la hiérarchie de positionnement). Si l'élément n'est pas positionné, c'est l'élément racine (html en mode de respect des standards ; body en mode de rendu quirks) qui est l'**offsetParent**. + +### Syntaxe + + objetParent = element.offsetParent + +### Paramètres + +- `objetParent` est une référence à l'élément dans lequel l'élément courant est positionné. + +### Spécification + +{{ DOM0() }} diff --git a/files/fr/web/api/htmlelement/offsettop/index.md b/files/fr/web/api/htmlelement/offsettop/index.md index 44e3b80d2c..68c4330e6f 100644 --- a/files/fr/web/api/htmlelement/offsettop/index.md +++ b/files/fr/web/api/htmlelement/offsettop/index.md @@ -6,41 +6,37 @@ tags: - DOM_0 translation_of: Web/API/HTMLElement/offsetTop --- -{{ ApiRef() }}
+{{ ApiRef() }} -offsetTop renvoie la distance entre l'élément courant et le haut du nœud offsetParent
.
topPos = element.offsetTop; -+ topPos = element.offsetTop; -
topPos
est le nombre de pixels depuis le haut de l'élément parent.d = document.getElementById("div1"); + d = document.getElementById("div1"); -topPos = d.offsetTop; + topPos = d.offsetTop; -if (topPos > 10 ) { + if (topPos > 10 ) { - // l'objet est décalé de plus de - // 10 pixels par rapport à son parent + // l'objet est décalé de plus de + // 10 pixels par rapport à son parent -} -+ } -
{{ DOM0() }}
+{{ DOM0() }} -{{ ApiRef() }}
+{{ ApiRef() }} -Renvoie la largeur totale d'un élément.
+Renvoie la largeur totale d'un élément. -var offsetWidth = element.offsetWidth; -+ var offsetWidth = element.offsetWidth; -
offsetWidth
est une propriété en lecture seule.
Typiquement, l'attribut offsetWidth
est une mesure qui comprend les bordures de l'élément, ses marges internes horizontales (padding), la barre de défilement verticale si présente et affichée, et la largeur CSS de l'élément.
offsetWidth
fait partie du modèle objet DHTML de Microsoft Internet Explorer. Elle ne fait partie d'aucune spécification ou recommandation technique du W3C.
offsetWidth
est une propriété du modèle objet DHTML provenant de Microsoft Internet Explorer. On l'appelle parfois la largeur physique ou graphique d'un élément, ou sa largeur « border-box » (bordure et boîte).
{{ Non-standard_header() }}
+{{ Non-standard_header() }} -HTMLElement.outerText
n'est pas une propriété standard. En lecture, elle renvoie la même valeur que {{domxref("Node.innerText")}}. En écriture, elle supprime le noeud courant et le remplace par le texte fourni.
Voir cette réponse proposée sur StackOverflow.
+Voir [cette réponse proposée sur StackOverflow](http://stackoverflow.com/questions/18481382/what-is-the-difference-between-innertext-and-outertext/18481435#18481435). -Ne fait partie d'aucune spécification. Discussion de la norme : whatwg/html#668.
+Ne fait partie d'aucune spécification. Discussion de la norme : [whatwg/html#668](https://github.com/whatwg/html/issues/668). -Microsoft en a publié une description sur MSDN.
+Microsoft en a publié [une description sur MSDN]({{Compat("api.HTMLElement.outerText")}}
+{{Compat("api.HTMLElement.outerText")}} -La propriété HTMLElement.title
représente le titre de l'élément, le texte habituellement affiché dans une fenêtre contextuelle d''info-bulle' lorsque la souris survole le nœud affiché.
Note : Si un nœud n'a pas d'attribut title
, alors l'action par défaut est de l'hériter de son nœud parent, qui peut à son tour l'hériter de son nœud parent, etc..
<div title="InfoCool"> - <div title="">le survol de la souris ici fera apparaître "InfoCool"</div> - <div title=" ">le survol de la souris ici ne fera rien apparaître</div> - </div> --
var chn = element.title; -element.title = chn; -+## Exemple -
bouton1.title = "cliquer pour rafraîchir"; -+## Spécifications -
Spécification | -Statut | -Commentaire | -
---|---|---|
{{SpecName('HTML WHATWG', '#dom-title', 'title')}} | -{{Spec2('HTML WHATWG')}} | -Pas de changement par rapport à la {{SpecName('DOM2 HTML')}}. | -
{{SpecName('DOM2 HTML', 'html.html#ID-78276800', 'title')}} | -{{Spec2('DOM2 HTML')}} | -Pas de changement par rapport à la {{SpecName('DOM1')}}. | -
{{SpecName('DOM1', 'level-one-html.html#ID-78276800', 'title')}} | -{{Spec2('DOM1')}} | -Définition initiale. | -
{{Compat("api.HTMLElement.title")}}
+## Voir aussi -L'événement transitionend
est déclenché lorsqu'une transition CSS est terminée. Dans le cas où une transition est supprimée avant la fin, par exemple si {{cssxref ("transition-property")}} est supprimé ou {{cssxref ("display")}} est défini sur none
, alors l'événement ne pourra pas être généré.
Bulles | -Oui | -
---|---|
Annulable | -Oui | -
Interface | -{{domxref("TransitionEvent")}} | -
Propriété de gestionnaire d'événements | -{{domxref("GlobalEventHandlers/ontransitionend", "ontransitionend")}} | -
Bulles | +Oui | +
Annulable | +Oui | +
Interface | +{{domxref("TransitionEvent")}} | +
Propriété de gestionnaire d'événements | ++ {{domxref("GlobalEventHandlers/ontransitionend", "ontransitionend")}} + | +
L'événement transitionend
est déclenché dans les deux sens - à la fin de la transition vers l'état de transition et lorsqu'il revient complètement à l'état par défaut ou sans transition. S'il n'y a pas de délai ou de durée de transition, si les deux sont 0 ou qu'aucun n'est déclaré, il n'y a pas de transition et aucun des événements de transition n'est déclenché. Si l'événement transitioncancel
est déclenché, l'événement transitionend
ne se déclenchera pas.
Propriétés | -Type | -Description | -
---|---|---|
target {{readonlyInline}} |
- {{domxref("EventTarget")}} | -The event target (the topmost target in the DOM tree). | -
type {{readonlyInline}} |
- {{domxref("DOMString")}} | -The type of event. | -
bubbles {{readonlyInline}} |
- {{jsxref("Boolean")}} | -Whether the event normally bubbles or not. | -
cancelable {{readonlyInline}} |
- {{jsxref("Boolean")}} | -Whether the event is cancellable or not. | -
propertyName {{readonlyInline}} |
- {{domxref("DOMString")}} | -The name of the CSS property associated with the transition. | -
elapsedTime {{readonlyInline}} |
- Float | -The amount of time the transition has been running, in seconds, as of the time the event was generated. This value is not affected by the value of transition-delay . |
-
pseudoElement {{readonlyInline}} |
- {{domxref("DOMString")}} | -The name (beginning with two colons) of the CSS pseudo-element on which the transition occured (in which case the target of the event is that pseudo-element's corresponding element), or the empty string if the transition occurred on an element (which means the target of the event is that element). | -
This code gets an element that has a transition defined and adds a listener to the transitionend
event:
const transition = document.querySelector('.transition'); +```js +const transition = document.querySelector('.transition'); -transition.addEventListener('transitionend', () => { +transition.addEventListener('transitionend', () => { console.log('Transition ended'); -});+}); +``` -
The same, but using the {{domxref("GlobalEventHandlers/ontransitionend", "ontransitionend")}}:
+The same, but using the {{domxref("GlobalEventHandlers/ontransitionend", "ontransitionend")}}: -const transition = document.querySelector('.transition'); +```js +const transition = document.querySelector('.transition'); -transition.ontransitionend = () => { +transition.ontransitionend = () => { console.log('Transition ended'); -};+}; +``` -
In the following example, we have a simple {{htmlelement("div")}} element, styled with a transition that includes a delay:
+In the following example, we have a simple {{htmlelement("div")}} element, styled with a transition that includes a delay: -<div class="transition">Hover over me</div> -<div class="message"></div>+```html +
.transition { +```css +.transition { width: 100px; height: 100px; background: rgba(255,0,0,1); @@ -124,11 +96,13 @@ transition.ontransitionend = () => { .transition:hover { transform: rotate(90deg); background: rgba(255,0,0,0); -}+} +``` -
To this, we'll add some JavaScript to indicate that the transitionstart
, transitionrun
, transitioncancel
and transitionend
events fire. In this example, to cancel the transition, stop hovering over the transitioning box before the transition ends. For the transition end event to fire, stay hovered over the transition until the transition ends.
const message = document.querySelector('.message'); +```js +const message = document.querySelector('.message'); const el = document.querySelector('.transition'); el.addEventListener('transitionrun', function() { @@ -146,46 +120,31 @@ el.addEventListener('transitioncancel', function() { el.addEventListener('transitionend', function() { message.textContent = 'transitionend fired'; }); -+``` -
{{ EmbedLiveSample('Live_example', '100%', '150px') }}
+{{ EmbedLiveSample('Live_example', '100%', '150px') }} -The transitionend
event is fired in both directions: when the box finishes turning and the opacity hits 0 or 1, depending on the direction.
If there is no transition delay or duration, if both are 0s or neither is declared, there is no transition, and none of the transition events are fired.
+If there is no transition delay or duration, if both are 0s or neither is declared, there is no transition, and none of the transition events are fired. -If the transitioncancel
event is fired, the transitionend
event will not fire.
Spécification | -Statut | -Commentaire | -
---|---|---|
{{SpecName("CSS3 Transitions", "#transitionend", "transitionend")}} | -{{Spec2('CSS3 Transitions')}} | -Définition initiale. | -
{{Compat("api.HTMLElement.transitionend_event")}}
+{{Compat("api.HTMLElement.transitionend_event")}} -