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 Elternteil, Element.

HTMLElement.accessKey

Ein String, der den dem Element zugewiesenen Zugangsschlüssel darstellt.

HTMLElement.accessKeyLabel Schreibgeschützt

Gibt einen String zurück, der den dem Element zugeordneten 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 kein solches gibt.

HTMLElement.attributeStyleMap Schreibgeschützt

Ein StylePropertyMap, das die Deklarationen des style Attributs des Elements darstellt.

HTMLElement.autocapitalize

Ein String, der das Verhalten der Großschreibung 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-Attribut widerspiegelt, das angibt, ob das Steuerelement beim Laden der Seite fokussiert sein soll oder wenn ein Dialog oder Popover gezeigt wird, falls es in einem Element innerhalb von <dialog> Elementen oder Elementen mit gesetztem Popover-Attribut angegeben ist.

HTMLElement.autocorrect

Ein boolescher Wert, der darstellt, ob der durch Benutzer eingegebene Text automatisch korrigiert werden soll oder nicht. Dies spiegelt das globale HTML-Attribut autocorrect wider.

HTMLElement.contentEditable

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

HTMLElement.dataset Schreibgeschützt

Gibt ein DOMStringMap zurück, mit dem Skript die benutzerdefinierten Datenattribute (data-*) lesen und schreiben kann.

HTMLElement.dir

Ein String, der das dir-Globale Attribut widerspiegelt und die Richtung 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 verknüpft ist, oder null, wenn es keinen gibt.

HTMLElement.enterKeyHint

Ein String, der angibt, welches Aktionslabel (oder -symbol) für die Eingabetaste auf virtuellen Tastaturen dargestellt 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, In-Page-Textsuche ("Seite durchsuchen") und Textauswahl nicht vorhanden ist.

HTMLElement.innerText

Stellt den gerenderten Textinhalt eines Knotens und seiner Nachfahren dar. Als Getter nähert er den Text an, den der Benutzer erhalten würde, wenn er den Inhalt des Elements mit dem Cursor markiert und dann in die Zwischenablage kopiert. Als Setter ersetzt er den Inhalt innerhalb des ausgewählten Elements, indem er Zeilenumbrüche in <br>-Elemente umwandelt.

HTMLElement.inputMode

Ein Stringwert, 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 eines Elements Attribute, Text und Inhalte 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 fortgesetzt 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, das den Abstand von der linken Grenze dieses Elements bis zur linken Grenze seines offsetParent darstellt.

HTMLElement.offsetParent Schreibgeschützt

Ein Element, das das Element ist, von dem aus alle Offsetberechnungen derzeit durchgeführt werden.

HTMLElement.offsetTop Schreibgeschützt

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

HTMLElement.offsetWidth Schreibgeschützt

Gibt ein double zurück, das die Breite eines Elements relativ zum Layout enthält.

HTMLElement.outerText

Stellt den gerenderten Textinhalt eines Knotens und seiner Nachfahren dar. Als Getter ist es dasselbe wie HTMLElement.innerText (es repräsentiert den gerenderten Textinhalt eines Elements und seiner Nachfahren). Als Setter ersetzt es den ausgewählten Knoten und seinen Inhalt mit dem angegebenen Wert, indem es Zeilenumbrüche in <br>-Elemente umwandelt.

HTMLElement.popover

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

HTMLElement.spellcheck

Ein boolescher Wert, der den Hinweis zur Rechtschreibprüfung steuert. Er ist auf allen HTML-Elementen verfügbar, beeinflusst jedoch nicht alle.

HTMLElement.style

Eine CSSStyleDeclaration, die die Deklarationen des style-Attributs des Elements darstellt.

HTMLElement.tabIndex

Ein long, der die Position des Elements in der Tab-Reihenfolge darstellt.

HTMLElement.title

Ein String, der den Text enthält, der in einem Popup-Fenster erscheint, wenn der Mauszeiger über dem Element ist.

HTMLElement.translate

Ein boolescher Wert, der die Übersetzung darstellt.

HTMLElement.virtualKeyboardPolicy Experimentell

Ein String, der das Verhalten der Bildschirmtastatur auf Geräten wie Tablets, Mobiltelefonen oder anderen Geräten angibt, auf denen möglicherweise keine Hardwaretastatur verfügbar ist, wenn der Inhalt des Elements bearbeitbar ist (zum Beispiel ein <input> oder <textarea>-Element oder ein Element mit dem Attribut contenteditable gesetzt).

HTMLElement.writingSuggestions

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

Instanz-Methoden

Erbt auch Methoden von seinem Elternteil, 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 derzeit 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 aus der oberen Ebene entfernt und mit display: none gestylt wird.

HTMLElement.showPopover()

Zeigt ein Popover-Element an, indem es zur oberen Ebene hinzugefügt und display: none; aus seinen Stilen entfernt wird.

HTMLElement.togglePopover()

Wechselt ein Popover-Element zwischen dem versteckten und angezeigten Zustand.

Ereignisse

Hören Sie diese Ereignisse mit addEventListener() oder durch Zuweisung eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces.

Erbt auch Ereignisse von seinem Elternteil, Element.

cancel

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

change

Wird ausgelöst, wenn sich 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 notwendigerweise für jede Ä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 Ausschneideaktion ü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 ein Ziehvorgang 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 für das Ablegen betritt.

dragleave

Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl ein gültiges Ziel für das Ablegen 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 Ziel für das Ablegen befindet (alle 50 ms, WENN die Maus sich nicht bewegt, SONST viel schneller zwischen etwa 5 ms (langsame Bewegung) und 1 ms (schnelle Bewegung). Dieses Feuermuster ist anders als 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 einem gültigen Ziel für das Ablegen abgelegt wird.

Umschalt-Ereignisse

beforetoggle

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

toggle

Wird ausgelöst, wenn das Element ein popover, ein <dialog>, oder ein <details>-Element ist, kurz nachdem es versteckt oder gezeigt wurde.

Spezifikationen

Specification
HTML
# htmlelement

Browser-Kompatibilität

Siehe auch