快速参考

属性
divide-x-0 > * + *border-right-width: 0px; border-left-width: 0px;
divide-x-2 > * + *border-right-width: 0px; border-left-width: 2px;
divide-x-4 > * + *border-right-width: 0px; border-left-width: 4px;
divide-x-8 > * + *border-right-width: 0px; border-left-width: 8px;
divide-x > * + *border-right-width: 0px; border-left-width: 1px;
divide-y-0 > * + *border-top-width: 0px; border-bottom-width: 0px;
divide-y-2 > * + *border-top-width: 2px; border-bottom-width: 0px;
divide-y-4 > * + *border-top-width: 4px; border-bottom-width: 0px;
divide-y-8 > * + *border-top-width: 8px; border-bottom-width: 0px;
divide-y > * + *border-top-width: 1px; border-bottom-width: 0px;
divide-y-reverse > * + *--tw-divide-y-reverse: 1;
divide-x-reverse > * + *--tw-divide-x-reverse: 1;

基本用法

在水平子元素之间添加边框

使用 divide-x-{width} 实用程序在水平元素之间添加边框。

01
02
03
<div class="grid grid-cols-3 divide-x">
  <div>01</div>
  <div>02</div>
  <div>03</div>
</div>

在堆叠的子元素之间添加边框

使用 `divide-y-{width}` 实用程序在堆叠元素之间添加边框。

01
02
03
<div class="grid grid-cols-1 divide-y">
  <div>01</div>
  <div>02</div>
  <div>03</div>
</div>

反转子元素顺序

如果你的元素顺序反转(例如使用 `flex-row-reverse` 或 `flex-col-reverse`),请使用 `divide-x-reverse` 或 `divide-y-reverse` 实用程序来确保边框添加到每个元素的正确侧。

01
02
03
<div class="flex flex-col-reverse divide-y divide-y-reverse">
  <div>01</div>
  <div>02</div>
  <div>03</div>
</div>

条件应用

悬停、聚焦和其他状态

Tailwind 允许你使用变体修饰符在不同状态下有条件地应用实用程序类。例如,使用 `hover:divide-y-8` 仅在悬停时应用 `divide-y-8` 实用程序。

<div class="divide-y divide-gray-400 hover:divide-y-8">
  <!-- ... -->
</div>

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

断点和媒体查询

你还可以使用变体修饰符来定位媒体查询,例如响应式断点、暗黑模式、prefers-reduced-motion 等等。例如,使用 `md:divide-y-8` 仅在中等屏幕尺寸及以上时应用 `divide-y-8` 实用程序。

<div class="divide-y divide-gray-400 md:divide-y-8">
  <!-- ... -->
</div>

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


使用自定义值

自定义主题

默认情况下,分隔线宽度比例继承自borderWidth比例,因此,如果您想同时自定义边框宽度和分隔线宽度,请使用tailwind.config.js文件中的theme.borderWidth部分。

tailwind.config.js
module.exports = {
  theme: {
    borderWidth: {
      DEFAULT: '1px',
      '0': '0',
      '2': '2px',
      '3': '3px',
      '4': '4px',
      '6': '6px',
      '8': '8px',
    }
  }
}

要仅自定义分隔线宽度值,请使用tailwind.config.js文件中的theme.divideWidth部分。

tailwind.config.js
module.exports = {
  theme: {
    divideWidth: {
      DEFAULT: '1px',
      '0': '0',
      '2': '2px',
      '3': '3px',
      '4': '4px',
      '6': '6px',
      '8': '8px',
    }
  }
}

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

任意值

如果您需要使用一次性的divide-{x|y}-{width}值,而该值不适合包含在您的主题中,请使用方括号使用任何任意值动态生成属性。

<div class="divide-x-[3px]">
  <!-- ... -->
</div>

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