列表样式图片

类	属性
list-image-none	list-style-image: none;

类

属性

list-image-none

list-style-image: none;

基本用法

¥Basic usage

设置列表样式图片

¥Setting the list style image

使用 list-image-* 工具控制列表项的标记图片。

¥Use the list-image-* utilities to control the marker image for list items.

开箱即用，list-image-none 是唯一可用的预配置列表样式图片工具。虽然你可以通过定制你的主题添加其他工具，但你也可以使用方括号表示法即时生成任意值。

¥Out of the box, list-image-none is the only available preconfigured list style image utility. And while you can add additional utilities by customizing your theme, you can also use the square bracket notation to generate an arbitrary value on the fly.

5 cups chopped Porcini mushrooms
1/2 cup of olive oil
3lb of celery

<ul class="list-image-[url(checkmark.png)] ...">
  <li>5 cups chopped Porcini mushrooms</li>
  <!-- ... -->
</ul>

有条件地应用

悬停、聚焦和其他状态

Tailwind 允许你使用变体修饰符在不同状态下有条件地应用工具类。例如，使用hover:list-image-[url(checkmark.png)] 仅在 hover 时应用 list-image-[url(checkmark.png)] 工具。

<ul class="list-image-none hover:list-image-[url(checkmark.png)]">
  <!-- ... -->
</ul>

有关所有可用状态修饰符的完整列表，请查看悬停、聚焦、以及其他状态文档。

断点和媒体查询

你还可以使用变体修饰符来定位媒体查询，例如响应式断点、暗黑模式、首选减少运动等。例如，使用 md:list-image-[url(checkmark.png)] 仅在中等屏幕尺寸及以上时应用 list-image-[url(checkmark.png)] 工具。

<ul class="list-image-none md:list-image-[url(checkmark.png)]">
  <!-- ... -->
</ul>

要了解更多信息，请查看有关响应式设计、暗黑模式、以及其他媒体查询修饰符的文档。

使用自定义值

¥Using custom values

自定义主题

¥Customizing your theme

默认情况下，Tailwind 仅提供 list-image-none 工具。你可以通过编辑 tailwind.config.js 文件中的 theme.listStyleImage 或 theme.extend.listStyleImage 来自定义这些值。

¥By default, Tailwind only provides the list-image-none utility. You can customize these values by editing theme.listStyleImage or theme.extend.listStyleImage in your tailwind.config.js file.

tailwind.config.js

module.exports = {
  theme: {
    extend: {
      listStyleImage: {
        checkmark: 'url("/img/checkmark.png")',
      },
    }
  }
}

在主题定制文档中了解有关自定义默认主题的更多信息。

¥Learn more about customizing the default theme in the theme customization documentation.

任意值

¥Arbitrary values

如果你需要使用一次性的 list-style-image 值，而该值没有必要包含在你的主题中，请使用方括号动态生成属性，使用任意值。

<ul class="list-image-[url(checkmark.png)]">
  <!-- ... -->
</ul>

在任意值文档中了解有关任意值支持的更多信息。

Quick reference