HTMLElement
Das HTMLElement
Interface repräsentiert jedes HTML-Element. Einige Elemente implementieren dieses Interface direkt, während andere es über ein vererbendes Interface implementieren.
Instanz-Eigenschaften
Erbt auch Eigenschaften von seinem Elternteil, Element
.
HTMLElement.accessKey
-
Ein String, der den dem Element zugewiesenen Zugangsschlüssel darstellt.
HTMLElement.accessKeyLabel
Nur lesbar-
Gibt einen String zurück, der den dem Element zugewiesenen Zugangsschlüssel enthält.
HTMLElement.anchorElement
Nur lesbar Nicht standardisiert Experimentell-
Gibt eine Referenz auf das Ankerelement des Elements zurück oder
null
, wenn kein Ankerelement vorhanden ist. HTMLElement.attributeStyleMap
Nur lesbar-
Ein
StylePropertyMap
, das die Deklarationen desstyle
-Attributs des Elements darstellt. HTMLElement.autocapitalize
-
Ein String, der das Großschreibeverhalten des Elements für Benutzereingaben darstellt. Gültige Werte sind:
none
,off
,on
,characters
,words
,sentences
. HTMLElement.autofocus
-
Ein Wahrheitswert, der das
autofocus
globale HTML-Attribut widerspiegelt, welches anzeigt, ob das Steuerelement fokussiert werden soll, wenn die Seite geladen wird oder wenn ein Dialog oder Popover angezeigt wird, sofern in einem Element innerhalb von<dialog>
-Elementen angegeben oder in Elementen, deren Popover-Attribut gesetzt ist. HTMLElement.autocorrect
Experimentell-
Ein Boolean, der darstellt, ob von einem Benutzer eingegebener Text automatisch korrigiert werden soll oder nicht. Dies spiegelt das
autocorrect
globale HTML-Attribut wider. HTMLElement.contentEditable
-
Ein String, wobei ein Wert von
true
bedeutet, dass das Element bearbeitbar ist, und ein Wert vonfalse
, dass es nicht bearbeitbar ist. HTMLElement.dataset
Nur lesbar-
Gibt ein
DOMStringMap
zurück, mit dem Skript die benutzerdefinierten Datenattribute (data-*
) des Elements lesen und schreiben kann. HTMLElement.dir
-
Ein String, der das
dir
globale Attribut widerspiegelt und die Richtung des Elements darstellt. Mögliche Werte sind"ltr"
,"rtl"
und"auto"
. HTMLElement.draggable
-
Ein Boolean-Wert, der angibt, ob das Element gezogen werden kann.
HTMLElement.editContext
Experimentell-
Gibt den dem Element zugeordneten
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 präsentiert werden soll.
-
Ein String oder Boolean-Wert, der den Wert des
hidden
-Attributs des Elements widerspiegelt. HTMLElement.inert
-
Ein Boolean-Wert, der angibt, ob der User-Agent so handeln muss, als ob der gegebene Knoten für Benutzerinteraktionsereignisse, in-seiten Textsuchen ("finden in Seite") und Textauswahl nicht vorhanden ist.
HTMLElement.innerText
-
Stellt den gerenderten Textinhalt eines Knotens und seiner Nachfahren dar. Als Getter approximiert es den Text, den der Benutzer erhalten würde, wenn er den Inhalt des Elements mit dem Cursor hervorhebt und dann in die Zwischenablage kopiert. Als Setter ersetzt es den Inhalt innerhalb des ausgewählten Elements und konvertiert Zeilenumbrüche in
<br>
Elemente. HTMLElement.inputMode
-
Ein String-Wert, der den Wert des
inputmode
-Attributs des Elements widerspiegelt. HTMLElement.isContentEditable
Nur lesbar-
Gibt einen Boolean-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 Elemente eines Elements darstellt.
HTMLElement.nonce
-
Gibt die einmalig verwendete kryptografische Zahl zurück, die von Content Security Policy verwendet wird, um zu bestimmen, ob ein gegebener Abruf durchgeführt werden darf.
HTMLElement.offsetHeight
Nur lesbar-
Gibt ein
double
zurück, das die Höhe eines Elements relativ zum Layout enthält. HTMLElement.offsetLeft
Nur lesbar-
Gibt ein
double
zurück, die Entfernung dieses Elements vom linken Rand zu seinemoffsetParent
-linken Rand anzeigt. HTMLElement.offsetParent
Nur lesbar-
Ein
Element
, das das Element ist, von dem alle Versatz-Berechnungen derzeit durchgeführt werden. HTMLElement.offsetTop
Nur lesbar-
Gibt ein
double
zurück, die Entfernung dieses Elements vom oberen Rand zu seinemoffsetParent
-oberen Rand anzeigt. HTMLElement.offsetWidth
Nur lesbar-
Gibt ein
double
zurück, das die Breite eines Elements relativ zum Layout enthält. HTMLElement.outerText
-
Stellt den gerenderten Textinhalt eines Knotens und seiner Nachfahren dar. Als Getter ist es dasselbe wie
HTMLElement.innerText
(es repräsentiert den gerenderten Textinhalt eines Elements und dessen Nachfahren). Als Setter ersetzt es den ausgewählten Knoten und dessen Inhalt mit dem gegebenen Wert und konvertiert Zeilenumbrüche in<br>
Elemente. HTMLElement.popover
-
Ruft den Popover-Status eines Elements ab und setzt ihn über JavaScript (
"auto"
oder"manual"
), und kann zur Funktionsprüfung verwendet werden. Spiegelt den Wert des globalen HTML-Attributspopover
wider. HTMLElement.spellcheck
-
Ein Boolean-Wert, der den Rechtschreibprüfung-Hinweis steuert. Er ist für alle HTML-Elemente verfügbar, wirkt sich jedoch nicht auf alle aus.
HTMLElement.style
-
Eine
CSSStyleDeclaration
, die die Deklarationen desstyle
-Attributs des Elements darstellt. HTMLElement.tabIndex
-
Ein
long
, der die Position des Elements in der Tabulatorreihenfolge darstellt. HTMLElement.title
-
Ein String, der den Text enthält, der in einem Popup-Fenster angezeigt wird, wenn die Maus über das Element fährt.
HTMLElement.translate
-
Ein Boolean-Wert, der die Übersetzung darstellt.
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, es ist ein
<input>
oder<textarea>
Element, oder ein Element mit demcontenteditable
-Attribut gesetzt).
Instanz-Methoden
Erbt auch 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 die Tastaturfokussierung 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 aus der obersten Schicht entfernt wird und es mit
display: none
gestylt wird. HTMLElement.showPopover()
-
Zeigt ein Popover-Element, indem es zur obersten Schicht hinzugefügt und
display: none;
aus seinen Stilen entfernt wird. HTMLElement.togglePopover()
-
Schaltet ein Popover-Element zwischen den versteckten und sichtbaren Zuständen um.
Ereignisse
Hören Sie auf diese Ereignisse, indem Sie addEventListener()
verwenden oder indem Sie einen Ereignis-Listener zur oneventname
-Eigenschaft dieser Schnittstelle zuweisen.
Erbt auch Ereignisse von seinem Elternteil, Element
.
cancel
-
Wird für
<input>
und<dialog>
-Elemente ausgelöst, wenn der Benutzer den aktuell geöffneten Dialog durch Drücken der Esc-Taste abbricht. change
-
Wird ausgelöst, wenn der
value
eines<input>
,<select>
, oder<textarea>
Elements vom Benutzer geändert und bestätigt 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 kann 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 Ausschneidaktion ü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 ein Ziehvorgang beendet wird (durch Freigeben einer Maustaste oder das Drücken der Escape-Taste).
dragenter
-
Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl ein gültiges Ziel für das Ablegen betritt.
dragleave
-
Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl ein gültiges Ziel für das Ablegen verlässt.
dragover
-
Dieses Ereignis wird kontinuierlich ausgelöst, wenn ein Element oder eine Textauswahl gezogen wird und der Mauszeiger über einem gültigen Ablageziel ist (jede 50 ms WENN die Maus sich nicht bewegt, SONST viel schneller zwischen ca. 5 ms (langsame Bewegung) und 1ms (schnelle Bewegung). Diese Auslösemuster unterscheidet sich vom
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.
Popover-Ereignisse
beforetoggle
-
Wird ausgelöst, wenn das Element ein Popover ist, bevor es versteckt oder angezeigt wird.
toggle
-
Wird ausgelöst, wenn das Element ein Popover ist, gerade nachdem es versteckt oder angezeigt wurde.
Spezifikationen
Specification |
---|
HTML Standard # htmlelement |
Browser-Kompatibilität
BCD tables only load in the browser