list-style-position

在此页

句法
形式定义
形式句法
范例
规范
浏览器兼容性
另请参阅
相关话题

list-style-position CSS property sets the position of the ::marker relative to a list item.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

It is often more convenient to use the shorthand list-style .

注意： This property is applied to list items, i.e., elements with display : list-item; . By default this includes <li> elements. Because this property is inherited, it can be set on the parent element (normally <ol> or <ul> ) to let it apply to all list items.

Note that there is variance among browsers regarding behavior when a block element is placed first within a list element declared as list-style-position: inside . Chrome and Safari both place this element on the same line as the marker box, whereas Firefox, Internet Explorer, and Opera place it on the next line. For more information on this, see bug 36854 .

句法

/* Keyword values */
list-style-position: inside;
list-style-position: outside;
/* Global values */
list-style-position: inherit;
list-style-position: initial;
list-style-position: unset;

list-style-position property is specified as one of the keyword values listed below.

值

inside: ::marker is the first element among the list item's contents.
outside: ::marker is outside the principal block box.

形式定义

初始值	`outside`
适用于	list items
继承	yes
计算值	如指定
动画类型	discrete

形式句法

inside | outside

范例

Setting list item position

HTML

<ul class="inside">List 1
  <li>List Item 1-1</li>
  <li>List Item 1-2</li>
  <li>List Item 1-3</li>
  <li>List Item 1-4</li>
</ul>
<ul class="outside">List 2
  <li>List Item 2-1</li>
  <li>List Item 2-2</li>
  <li>List Item 2-3</li>
  <li>List Item 2-4</li>
</ul>
<ul class="inside-img">List 3
  <li>List Item 3-1</li>
  <li>List Item 3-2</li>
  <li>List Item 3-3</li>
  <li>List Item 3-4</li>
</ul>

CSS

.inside {
  list-style-position: inside;
  list-style-type: square;
}
.outside {
  list-style-position: outside;
  list-style-type: circle;
}
.inside-img {
  list-style-position: inside;
  list-style-image: url("https://mdn.mozillademos.org/files/11979/starsolid.gif");
}

结果

规范

规范	状态	注释
CSS Lists Module Level 3 The definition of 'list-style-position' in that specification.	工作草案	无变化。
CSS Level 2 (Revision 1) The definition of 'list-style-position' in that specification.	推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`list-style-position`	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 4	Opera 完整支持 3.5	Safari 完整支持 1	WebView Android 完整支持 ≤37	Chrome Android 完整支持 18	Firefox Android 完整支持 4	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0

图例

完整支持

另请参阅

list-style , list-style-type , list-style-image

元数据

最后修改： 2020 年 7 月 17 日

CSS
CSS 参考
CSS Lists and Counters
指南
1. Consistent list indentation
2. Using CSS counters
特性
1. <custom-ident>
2. list-style
3. list-style-image
4. list-style-position
5. list-style-type

在此页

句法

值