Globale Attribute
Globale Attribute sind Attribute, die allen HTML-Elementen gemeinsam sind. Sie können für alle Elemente verwendet werden, auch wenn sie bei manchen Elementen keine Wirkung haben.
Globale Attribute können für alle HTML-Elemente angegeben werden, auch für solche, die nicht im Standard definiert sind. Das bedeutet, dass auch Nicht-Standard-Elemente diese Attribute zulassen müssen, obwohl das Dokument durch die Verwendung solcher Elemente nicht mehr HTML5-konform ist. Beispielsweise verbergen HTML5-konforme Browser Inhalte, die mit <foo hidden>…</foo> ausgezeichnet sind, obwohl <foo> kein gültiges HTML-Element ist.
Neben den grundlegenden globalen HTML-Attributen gibt es außerdem folgende globale Attribute:
xml:langundxml:base– sie stammen aus den XHTML-Spezifikationen, sind veraltet, werden aber aus Kompatibilitätsgründen beibehalten.- Das ARIA-Attribut
rolesowie die verschiedenenaria-*-Zustände und -Eigenschaften, die der Barrierefreiheit dienen. - Die unten aufgeführten Event-Handler-Attribute.
Liste der globalen Attribute
accesskey-
Gibt einen Hinweis zur Erstellung eines Tastenkürzels für das aktuelle Element. Dieses Attribut besteht aus einer durch Leerzeichen getrennten Liste von Zeichen. Der Browser sollte das erste Zeichen verwenden, das auf der Tastaturbelegung des Computers vorhanden ist.
anchor-
Verknüpft ein positioniertes Element mit einem Ankerelement. Der Wert des Attributs ist der Wert des Attributs
iddes Elements, an dem das positionierte Element verankert werden soll. Anschließend kann das Element mithilfe der CSS-Ankerpositionierung positioniert werden. autocapitalize-
Steuert, ob eingegebener Text automatisch großgeschrieben wird und, falls ja, auf welche Weise.
autocorrect-
Steuert, ob eingegebener Text automatisch auf Rechtschreibfehler korrigiert wird. Dies kann auf Elemente mit bearbeitbarem Text angewendet werden, mit Ausnahme von
<input>-Elementen mit dem Attributtype="password",type="email"odertype="url". autofocus-
Gibt an, dass ein Element beim Laden der Seite oder sobald das
<dialog>, zu dem es gehört, angezeigt wird, den Fokus erhalten soll. Dieses Attribut ist boolesch und hat anfänglich den Wertfalse. class-
Eine durch Leerzeichen getrennte Liste der Klassen des Elements. Klassen ermöglichen es CSS und JavaScript, bestimmte Elemente über Klassenselektoren oder Funktionen wie die Methode
Document.getElementsByClassName()auszuwählen und darauf zuzugreifen. containertiming-
Eine Zeichenfolge, die das Element als Containerwurzel für die Beobachtung durch
PerformanceObserver-Objekte mit dem Typ"container"kennzeichnet. Ihr Wert identifiziert den Container. containertimingignore-
Ein boolesches Attribut, das das Element und seine Nachfahren davon ausschließt, zum Timing eines mit
containertiminggekennzeichneten Vorfahrenelements beizutragen. contenteditable-
Ein Aufzählungsattribut, das angibt, ob das Element von Benutzern bearbeitet werden können soll. Ist dies der Fall, passt der Browser seine Benutzeroberfläche an, um die Bearbeitung zu ermöglichen. Das Attribut muss einen der folgenden Werte haben:
trueoder die leere Zeichenfolge: Das Element muss bearbeitbar sein.false: Das Element darf nicht bearbeitbar sein.plaintext-only: Der unformatierte Text des Elements ist bearbeitbar, aber die Rich-Text-Formatierung ist deaktiviert.
data-*-
Bildet eine Klasse von Attributen, die als benutzerdefinierte Datenattribute bezeichnet werden. Sie ermöglichen den Austausch eigener Informationen zwischen HTML und seiner DOM-Repräsentation, die von Skripten verwendet werden können. Alle solchen benutzerdefinierten Daten sind über die
HTMLElement-Schnittstelle des Elements verfügbar, für das das Attribut gesetzt ist. Die EigenschaftHTMLElement.datasetermöglicht den Zugriff darauf. dir-
Ein Aufzählungsattribut, das die Schreibrichtung des Textes eines Elements angibt. Es kann folgende Werte haben:
ltrbedeutet von links nach rechts und wird für Sprachen verwendet, die von links nach rechts geschrieben werden (wie Englisch).rtlbedeutet von rechts nach links und wird für Sprachen verwendet, die von rechts nach links geschrieben werden (wie Arabisch).autoüberlässt die Entscheidung dem User Agent. Dieser analysiert die Zeichen innerhalb des Elements mit einem einfachen Algorithmus, bis er ein Zeichen mit eindeutiger Schreibrichtung findet, und wendet diese Schreibrichtung dann auf das gesamte Element an.
draggable-
Ein Aufzählungsattribut, das angibt, ob das Element mithilfe der Drag-and-Drop-API gezogen werden kann. Es kann folgende Werte haben:
truegibt an, dass das Element gezogen werden kann.falsegibt an, dass das Element nicht gezogen werden kann.
enterkeyhint-
Gibt einen Hinweis darauf, welche Aktionsbeschriftung oder welches Symbol für die Eingabetaste auf virtuellen Tastaturen angezeigt werden soll.
exportparts-
Wird verwendet, um Shadow Parts transitiv aus einem verschachtelten Shadow Tree in einen umgebenden Light Tree zu exportieren.
headingoffset-
Erhöht die berechnete Überschriftenebene der Überschriftenelemente innerhalb des Elements, ohne die dafür verwendeten Elemente zu ändern.
headingreset-
Ein boolesches Attribut, das verhindert, dass sich die
headingoffset-Werte von Vorfahrenelementen auf die Überschriften innerhalb des Elements auswirken. -
Ein Aufzählungsattribut, das angibt, dass das Element noch nicht oder nicht mehr relevant ist. Es kann beispielsweise verwendet werden, um Seitenelemente zu verbergen, die erst nach Abschluss der Anmeldung verwendet werden können. Der Browser stellt solche Elemente nicht dar. Dieses Attribut darf nicht verwendet werden, um Inhalte zu verbergen, die berechtigterweise angezeigt werden könnten.
id-
Definiert einen eindeutigen Bezeichner (ID), der im gesamten Dokument nur einmal vorkommen darf. Er dient dazu, das Element beim Verlinken (mithilfe eines Fragmentbezeichners), in Skripten oder bei der Gestaltung mit CSS zu identifizieren.
inert-
Ein boolescher Wert, der bewirkt, dass der Browser Benutzereingabeereignisse für das Element ignoriert. Nützlich, wenn Klickereignisse vorhanden sind.
inputmode-
Gibt Browsern einen Hinweis darauf, welche Art von virtueller Tastatur beim Bearbeiten dieses Elements oder seines Inhalts verwendet werden soll. Wird hauptsächlich für
<input>-Elemente verwendet, kann aber für jedes Element imcontenteditable-Modus verwendet werden. is-
Ermöglicht festzulegen, dass sich ein Standard-HTML-Element wie ein registriertes angepasstes integriertes Element verhalten soll (weitere Informationen finden Sie unter Benutzerdefinierte Elemente verwenden).
Hinweis:
Die item*-Attribute sind Teil der WHATWG-HTML-Mikrodatenfunktion.
itemid-
Der eindeutige, globale Bezeichner eines Eintrags.
itemprop-
Wird verwendet, um einem Eintrag Eigenschaften hinzuzufügen. Für jedes HTML-Element kann ein
itemprop-Attribut angegeben werden, wobei einitempropaus einem Name-Wert-Paar besteht. itemref-
Eigenschaften, die keine Nachfahren eines Elements mit dem Attribut
itemscopesind, können dem Eintrag mithilfe vonitemrefzugeordnet werden. Es enthält eine Liste von Element-IDs (nichtitemid-Werten) mit zusätzlichen Eigenschaften an anderen Stellen im Dokument. itemscope-
itemscopewird (üblicherweise) zusammen mititemtypeverwendet, um anzugeben, dass sich das in einem Block enthaltene HTML auf einen bestimmten Eintrag bezieht.itemscopeerstellt den Eintrag und definiert den Geltungsbereich des zugehörigenitemtype.itemtypeist eine gültige URL eines Vokabulars (etwa schema.org), das den Eintrag und den Kontext seiner Eigenschaften beschreibt. itemtype-
Gibt die URL des Vokabulars an, das zur Definition von
itemprop-Eigenschaften in der Datenstruktur verwendet wird. Mititemscopewird festgelegt, in welchem Bereich der Datenstruktur das durchitemtypeangegebene Vokabular gilt. lang-
Hilft dabei, die Sprache eines Elements festzulegen: die Sprache, in der nicht bearbeitbare Elemente verfasst sind, oder die Sprache, in der Benutzer bearbeitbare Elemente verfassen sollen. Das Attribut sollte ein gültiges BCP-47-Sprachkennzeichen enthalten.
xml:langhat Vorrang vor diesem Attribut. nonce-
Eine kryptografische Nonce („number used once“, eine nur einmal verwendete Zahl), anhand derer die Content Security Policy bestimmen kann, ob ein bestimmter Abruf fortgesetzt werden darf.
part-
Eine durch Leerzeichen getrennte Liste der Part-Namen des Elements. Part-Namen ermöglichen es CSS, bestimmte Elemente in einem Shadow Tree über das Pseudoelement
::partauszuwählen und zu gestalten. popover-
Kennzeichnet ein Element als Popover-Element (siehe Popover-API). Popover-Elemente sind durch
display: noneverborgen, bis sie über ein auslösendes oder steuerndes Element (beispielsweise ein<button>oder<input type="button">mit dem Attributpopovertarget) oder durch einen Aufruf vonHTMLElement.showPopover()geöffnet werden. role-
Rollen definieren die semantische Bedeutung von Inhalten. Dadurch können Screenreader und andere Hilfsmittel die Interaktion mit einem Objekt entsprechend den Erwartungen der Benutzer an diesen Objekttyp darstellen und unterstützen.
roleswerden HTML-Elementen mitrole="role_type"hinzugefügt, wobeirole_typeder Name einer Rolle in der ARIA-Spezifikation ist. slot-
Weist einem Element einen Slot in einem Shadow-DOM-Shadow-Tree zu: Ein Element mit einem
slot-Attribut wird dem Slot zugewiesen, den das<slot>-Element erstellt, dessen Attributnamedenselben Wert wie dasslot-Attribut hat. spellcheck-
Ein Aufzählungsattribut, das festlegt, ob das Element auf Rechtschreibfehler geprüft werden darf. Es kann folgende Werte haben:
- die leere Zeichenfolge oder
true: Das Element sollte nach Möglichkeit auf Rechtschreibfehler geprüft werden. false: Das Element sollte nicht auf Rechtschreibfehler geprüft werden.
- die leere Zeichenfolge oder
style-
Enthält CSS-Gestaltungsdeklarationen, die auf das Element angewendet werden. Es wird empfohlen, Stile in einer oder mehreren separaten Dateien zu definieren. Dieses Attribut und das Element
<style>dienen hauptsächlich dazu, eine schnelle Gestaltung zu ermöglichen, beispielsweise zu Testzwecken. tabindex-
Ein ganzzahliges Attribut, das angibt, ob das Element den Eingabefokus erhalten kann (also fokussierbar ist), ob es an der sequenziellen Tastaturnavigation teilnehmen soll und, falls ja, an welcher Position. Es kann verschiedene Werte haben:
- Ein negativer Wert bedeutet, dass das Element fokussierbar sein soll, aber nicht über die sequenzielle Tastaturnavigation erreichbar sein soll.
0bedeutet, dass das Element fokussierbar und über die sequenzielle Tastaturnavigation erreichbar sein soll. Seine relative Reihenfolge richtet sich jedoch nach den Konventionen der Plattform.- Ein positiver Wert bedeutet, dass das Element fokussierbar und über die sequenzielle Tastaturnavigation erreichbar sein soll. Die Reihenfolge, in der die Elemente fokussiert werden, richtet sich nach dem aufsteigenden Wert von
tabindex. Haben mehrere Elemente denselben tabindex, richtet sich ihre relative Reihenfolge nach ihrer Position im Dokument.
title-
Enthält einen Text mit ergänzenden Informationen zu dem Element, zu dem das Attribut gehört. Solche Informationen können Benutzern typischerweise, aber nicht zwingend, als Tooltip angezeigt werden.
translate-
Ein Aufzählungsattribut, das angibt, ob die Attributwerte eines Elements und die Werte seiner untergeordneten
Text-Knoten bei der Lokalisierung der Seite übersetzt oder unverändert gelassen werden sollen. Es kann folgende Werte haben:- die leere Zeichenfolge oder
yes: Das Element wird übersetzt. no: Das Element wird nicht übersetzt.
- die leere Zeichenfolge oder
virtualkeyboardpolicy-
Ein Aufzählungsattribut, mit dem das Verhalten der virtuellen Bildschirmtastatur auf Geräten wie Tablets, Mobiltelefonen oder anderen Geräten gesteuert wird, auf denen möglicherweise keine Hardwaretastatur verfügbar ist, wenn der Inhalt eines Elements bearbeitbar ist (beispielsweise bei einem
<input>- oder<textarea>-Element oder einem Element mit dem Attributcontenteditable).autooder die leere Zeichenfolge: Die virtuelle Tastatur wird automatisch angezeigt, wenn das Element fokussiert oder angetippt wird.manual: Das Fokussieren und Antippen des Elements wird vom Zustand der virtuellen Tastatur entkoppelt.
writingsuggestions-
Ein Aufzählungsattribut, das angibt, ob vom Browser bereitgestellte Schreibvorschläge im Geltungsbereich des Elements aktiviert sein sollen.
falsedeaktiviert die Schreibvorschläge des Browsers.trueoder die leere Zeichenfolge aktiviert Schreibvorschläge.
Liste der globalen Event-Handler-Attribute
Von der Verwendung von HTML-Event-Handler-Attributen wird abgeraten. Wie sie funktionieren, erfahren Sie in der Referenz der HTML-Attribute.
Die unten aufgeführten Attribute gelten zwar für alle Elemente, sind aber nicht für alle Elemente sinnvoll. Beispielsweise wird das HTML-Attribut onvolumechange von allen Elementen akzeptiert und fügt einen Event-Listener für volumechange hinzu. Ein vom Browser ausgelöstes volumechange-Ereignis empfangen jedoch nur Medienelemente. Bei anderen Elementen können Sie ein solches Ereignis nur mit EventTarget.dispatchEvent() manuell auslösen. Einige Attribute können für <body> angegeben werden, reagieren dann aber stattdessen auf Ereignisse auf window.
onabortonanimationcancelonanimationendonanimationiterationonanimationstartonauxclickonbeforeinputonbeforematchonbeforetoggleonbluroncanceloncanplayoncanplaythroughonchangeonclickoncloseoncommandoncontentvisibilityautostatechangeoncontextlostoncontextmenuoncontextrestoredoncopyoncuechangeoncutondblclickondragondragendondragenterondragleaveondragoverondragstartondropondurationchangeonemptiedonendedonerroronfocusonfocusinonfocusoutonformdataonfullscreenchangeonfullscreenerrorongesturechangeongestureendongesturestartongotpointercaptureoninputoninvalidonkeydownonkeypressonkeyuponloadonloadeddataonloadedmetadataonloadstartonlostpointercaptureonmousedownonmouseenteronmouseleaveonmousemoveonmouseoutonmouseoveronmouseuponmousewheelonpasteonpauseonplayonplayingonpointercancelonpointerdownonpointerenteronpointerleaveonpointermoveonpointeroutonpointeroveronpointerrawupdateonpointeruponprogressonratechangeonresetonresizeonscrollonscrollendonscrollsnapchangeonscrollsnapchangingonsecuritypolicyviolationonseekedonseekingonselectonselectionchangeonselectstartonslotchangeonstalledonsubmitonsuspendontimeupdateontoggleontouchcancelontouchendontouchmoveontouchstartontransitioncancelontransitionendontransitionrunontransitionstartonvolumechangeonwaitingonwebkitmouseforcechangedonwebkitmouseforcedownonwebkitmouseforceuponwebkitmouseforcewillbeginonwheel
Spezifikationen
Browser-Kompatibilität
Siehe auch
- Die Schnittstelle
Element, über die sich die meisten globalen Attribute abfragen lassen.