HTMLElement
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Das Interface HTMLElement repräsentiert jedes HTML-Element. Einige Elemente implementieren dieses Interface direkt, während andere es über ein Interface implementieren, das von ihm erbt.
Instanzeigenschaften
Erbt außerdem Eigenschaften von seinem übergeordneten Interface Element.
HTMLElement.accessKey-
Ein String, der den dem Element zugewiesenen Zugriffsschlüssel repräsentiert.
HTMLElement.accessKeyLabelSchreibgeschützt-
Gibt einen String zurück, der den dem Element zugewiesenen Zugriffsschlüssel enthält.
HTMLElement.anchorElementSchreibgeschützt-
Gibt eine Referenz auf das Ankerelement des Elements zurück oder
null, wenn es keines hat. HTMLElement.attributeStyleMapSchreibgeschützt-
Eine
StylePropertyMap, die die Deklarationen desstyle-Attributs des Elements repräsentiert. HTMLElement.autocapitalize-
Ein String, der angibt, wie Großschreibung bei Benutzereingaben für das Element gehandhabt wird. Gültige Werte sind:
none,off,on,characters,words,sentences. HTMLElement.autofocus-
Ein boolescher Wert, der das globale HTML-Attribut
autofocuswiderspiegelt. Dieses gibt an, ob das Steuerelement beim Laden der Seite den Fokus erhalten soll oder, wenn es sich innerhalb eines<dialog>-Elements oder eines Elements mit gesetztem Popover-Attribut befindet, sobald der Dialog beziehungsweise das Popover angezeigt wird. HTMLElement.autocorrect-
Ein boolescher Wert, der angibt, ob von Benutzern eingegebener Text automatisch korrigiert werden soll. Er spiegelt das globale HTML-Attribut
autocorrectwider. HTMLElement.containerTiming-
Ein String, der das Element als Containerwurzel für die Beobachtung mit der
PerformanceContainerTiming-API kennzeichnet. Er spiegelt das globale HTML-Attributcontainertimingwider. HTMLElement.containerTimingIgnore-
Ein boolescher Wert, der das Element und seine Nachfahren davon ausschließt, zur Zeitmessung einer übergeordneten Containerwurzel beizutragen. Er spiegelt das globale HTML-Attribut
containertimingignorewider. HTMLElement.contentEditable-
Ein String, bei dem der Wert
truebedeutet, dass das Element bearbeitbar ist, und der Wertfalse, dass es nicht bearbeitbar ist. HTMLElement.datasetSchreibgeschützt-
Gibt eine
DOMStringMapzurück, mit der Skripte die benutzerdefinierten Datenattribute (data-*) des Elements lesen und schreiben können. HTMLElement.dir-
Ein String, der das globale Attribut
dirwiderspiegelt und die Schreibrichtung des Elements angibt. Mögliche Werte sind"ltr","rtl"und"auto". HTMLElement.draggable-
Ein boolescher Wert, der angibt, ob das Element gezogen werden kann.
HTMLElement.editContext-
Gibt den dem Element zugeordneten
EditContextzurück odernull, wenn keiner vorhanden ist. HTMLElement.enterKeyHint-
Ein String, der festlegt, welche Aktionsbeschriftung oder welches Symbol für die Eingabetaste auf virtuellen Tastaturen angezeigt werden soll.
-
Ein String oder ein boolescher Wert, der den Wert des
hidden-Attributs des Elements widerspiegelt. HTMLElement.inert-
Ein boolescher Wert, der angibt, ob der User Agent den betreffenden Knoten für Benutzerinteraktionsereignisse, die Textsuche innerhalb der Seite („Auf Seite suchen“) und die Textauswahl so behandeln muss, als wäre er nicht vorhanden.
HTMLElement.innerText-
Repräsentiert den gerenderten Textinhalt eines Knotens und seiner Nachfahren. Beim Lesen entspricht der Wert ungefähr dem Text, den Benutzer erhalten würden, wenn sie den Inhalt des Elements mit dem Cursor markieren und anschließend in die Zwischenablage kopieren. Beim Schreiben ersetzt er den Inhalt des ausgewählten Elements und wandelt dabei Zeilenumbrüche in
<br>-Elemente um. HTMLElement.inputMode-
Ein String, der den Wert des
inputmode-Attributs des Elements widerspiegelt. HTMLElement.isContentEditableSchreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob der Inhalt des Elements bearbeitet werden kann.
HTMLElement.lang-
Ein String, der die Sprache der Attribute, des Texts und des Inhalts eines Elements angibt.
HTMLElement.nonce-
Gibt die einmalig verwendete kryptografische Zahl zurück, anhand derer die Content Security Policy bestimmt, ob ein bestimmter Abruf zulässig ist.
HTMLElement.offsetHeightSchreibgeschützt-
Gibt einen
double-Wert zurück, der die Höhe eines Elements im Layout angibt. HTMLElement.offsetLeftSchreibgeschützt-
Gibt einen
double-Wert zurück, der den Abstand vom linken Rand dieses Elements zum linken Rand seinesoffsetParentangibt. HTMLElement.offsetParentSchreibgeschützt-
Ein
Element, auf dessen Grundlage derzeit alle Offset-Berechnungen erfolgen. HTMLElement.offsetTopSchreibgeschützt-
Gibt einen
double-Wert zurück, der den Abstand vom oberen Rand dieses Elements zum oberen Rand seinesoffsetParentangibt. HTMLElement.offsetWidthSchreibgeschützt-
Gibt einen
double-Wert zurück, der die Breite eines Elements im Layout angibt. HTMLElement.outerText-
Repräsentiert den gerenderten Textinhalt eines Knotens und seiner Nachfahren. Beim Lesen entspricht der Wert
HTMLElement.innerTextund repräsentiert den gerenderten Textinhalt eines Elements und seiner Nachfahren. Beim Schreiben ersetzt er den ausgewählten Knoten samt Inhalt durch den angegebenen Wert und wandelt dabei Zeilenumbrüche in<br>-Elemente um. HTMLElement.popover-
Liest und setzt den Popover-Zustand eines Elements über JavaScript (
"auto","hint"oder"manual") und kann zur Feature-Erkennung verwendet werden. Spiegelt den Wert des globalen HTML-Attributspopoverwider. HTMLElement.spellcheck-
Ein boolescher Wert, der den Hinweis zur Rechtschreibprüfung steuert. Er ist für alle HTML-Elemente verfügbar, wirkt sich aber nicht auf alle aus.
HTMLElement.style-
Eine
CSSStyleDeclaration, die die Deklarationen desstyle-Attributs des Elements repräsentiert. HTMLElement.tabIndex-
Ein
long-Wert, der die Position des Elements in der Tab-Reihenfolge angibt. HTMLElement.title-
Ein String, der den Text enthält, der in einem Popup angezeigt wird, wenn sich der Mauszeiger über dem Element befindet.
HTMLElement.translate-
Ein boolescher Wert, der angibt, ob das Element übersetzt werden soll.
HTMLElement.virtualKeyboardPolicy-
Ein String, der das Verhalten der virtuellen Bildschirmtastatur auf Geräten wie Tablets und Mobiltelefonen oder anderen Geräten angibt, auf denen möglicherweise keine physische Tastatur verfügbar ist, sofern der Inhalt des Elements bearbeitbar ist (beispielsweise bei einem
<input>- oder<textarea>-Element oder einem Element mit gesetztemcontenteditable-Attribut). HTMLElement.writingSuggestions-
Ein String, der angibt, ob vom Browser bereitgestellte Schreibvorschläge im Bereich des Elements aktiviert sein sollen.
Instanzmethoden
Erbt außerdem 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()-
Setzt den Tastaturfokus auf das Element.
HTMLElement.hidePopover()-
Blendet ein Popover-Element aus, indem es aus der obersten Ebene entfernt und mit
display: noneformatiert wird. HTMLElement.showPopover()-
Zeigt ein Popover-Element an, indem es der obersten Ebene hinzugefügt und
display: none;aus seinen Styles entfernt wird. HTMLElement.togglePopover()-
Schaltet ein Popover-Element zwischen dem ausgeblendeten und dem angezeigten Zustand um.
Ereignisse
Sie können diese Ereignisse mit addEventListener() überwachen oder der Eigenschaft oneventname dieses Interfaces einen Event Listener zuweisen.
Erbt außerdem Ereignisse von seinem übergeordneten Interface Element.
change-
Wird ausgelöst, wenn der
valueeines<input>-,<select>- oder<textarea>-Elements durch Benutzer geändert und die Änderung bestätigt wurde. Anders als das Ereignisinputwird das Ereignischangenicht unbedingt bei jeder Änderung desvalueeines Elements ausgelöst. command-
Wird bei einem Element ausgelöst, das über einen
buttonmit gültigen Werten fürcommandForElementundcommandgesteuert wird, sobald mit dem Button interagiert wird (etwa durch einen Klick). error-
Wird ausgelöst, wenn eine Ressource nicht geladen werden konnte oder nicht verwendet werden kann.
load-
Wird bei Elementen ausgelöst, die eine Ressource enthalten, wenn diese erfolgreich geladen wurde.
Drag-and-Drop-Ereignisse
drag-
Dieses Ereignis wird wiederholt ausgelöst, während ein Element oder eine Textauswahl gezogen wird. Die Häufigkeit hängt vom Browser, Betriebssystem und der Zeigerbewegung ab; verlassen Sie sich nicht auf ein festes Intervall.
dragend-
Dieses Ereignis wird ausgelöst, wenn ein Ziehvorgang beendet wird, indem die Maustaste losgelassen oder die Escape-Taste gedrückt wird.
dragenter-
Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine gezogene Textauswahl in ein gültiges Ablageziel gelangt.
dragleave-
Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine gezogene Textauswahl ein gültiges Ablageziel verlässt.
dragover-
Dieses Ereignis wird wiederholt ausgelöst, während ein Element oder eine Textauswahl über ein potenzielles Ablageziel gezogen wird. Die Häufigkeit hängt vom Browser, Betriebssystem und der Zeigerbewegung ab; verlassen Sie sich nicht auf ein festes Intervall.
dragstart-
Dieses Ereignis wird ausgelöst, wenn Benutzer beginnen, ein Element oder eine Textauswahl zu ziehen.
drop-
Dieses Ereignis wird ausgelöst, wenn ein Element oder eine Textauswahl auf einem gültigen Ablageziel abgelegt wird.
Interest-Invoker-Ereignisse
interest-
Wird beim Zielelement eines Interest Invokers ausgelöst, wenn Interesse angezeigt wird. Dadurch kann als Reaktion darauf Code ausgeführt werden.
loseinterest-
Wird beim Zielelement eines Interest Invokers ausgelöst, wenn das Interesse endet. Dadurch kann als Reaktion darauf Code ausgeführt werden.
Toggle-Ereignisse
Spezifikationen
| Spezifikation |
|---|
| HTML> # htmlelement> |