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 ein beliebiges HTML-Element. Einige Elemente implementieren dieses Interface direkt, während andere es über ein Interface implementieren, das davon erbt.
Instanz-Eigenschaften
Erbt auch Eigenschaften von seinem übergeordneten Objekt, Element
.
HTMLElement.accessKey
-
Ein Zeichenfolgenwert, der den Zugriffsschlüssel darstellt, der dem Element zugewiesen ist.
HTMLElement.accessKeyLabel
Schreibgeschützt-
Gibt eine Zeichenfolge zurück, die den dem Element zugewiesenen Zugriffsschlüssel 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-
Eine
StylePropertyMap
, die die Deklarationen desstyle
-Attributs des Elements repräsentiert. HTMLElement.autocapitalize
-
Eine Zeichenfolge, die das Verhalten der Großschreibung für Benutzereingaben des Elements darstellt. Gültige Werte sind:
none
,off
,on
,characters
,words
,sentences
. HTMLElement.autofocus
-
Ein boolescher Wert, der das HTML-Globale Attribut
autofocus
widerspiegelt, welches angibt, ob das Kontrollkästchen fokussiert werden soll, wenn die Seite geladen wird oder wenn das Dialogfeld oder das Popover angezeigt wird, falls es in einem Element innerhalb von<dialog>
-Elementen oder Elementen, deren Popover-Attribut festgelegt ist, angegeben ist. HTMLElement.autocorrect
-
Ein Boolescher Wert, der darstellt, ob der vom Benutzer eingegebene Text automatisch korrigiert werden soll oder nicht. Dies spiegelt das HTML-Globale Attribut
autocorrect
wider. HTMLElement.contentEditable
-
Eine Zeichenfolge, bei der ein Wert von
true
bedeutet, dass das Element bearbeitbar ist, und ein Wert vonfalse
, dass es nicht bearbeitbar ist. HTMLElement.dataset
Schreibgeschützt-
Gibt ein
DOMStringMap
zurück, mit dem ein Skript die benutzerdefinierten Dateneigenschaften (data-*
) eines Elements lesen und schreiben kann. HTMLElement.dir
-
Eine Zeichenfolge, die das
dir
-Globale Attribut widerspiegelt, welches die Schreibrichtung des Elements darstellt. 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
EditContext
zurück, der mit dem Element assoziiert ist, odernull
, wenn keiner vorhanden ist. HTMLElement.enterKeyHint
-
Eine Zeichenfolge, die angibt, welches Aktionssymbol (oder Ikone) für die Eingabetaste auf virtuellen Tastaturen angezeigt werden soll.
-
Ein Zeichenfolgen- oder boolescher Wert, der den Wert des
hidden
-Attributs des Elements widerspiegelt. HTMLElement.inert
-
Ein boolescher Wert, der angibt, ob der Nutzer-Agent so handeln muss, als ob der gegebene Knoten für die Zwecke von Benutzerinteraktionsereignissen, textbasierte In-Page-Suchen ("Seite durchsuchen") und Textauswahl abwesend ist.
HTMLElement.innerText
-
Repräsentiert den gerenderten Textinhalt eines Knotens und seiner Nachkommen. Als Leser approximiert er den Text, den der Benutzer erhalten würde, wenn er den Inhalt des Elements mit dem Cursor markiert und dann in die Zwischenablage kopiert hätte. Als Schreiber ersetzt er den Inhalt innerhalb des ausgewählten Elements, indem er alle Zeilenumbrüche in
<br>
-Elemente konvertiert. HTMLElement.inputMode
-
Ein Zeichenfolgenwert, 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
-
Eine Zeichenfolge, die die Sprache der Attribute, des Textes und der Inhalte eines Elements repräsentiert.
HTMLElement.nonce
-
Gibt die einmal verwendete kryptografische Nummer zurück, die von der Content Security Policy verwendet wird, um zu bestimmen, ob ein gegebener Abruf durchgeführt werden darf.
HTMLElement.offsetHeight
Schreibgeschützt-
Gibt ein
double
zurück, das die Höhe eines Elements relativ zum Layout enthält. HTMLElement.offsetLeft
Schreibgeschützt-
Gibt ein
double
zurück, der die Entfernung vom linken Rand dieses Elements zum linken Rand desoffsetParent
enthält. HTMLElement.offsetParent
Schreibgeschützt-
Ein
Element
, von dem alle Offset-Berechnungen derzeit durchgeführt werden. HTMLElement.offsetTop
Schreibgeschützt-
Gibt ein
double
zurück, der die Entfernung vom oberen Rand dieses Elements zum oberen Rand desoffsetParent
enthält. HTMLElement.offsetWidth
Schreibgeschützt-
Gibt ein
double
zurück, das die Breite eines Elements relativ zum Layout enthält. HTMLElement.outerText
-
Repräsentiert den gerenderten Textinhalt eines Knotens und seiner Nachkommen. Als Leser ist es dasselbe wie
HTMLElement.innerText
(es repräsentiert den angezeigten Textinhalt eines Elements und seiner Nachkommen). Als Schreiber ersetzt er den ausgewählten Knoten und seine Inhalte durch den gegebenen Wert und konvertiert alle Zeilenumbrüche in<br>
-Elemente. HTMLElement.popover
-
Ruft den Popover-Zustand eines Elements über JavaScript ab und setzt diesen (
"auto"
,"hint"
oder"manual"
) und kann zur Feature-Erkennung verwendet werden. Spiegelt den Wert des globalen HTML-Attributspopover
wider. HTMLElement.spellcheck
-
Ein boolescher Wert, der den Hinweis auf die Rechtschreibprüfung steuert. Es ist für alle HTML-Elemente verfügbar, obwohl es nicht alle betrifft.
HTMLElement.style
-
Eine
CSSStyleDeclaration
, die die Deklarationen desstyle
-Attributs des Elements repräsentiert. HTMLElement.tabIndex
-
Eine
long
, die die Position des Elements in der Tab-Reihenfolge repräsentiert. HTMLElement.title
-
Eine Zeichenfolge, die den Text enthält, der in einem Popup-Fenster erscheint, wenn die Maus über dem Element ist.
HTMLElement.translate
-
Ein boolescher Wert, der die Übersetzung repräsentiert.
HTMLElement.virtualKeyboardPolicy
Experimentell-
Eine Zeichenfolge, die das Verhalten der virtuellen Bildschirmtastatur auf Geräten wie Tablets, Mobiltelefonen oder anderen Geräten, bei denen möglicherweise keine Hardwaretastatur verfügbar ist, angibt, sofern der Inhalt des Elements bearbeitbar ist (zum Beispiel ist es ein
<input>
- oder<textarea>
-Element, oder ein Element mit dem Attributcontenteditable
gesetzt). HTMLElement.writingSuggestions
-
Eine Zeichenfolge, die angibt, ob vom Browser bereitgestellte Schreibvorschläge im Rahmen des Elements aktiv sein sollen oder nicht.
Instanz-Methoden
Erbt auch Methoden von seinem übergeordneten Objekt, Element
.
HTMLElement.attachInternals()
-
Gibt ein
ElementInternals
-Objekt zurück und ermöglicht es einem benutzerdefinierten Element, an HTML-Formularen teilzunehmen. HTMLElement.blur()
-
Entfernt die Tastaturfokussierung von dem aktuell fokussierten Element.
HTMLElement.click()
-
Sendet ein Mausklick-Ereignis an das Element.
HTMLElement.focus()
-
Macht das Element zum aktuellen Tastaturfokus.
HTMLElement.hidePopover()
-
Versteckt ein Popover-Element, indem es aus der oberen Schicht entfernt und mit
display: none
gestylt wird. HTMLElement.showPopover()
-
Zeigt ein Popover-Element, indem es zur oberen Schicht hinzugefügt und
display: none;
aus seinen Stilen entfernt wird. HTMLElement.togglePopover()
-
Schaltet ein Popover-Element zwischen den Zuständen "versteckt" und "angezeigt" um.
Ereignisse
Diese Ereignisse können mit addEventListener()
oder durch Zuweisen eines Ereignis-Listeners zur oneventname
-Eigenschaft dieses Interfaces überwacht werden.
Erbt auch Ereignisse von seinem übergeordneten Objekt, Element
.
change
-
Wird ausgelöst, wenn der
value
eines<input>
,<select>
oder<textarea>
-Elements geändert und vom Benutzer bestätigt wurde. Im Gegensatz zuminput
-Ereignis wird daschange
-Ereignis nicht unbedingt für jede Änderung desvalue
-Werts eines Elements ausgelöst. command
-
Wird auf einem Element ausgelöst, das über ein
button
mit gültigencommandForElement
undcommand
-Werten gesteuert wird, wann immer der Button interagiert wird (z.B. wenn darauf geklickt wird). 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 diese Ressource erfolgreich geladen wurde.
Zwischenablage-Ereignisse
copy
-
Wird ausgelöst, wenn der Benutzer eine Kopieraktion über die Benutzeroberfläche des Browsers einleitet.
cut
-
Wird ausgelöst, wenn der Benutzer eine Ausschneideaktion über die Benutzeroberfläche des Browsers einleitet.
paste
-
Wird ausgelöst, wenn der Benutzer eine Einfügeaktion über die Benutzeroberfläche des Browsers einleitet.
Drag & Drop-Ereignisse
drag
-
Dieses Ereignis wird ausgelöst, wenn ein Element oder eine Textauswahl gezogen wird.
dragend
-
Dieses Ereignis wird ausgelöst, wenn ein Zieh-Vorgang 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 in ein gültiges Ziehziel eintritt.
dragleave
-
Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl ein gültiges Ziehziel 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 Ziehziel befindet (alle 50 ms, wenn die Maus nicht bewegt wird, sonst viel schneller, zwischen 5 ms (langsamer Bewegung) und ca. 1ms (schnelle Bewegung). Dieses Auslöse-Muster unterscheidet sich vom
mouseover
-Ereignis). dragstart
-
Dieses Ereignis wird ausgelöst, wenn der Benutzer anfängt, ein Element oder eine Textauswahl zu ziehen.
drop
-
Dieses Ereignis wird ausgelöst, wenn ein Element oder eine Textauswahl auf ein gültiges Ziehziel fallen gelassen wird.
Umschalt-Ereignisse
Spezifikationen
Specification |
---|
HTML # htmlelement |