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.

EventTarget Node Element HTMLElement

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 des style-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 von false, 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, oder null, wenn keiner vorhanden ist.

HTMLElement.enterKeyHint

Eine Zeichenfolge, die angibt, welches Aktionssymbol (oder Ikone) für die Eingabetaste auf virtuellen Tastaturen angezeigt werden soll.

HTMLElement.hidden

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 des offsetParent 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 des offsetParent 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-Attributs popover 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 des style-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 Attribut contenteditable 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 zum input-Ereignis wird das change-Ereignis nicht unbedingt für jede Änderung des value-Werts eines Elements ausgelöst.

command

Wird auf einem Element ausgelöst, das über ein button mit gültigen commandForElement und command-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

beforetoggle

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

toggle

Wird ausgelöst, wenn das Element ein Popover, <dialog> oder <details>-Element ist, gerade nachdem es versteckt oder angezeigt wird.

Spezifikationen

Specification
HTML
# htmlelement

Browser-Kompatibilität

Siehe auch