快速参考

属性
aspect-autoaspect-ratio: auto;
aspect-squareaspect-ratio: 1 / 1;
aspect-videoaspect-ratio: 16 / 9;

基本用法

设置纵横比

使用 aspect-{ratio} 实用程序来设置元素所需的纵横比。

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

Tailwind 默认情况下不包含大量纵横比值,因为直接使用任意值更容易。有关更多信息,请参阅 任意值 部分。

浏览器支持

aspect-{ratio} 实用程序使用原生 aspect-ratio CSS 属性,该属性在 Safari 15 之前版本中不受支持。在 Safari 15 普及之前,Tailwind 的 aspect-ratio 插件是一个不错的替代方案。


条件应用

悬停、聚焦和其他状态

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

<iframe class="w-full aspect-video hover:aspect-square" src="https://www.youtube.com/..."></iframe>

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

断点和媒体查询

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

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

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


使用自定义值

自定义主题

默认情况下,Tailwind 提供了一组最小的 aspect-ratio 实用程序。您可以通过编辑 tailwind.config.js 文件中的 theme.aspectRatiotheme.extend.aspectRatio 来自定义这些值。

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      aspectRatio: {
        '4/3': '4 / 3',
      },
    }
  }
}

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

任意值

如果您需要使用一个不适合包含在主题中的 aspect-ratio 值,请使用方括号使用任何任意值动态生成属性。

<iframe class="w-full aspect-[4/3]" src="https://www.youtube.com/..."></iframe>

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