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.

Das HTMLElement Interface repräsentiert ein beliebiges HTML-Element. Einige Elemente implementieren dieses Interface direkt, während andere es über ein vererbendes Interface implementieren.

EventTarget Node Element HTMLElement

Instanz-Eigenschaften

Erbt auch Eigenschaften von seinem übergeordneten Interface, Element.

HTMLElement.accessKey

Ein String, der den dem Element zugewiesenen Access Key repräsentiert.

HTMLElement.accessKeyLabel Schreibgeschützt

Gibt einen String zurück, der den zugewiesenen Access Key des Elements 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

Ein StylePropertyMap, welches die Deklarationen des style-Attributs des Elements repräsentiert.

HTMLElement.autocapitalize

Ein String, der das Kapitalisierungsverhalten des Elements für Benutzereingaben repräsentiert. Gültige Werte sind: none, off, on, characters, words, sentences.

HTMLElement.autofocus

Ein boolescher Wert, der das autofocus HTML-Globale Attribut widerspiegelt, welches angibt, ob die Steuerung fokussiert werden soll, wenn die Seite geladen wird oder wenn ein Dialog oder Popover angezeigt wird, sofern angegeben in einem Element innerhalb von <dialog>-Elementen oder Elementen, deren Popover-Attribut gesetzt ist.

HTMLElement.autocorrect Experimentell

Ein Boolean, der angibt, ob Texteingaben eines Benutzers automatisch korrigiert werden sollen oder nicht. Dies spiegelt das HTML-Globale Attribut autocorrect wider.

HTMLElement.contentEditable

Ein String, bei dem ein Wert von true bedeutet, dass das Element bearbeitbar ist, und ein Wert von false bedeutet, dass es das nicht 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

Ein String, der das dir-Globale Attribut widerspiegelt und die Richtungsabhängigkeit des Elements repräsentiert. 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 oder null, wenn keiner vorhanden ist.

HTMLElement.enterKeyHint

Ein String, der definiert, welches Aktionslabel (oder Symbol) für die Eingabetaste auf virtuellen Tastaturen angezeigt werden soll.

HTMLElement.hidden

Ein String oder 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, Textsuchen auf der Seite ("Seite durchsuchen") und Textauswahl nicht vorhanden ist.

HTMLElement.innerText

Repräsentiert den angezeigten Textinhalt eines Knotens und seiner Nachkommen. Als Getter approximiert er den Text, den der Benutzer erhalten würde, wenn er die Inhalte des Elements mit dem Cursor markiert und dann in die Zwischenablage kopiert. Als Setter ersetzt er den Inhalt des ausgewählten Elements und wandelt alle Zeilenumbrüche in <br>-Elemente um.

HTMLElement.inputMode

Ein String-Wert, 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

Ein String, der die Sprache der Attribute, des Textes und der Inhalte eines Elements repräsentiert.

HTMLElement.nonce

Gibt die kryptographische Nummer zurück, die einmal verwendet wird und von der Content Security Policy verwendet wird, um zu bestimmen, ob ein bestimmter Abruf ausgeführt werden darf.

HTMLElement.offsetHeight Schreibgeschützt

Gibt einen double zurück, der die Höhe eines Elements relativ zum Layout darstellt.

HTMLElement.offsetLeft Schreibgeschützt

Gibt einen double zurück, der den Abstand von der linken Grenze dieses Elements zur linken Grenze seines offsetParent darstellt.

HTMLElement.offsetParent Schreibgeschützt

Ein Element, das das Element ist, von dem aus alle Offsets zurzeit berechnet werden.

HTMLElement.offsetTop Schreibgeschützt

Gibt einen double zurück, der den Abstand von der oberen Grenze dieses Elements zur oberen Grenze seines offsetParent darstellt.

HTMLElement.offsetWidth Schreibgeschützt

Gibt einen double zurück, der die Breite eines Elements relativ zum Layout darstellt.

HTMLElement.outerText

Repräsentiert den angezeigten Textinhalt eines Knotens und seiner Nachkommen. Als Getter ist es dasselbe wie HTMLElement.innerText (es repräsentiert den angezeigten Textinhalt eines Elements und seiner Nachkommen). Als Setter ersetzt es den ausgewählten Knoten und seinen Inhalt mit dem gegebenen Wert und wandelt alle Zeilenumbrüche in <br>-Elemente um.

HTMLElement.popover

Ruft den Popover-Zustand eines Elements über JavaScript ab und setzt ihn ("auto" oder "manual"), und kann zur Merkmalsüberprüfung verwendet werden. Spiegelt den Wert des globalen HTML-Attributs popover wider.

HTMLElement.spellcheck

Ein boolescher Wert, der den Hinweis für die Rechtschreibprüfung steuert. Es ist auf allen HTML-Elementen verfügbar, obwohl es nicht alle beeinflusst.

HTMLElement.style

Eine CSSStyleDeclaration, die die Deklarationen des style-Attributs des Elements repräsentiert.

HTMLElement.tabIndex

Ein long, der die Position des Elements in der Tabulatorenreihenfolge darstellt.

HTMLElement.title

Ein String, der den Text enthält, der in einem Popup-Fenster angezeigt wird, wenn die Maus über dem Element ist.

HTMLElement.translate

Ein boolescher Wert, der die Übersetzung repräsentiert.

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 ein <input> oder <textarea>-Element oder ein Element mit dem contenteditable-Attribut).

HTMLElement.writingSuggestions

Ein String, der angibt, ob browserseitige Schreibvorschläge unter dem Geltungsbereich des Elements aktiviert sein sollen oder nicht.

Instanz-Methoden

Erbt auch 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()

Macht das Element zum aktuellen Tastaturfokus.

HTMLElement.hidePopover()

Verbirgt ein Popover-Element, indem es es von der obersten Schicht entfernt und es mit display: none stylt.

HTMLElement.showPopover()

Zeigt ein Popover-Element, indem es es der obersten Schicht hinzufügt und display: none; aus seinen Stilen entfernt.

HTMLElement.togglePopover()

Wechselt ein Popover-Element zwischen den Zuständen 'verborgen' und 'sichtbar'.

Ereignisse

Hören Sie diese Ereignisse mithilfe von addEventListener() oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zuweisen.

Erbt auch Ereignisse von seinem übergeordneten Interface, Element.

cancel

Wird für <input> und <dialog>-Elemente ausgelöst, wenn der Benutzer den aktuell geöffneten Dialog mit der Esc-Taste abbricht.

change

Wird ausgelöst, wenn der value eines <input>, <select> oder <textarea>-Elements vom Benutzer geändert und festgeschrieben wurde. Im Gegensatz zum input-Ereignis wird das change-Ereignis nicht unbedingt bei jeder Änderung des value eines Elements ausgelöst.

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 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 Schneideaktion ü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 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 Ziel erreicht.

dragleave

Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl ein gültiges Ziel 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 Ziel befindet (alle 50 ms, wenn die Maus nicht bewegt wird, ansonsten viel schneller zwischen ca. 5 ms (langsame Bewegung) und 1 ms (schnelle Bewegung). Dieses Auslösepattern 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 Ziel fallen gelassen wird.

Umschalt-Ereignisse

beforetoggle

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

toggle

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

Spezifikationen

Specification
HTML Standard
# htmlelement

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch