HTMLElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Das HTMLElement-Interface repräsentiert jedes HTML-Element. Einige Elemente implementieren dieses Interface direkt, während andere es über ein abgeleitetes Interface implementieren.

EventTarget Node Element HTMLElement

Instanzeigenschaften

Erbt außerdem Eigenschaften von seinem Elternteil, Element.

HTMLElement.accessKey

Ein String, der den Accesskey repräsentiert, der dem Element zugewiesen ist.

HTMLElement.accessKeyLabel Schreibgeschützt

Gibt einen String zurück, der den zugewiesenen Accesskey des Elements enthält.

HTMLElement.anchorElement Schreibgeschützt  Nicht standardisiert Experimentell

Gibt eine Referenz auf das Ankerelement des Elements zurück oder null, falls keines vorhanden ist.

HTMLElement.attributeStyleMap Schreibgeschützt

Ein StylePropertyMap, das die Deklarationen des style-Attributs des Elements repräsentiert.

HTMLElement.autocapitalize

Ein String, der das Verhalten der Groß-/Kleinschreibung bei Benutzereingaben repräsentiert. Gültige Werte sind: none, off, on, characters, words, sentences.

HTMLElement.autofocus

Ein boolescher Wert, der das autofocus-Globale-Attribut in HTML widerspiegelt. Es zeigt an, ob das Steuerelement fokussiert werden soll, wenn die Seite geladen wird oder wenn ein Dialog oder Popover angezeigt wird, falls angegeben innerhalb von <dialog>-Elementen oder Elementen mit gesetztem Popover-Attribut.

HTMLElement.autocorrect

Ein boolescher Wert, der angibt, ob die Benutzereingabe automatisch korrigiert werden soll. Dieser Wert spiegelt das autocorrect-Globale-Attribut aus HTML wider.

HTMLElement.contentEditable

Ein String, wobei der Wert true bedeutet, dass das Element bearbeitbar ist, und false, dass es nicht bearbeitbar ist.

HTMLElement.dataset Schreibgeschützt

Gibt ein DOMStringMap zurück, mit dem Script auf die benutzerdefinierten Datenattribute (data-*) des Elements zugreifen und diese ändern kann.

HTMLElement.dir

Ein String, der das dir Globale-Attribut widerspiegelt und die Ausrichtung des Elements repräsentiert. Mögliche Werte sind "ltr", "rtl" und "auto".

HTMLElement.draggable

Ein boolescher Wert, der angibt, ob das Element ziehbar ist.

HTMLElement.editContext Experimentell

Gibt den EditContext, der mit dem Element verknüpft ist, zurück oder null, wenn keiner vorhanden ist.

HTMLElement.enterKeyHint

Ein String, der definiert, welche Aktion für die Enter-Taste auf virtuellen Tastaturen dargestellt werden soll.

HTMLElement.hidden

Ein String oder boolescher Wert, der dem Wert des hidden-Attributs des Elements entspricht.

HTMLElement.inert

Ein boolescher Wert, der angibt, ob der User-Agent so handeln muss, als ob der gegebene Knoten für Benutzerinteraktionen, Seitentextsuchen ("Text in Seite finden") und Textauswahl nicht vorhanden ist.

HTMLElement.innerText

Repräsentiert den gerenderten Textinhalt eines Knotens und seiner Nachkommen. Als Getter entspricht er etwa dem Text, den der Benutzer erhalten würde, wenn er den Inhalt des Elements mit dem Cursor markiert und in die Zwischenablage kopiert. Als Setter ersetzt er den Inhalt innerhalb des ausgewählten Elements und konvertiert Zeilenumbrüche in <br>-Elemente.

HTMLElement.inputMode

Ein String-Wert, der dem Wert des inputmode-Attributs des Elements entspricht.

HTMLElement.isContentEditable Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob der Inhalt des Elements bearbeitbar ist.

HTMLElement.lang

Ein String, der die Sprache der Attribute, des Textes und der Inhalte eines Elements repräsentiert.

HTMLElement.nonce

Gibt die einmalige kryptographische Nummer zurück, die von der Content Security Policy verwendet wird, um zu bestimmen, ob ein bestimmter Abruf fortgesetzt werden darf.

