你正在瀏覽的是 Tailwind CSS v2. 的技術文件
Tailwind CSS 的 GitHub

Background Size (背景尺寸)

控制元素 (Element) 背景圖片尺寸的功能

Default class reference

Class
屬性
bg-autobackground-size: auto;
bg-coverbackground-size: cover;
bg-containbackground-size: contain;

Auto

使用 bg-auto 顯示背景圖片預設尺寸。

<div class="bg-auto bg-no-repeat bg-center ..." style="background-image: url(...)"></div>

Cover

使用 bg-cover 將背景圖片放大至填滿整個背景。

<div class="bg-cover bg-center ..." style="background-image: url(...)"></div>

Contain

使用 bg-contain 將背景圖片在不裁切或延伸的情形下,縮放到容器外緣。

<div class="bg-contain bg-center ..." style="background-image: url(...)"></div>

響應式

如要讓元素的背景尺寸有響應式效果,可在現有背景尺寸功能前加上前綴詞 {screen}: 。例如:中型或以上的螢幕尺寸使用 md:bg-contain 以套用 bg-contain 功能。

<div class="bg-auto md:bg-contain ..."></div>

更多有關 Tailwind 響應式設計功能的資訊,可參考 響應式設計 文件。

客製化

Tailwind 預設有 autocovercontain 這三個功能。你可以編輯 theme.backgroundSize 來變更、新增或移除這些功能。

  // tailwind.config.js
  module.exports = {
    theme: {
      backgroundSize: {
        'auto': 'auto',
        'cover': 'cover',
        'contain': 'contain',
+       '50%': '50%',
+       '16': '4rem',
      }
    }
  }

變化模式

默認情況下, 只有 響應式 的 background size 變化模式 (variants) 會產生。

tailwind.config.jsvariants 區塊中變更 backgroundSize 屬性來決定有哪些變化模式會生成。

舉個例子來說,這個設定將會生成 響應式 和 hover 的變化模式。

  // tailwind.config.js
  module.exports = {
    variants: {
      extend: {
        // ...
+       backgroundSize: ['responsive', 'hover'],
      }
    }
  }

停用

如果你不打算在專案中使用 background size 功能,可以在你的設定檔裡的 corePlugins 屬性中將 backgroundSize 設定為 false 來停用功能:

  // tailwind.config.js
  module.exports = {
    corePlugins: {
      // ...
+     backgroundSize: false,
    }
  }