1. 布局
  2. aspect-ratio

布局

aspect-ratio

用于控制元素纵横比的工具。

样式
aspect-<ratio>
aspect-ratio: <ratio>;
aspect-square
aspect-ratio: 1 / 1;
aspect-video
aspect-ratio: var(--aspect-ratio-video); /* 16 / 9 */
aspect-auto
aspect-ratio: auto;
aspect-(<custom-property>)
aspect-ratio: var(<custom-property>);
aspect-[<value>]
aspect-ratio: <value>;

示例(Examples)

¥Examples

基本示例(Basic example)

¥Basic example

使用 aspect-<ratio> 工具(如 aspect-3/2)为元素提供特定的纵横比:

¥Use aspect-<ratio> utilities like aspect-3/2 to give an element a specific aspect ratio:

调整示例大小以查看预期行为

<img class="aspect-3/2 object-cover ..." src="/img/villas.jpg" />

使用视频宽高比(Using a video aspect ratio)

¥Using a video aspect ratio

使用 aspect-video 工具为视频元素提供 16/9 的宽高比:

¥Use the aspect-video utility to give a video element a 16 / 9 aspect ratio:

调整示例大小以查看预期行为

<iframe class="aspect-video ..." src="https://www.youtube.com/embed/dQw4w9WgXcQ"></iframe>

使用自定义值(Using a custom value)

¥Using a custom value

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

<img class="aspect-[calc(4*3+1)/3] ..." src="/img/villas.jpg" />

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

<img class="aspect-(--my-aspect-ratio) ..." src="/img/villas.jpg" />

这只是简写,用于 aspect-[var(<custom-property>)] 它会自动为你添加 var() 函数。

响应式设计(Responsive design)

¥Responsive design

aspect-ratio 工具前面使用断点变体如 md: 仅在 medium 屏幕尺寸及以上时应用工具:

<iframe class="aspect-video md:aspect-square ..." src="https://www.youtube.com/embed/dQw4w9WgXcQ"></iframe>

请参阅 变体文档 详细了解如何使用变体。

自定义主题(Customizing your theme)

¥Customizing your theme

使用 --aspect-* 主题变量来自定义项目中的 aspect ratio 工具:

@theme {
--aspect-retro: 4 / 3;
}

现在 aspect-retro 工具可用于你的标记:

<iframe class="aspect-retro" src="https://www.youtube.com/embed/dQw4w9WgXcQ"></iframe>

在此详细了解如何自定义主题: 主题文档

TailwindCSS v4.1 中文网 - 粤ICP备13048890号