list-style

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

list-style は CSS の一括指定プロパティで、リストのすべてのスタイルプロパティを設定します。

試してみましょう

このプロパティの値はリストアイテム、すなわち <li> 要素や display: list-item; が設定された要素に適用されます。このプロパティは継承されるので、親要素(ふつうは <ol> または <ul>)に設定すれば、同じリストスタイルを内部のすべてのアイテムに適用できます。

構成要素のプロパティ

このプロパティは以下の CSS プロパティの一括指定です。

構文

css
/* type */
list-style: square;

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

/* position */
list-style: inside;

/* 2 つの値 */
list-style: georgian outside;
list-style: url("img/pip.svg") inside;

/* 3 つの値 */
list-style: lower-roman url("img/shape.png") outside;

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

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

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

list-style-type

<counter-style><string>none のいずれかです。一括指定で省略された場合は、既定値の disc の値が使用されます。 list-style-type を参照して下さい。

list-style-image

<image> または none です。省略された場合、既定値の none が使用されます。 list-style-image を参照して下さい。

list-style-position

insideoutside のどちらかです。省略された場合、list-style-position を参照して下さい。

none

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

公式定義

初期値一括指定の次の各プロパティとして
適用対象 リスト項目
継承あり
計算値一括指定の次の各プロパティとして
アニメーションの種類一括指定の次の各プロパティとして

形式文法

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

<list-style-position> =
inside |
outside

<list-style-image> =
<image> |
none

<list-style-type> =
<counter-style> |
<string> |
none

<image> =
<url> |
<gradient>

<counter-style> =
<counter-style-name> |
<symbols()>

<url> =
<url()> |
<src()>

<symbols()> =
symbols( <symbols-type>? [ <string> | <image> ]+ )

<url()> =
url( <string> <url-modifier>* ) |
<url-token>

<src()> =
src( <string> <url-modifier>* )

<symbols-type> =
cyclic |
numeric |
alphabetic |
symbolic |
fixed

アクセシビリティ

Safari では、 list-style 値が none である場合、それが <nav> のナビゲーション要素内に含まれていない限り、順序付きリストまたは順序なしリストをアクセシビリティツリー内のリストとして認識しません。これは意図的な動作であり、バグと認識されていません。

リストを確実にリストとしてアナウンスするようにするには、 role="list"<ol> および <ul> 要素に設定しておください。特に、このリストが <nav> に含まれていない場合はなおさらです。これによって、デザインに影響を与えることなく、リストの意味を回復することができます。

html
<ul role="list">
  <li>アイテム</li>
  <li>他のアイテム</li>
</ul>

ARIA role がコードに適さない場合は、代わりに CSS を使用することができます。各リストアイテムの前に、テキストや画像などの空ではない擬似コンテンツを追加すると、リストの意味を復元できますが、視覚的な外観に影響します。 Safari は、追加された擬似コンテンツがアクセシビリティのあるコンテンツとして十分かどうかを判断し、十分であればリストの意味を復元します。通常、 Safari はテキストと画像で十分であるとみなします。そのため、以下に示す content: "+ "; が機能します(ただし、デザインに影響を与えないようにするには、追加のスタイル設定が必要です)。

css
ul {
  list-style: none;
}

ul li::before {
  content: "+ ";
}

content: ""; (空文字列)の宣言は無視されます。また、 content の値は content: " "; のように空白だけの場合も無視されます。

これらの CSS による回避策は HTML での解決ができない場合のみに使用してください。また、ユーザーの使い勝手に悪影響を与えないことをテストした後にのみ使用してください。

リストスタイルの種類と位置の設定

HTML

html
リスト 1
<ul class="one">
  <li>リストアイテム 1</li>
  <li>リストアイテム 2</li>
  <li>リストアイテム 3</li>
</ul>
リスト 2
<ul class="two">
  <li>リストアイテム A</li>
  <li>リストアイテム B</li>
  <li>リストアイテム C</li>
</ul>

CSS

css
.one {
  list-style: circle;
}

.two {
  list-style: square inside;
}

仕様書

Specification
CSS Lists and Counters Module Level 3
# list-style-property

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
list-style
symbols()

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

関連情報