HTMLElement.offsetHeight Schreibgeschützt

Gibt eine double-Zahl zurück, die die Höhe eines Elements relativ zum Layout angibt.

HTMLElement.offsetLeft Schreibgeschützt

Gibt eine double-Zahl zurück, die die Distanz von der linken Grenze dieses Elements zur linken Grenze seines offsetParent angibt.

HTMLElement.offsetParent Schreibgeschützt

Ein Element, das das Element ist, aus dem alle Versatzberechnungen aktuell durchgeführt werden.

HTMLElement.offsetTop Schreibgeschützt

Gibt eine double-Zahl zurück, die die Distanz von der oberen Grenze dieses Elements zur oberen Grenze seines offsetParent angibt.

HTMLElement.offsetWidth Schreibgeschützt

Gibt eine double-Zahl zurück, die die Breite eines Elements relativ zum Layout angibt.

HTMLElement.outerText

Repräsentiert den gerenderten Textinhalt eines Knotens und seiner Nachkommen. Als Getter entspricht es HTMLElement.innerText (der gerenderte Textinhalt eines Elements und seiner Nachkommen wird dargestellt). Als Setter ersetzt es den ausgewählten Knoten und seinen Inhalt durch den gegebenen Wert und konvertiert Zeilenumbrüche in <br>-Elemente.

HTMLElement.popover

Holt und setzt den Popover-Zustand eines Elements über JavaScript ("auto" oder "manual") und kann für die Feature-Erkennung verwendet werden. Spiegelt den Wert des popover-Globalen-HTML-Attributs wider.

HTMLElement.spellcheck

Ein boolescher Wert, der den Rechtschreibprüfung-Hinweis steuert. Er ist bei allen HTML-Elementen verfügbar, beeinflusst jedoch nicht alle.

HTMLElement.style

Eine CSSStyleDeclaration, die die Deklarationen des style-Attributs des Elements repräsentiert.

HTMLElement.tabIndex

Ein long, der die Position des Elements in der Tabulatorreihenfolge repräsentiert.

HTMLElement.title

Ein String, der den Text enthält, der in einer Popup-Box angezeigt wird, wenn sich der Mauszeiger über dem Element befindet.

HTMLElement.translate

Ein boolescher Wert, der die Übersetzung angibt.

HTMLElement.virtualKeyboardPolicy Experimentell

Ein String, der das Verhalten der virtuellen On-Screen-Tastatur für Geräte wie Tablets, Mobiltelefone oder andere Geräte angibt, bei denen möglicherweise keine Hardware-Tastatur verfügbar ist, falls der Inhalt des Elements editierbar ist (z. B. ein <input>- oder <textarea>-Element oder ein Element mit gesetztem contenteditable-Attribut).

HTMLElement.writingSuggestions

Ein String, der angibt, ob durch den Browser bereitgestellte Schreibvorschläge im Bereich des Elements aktiviert werden sollen oder nicht.

Instanzmethoden

Erbt außerdem Methoden von seinem Elternteil, Element.

HTMLElement.attachInternals()

Gibt ein ElementInternals-Objekt zurück und ermöglicht es einem benutzerdefinierten Element, an HTML-Formularen teilzunehmen.

HTMLElement.blur()

Entfernt den Tastaturfokus vom aktuell fokussierten Element.

HTMLElement.click()

Sendet ein Mausevent zum Klicken an das Element.

HTMLElement.focus()

Macht das Element zum aktuellen Tastaturfokus.

HTMLElement.hidePopover()

Versteckt ein Popover-Element, indem es aus der obersten Schicht entfernt und mit display: none versehen wird.

HTMLElement.showPopover()

Zeigt ein Popover-Element an, indem es zur obersten Schicht hinzugefügt und display: none; aus seinen Stilen entfernt wird.

HTMLElement.togglePopover()

Schaltet ein Popover-Element zwischen den Zuständen "ausgeblendet" und "angezeigt" um.

Ereignisse

Diese Ereignisse können mit addEventListener() überwacht werden oder indem ein Event-Listener auf die oneventname-Eigenschaft dieses Interfaces zugewiesen wird.

Erbt außerdem Ereignisse von seinem Elternteil, Element.

cancel

