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.
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 desstyle
-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, undfalse
, 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 odernull
, wenn keiner vorhanden ist. HTMLElement.enterKeyHint
-
Ein String, der definiert, welche Aktion für die Enter-Taste auf virtuellen Tastaturen dargestellt werden soll.
-
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 seinesoffsetParent
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 seinesoffsetParent
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 despopover
-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 desstyle
-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 gesetztemcontenteditable
-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 zuminput
-Ereignis wird daschange
-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
Spezifikationen
Specification |
---|
HTML # htmlelement |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubLegend
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.