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.
Das HTMLElement
Interface repräsentiert ein beliebiges HTML-Element. Einige Elemente implementieren dieses Interface direkt, während andere es über ein vererbendes Interface implementieren.
Instanz-Eigenschaften
Erbt auch Eigenschaften von seinem übergeordneten Interface, Element
.
HTMLElement.accessKey
-
Ein String, der den dem Element zugewiesenen Access Key repräsentiert.
HTMLElement.accessKeyLabel
Schreibgeschützt-
Gibt einen String zurück, der den zugewiesenen Access Key des Elements enthält.
HTMLElement.anchorElement
Schreibgeschützt Nicht standardisiert Experimentell-
Gibt eine Referenz auf das Ankerelement des Elements zurück oder
null
, wenn es keines hat. HTMLElement.attributeStyleMap
Schreibgeschützt-
Ein
StylePropertyMap
, welches die Deklarationen desstyle
-Attributs des Elements repräsentiert. HTMLElement.autocapitalize
-
Ein String, der das Kapitalisierungsverhalten des Elements für Benutzereingaben repräsentiert. Gültige Werte sind:
none
,off
,on
,characters
,words
,sentences
. HTMLElement.autofocus
-
Ein boolescher Wert, der das
autofocus
HTML-Globale Attribut widerspiegelt, welches angibt, ob die Steuerung fokussiert werden soll, wenn die Seite geladen wird oder wenn ein Dialog oder Popover angezeigt wird, sofern angegeben in einem Element innerhalb von<dialog>
-Elementen oder Elementen, deren Popover-Attribut gesetzt ist. HTMLElement.autocorrect
Experimentell-
Ein Boolean, der angibt, ob Texteingaben eines Benutzers automatisch korrigiert werden sollen oder nicht. Dies spiegelt das HTML-Globale Attribut
autocorrect
wider. HTMLElement.contentEditable
-
Ein String, bei dem ein Wert von
true
bedeutet, dass das Element bearbeitbar ist, und ein Wert vonfalse
bedeutet, dass es das nicht ist. HTMLElement.dataset
Schreibgeschützt-
Gibt ein
DOMStringMap
zurück, mit dem Skripte die benutzerdefinierten Datenattribute (data-*
) des Elements lesen und schreiben können. HTMLElement.dir
-
Ein String, der das
dir
-Globale Attribut widerspiegelt und die Richtungsabhängigkeit des Elements repräsentiert. Mögliche Werte sind"ltr"
,"rtl"
und"auto"
. HTMLElement.draggable
-
Ein boolescher Wert, der angibt, ob das Element gezogen werden kann.
HTMLElement.editContext
Experimentell-
Gibt den mit dem Element verbundenen
EditContext
zurück odernull
, wenn keiner vorhanden ist. HTMLElement.enterKeyHint
-
Ein String, der definiert, welches Aktionslabel (oder Symbol) für die Eingabetaste auf virtuellen Tastaturen angezeigt werden soll.
-
Ein String oder boolescher Wert, der den Wert des
hidden
Attributs des Elements widerspiegelt. HTMLElement.inert
-
Ein boolescher Wert, der angibt, ob der Benutzeragent so handeln muss, als ob der gegebene Knoten für Benutzerinteraktionsereignisse, Textsuchen auf der Seite ("Seite durchsuchen") und Textauswahl nicht vorhanden ist.
HTMLElement.innerText
-
Repräsentiert den angezeigten Textinhalt eines Knotens und seiner Nachkommen. Als Getter approximiert er den Text, den der Benutzer erhalten würde, wenn er die Inhalte des Elements mit dem Cursor markiert und dann in die Zwischenablage kopiert. Als Setter ersetzt er den Inhalt des ausgewählten Elements und wandelt alle Zeilenumbrüche in
<br>
-Elemente um. HTMLElement.inputMode
-
Ein String-Wert, der den Wert des
inputmode
-Attributs des Elements widerspiegelt. HTMLElement.isContentEditable
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob der Inhalt des Elements bearbeitet werden kann oder nicht.
HTMLElement.lang
-
Ein String, der die Sprache der Attribute, des Textes und der Inhalte eines Elements repräsentiert.
HTMLElement.nonce
-
Gibt die kryptographische Nummer zurück, die einmal verwendet wird und von der Content Security Policy verwendet wird, um zu bestimmen, ob ein bestimmter Abruf ausgeführt werden darf.
HTMLElement.offsetHeight
Schreibgeschützt-
Gibt einen
double
zurück, der die Höhe eines Elements relativ zum Layout darstellt. HTMLElement.offsetLeft
Schreibgeschützt-
Gibt einen
double
zurück, der den Abstand von der linken Grenze dieses Elements zur linken Grenze seinesoffsetParent
darstellt. HTMLElement.offsetParent
Schreibgeschützt-
Ein
Element
, das das Element ist, von dem aus alle Offsets zurzeit berechnet werden. HTMLElement.offsetTop
Schreibgeschützt-
Gibt einen
double
zurück, der den Abstand von der oberen Grenze dieses Elements zur oberen Grenze seinesoffsetParent
darstellt. HTMLElement.offsetWidth
Schreibgeschützt-
Gibt einen
double
zurück, der die Breite eines Elements relativ zum Layout darstellt. HTMLElement.outerText
-
Repräsentiert den angezeigten Textinhalt eines Knotens und seiner Nachkommen. Als Getter ist es dasselbe wie
HTMLElement.innerText
(es repräsentiert den angezeigten Textinhalt eines Elements und seiner Nachkommen). Als Setter ersetzt es den ausgewählten Knoten und seinen Inhalt mit dem gegebenen Wert und wandelt alle Zeilenumbrüche in<br>
-Elemente um. HTMLElement.popover
-
Ruft den Popover-Zustand eines Elements über JavaScript ab und setzt ihn (
"auto"
oder"manual"
), und kann zur Merkmalsüberprüfung verwendet werden. Spiegelt den Wert des globalen HTML-Attributspopover
wider. HTMLElement.spellcheck
-
Ein boolescher Wert, der den Hinweis für die Rechtschreibprüfung steuert. Es ist auf allen HTML-Elementen verfügbar, obwohl es nicht alle beeinflusst.
HTMLElement.style
-
Eine
CSSStyleDeclaration
, die die Deklarationen desstyle
-Attributs des Elements repräsentiert. HTMLElement.tabIndex
-
Ein
long
, der die Position des Elements in der Tabulatorenreihenfolge darstellt. HTMLElement.title
-
Ein String, der den Text enthält, der in einem Popup-Fenster angezeigt wird, wenn die Maus über dem Element ist.
HTMLElement.translate
-
Ein boolescher Wert, der die Übersetzung repräsentiert.
HTMLElement.virtualKeyboardPolicy
Experimentell-
Ein String, der das Verhalten der Bildschirmtastatur auf Geräten wie Tablets, Mobiltelefonen oder anderen Geräten, bei denen möglicherweise keine Hardwaretastatur verfügbar ist, angibt, wenn der Inhalt des Elements bearbeitbar ist (zum Beispiel ein
<input>
oder<textarea>
-Element oder ein Element mit demcontenteditable
-Attribut). HTMLElement.writingSuggestions
-
Ein String, der angibt, ob browserseitige Schreibvorschläge unter dem Geltungsbereich des Elements aktiviert sein sollen oder nicht.
Instanz-Methoden
Erbt auch Methoden von seinem übergeordneten Interface, 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 Mausklick-Ereignis an das Element.
HTMLElement.focus()
-
Macht das Element zum aktuellen Tastaturfokus.
HTMLElement.hidePopover()
-
Verbirgt ein Popover-Element, indem es es von der obersten Schicht entfernt und es mit
display: none
stylt. HTMLElement.showPopover()
-
Zeigt ein Popover-Element, indem es es der obersten Schicht hinzufügt und
display: none;
aus seinen Stilen entfernt. HTMLElement.togglePopover()
-
Wechselt ein Popover-Element zwischen den Zuständen 'verborgen' und 'sichtbar'.
Ereignisse
Hören Sie diese Ereignisse mithilfe von addEventListener()
oder indem Sie einen Ereignis-Listener der oneventname
-Eigenschaft dieses Interfaces zuweisen.
Erbt auch Ereignisse von seinem übergeordneten Interface, Element
.
cancel
-
Wird für
<input>
und<dialog>
-Elemente ausgelöst, wenn der Benutzer den aktuell geöffneten Dialog mit der Esc-Taste abbricht. change
-
Wird ausgelöst, wenn der
value
eines<input>
,<select>
oder<textarea>
-Elements vom Benutzer geändert und festgeschrieben wurde. Im Gegensatz zuminput
-Ereignis wird daschange
-Ereignis nicht unbedingt bei jeder Änderung desvalue
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, wenn die 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 Schneideaktion über die Benutzeroberfläche des Browsers initiiert.
paste
-
Wird ausgelöst, wenn der Benutzer eine Einfügeaktion über die Benutzeroberfläche des Browsers initiiert.
Drag & Drop-Ereignisse
drag
-
Dieses Ereignis wird ausgelöst, wenn ein Element oder eine Textauswahl gezogen wird.
dragend
-
Dieses Ereignis wird ausgelöst, wenn eine Ziehoperation beendet wird (durch Loslassen einer Maustaste oder Drücken der Escape-Taste).
dragenter
-
Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl ein gültiges Ziel erreicht.
dragleave
-
Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl ein gültiges 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 Ziel befindet (alle 50 ms, wenn die Maus nicht bewegt wird, ansonsten viel schneller zwischen ca. 5 ms (langsame Bewegung) und 1 ms (schnelle Bewegung). Dieses Auslösepattern unterscheidet sich von
mouseover
. 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 Ziel fallen gelassen wird.
Umschalt-Ereignisse
Spezifikationen
Specification |
---|
HTML Standard # htmlelement |
Browser-Kompatibilität
BCD tables only load in the browser