Wird für <input>- und <dialog>-Elemente ausgelöst, wenn der Benutzer den aktuell geöffneten Dialog mit der Esc-Taste schließt.

change

Wird ausgelöst, wenn der value eines <input>-, <select>- oder <textarea>-Elements von einem Benutzer geändert und bestätigt wurde. Im Gegensatz zum input-Ereignis wird das change-Ereignis nicht zwingend für jede Änderung eines Werts eines Elements ausgelöst.

error

Wird ausgelöst, wenn eine Ressource nicht geladen werden konnte oder nicht verwendet werden kann.

load

Wird für Elemente ausgelöst, die eine Ressource enthalten, sobald diese Ressource erfolgreich geladen wurde.

Zwischenablage-Ereignisse

copy

Wird ausgelöst, wenn der Benutzer eine Kopieraktion über die Benutzeroberfläche des Browsers initiiert.

cut

Wird ausgelöst, wenn der Benutzer eine Ausschneiden-Aktion über die Benutzeroberfläche des Browsers initiiert.

paste

Wird ausgelöst, wenn der Benutzer eine Einfügen-Aktion über die Benutzeroberfläche des Browsers initiiert.

Drag & Drop-Ereignisse

drag

Dieses Ereignis wird ausgelöst, wenn ein Element oder Text ausgewählt und gezogen wird.

dragend

Dieses Ereignis wird ausgelöst, wenn eine Ziehoperation durch Loslassen der Maustaste oder Betätigen der Escape-Taste beendet wird.

dragenter

Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl in ein gültiges Drop-Ziel eintritt.

dragleave

Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl ein gültiges Drop-Ziel verlässt.

dragover

Dieses Ereignis wird kontinuierlich ausgelöst, wenn ein Element oder eine Textauswahl gezogen wird und sich der Mauszeiger über einem gültigen Drop-Ziel befindet (etwa alle 50 ms, wenn sich die Maus nicht bewegt, ansonsten viel schneller, etwa zwischen 5 ms (langsame Bewegung) und 1 ms (schnelle Bewegung)). Dieses Auslöseverhalten unterscheidet sich vom mouseover-Ereignis.

dragstart

Dieses Ereignis wird ausgelöst, wenn der Benutzer beginnt, ein Element oder eine Textauswahl zu ziehen.

drop

Dieses Ereignis wird ausgelöst, wenn ein Element oder eine Textauswahl auf ein gültiges Drop-Ziel abgelegt wird.

Toggle-Ereignisse

beforetoggle

Wird ausgelöst, wenn das Element ein Popover oder <dialog> ist, bevor es ausgeblendet oder angezeigt wird.

toggle

Wird ausgelöst, wenn das Element ein Popover, <dialog> oder <details> ist, kurz nachdem es ausgeblendet oder angezeigt wurde.

Spezifikationen

Specification
HTML
# htmlelement

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLElement
accessKey
accessKeyLabel
anchorElement
ExperimentalNon-standard
attachInternals
attributeStyleMap
autocapitalize
autocorrect
autofocus
beforetoggle event
beforetoggle event fires at dialog elements
beforetoggle event fires at popover elements
blur
change event
click
command event
Experimental
contentEditable
plaintext-only as a value
dataset
dir
drag event
dragend event
dragenter event
dragexit event
DeprecatedNon-standard
draggable
dragleave event
dragover event
dragstart event
drop event
editContext
Experimental
enterKeyHint
error event
focus
options.focusVisible parameter
Experimental
options.preventScroll parameter
hidden
hidePopover
inert
Element is ignored for the purposes of find-in-page.
innerText
Can be set with TrustedScript instances in HTMLScriptElement.
inputMode
isContentEditable
lang
nonce
offsetHeight
offsetLeft
offsetParent
offsetTop
offsetWidth
outerText
popover
hint value
Experimental
showPopover
source option
Experimental
Implicit anchor reference via source
Experimental
spellcheck
style
tabIndex
title
togglePopover
Returns true or false
source option
Experimental
Implicit anchor reference via source
Experimental
toggle event
toggle event fires at details elements
toggle event fires at dialog elements
toggle event fires at popover elements
translate
virtualKeyboardPolicy
Experimental
writingSuggestions

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
User must explicitly enable this feature.
Has more compatibility info.

Siehe auch