Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

EventTarget Node Element HTMLElement

Instanzeigenschaften

Erbt außerdem Eigenschaften von seinem übergeordneten Interface Element.

HTMLElement.accessKey

Ein String, der den dem Element zugewiesenen Zugriffsschlüssel repräsentiert.

HTMLElement.accessKeyLabel Schreibgeschützt

Gibt einen String zurück, der den dem Element zugewiesenen Zugriffsschlüssel enthält.

HTMLElement.anchorElement Schreibgeschützt 

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 des style-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 autofocus widerspiegelt. 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 autocorrect wider.

HTMLElement.containerTiming

Ein String, der das Element als Containerwurzel für die Beobachtung mit der PerformanceContainerTiming-API kennzeichnet. Er spiegelt das globale HTML-Attribut containertiming wider.

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 containertimingignore wider.

HTMLElement.contentEditable

Ein String, bei dem der Wert true bedeutet, dass das Element bearbeitbar ist, und der Wert false, dass es nicht bearbeitbar ist.

HTMLElement.dataset Schreibgeschützt

Gibt eine DOMStringMap zurück, mit der Skripte die benutzerdefinierten Datenattribute (data-*) des Elements lesen und schreiben können.

HTMLElement.dir

Ein String, der das globale Attribut dir widerspiegelt 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 EditContext zurück oder null, 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.

HTMLElement.hidden

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.isContentEditable Schreibgeschü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.offsetHeight Schreibgeschützt

Gibt einen double-Wert zurück, der die Höhe eines Elements im Layout angibt.

HTMLElement.offsetLeft Schreibgeschützt

Gibt einen double-Wert zurück, der den Abstand vom linken Rand dieses Elements zum linken Rand seines offsetParent angibt.

HTMLElement.offsetParent Schreibgeschützt

Ein Element, auf dessen Grundlage derzeit alle Offset-Berechnungen erfolgen.

HTMLElement.offsetTop Schreibgeschützt

Gibt einen double-Wert zurück, der den Abstand vom oberen Rand dieses Elements zum oberen Rand seines offsetParent angibt.

HTMLElement.offsetWidth Schreibgeschü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.innerText und 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-Attributs popover wider.

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 des style-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 gesetztem contenteditable-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: none formatiert 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 value eines <input>-, <select>- oder <textarea>-Elements durch Benutzer geändert und die Änderung bestätigt wurde. Anders als das Ereignis input wird das Ereignis change nicht unbedingt bei jeder Änderung des value eines Elements ausgelöst.

command

Wird bei einem Element ausgelöst, das über einen button mit gültigen Werten für commandForElement und command gesteuert 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

beforetoggle

Wird ausgelöst, wenn das Element ein Popover oder ein <dialog> ist, bevor es ausgeblendet oder angezeigt wird.

toggle

Wird ausgelöst, wenn das Element ein Popover, ein <dialog>- oder ein <details>-Element ist, unmittelbar nachdem es ausgeblendet oder angezeigt wurde.

Spezifikationen

Spezifikation
HTML
# htmlelement

Browser-Kompatibilität

Siehe auch