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 Interface implementieren, das es erbt.
Instanz-Eigenschaften
Erbt auch Eigenschaften von seinem übergeordneten Element, Element
.
HTMLElement.accessKey
-
Ein Zeichenkette, die den dem Element zugewiesenen Zugangsschlüssel darstellt.
HTMLElement.accessKeyLabel
Schreibgeschützt-
Gibt eine Zeichenkette zurück, die den dem Element zugewiesenen Zugangsschlü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
-Attributes des Elements darstellt. HTMLElement.autocapitalize
-
Eine Zeichenkette, die das Kapitalisierungsverhalten des Elements für Benutzereingaben darstellt. Gültige Werte sind:
none
,off
,on
,characters
,words
,sentences
. HTMLElement.autofocus
-
Ein boolescher Wert, der das
autofocus
HTML-Globalattribut widerspiegelt, das angibt, ob die Steuerung beim Laden der Seite oder beim Anzeigen eines Dialogs oder Popovers fokussiert werden soll, falls es in einem Element innerhalb von<dialog>
-Elementen oder Elementen, deren Popover-Attribut gesetzt ist, angegeben ist. HTMLElement.autocorrect
-
Ein boolean, das angibt, ob Texteingaben des Benutzers automatisch korrigiert werden sollen oder nicht. Dies spiegelt das
autocorrect
HTML-Globalattribut wider. HTMLElement.contentEditable
-
Eine Zeichenkette, bei der ein Wert von
true
bedeutet, dass das Element editierbar ist, und ein Wert vonfalse
, dass es nicht editierbar 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
-
Eine Zeichenkette, die das globale Attribut
dir
widerspiegelt und die Richtungsangabe 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 mit dem Element verbundenen
EditContext
zurück odernull
, wenn keiner vorhanden ist. HTMLElement.enterKeyHint
-
Eine Zeichenkette, die definiert, welches Aktionslabel (oder Icon) für die Enter-Taste auf virtuellen Tastaturen angezeigt werden soll.
-
Eine Zeichenkette oder ein 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, In-Seiten-Textsuchvorgänge ("Seiteninhalt durchsuchen") und Textauswahl nicht vorhanden ist.
HTMLElement.innerText
-
Stellt den gerenderten Textinhalt eines Knotens und seiner Nachkommen dar. Als Getter approximiert es den Text, den der Benutzer erhalten würde, wenn er die Inhalte des Elements mit dem Cursor markieren und dann in die Zwischenablage kopieren würde. Als Setter ersetzt es den Inhalt im ausgewählten Element und konvertiert Zeilenumbrüche in
<br>
-Elemente. HTMLElement.inputMode
-
Ein Zeichenkettenwert, 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 Zeichenkette, die die Sprache der Attribute, des Textes und der Inhalte eines Elements darstellt.
HTMLElement.nonce
-
Gibt die kryptografische Nummer zurück, die von der Content Security Policy verwendet wird, um festzustellen, ob ein bestimmter Abruf durchgeführt werden darf.
HTMLElement.offsetHeight
Schreibgeschützt-
Gibt einen
double
zurück, welcher die Höhe eines Elements relativ zum Layout enthält. HTMLElement.offsetLeft
Schreibgeschützt-
Gibt einen
double
zurück, welcher die Entfernung von der linken Grenze dieses Elements zur linken Grenze seinesoffsetParent
wiedergibt. HTMLElement.offsetParent
Schreibgeschützt-
Ein
Element
, das das Element ist, von dem alle Offset-Berechnungen derzeit durchgeführt werden. HTMLElement.offsetTop
Schreibgeschützt-
Gibt einen
double
zurück, welcher die Entfernung von der oberen Grenze dieses Elements zur oberen Grenze seinesoffsetParent
wiedergibt. HTMLElement.offsetWidth
Schreibgeschützt-
Gibt einen
double
zurück, welcher die Breite eines Elements relativ zum Layout enthält. HTMLElement.outerText
-
Stellt den gerenderten Textinhalt eines Knotens und seiner Nachkommen dar. Als Getter ist es das gleiche wie
HTMLElement.innerText
(es repräsentiert den gerenderten Textinhalt eines Elements und seiner Nachkommen). Als Setter ersetzt es den ausgewählten Knoten und seinen Inhalt durch den angegebenen Wert und konvertiert Zeilenumbrüche in<br>
-Elemente. HTMLElement.popover
-
Ruft den Popover-Zustand eines Elements über JavaScript ab und legt ihn fest (
"auto"
,"hint"
oder"manual"
), und kann zur Funktionsunterstützungserkennung verwendet werden. Spiegelt den Wert despopover
-Attributs des globalen HTML-Attributs wider. HTMLElement.spellcheck
-
Ein boolescher Wert, der den Rechtschreibprüfung-Hinweis steuert. Es ist auf allen HTML-Elementen verfügbar, wirkt sich jedoch nicht auf alle aus.
HTMLElement.style
-
Ein
CSSStyleDeclaration
, der die Deklarationen desstyle
-Attributes des Elements darstellt. HTMLElement.tabIndex
-
Ein
long
, der die Position des Elements in der Tabulatorreihenfolge darstellt. HTMLElement.title
-
Ein Zeichenkette, die den Text enthält, der in einem Popup-Fenster angezeigt wird, wenn die Maus über das Element fährt.
HTMLElement.translate
-
Ein boolean, der die Übersetzung darstellt.
HTMLElement.virtualKeyboardPolicy
Experimentell-
Ein Zeichenkette, die das Verhalten der virtuellen Bildschirmtastatur auf Geräten wie Tablets, Mobiltelefonen oder anderen Geräten angibt, bei denen möglicherweise keine Hardwaretastatur verfügbar ist, wenn der Inhalt des Elements bearbeitbar ist (z. B. ein
<input>
- oder<textarea>
-Element oder ein Element mit demcontenteditable
-Attribut). HTMLElement.writingSuggestions
-
Eine Zeichenkette, die angibt, ob vom Browser bereitgestellte Schreibvorschläge innerhalb des Geltungsbereichs des Elements aktiviert werden sollen oder nicht.
Instanz-Methoden
Erbt auch Methoden von seinem übergeordneten Element, 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 Mausklickereignis an das Element.
HTMLElement.focus()
-
Macht das Element zum aktuellen Tastaturfokus.
HTMLElement.hidePopover()
-
Blendet ein Popover-Element aus, indem es aus der obersten Ebene entfernt und mit
display: none
gestylt wird. HTMLElement.showPopover()
-
Zeigt ein Popover-Element an, indem es zur obersten Ebene 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
Hören Sie auf diese Ereignisse mit addEventListener()
oder durch Zuweisen eines Ereignis-Listeners zur oneventname
-Eigenschaft dieses Interface.
Erbt auch Ereignisse von seinem übergeordneten Element, Element
.
change
-
Ausgelöst, wenn der
value
eines<input>
,<select>
oder<textarea>
-Elements durch den Benutzer geändert und festgelegt wurde. Anders als dasinput
-Ereignis wird daschange
-Ereignis nicht unbedingt für jede Änderung desvalue
eines Elements ausgelöst. command
-
Wird auf einem Element ausgelöst, das über einen
button
mit gültigencommandForElement
- undcommand
-Werten gesteuert wird, wann immer der Button interagiert wurde (z. B. durch Klicken). error
-
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
-
Ausgelöst, wenn der Benutzer eine Kopieraktion über die Benutzeroberfläche des Browsers initiiert.
cut
-
Ausgelöst, wenn der Benutzer eine Ausschneideaktion über die Benutzeroberfläche des Browsers initiiert.
paste
-
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 Ziehl-Ziel betritt.
dragleave
-
Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl ein gültiges Ziehl-Ziel verlässt.
dragover
-
Dieses Ereignis wird kontinuierlich ausgelöst, wenn ein Element oder eine Textauswahl gezogen wird und der Mauszeiger sich über einem gültigen Ziehl-Ziel befindet (alle 50 ms WENN die Maus sich nicht bewegt, ANSONSTEN viel schneller zwischen ungefähr 5 ms (langsamer Bewegung) und 1ms (schneller Bewegung). Dieses Auslösungsmuster 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 Ziehl-Ziel fallen gelassen wird.
Umschalt-Ereignisse
Spezifikationen
Specification |
---|
HTML # htmlelement |