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 jedes HTML-Element. Einige Elemente implementieren dieses Interface direkt, während andere es über ein Interface implementieren, das es erbt.

EventTarget Node Element HTMLElement

Instanz-Eigenschaften

Erbt auch Eigenschaften von seinem übergeordneten Element, Element.

HTMLElement.accessKey

Ein Zeichenkette, die den dem Element zugewiesenen Zugangsschlüssel darstellt.

HTMLElement.accessKeyLabel Schreibgeschützt

Gibt eine Zeichenkette zurück, die den dem Element zugewiesenen 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 keines hat.

HTMLElement.attributeStyleMap Schreibgeschützt

Eine StylePropertyMap, die die Deklarationen des style-Attributes des Elements darstellt.

HTMLElement.autocapitalize

Eine Zeichenkette, die das Kapitalisierungsverhalten 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-Globalattribut widerspiegelt, das angibt, ob die Steuerung beim Laden der Seite oder beim Anzeigen eines Dialogs oder Popovers fokussiert werden soll, falls es in einem Element innerhalb von <dialog>-Elementen oder Elementen, deren Popover-Attribut gesetzt ist, angegeben ist.

HTMLElement.autocorrect

Ein boolean, das angibt, ob Texteingaben des Benutzers automatisch korrigiert werden sollen oder nicht. Dies spiegelt das autocorrect HTML-Globalattribut wider.

HTMLElement.contentEditable

Eine Zeichenkette, bei der ein Wert von true bedeutet, dass das Element editierbar ist, und ein Wert von false, dass es nicht editierbar 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

Eine Zeichenkette, die das globale Attribut dir widerspiegelt und die Richtungsangabe 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 mit dem Element verbundenen EditContext zurück oder null, wenn keiner vorhanden ist.

HTMLElement.enterKeyHint

Eine Zeichenkette, die definiert, welches Aktionslabel (oder Icon) für die Enter-Taste auf virtuellen Tastaturen angezeigt werden soll.

HTMLElement.hidden

Eine Zeichenkette oder ein 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-Seiten-Textsuchvorgänge ("Seiteninhalt durchsuchen") und Textauswahl nicht vorhanden ist.

HTMLElement.innerText

Stellt den gerenderten Textinhalt eines Knotens und seiner Nachkommen dar. Als Getter approximiert es den Text, den der Benutzer erhalten würde, wenn er die Inhalte des Elements mit dem Cursor markieren und dann in die Zwischenablage kopieren würde. Als Setter ersetzt es den Inhalt im ausgewählten Element und konvertiert Zeilenumbrüche in <br>-Elemente.

HTMLElement.inputMode

Ein Zeichenkettenwert, 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 Zeichenkette, die die Sprache der Attribute, des Textes und der Inhalte eines Elements darstellt.

HTMLElement.nonce

Gibt die kryptografische Nummer zurück, die von der Content Security Policy verwendet wird, um festzustellen, ob ein bestimmter Abruf durchgeführt werden darf.

HTMLElement.offsetHeight Schreibgeschützt

Gibt einen double zurück, welcher die Höhe eines Elements relativ zum Layout enthält.

HTMLElement.offsetLeft Schreibgeschützt

Gibt einen double zurück, welcher die Entfernung von der linken Grenze dieses Elements zur linken Grenze seines offsetParent wiedergibt.

HTMLElement.offsetParent Schreibgeschützt

Ein Element, das das Element ist, von dem alle Offset-Berechnungen derzeit durchgeführt werden.

HTMLElement.offsetTop Schreibgeschützt

Gibt einen double zurück, welcher die Entfernung von der oberen Grenze dieses Elements zur oberen Grenze seines offsetParent wiedergibt.

HTMLElement.offsetWidth Schreibgeschützt

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

HTMLElement.outerText

Stellt den gerenderten Textinhalt eines Knotens und seiner Nachkommen dar. Als Getter ist es das gleiche wie HTMLElement.innerText (es repräsentiert den gerenderten Textinhalt eines Elements und seiner Nachkommen). Als Setter ersetzt es den ausgewählten Knoten und seinen Inhalt durch den angegebenen Wert und konvertiert Zeilenumbrüche in <br>-Elemente.

HTMLElement.popover

Ruft den Popover-Zustand eines Elements über JavaScript ab und legt ihn fest ("auto", "hint" oder "manual"), und kann zur Funktionsunterstützungserkennung verwendet werden. Spiegelt den Wert des popover-Attributs des globalen HTML-Attributs wider.

HTMLElement.spellcheck

Ein boolescher Wert, der den Rechtschreibprüfung-Hinweis steuert. Es ist auf allen HTML-Elementen verfügbar, wirkt sich jedoch nicht auf alle aus.

HTMLElement.style

Ein CSSStyleDeclaration, der die Deklarationen des style-Attributes des Elements darstellt.

HTMLElement.tabIndex

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

HTMLElement.title

Ein Zeichenkette, die den Text enthält, der in einem Popup-Fenster angezeigt wird, wenn die Maus über das Element fährt.

HTMLElement.translate

Ein boolean, der die Übersetzung darstellt.

HTMLElement.virtualKeyboardPolicy Experimentell

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

HTMLElement.writingSuggestions

Eine Zeichenkette, die angibt, ob vom Browser bereitgestellte Schreibvorschläge innerhalb des Geltungsbereichs des Elements aktiviert werden sollen oder nicht.

Instanz-Methoden

Erbt auch Methoden von seinem übergeordneten Element, 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 Mausklickereignis an das Element.

HTMLElement.focus()

Macht das Element zum aktuellen Tastaturfokus.

HTMLElement.hidePopover()

Blendet ein Popover-Element aus, indem es aus der obersten Ebene entfernt und mit display: none gestylt wird.

HTMLElement.showPopover()

Zeigt ein Popover-Element an, indem es zur obersten Ebene 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

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

Erbt auch Ereignisse von seinem übergeordneten Element, Element.

change

Ausgelöst, wenn der value eines <input>, <select> oder <textarea>-Elements durch den Benutzer geändert und festgelegt wurde. Anders als das input-Ereignis wird das change-Ereignis nicht unbedingt für jede Änderung des value eines Elements ausgelöst.

command

Wird auf einem Element ausgelöst, das über einen button mit gültigen commandForElement- und command-Werten gesteuert wird, wann immer der Button interagiert wurde (z. B. durch Klicken).

error

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

Ausgelöst, wenn der Benutzer eine Kopieraktion über die Benutzeroberfläche des Browsers initiiert.

cut

Ausgelöst, wenn der Benutzer eine Ausschneideaktion über die Benutzeroberfläche des Browsers initiiert.

paste

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 Ziehl-Ziel betritt.

dragleave

Dieses Ereignis wird ausgelöst, wenn ein gezogenes Element oder eine Textauswahl ein gültiges Ziehl-Ziel 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 Ziehl-Ziel befindet (alle 50 ms WENN die Maus sich nicht bewegt, ANSONSTEN viel schneller zwischen ungefähr 5 ms (langsamer Bewegung) und 1ms (schneller Bewegung). Dieses Auslösungsmuster 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 Ziehl-Ziel fallen gelassen wird.

Umschalt-Ereignisse

beforetoggle

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

toggle

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

Spezifikationen

Specification
HTML
# htmlelement

Browser-Kompatibilität

Siehe auch