list-style

CSS の list-style プロパティは、リストをどのように表示するかを定義する list-style-type、 list-style-image、 list-style-position のそれぞれの値を設定する一括指定プロパティです。

この対話型サンプルのソースファイルは GitHub リポジトリに格納されています。対話型サンプルプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。

構文

/* type */
list-style: square;

/* image */
list-style: url('../img/shape.png');

/* position */
list-style: inside;

/* type | position */
list-style: georgian inside;

/* type | image | position */
list-style: lower-roman url('../img/shape.png') outside;

/* キーワード値 */
list-style: none;

/* グローバル値 */
list-style: inherit;
list-style: initial;
list-style: unset;

list-style プロパティは1～3つのキーワードを任意の順序で指定します。 list-style-type と list-style-image が両方とも設定された場合、 list-style-type は画像が利用できない場合の予備として使用されます。

値

list-style-type

list-style-type を参照して下さい。

list-style-image

list-style-image を参照して下さい。

list-style-position

list-style-position を参照して下さい。

none

リストスタイルは使用されません。

形式文法

<'list-style-type'> || <'list-style-position'> || <'list-style-image'>

例

HTML

List 1
<ul class="one">
  <li>List Item1</li>
  <li>List Item2</li>
  <li>List Item3</li>
</ul>
List 2
<ul class="two">
  <li>List Item A</li>
  <li>List Item B</li>
  <li>List Item C</li>
</ul>

CSS

.one {
  list-style: circle;
}

.two {
  list-style: square inside;
}

結果

アクセシビリティの考慮事項

Safari は順序なしリストで list-style の値に none が適用されると、アクセシビリティツリー上でリストとして認識されないという問題があります。これを解決するためには、それぞれのリスト項目の前にゼロ幅スペースを擬似コンテンツとして追加してください。これでデザインがこのバグの影響を受けず、リスト項目が正しくない記述にはなりません。

ul {
  list-style: none;
}

ul li::before {
  content: "\200B";
}

• VoiceOver and list-style-type: none – Unfettered Thoughts
• MDN WCAG を理解する ― ガイドライン 1.3 の解説
• Understanding Success Criterion 1.3.1 | W3C Understanding WCAG 2.0

仕様書

ブラウザーの対応

関連情報

• list-style-type, list-style-image, list-style-position