CSS list-style-image

<!doctype html>
<title>Example</title>
<style>
  ul { 
    list-style-image: url(/pix/printer_icon.gif);
    }
</style>
<p>Remember to print out info on the following:</p>
<ul>
  <li>list-style-type</li>
  <li>list-style-position</li>
  <li>list-style-image</li>
</ul>

The CSS list-style-image property is used to specify an image to be used as a list marker's default contents.

The list-style-image property allows you to create your own custom bullets to use in lists.

The list-style-image property can be used on any list item. A list item is any element with its display property set to list-item or inline-list-item. List items are the only elements that generate ::marker pseudo-elements.

Also see the list-style, list-style-type and list-style-position properties.

Syntax

Possible Values

none: The default contents of the of the list item's marker are given by list-style-type instead.
image: Specifies an image as the default contents of the list item's marker. Must be a valid image, otherwise the default contents will be provided by list-style-type instead.

In addition, all CSS properties also accept the following CSS-wide keyword values as the sole component of their property value:

initial: Represents the value specified as the property's initial value.
inherit: Represents the computed value of the property on the element's parent.
unset: This value acts as either inherit or initial, depending on whether the property is inherited or not. In other words, it sets all properties to their parent value if they are inheritable or to their initial value if not inheritable.

General Information

Initial Value: none
Applies To: List items (any element with its display property set to list-item or inline-list-item).
Inherited?: Yes
Media: Visual

Example Code

Official Specifications

CSS Lists and Counters Module Level 3 (W3C Working Draft)
CSS Level 2.1 (W3C Recommendation 07 June 2011)
CSS Level 1 (W3C Recommendation 17 Dec 1996)