在此页

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

list-style-image CSS property sets an image to be used as the list item marker.

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

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.

注意： 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.

句法

/* Keyword values */
list-style-image: none;
/* <url> values */
list-style-image: url('starsolid.gif');
/* Global values */
list-style-image: inherit;
list-style-image: initial;
list-style-image: unset;
				

值

<url>

Location of image to use as the marker.

none

Specifies that no image is used as the marker. If this value is set, the marker defined in list-style-type will be used instead.

形式定义

初始值	none
适用于	list items
继承	yes
计算值	none or the image with its URI made absolute
动画类型	discrete

形式句法

<url> | none
					

范例

Setting list item images

HTML

<ul>
  <li>Item 1</li>
  <li>Item 2</li>
</ul>
					

CSS

ul {
  list-style-image: url("https://mdn.mozillademos.org/files/11981/starsolid.gif");
}
					

结果

规范

规范	状态	注释
CSS Lists Module Level 3 The definition of 'list-style-image' in that specification.	工作草案	Extends support to any <image> data type.
CSS Level 2 (Revision 1) The definition of 'list-style-image' 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-image	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 4	Opera 完整支持 7	Safari 完整支持 1	WebView Android 完整支持 1	Chrome Android 完整支持 18	Firefox Android 完整支持 4	Opera Android 完整支持 10.1	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0

图例

完整支持

完整支持

另请参阅

• list-style , list-style-type , list-style-position
• url() function

元数据

• 最后修改： Aug 9, 2020

相关话题

1. CSS
2. CSS 参考
3. CSS Lists and Counters
4. 指南

   1. Consistent list indentation
   2. Using CSS counters
5. 特性

   1. <custom-ident>
   2. list-style
   3. list-style-image
   4. list-style-position
   5. list-style-type