--- title: element slug: Web/API/Element tags: - API - DOM - Elements - Interface - Reference - Web API translation_of: Web/API/Element ---
{{APIRef("DOM")}}
Element
est la classe de base la plus générale à partir de laquelle tous les objets d'un {{domxref("Document")}} héritent. Il n'a que des méthodes et des propriétés communes à tous les types d'éléments. Les classes plus spécifiques héritent d'Element
. Par exemple, l'interface {{domxref("HTMLElement")}} est l'interface de base pour les éléments HTML, tandis que l'interface {{domxref ("SVGElement")}} est la base de tous les éléments SVG. La plupart des fonctionnalités sont spécifiées plus bas dans la hiérarchie des classes.
Les langages en dehors du domaine de la plate-forme Web, comme XUL via l'interface XULElement
, implémentent également Element
.
{{InheritanceDiagram}}
Hérite des propriétés de son interface parent {{domxref("Node")}} et, par extension, du parent de cette interface {{domxref("EventTarget")}}. Il implémente les propriétés de {{domxref("ParentNode")}}, {{domxref("ChildNode")}}, {{domxref("NonDocumentTypeChildNode")}} et {{domxref("Animatable")}}.
null
s'il n'est pas un espace de noms.Note : Dans Firefox 3.5 et versions antérieures, les éléments HTML ne sont pas dans un espace de noms. Dans les versions ultérieures, les éléments HTML se trouvent dans l'espace de noms http://www.w3.org/1999/xhtml
dans les arborescences HTML et XML. {{gecko_minversion_inline("1.9.2")}}
null
s'il n'y a pas de noeud frère.part
de l'élément (c'est-à-dire définis en utilisant l'attribut part
), retournés dans un {{domxref("DOMTokenList")}}.null
si aucun préfixe n'est spécifié.null
s'il n'y a pas d'élément frère.Note : DOM niveau 3 définit namespaceURI
, localName
et prefix
sur l'interface {{domxref("Node")}}. Dans DOM4, ils ont été déplacés dans Element
.
Ce changement est implémenté dans Chrome depuis la version 46.0 et Firefox à partir de la version 48.0.
L'interface Element
inclut la propriété suivante, définie sur le "mixin" {{domxref("Slotable")}}.
Hérite des méthodes de son parent {{domxref ("Node")}} et de son propre parent {{domxref ("EventTarget")}}, et implémente celles de {{domxref("ParentNode")}}, {{domxref("ChildNode")}} , {{domxref("NonDocumentTypeChildNode")}} et {{domxref("Animatable")}}.
Ecoute ces évènements en utilisant addEventListener()
ou en assignant un écouteur d'évènement (event listener) au oneventname
propriété de cette interface.
contextmenu
. {{deprecated_inline}}Element
si une erreur survient en tentant de passer vers ou de quitter le plein écran.{{domxref("Element/keydown_event", "keydown")}}
{{domxref("Element/keypress_event", "keypress")}}
{{domxref("Element/keyup_event", "keyup")}}
Spécification | État | Commentaire |
---|---|---|
{{SpecName("Web Animations", '', '')}} | {{Spec2("Web Animations")}} | Ajoute la méthode getAnimations() . |
{{SpecName('Undo Manager', '', 'Element')}} | {{Spec2('Undo Manager')}} | Ajoute les propriétés undoScope et undoManager . |
{{SpecName('Pointer Events 2', '#extensions-to-the-element-interface', 'Element')}} | {{Spec2('Pointer Events 2')}} | Ajoute les gestionnaires d'évènements suivants : ongotpointercapture etonlostpointercapture .Ajoute les méthodes suivantes : setPointerCapture() et releasePointerCapture() . |
{{SpecName('Pointer Events', '#extensions-to-the-element-interface', 'Element')}} | {{Spec2('Pointer Events')}} | Ajoute les gestionnaires d'évènements suivants : ongotpointercapture et onlostpointercapture .Ajoute les méthodes suivantes : setPointerCapture() et releasePointerCapture() . |
{{SpecName('Selectors API Level 1', '#interface-definitions', 'Element')}} | {{Spec2('Selectors API Level 1')}} | Ajoute les méthodes suivantes : querySelector() et querySelectorAll() . |
{{SpecName('Pointer Lock', 'index.html#element-interface', 'Element')}} | {{Spec2('Pointer Lock')}} | Ajoute la méthoderequestPointerLock() . |
{{SpecName('Fullscreen', '#api', 'Element')}} | {{Spec2('Fullscreen')}} | Ajoute la méthode requestFullscreen(). |
{{SpecName('DOM Parsing', '#extensions-to-the-element-interface', 'Element')}} | {{Spec2('DOM Parsing')}} | Ajoute les propriétés suivantes : innerHTML et outerHTML .Ajoute les méthodes suivantes : insertAdjacentHTML() . |
{{SpecName('CSSOM View', '#extensions-to-the-element-interface', 'Element')}} | {{Spec2('CSSOM View')}} | Ajoute les propriétés suivantes : scrollTop , scrollLeft , scrollWidth , scrollHeight , clientTop , clientLeft , clientWidth et clientHeight .Ajoute les méthodes suivantes : getClientRects() , getBoundingClientRect() et scrollIntoView() . |
{{SpecName('Element Traversal', '#ecmascript-bindings', 'Element')}} | {{Spec2('Element Traversal')}} | Ajoute l'héritage de l'interface {{domxref("ElementTraversal")}}. |
{{SpecName('DOM WHATWG', '#interface-element', 'Element')}} | {{Spec2('DOM WHATWG')}} | Supprime les méthodes suivantes : closest() , setIdAttribute() , setIdAttributeNS() , et setIdAttributeNode() .Supprime la propriété schemaTypeInfo .Modifie la valeur retournée de getElementsByTag() et getElementsByTagNS() .Déplace hasAttributes() de l'interface Node ici.Insère insertAdjacentElement() et insertAdjacentText() . |
{{SpecName('DOM3 Core', 'core.html#ID-745549614', 'Element')}} | {{Spec2('DOM3 Core')}} | Ajoute les méthodes suivantes : setIdAttribute() , setIdAttributeNS() et setIdAttributeNode() . Ces méthodes n'ont jamais été implémentées et ont été supprimées dans des spécifications ultérieures.Ajoute la propriété schemaTypeInfo . Cette propriété n'a jamais été implémentée et a été supprimée dans des spécificationq ultérieures. |
{{SpecName('DOM2 Core', 'core.html#ID-745549614', 'Element')}} | {{Spec2('DOM2 Core')}} | La méthode normalize() a été déplacée vers {{domxref("Node")}}. |
{{SpecName('DOM1', 'level-one-core.html#ID-745549614', 'Element')}} | {{Spec2('DOM1')}} | Définition initiale. |
Fonctionnalité | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | 1.0 | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("1")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | 1.0 |
children |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9")}} | 7.0 with a significant bug [1] 9.0 according to the spec |
{{CompatVersionUnknown}} | {{CompatNo}} |
childElementCount , nextElementSibling , previousElementSibling |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9.1")}} | 9.0 | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
firstElementChild , lastElementChild |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9")}} | 9.0 | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
classList |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9.2")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | |
outerHTML {{experimental_inline}} |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("11")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
clientLeft , clientTop {{experimental_inline}} |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9.1")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
getBoundingClientRect() , getClientRects() {{experimental_inline}} |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
querySelector() , querySelectorAll() |
1.0 | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.9.1")}} | 8.0 | 10.0 | 3.2 (525.3) |
insertAdjacentHTML() {{experimental_inline}} |
1.0 | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("8")}} | 4.0 | 7.0 | 4.0 (527) |
setCapture() {{non-standard_inline}} |
{{CompatNo}} | {{CompatNo}} | {{CompatGeckoDesktop("2")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
oncopy , oncut , onpaste {{non-standard_inline}} |
{{CompatNo}} | {{CompatNo}} | {{CompatGeckoDesktop("1.9")}} | {{CompatVersionUnknown}} | {{CompatNo}} | |
onwheel {{non-standard_inline}} |
{{CompatNo}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("17")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
ongotpointercapture , onlostpointercapture , setPointerCapture() , and releasePointerCapture() |
{{CompatChrome(52.0)}} [4] | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} [3] | 10.0 | {{CompatNo}} | {{CompatNo}} |
matches() {{experimental_inline}} |
{{CompatVersionUnknown}} with the non-standard name webkitMatchesSelector |
{{CompatVersionUnknown}} {{property_prefix("webkit")}} {{property_prefix("ms")}} | {{CompatGeckoDesktop("1.9.2")}} with the non-standard name mozMatchesSelector {{CompatGeckoDesktop("34")}} with the standard name |
9.0 with the non-standard name msMatchesSelector |
11.5 with the non-standard name oMatchesSelector 15.0 with the non-standard name webkitMatchesSelector |
5.0 with the non-standard name webkitMatchesSelector |
requestPointerLock() |
16.0 {{property_prefix("webkit")}}, behind an about:flags 22.0 {{property_prefix("webkit")}} (with special cases, progressively lifted see [2]) |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("14")}}{{property_prefix("moz")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
requestFullscreen() |
14.0 {{property_prefix("webkit")}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("10")}} {{property_prefix("moz")}} | 11.0 {{property_prefix("ms")}} | 12.10 15.0 {{property_prefix("webkit")}} |
5.1 {{property_prefix("webkit")}} |
undoManager and undoScope |
{{CompatNo}} | {{CompatNo}} | {{CompatVersionUnknown}} (behind the dom.undo_manager.enabled pref) |
{{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
attributes |
{{CompatUnknown}} | {{CompatNo}} | {{CompatGeckoDesktop("22")}} Before this it was available via the {{domxref("Node")}} interface that any element inherits. |
{{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
scrollTopMax() and scrollLeftMax() |
{{CompatNo}} | {{CompatNo}} | {{CompatGeckoDesktop("16")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
closest() |
{{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("35")}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
hasAttributes() |
{{CompatVersionUnknown}} | {{CompatNo}} | {{CompatGeckoDesktop("1.0")}} (on the {{domxref("Node")}} interface) {{CompatGeckoDesktop("35")}} (on this interface |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
insertAdjacentElement() , insertAdjacentText() |
{{CompatVersionUnknown}} | {{CompatNo}} | {{CompatGeckoDesktop("48.0")}} | {{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
assignedSlot , attatchShadow , shadowRoot , and slot |
{{CompatChrome(53)}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
computedRole and computedName |
{{CompatChrome(41)}}[4] | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | 28[4] | {{CompatUnknown}} |
Fonctionnalité | Android | Android Webview | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | 1.0 | {{CompatVersionUnknown}} | {{CompatGeckoMobile("1")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | 1.0 | ||
scrollTopMax() and scrollLeftMax() |
{{CompatNo}} | {{CompatNo}} | {{CompatGeckoMobile("16")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} | ||
closest() |
{{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoMobile("35")}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | ||
hasAttributes() |
{{CompatVersionUnknown}} | {{CompatNo}} | {{CompatGeckoMobile("1.0")}} (on the {{domxref("Node")}} interface) {{CompatGeckoMobile("35")}} (on this interface |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | ||
insertAdjacentElement() , insertAdjacentText() |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoMobile("48.0")}} | {{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | ||
assignedSlot , attatchShadow , shadowRoot , and slot |
{{CompatNo}} | {{CompatChrome(53.0)}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatChrome(53)}} |
computedRole and computedName |
{{CompatNo}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | 28[4] | {{CompatUnknown}} | {{CompatNo}} |
[1] Internet Explorer 7 et 8 retourne incorrectement les commentaires dans le cadre des enfants d'un élément. Ceci est corrigé dans Internet Explorer 9 et versions ultérieures.
[2] Chrome 16 permet webkitRequestPointerLock()
uniquement en plein écran ; Chrome 21 pour un site web de confiance (permission demandée) ; Chrome 22 autorise par défaut pour tous les documents de même origine ; Chrome 23 autorise dans le bac à sable {{HTMLElement("iframe")}} si la valeur non-standard webkit-allow-pointer-lock
est définie dans l'attribut {{htmlattrxref("sandbox", "iframe")}}.
[3] Implémentation retiré. Voir {{Bug("1166347")}}.
[4] Derrière une balise (flag).
Devrait figurer sur une page traitant de NodeList ; item: Retrouve un nœud dans une <code>NodeList</code> par son indice. (DOM Core, ne fait pas partie de l'interface <code>Element</code>) ?? ; supports: Teste si cette implémentation du DOM gère une fonctionnalité particulière. (DOM Core)