Lzh on GitHub

width

设置元素宽度的实用工具。

快速参考

类名样式
w-<number>width: calc(var(--spacing) * <number>);
w-<fraction>width: calc(<fraction> * 100%);
w-3xswidth: var(--container-3xs); /* 16rem (256px) */
w-2xswidth: var(--container-2xs); /* 18rem (288px) */
w-xswidth: var(--container-xs); /* 20rem (320px) */
w-smwidth: var(--container-sm); /* 24rem (384px) */
w-mdwidth: var(--container-md); /* 28rem (448px) */
w-lgwidth: var(--container-lg); /* 32rem (512px) */
w-xlwidth: var(--container-xl); /* 36rem (576px) */
w-2xlwidth: var(--container-2xl); /* 42rem (672px) */
w-3xlwidth: var(--container-3xl); /* 48rem (768px) */
w-4xlwidth: var(--container-4xl); /* 56rem (896px) */
w-5xlwidth: var(--container-5xl); /* 64rem (1024px) */
w-6xlwidth: var(--container-6xl); /* 72rem (1152px) */
w-7xlwidth: var(--container-7xl); /* 80rem (1280px) */
w-autowidth: auto;
w-pxwidth: 1px;
w-fullwidth: 100%;
w-screenwidth: 100vw;
w-dvwwidth: 100dvw;
w-dvhwidth: 100dvh;
w-lvwwidth: 100lvw;
w-lvhwidth: 100lvh;
w-svwwidth: 100svw;
w-svhwidth: 100svh;
w-minwidth: min-content;
w-maxwidth: max-content;
w-fitwidth: fit-content;
w-(<custom-property>)width: var(<custom-property>);
w-[<value>]width: <value>;
size-<number>width: calc(var(--spacing) * <number>); height: calc(var(--spacing) * <number>);
size-<fraction>width: calc(<fraction> * 100%); height: calc(<fraction> * 100%);
size-autowidth: auto; height: auto;
size-pxwidth: 1px; height: 1px;
size-fullwidth: 100%; height: 100%;
size-dvwwidth: 100dvw; height: 100dvw;
size-dvhwidth: 100dvh; height: 100dvh;
size-lvwwidth: 100lvw; height: 100lvw;
size-lvhwidth: 100lvh; height: 100lvh;
size-svwwidth: 100svw; height: 100svw;
size-svhwidth: 100svh; height: 100svh;
size-minwidth: min-content; height: min-content;
size-maxwidth: max-content; height: max-content;
size-fitwidth: fit-content; height: fit-content;
size-(<custom-property>)width: var(<custom-property>); height: var(<custom-property>);
size-[<value>]width: <value>; height: <value>;

示例

基本示例

使用 w-<number> 实用工具(如 w-24w-64)根据间距比例将元素设置为固定宽度:

w-48
w-40
w-32
w-24
<div class="w-96 ...">w-96</div>
<div class="w-80 ...">w-80</div>
<div class="w-64 ...">w-64</div>
<div class="w-48 ...">w-48</div>
<div class="w-40 ...">w-40</div>
<div class="w-32 ...">w-32</div>
<div class="w-24 ...">w-24</div>

使用百分比

使用 w-fullw-<fraction> 实用工具(如 w-1/2w-2/5)为元素设置基于百分比的宽度:

w-1/2
w-1/2
w-2/5
w-3/5
w-1/3
w-2/3
w-full
<div class="flex ...">
  <div class="w-1/2 ...">w-1/2</div>
  <div class="w-1/2 ...">w-1/2</div>
</div>
<div class="flex ...">
  <div class="w-2/5 ...">w-2/5</div>
  <div class="w-3/5 ...">w-3/5</div>
</div>
<div class="flex ...">
  <div class="w-1/3 ...">w-1/3</div>
  <div class="w-2/3 ...">w-2/3</div>
</div>
<div class="flex ...">
  <div class="w-1/4 ...">w-1/4</div>
  <div class="w-3/4 ...">w-3/4</div>
</div>
<div class="flex ...">
  <div class="w-1/5 ...">w-1/5</div>
  <div class="w-4/5 ...">w-4/5</div>
</div>
<div class="flex ...">
  <div class="w-1/6 ...">w-1/6</div>
  <div class="w-5/6 ...">w-5/6</div>
</div>
<div class="w-full ...">w-full</div>

使用容器比例

使用 w-smw-xl 等实用工具根据容器比例设置元素的固定宽度:

w-sm
w-xs
w-2xs
w-3xs
<div class="w-xl ...">w-xl</div>
<div class="w-lg ...">w-lg</div>
<div class="w-md ...">w-md</div>
<div class="w-sm ...">w-sm</div>
<div class="w-xs ...">w-xs</div>
<div class="w-2xs ...">w-2xs</div>
<div class="w-3xs ...">w-3xs</div>

匹配视口宽度

使用 w-screen 实用工具使元素跨越整个视口的宽度:

<div class="w-screen">
  <!-- ... -->
</div>

或者,您可以使用 w-lvww-svww-dvw 实用工具匹配大型、小型或动态视口的宽度。

重置宽度

在特定条件下(例如在特定的断点),使用 w-auto 实用工具删除元素已分配的宽度:

<div class="w-full md:w-auto">
  <!-- ... -->
</div>

同时设置宽度和高度

使用 size-pxsize-4size-full 等实用工具同时设置元素的宽度和高度:

size-16
size-20
size-24
<div class="size-16 ...">size-16</div>
<div class="size-20 ...">size-20</div>
<div class="size-24 ...">size-24</div>
<div class="size-32 ...">size-32</div>
<div class="size-40 ...">size-40</div>

使用自定义值

使用 w-[<value>] 语法根据完全自定义的值设置 width

<div class="w-[5px] ...">
  <!-- ... -->
</div>

对于 CSS 变量,您还可以使用 w-(<custom-property>) 语法:

<div class="w-(--my-width) ...">
  <!-- ... -->
</div>

这只是 w-[var(<custom-property>)] 的简写形式,它会自动为您添加 var() 函数。

响应式设计

使用断点变体(例如 md:)作为 width 实用工具的前缀,以便仅在中等尺寸及以上的屏幕上应用该实用工具:

<div class="w-1/2 md:w-full ...">
  <!-- ... -->
</div>

变体文档 中了解更多关于使用变体的信息。

自定义您的主题

w-<number>size-<number> 实用工具由 --spacing 主题变量驱动,该变量可以在您自己的主题中进行自定义:

@theme {
  --spacing: 1px;
}

主题变量文档 中了解更多关于自定义间距比例的信息。