CSS list-style-type: Listenzeichen und Nummerierung festlegen

Mit list-style-type legen Sie das Aufzählungszeichen oder das Nummernformat vor einem Listeneintrag fest. Verwenden Sie <ol> für Schritte in fester Reihenfolge und <ul> für Aufzählungen ohne feste Reihenfolge. Soll eine nummerierte Liste mit drei beginnen, setzen Sie start="3" am <ol>.

Werte für Aufzählungen und nummerierte Listen

disc, circle und square stehen für einen gefüllten Kreis, einen leeren Kreis und ein Quadrat. Für nummerierte Listen bieten sich decimal und lower-roman an. none entfernt das standardmäßige Textzeichen.

Der CSS-Anfangswert ist disc. Das Browser-Stylesheet verwendet für <ol> üblicherweise decimal. Prüfen Sie bei Zweifeln den berechneten Wert des Listeneintrags.

ol.steps { list-style-type: lower-roman; }
ul.topics { list-style-type: square; }

Ein lauffähiges HTML-Beispiel

Speichern Sie das vollständige Beispiel als UTF-8-Datei list-style-type.html und öffnen Sie es im Browser. Die CSS-Regeln gelten nur für die beiden Klassen im Beispiel.

<!doctype html>
<html lang="de">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Arbeitsschritte / Themen</title>
  <style>
    .steps, .topics { padding-inline-start: 2em; }
    ol.steps { list-style-type: lower-roman; }
    ul.topics { list-style-type: square; }
  </style>
</head>
<body>
  <h1>Arbeitsschritte</h1>
  <ol class="steps">
    <li>Datei speichern</li>
    <li>Datei öffnen</li>
  </ol>
  <h2>Themen</h2>
  <ul class="topics">
    <li>HTML</li>
    <li>CSS</li>
  </ul>
</body>
</html>

Vor den Schritten stehen i. und ii.. Die Themen erscheinen mit quadratischen Aufzählungszeichen.

  1. Ändern Sie in der Regel für .steps den Wert zuerst in decimal und dann in none. Die Reihenfolge der Einträge bleibt erhalten. Stellen Sie danach lower-roman wieder her.
  2. Ergänzen Sie am <ol> das Attribut start="3". Jetzt erscheinen iii. und iv.. Entfernen Sie das Attribut, um wieder bei eins zu beginnen.

HTML-Standard zur geordneten Liste

Vererbung, Bilder und Kurzschreibweise

Die Eigenschaft wird vom Listenelement an seine Einträge vererbt. Eine verschachtelte Liste kann trotzdem einen eigenen Wert aus dem Browser-Stylesheet erhalten. Soll sie den Stil der äußeren Liste übernehmen, setzen Sie gezielt etwa .features ul { list-style-type: inherit; }.

Ein gültiges list-style-image oder ausdrücklich gesetzter Inhalt von ::marker kann das erwartete Zeichen ersetzen. list-style: inside setzt den ausgelassenen Typ und das Bild auf ihre Anfangswerte zurück. Mit list-style-position: inside ändern Sie gezielt die Position.

W3C-Spezifikation zu Listenzeichen

Fehlende oder unerwartete Listenzeichen prüfen

  1. Wählen Sie in den Entwicklertools das betroffene <li>. Prüfen Sie den berechneten Typ und display. Wenn das Element durch display: flex seine Listenbox verliert, legen Sie den Flex-Container innerhalb des Eintrags an.
  2. Deaktivieren Sie zunächst Bild- und ::marker-Regeln einzeln. Stimmen die berechneten Werte, prüfen Sie den Innenabstand am Zeilenanfang und overflow bei Vorgängerelementen. Ein außen platziertes Zeichen benötigt Platz.

Wenn eine Nummer für die Anleitung wichtig ist, lassen Sie sie sichtbar. Bei Listen ohne Zeichen kann Safari die Listensemantik im Accessibility Tree auslassen. Prüfen Sie die Zielumgebung und ergänzen Sie bei Bedarf role="list" am Listenelement. MDN zur Barrierefreiheit bei Listen