HTML/Elemente/datalist

Das datalist-Element stellt eine Datenliste dar, die vordefinierte Auswahlmöglichkeiten für andere Steuerelemente enthält.

Syntax

Start-Tag: notwendig

End-Tag: notwendig

WAI‑ARIA‑Rolle

• listbox (Details)

Elternelemente

Darf vorkommen in:

• allen Elementen mit phrasing content

erlaubte Inhalte

• beliebig viele option-Elemente (außer denen, die disabled sind oder einen leeren Wert haben) und Script-unterstützende Elemente

oder

• phrasing content - als Fallback für Altbrowser, die datalist nicht unterstützen. Die enthaltenen option-Elemente (außer disabled oder leer) werden zur Auswahl angeboten

Beispiel

 <form action="#">
    <label for="search">Vogelart</label>
    <input type="search" id="search" list="Vögel">
    <datalist id="Vögel">
        <option value="Amsel"> 
        <option value="Buntspecht"> 
        <option value="Drossel"> 
        <option value="Eisvogel"> 
        <option value="Fink"> 
        <option value="Spatz"> 
        <option value="Specht"> 
  </datalist> 
  <button>finden!</button>
</form>

Das Beispiel zeigt ein Eingabefeld mit label. Der Zusammenhang zwischen dem Eingabefeld und der Liste an Vorschlägen wird dadurch hergestellt, dass der Bezeichner Vögel sowohl im list-Attribut des input-Elements, als auch im id-Attribut des datalist-Elements steht.
Bei einer Eingabe von "sp" werden die Vorschläge gefiltert und nur noch "Buntspecht, Spatz und Specht angezeigt.

Attribute

Name	Inhalt	Standardwert	Bedeutung
Universalattribute
id	ID		identifiziert ein einziges Element innerhalb eines Dokuments
class	Token		ordnet ein Element einer oder mehreren Klassen zu.
accesskey	Text (string)		Tastaturkürzel
contenteditable	Boolean		editierbarer Inhalt
dir	ltr, rtl		definiert die Schreibrichtung innerhalb des Dokuments
draggable	Boolean		kann mit Drag & Drop gezogen werden
hidden		Boolean	versteckter Inhalt
lang	Sprachkürzel		legt eine den IANA-Sprachdefinitionen folgende Sprache des Elementinhalts fest [RFC1766]
spellcheck	Boolean		Rechtschreibprüfung Sollte auch für input type="password" deaktiviert werden.
style	String (Text)		notiert direkt in einem Element- style sheet data
tabindex	NUMBER		zeigt an, ob dieses Element fokusiert werden kann, ob es mithilfe der Tastaturnavigation angesteuert werden kann und in welcher Reihenfolge navigiert wird.
title	String (Text)		betitelt oder beschreibt ein Element.

Attribut: Pflichtattribut
Attribut: optionales Attribut

Siehe auch

• Formulare
  • Formulare/Suchen und Filtern

Weblinks

• Spezifikation (W3C): The datalist-Element