列表样式图像

​基础用法

​设置列表样式图片

使用 list-image-* 实用程序来控制列表项的标记图像。

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

<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>

详细了解, 请参考 Hover, Focus, & Other States 文档.

​断点和媒体查询

您还可以使用变体修饰符来定位媒体查询，例如响应式断点、暗模式、首选减少运动等。例如, 使用 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 实用程序。您可以通过编辑 tailwind.config.js 文件中的 theme.listStyleImage 或 theme.extend.listStyleImage 来自定义这些值。

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

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

​任意值

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

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

进一步了解，请参考 任意值 文档.