Tailwind CSS on GitHub

列表项标记类型

用来控制列表项标记类型的功能类。

Default class reference

Class
Properties
list-nonelist-style-type: none;
list-disclist-style-type: disc;
list-decimallist-style-type: decimal;

使用方法

要创建项目符号或数字列表,请使用 list-disclist-decimal 功能类。

.list-disc

  • Lorem ipsum dolor sit amet, consectetur adipisicing elit
  • Assumenda, quia temporibus eveniet a libero incidunt suscipit
  • Quidem, ipsam illum quis sed voluptatum quae eum fugit earum

.list-decimal

  1. Lorem ipsum dolor sit amet, consectetur adipisicing elit
  2. Assumenda, quia temporibus eveniet a libero incidunt suscipit
  3. Quidem, ipsam illum quis sed voluptatum quae eum fugit earum

.list-none (default)

  • Lorem ipsum dolor sit amet, consectetur adipisicing elit
  • Assumenda, quia temporibus eveniet a libero incidunt suscipit
  • Quidem, ipsam illum quis sed voluptatum quae eum fugit earum

<ul class="list-disc">
  <li>Lorem ipsum dolor sit amet, consectetur adipisicing elit</li>
  ...
</ul>

<ol class="list-decimal">
  <li>Lorem ipsum dolor sit amet, consectetur adipisicing elit</li>
  ...
</ol>

<ul>
  <li>Lorem ipsum dolor sit amet, consectetur adipisicing elit</li>
  ...
</ul>

响应式

要在特定的断点处控制元素的列表项标记类型,请在任何现有的列表功能类前添加 {screen}: 前缀。例如,使用 md:list-disc 来仅在中等大小及以上的屏幕应用 list-disc 功能类。

<ul class="list-none md:list-disc">
  <li>Lorem ipsum dolor sit amet, consectetur adipisicing elit</li>
  <li>Assumenda, quia temporibus eveniet a libero incidunt suscipit</li>
  <li>Quidem, ipsam illum quis sed voluptatum quae eum fugit earum</li>
</ul>

关于 Tailwind 的响应式设计功能的更多信息,请查看 响应式设计 文档。

定制

默认情况下,Tailwind 为最常见的列表样式类型提供了三个功能类,您可以通过编辑 Tailwind 配置的 theme.listStyleType 部分来改变、添加或删除这些功能类。

  // tailwind.config.js
  module.exports = {
    theme: {
      listStyleType: {
        none: 'none',
-       disc: 'disc',
-       decimal: 'decimal',
+       square: 'square',
+       roman: 'upper-roman',
      }
    }
  }

变体

默认情况下, 针对 list style type 功能类,只生成 responsive 变体。

您可以通过修改您的 tailwind.config.js 文件中的 variants 部分中的 listStyleType 属性来控制为 list style type 功能生成哪些变体。

例如,这个配置将生成 hover and focus 变体:

  // tailwind.config.js
  module.exports = {
    variants: {
      extend: {
        // ...
+       listStyleType: ['hover', 'focus'],
      }
    }
  }

禁用

如果您不打算在您的项目中使用 list style type 功能,您可以通过在配置文件的 corePlugins 部分将 listStyleType 属性设置为 false 来完全禁用它们:

  // tailwind.config.js
  module.exports = {
    corePlugins: {
      // ...
+     listStyleType: false,
    }
  }