HTML/Elemente/legend

Das legend-Element definiert eine Überschrift für einen Formularbereich.

Syntax

Start-Tag: notwendig

End-Tag: notwendig

WAI‑ARIA‑Rolle

• keine

Elternelemente

Darf vorkommen in:

• fieldset
• muss erstes Kind des fieldset-Elements sein

erlaubte Inhalte

• beliebig viele Elemente mit phrasing content
• Überschrift-Elemente (headings)

Beispiel

<form id="gewinnen">
  <h2>Ausfüllen und Gewinnen!</h2>
  <fieldset>
   <legend>Name</legend> 
   <label for="vorname"> Vorname: <input name="vorname" id="vorname"> </label> 
   <label for="zuname"> Zuname: <input name="zuname" id="zuname"> </label> 
  </fieldset> <fieldset> 
    <legend>Geschlecht</legend> 
    <label for="männl">
      <input type="radio" name="geschlecht" id="männl" value="männl"> 
      männlich 
    </label> 
    <label for="weibl">
      <input type="radio" name="geschlecht" id="weibl" value="weibl">
       weiblich 
    </label> 
    <label for="divers">
      <input type="radio" name="geschlecht" id="divers" value="divers">
      divers
    </label> 
  </fieldset>
</form>

Das Formular erhält eine Beschreibung in einem label-Element, das über das form-Attribut mit der id des Formulars verknüpft ist.
Es ist mit fieldset-Elementen in zwei Blöcke gegliedert, die jede eine Erklärung in einem legend-Element haben.

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/Benutzereingaben zugänglich gestalten
    Gruppierung mit fieldset

Weblinks

• Spezifikation (W3C): The legend-Element