Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

<dl> HTML-Element für Definitionslisten

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Das <dl> HTML-Element stellt eine Definitionsliste dar. Das Element umschließt eine Liste von Gruppen aus Begriffen (spezifiziert mit dem <dt>-Element) und Beschreibungen (bereitgestellt durch <dd>-Elemente). Häufige Verwendungen für dieses Element sind die Implementierung eines Glossars oder die Anzeige von Metadaten (eine Liste von Schlüssel-Wert-Paaren).

Probieren Sie es aus

<p>Cryptids of Cornwall:</p>

<dl>
  <dt>Beast of Bodmin</dt>
  <dd>A large feline inhabiting Bodmin Moor.</dd>

  <dt>Morgawr</dt>
  <dd>A sea serpent.</dd>

  <dt>Owlman</dt>
  <dd>A giant owl-like creature.</dd>
</dl>
p,
dt {
  font-weight: bold;
}

dl,
dd {
  font-size: 0.9rem;
}

dd {
  margin-bottom: 1em;
}

Attribute

Dieses Element akzeptiert auch die globalen Attribute.

compact

Dieses Boolean-Attribut deutet darauf hin, dass die Liste in einem kompakten Stil gerendert werden sollte. Die Interpretation dieses Attributs ist browser-spezifisch. Verwenden Sie stattdessen CSS: Um einen ähnlichen Effekt wie das compact-Attribut zu erzielen, kann die CSS-Eigenschaft line-height mit einem Wert von 80% verwendet werden.

Barrierefreiheit

Jeder Screenreader stellt <dl>-Inhalte unterschiedlich dar, einschließlich Gesamtsumme, Kontext von Begriffen/Beschreibungen und Navigationsmethoden. Diese Unterschiede sind nicht notwendigerweise Fehler. Ab iOS 14 wird VoiceOver ankündigen, dass <dl>-Inhalte eine Liste sind, wenn mit dem virtuellen Cursor navigiert wird (nicht über den Kommando „Alles vorlesen“). VoiceOver unterstützt keine Listennavigationsbefehle mit <dl>. Seien Sie vorsichtig, wenn Sie ARIA term und definition Rollen auf <dl>-Konstrukte anwenden, da VoiceOver (macOS und iOS) die Art und Weise, wie sie angekündigt werden, anpasst.

Beispiele

Einzelner Begriff und Beschreibung

html
<dl>
  <dt>Firefox</dt>
  <dd>
    A free, open source, cross-platform, graphical web browser developed by the
    Mozilla Corporation and hundreds of volunteers.
  </dd>

  <!-- Other terms and descriptions -->
</dl>

Ergebnis

Mehrere Begriffe, eine Beschreibung

html
<dl>
  <dt>Firefox</dt>
  <dt>Mozilla Firefox</dt>
  <dt>Fx</dt>
  <dd>
    A free, open source, cross-platform, graphical web browser developed by the
    Mozilla Corporation and hundreds of volunteers.
  </dd>

  <!-- Other terms and descriptions -->
</dl>

Ergebnis

Einzelner Begriff, mehrere Beschreibungen

html
<dl>
  <dt>Firefox</dt>
  <dd>
    A free, open source, cross-platform, graphical web browser developed by the
    Mozilla Corporation and hundreds of volunteers.
  </dd>
  <dd>
    The Red Panda also known as the Lesser Panda, Wah, Bear Cat or Firefox, is a
    mostly herbivorous mammal, slightly larger than a domestic cat (60 cm long).
  </dd>

  <!-- Other terms and descriptions -->
</dl>

Ergebnis

Mehrere Begriffe und Beschreibungen

Es ist auch möglich, mehrere Begriffe mit mehreren entsprechenden Beschreibungen zu definieren, indem die obigen Beispiele kombiniert werden.

Metadaten

Definitionslisten sind nützlich, um Metadaten als Liste von Schlüssel-Wert-Paaren darzustellen.

html

Ergebnis

Tipp: Es kann hilfreich sein, einen Schlüssel-Wert-Trenner im CSS zu definieren, wie zum Beispiel:

css

Eingefasste Name-Wert-Gruppen in div-Elementen

HTML erlaubt das Einfassen jeder Name-Wert-Gruppe in einem <dl>-Element in einem <div>-Element. Dies kann nützlich sein, wenn Mikrodaten verwendet werden oder wenn globale Attribute auf eine ganze Gruppe angewendet werden oder zu Styling-Zwecken.

html
<dl>
  <div>
    <dt>Name</dt>
    <dd>Godzilla</dd>
  </div>
  <div>
    <dt>Born</dt>
    <dd>1952</dd>
  </div>
  <div>
    <dt>Birthplace</dt>
    <dd>Japan</dd>
  </div>
  <div>
    <dt>Color</dt>
    <dd>Green</dd>
  </div>
</dl>

Ergebnis

Anmerkungen

Verwenden Sie dieses Element (oder <ul>-Elemente) nicht nur, um Einzug auf einer Seite zu erstellen. Obwohl es funktioniert, ist dies eine schlechte Praxis und verdeckt die Bedeutung von Definitionslisten.

Um den Einzug eines Definitionsbegriffs zu ändern, verwenden Sie die CSS-Eigenschaft margin.

Technische Zusammenfassung

Inhaltskategorien Flussinhalt und, wenn die Kinder des Elements <dl> eine Name-Wert-Gruppe enthalten, fühlbarer Inhalt.
Erlaubter Inhalt

Entweder: Null oder mehr Gruppen, die jeweils aus einem oder mehreren <dt>-Elementen gefolgt von einem oder mehreren <dd>-Elementen bestehen, optional vermischt mit <script> und <template>-Elementen.
Oder: (im WHATWG HTML, W3C HTML 5.2 und später) ein oder mehrere <div>-Elemente, optional vermischt mit <script> und <template>-Elementen.

Tag-Auslassung Keine, sowohl das Start- als auch das End-Tag sind obligatorisch.
Erlaubte Eltern Jedes Element, das Flussinhalt akzeptiert.
Implizite ARIA-Rolle Keine entsprechende Rolle
Erlaubte ARIA-Rollen group, list, none, presentation
DOM-Schnittstelle [`HTMLDListElement`](/de/docs/Web/API/HTMLDListElement)

Spezifikationen

Spezifikation
HTML
# the-dl-element

Browser-Kompatibilität

Siehe auch