列表样式图片

​基本用法

​设置列表样式图像

使用 list-image-{value} 实用程序控制列表项的标记图像。

开箱即用，list-image-none 是唯一可用的预配置列表样式图像实用程序。虽然您可以通过 自定义主题 添加其他实用程序，但您也可以使用方括号表示法动态生成任意值。

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

​条件应用

​悬停、聚焦和其他状态

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

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

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

​断点和媒体查询

您还可以使用变体修饰符来定位媒体查询，例如响应式断点、暗黑模式、 prefers-reduced-motion 等等。例如，使用 md:list-image-[url(checkmark.png)] 在中型屏幕尺寸及以上应用 list-image-[url(checkmark.png)] 实用程序。

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

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

​使用自定义值

​自定义主题

默认情况下，Tailwind 只提供 list-image-none 实用程序。您可以通过编辑 theme.listStyleImage 或 theme.extend.listStyleImage 在您的 tailwind.config.js 文件中自定义这些值。

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

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

​任意值

如果您需要使用一个不适合包含在主题中的 list-image 值，请使用方括号使用任何任意值动态生成属性。

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

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