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

• Text
• beliebig viele option-Elemente.

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	CDATA		ordnet ein Element einer oder mehreren Klassen zu.
accesskey	ID		Tastaturkürzel
contenteditable	CDATA		editierbarer Inhalt
contextmenu			definiert Kontextmenü
dir	ltr, rtl		definiert die Schreibrichtung innerhalb des Dokuments
draggable	ID		kann mit Drag & Drop gezogen werden
dropzone	CDATA		Aktion bei Ablegen
hidden			versteckter Inhalt
lang	NAME		legt eine den IANA-Sprachdefinitionen folgende Sprache des Elementinhalts fest [RFC1766]
spellcheck	ID		Rechtschreibprüfung Sollte auch für input type="password" deaktiviert werden.
style	CDATA		notiert direkt in einem Element- style sheet data
tabindex	NAME		zeigt an, ob dieses Element fokusiert werden kann, ob es mithilfe der Tastaturnavigation angesteuert werden kann und in welcher Reihenfolge navigiert wird.
title	CDATA		betitelt oder beschreibt ein Element.

Attribut: Pflichtattribut
Attribut: optionales Attribut

Siehe auch

• Formulare
  • Formulare/Suchen und Filtern

Weblinks

• Spezifikation (W3C): The datalist-Element