List Style Image 列表样式图像

用于控制列表项标记图像的实用工具。

Class	Properties

基本用法

设置列表样式图像

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

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

• 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)] 仅在悬停时应用 list-image-[url(checkmark.png)] 实用程序。

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

有关所有可用状态修改器的完整列表，请查看悬停、焦点和其他状态文档。

断点和媒体查询

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

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

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

使用自定义值

定制您的主题

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

tailwind.config.js

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

有关自定义默认主题的更多信息，请参阅主题自定义文档。

任意值

如果您需要使用一个与主题无关的 list-image 值，可以使用方括号来根据任意值动态生成属性。

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

有关任意值支持的更多信息，请参阅任意值文档。