网站导航

设计令牌

容器尺寸

用于宽度、高度、最小和最大尺寸的预设长度。

本页内容

类

类声明
max-w-<name>max-width: var(--container-<name>);
w-<name>width: var(--container-<name>);
其他 11 个类
类声明
h-<name>height: var(--container-<name>);
basis-<name>flex-basis: var(--container-<name>);
max-h-<name>max-height: var(--container-<name>);
min-h-<name>min-height: var(--container-<name>);
min-w-<name>min-width: var(--container-<name>);
size-x-<name>inline-size: var(--container-<name>);
size-y-<name>block-size: var(--container-<name>);
max-size-x-<name>max-inline-size: var(--container-<name>);
max-size-y-<name>max-block-size: var(--container-<name>);
min-size-x-<name>min-inline-size: var(--container-<name>);
min-size-y-<name>min-block-size: var(--container-<name>);

容器令牌设置的是长度,不会定义视口或容器查询。w-full、max-w-fit、basis-min 这类填满或内在尺寸形式是固定工具类,与这些令牌无关。

值

每个值都是供尺寸属性使用的长度。像素换算假设根元素字号为 16px。这些值不是视口断点,也不是容器查询定义。

类值
max-w-3xs16rem256px
max-w-2xs18rem288px
max-w-xs20rem320px
max-w-sm24rem384px
max-w-md28rem448px
max-w-lg32rem512px
max-w-xl36rem576px
max-w-2xl42rem672px
max-w-3xl48rem768px
max-w-4xl56rem896px
max-w-5xl64rem1024px
max-w-6xl72rem1152px
max-w-7xl80rem1280px
max-w-8xl90rem1440px

最大尺寸只设置上限

max-w-3xs 设置 max-width: var(--container-3xs),其预设值为 16rem。当包含块的可用空间较少时,宽度为 auto 的普通块仍可以更窄。

相同上限可以产生不同宽度

宽度为 auto 的普通块会适应可用空间,直到达到最大宽度。两个父元素按相同比例绘制,根元素字号为 16px。

文字说明
  1. max-w-3xs 读取预设的 --container-3xs 值 16rem。两个示例都在普通块布局中使用 auto 宽度,采用 border-box 尺寸计算,且没有最小宽度限制。
  2. 第一个父元素提供 20rem 空间。子元素达到 16rem 上限后停止增宽,后面留下未使用的空间。
  3. 第二个父元素提供 13rem 空间。子元素适应这个较小空间,不会变成 16rem 宽。
  4. 虚线轮廓标示可用宽度,不是生成的边框或查询容器。两个父元素按相同比例绘制,根元素字号为 16px;高度则由相同内容决定。

w-3xs 则直接设置宽度。这两个类都不会添加居中、内边距或查询容器隔离。修改 --container-md 不会重新定义 @container(--md),也不会改变显式写出的查询阈值。创建查询容器时,请使用原生 container-type 和 container-name。

实际尺寸仍受原生布局影响:最小尺寸、盒模型计算、Flexbox 和 Grid 都可能改变使用尺寸。最大尺寸不会改变文本换行或溢出规则。若要设计页面外层容器或决定响应式布局,请继续阅读布局指南。

用法

限制对话框宽度与文本行长。

Leave this page?

Changes you made will not be saved.

<div class="… max-w-xs">  <p>Leave this page?</p>  <p class="… max-w-3xs">Changes you made will not be saved.</p></div>
生成的 CSS
@layer theme {  :root,  :host {    --container-3xs: 16rem;    --container-xs: 20rem  }}@layer utilities {  .max-w-3xs {    max-width: var(--container-3xs)  }  .max-w-xs {    max-width: var(--container-xs)  }}

自定义

修改预设值或添加尺寸:--container-prose 会创建 max-w-prose、w-prose 和其他尺寸类。

@theme {  --container-prose: 40rem;}
生成的 CSS
@layer theme {  :root,  :host {    --container-prose: 40rem  }}@layer utilities {  .max-w-prose {    max-width: var(--container-prose)  }}