「及時」模式:全新世代的 Tailwind CSS
Tailwind CSS on GitHub

Gap

Utilities for controlling gutters between grid and flexbox items.

Default class reference

Class
屬性
gap-0gap: 0px;
gap-x-0column-gap: 0px;
gap-y-0row-gap: 0px;
gap-pxgap: 1px;
gap-x-pxcolumn-gap: 1px;
gap-y-pxrow-gap: 1px;
gap-0.5gap: 0.125rem;
gap-x-0.5column-gap: 0.125rem;
gap-y-0.5row-gap: 0.125rem;
gap-1gap: 0.25rem;
gap-x-1column-gap: 0.25rem;
gap-y-1row-gap: 0.25rem;
gap-1.5gap: 0.375rem;
gap-x-1.5column-gap: 0.375rem;
gap-y-1.5row-gap: 0.375rem;
gap-2gap: 0.5rem;
gap-x-2column-gap: 0.5rem;
gap-y-2row-gap: 0.5rem;
gap-2.5gap: 0.625rem;
gap-x-2.5column-gap: 0.625rem;
gap-y-2.5row-gap: 0.625rem;
gap-3gap: 0.75rem;
gap-x-3column-gap: 0.75rem;
gap-y-3row-gap: 0.75rem;
gap-3.5gap: 0.875rem;
gap-x-3.5column-gap: 0.875rem;
gap-y-3.5row-gap: 0.875rem;
gap-4gap: 1rem;
gap-x-4column-gap: 1rem;
gap-y-4row-gap: 1rem;
gap-5gap: 1.25rem;
gap-x-5column-gap: 1.25rem;
gap-y-5row-gap: 1.25rem;
gap-6gap: 1.5rem;
gap-x-6column-gap: 1.5rem;
gap-y-6row-gap: 1.5rem;
gap-7gap: 1.75rem;
gap-x-7column-gap: 1.75rem;
gap-y-7row-gap: 1.75rem;
gap-8gap: 2rem;
gap-x-8column-gap: 2rem;
gap-y-8row-gap: 2rem;
gap-9gap: 2.25rem;
gap-x-9column-gap: 2.25rem;
gap-y-9row-gap: 2.25rem;
gap-10gap: 2.5rem;
gap-x-10column-gap: 2.5rem;
gap-y-10row-gap: 2.5rem;
gap-11gap: 2.75rem;
gap-x-11column-gap: 2.75rem;
gap-y-11row-gap: 2.75rem;
gap-12gap: 3rem;
gap-x-12column-gap: 3rem;
gap-y-12row-gap: 3rem;
gap-14gap: 3.5rem;
gap-x-14column-gap: 3.5rem;
gap-y-14row-gap: 3.5rem;
gap-16gap: 4rem;
gap-x-16column-gap: 4rem;
gap-y-16row-gap: 4rem;
gap-20gap: 5rem;
gap-x-20column-gap: 5rem;
gap-y-20row-gap: 5rem;
gap-24gap: 6rem;
gap-x-24column-gap: 6rem;
gap-y-24row-gap: 6rem;
gap-28gap: 7rem;
gap-x-28column-gap: 7rem;
gap-y-28row-gap: 7rem;
gap-32gap: 8rem;
gap-x-32column-gap: 8rem;
gap-y-32row-gap: 8rem;
gap-36gap: 9rem;
gap-x-36column-gap: 9rem;
gap-y-36row-gap: 9rem;
gap-40gap: 10rem;
gap-x-40column-gap: 10rem;
gap-y-40row-gap: 10rem;
gap-44gap: 11rem;
gap-x-44column-gap: 11rem;
gap-y-44row-gap: 11rem;
gap-48gap: 12rem;
gap-x-48column-gap: 12rem;
gap-y-48row-gap: 12rem;
gap-52gap: 13rem;
gap-x-52column-gap: 13rem;
gap-y-52row-gap: 13rem;
gap-56gap: 14rem;
gap-x-56column-gap: 14rem;
gap-y-56row-gap: 14rem;
gap-60gap: 15rem;
gap-x-60column-gap: 15rem;
gap-y-60row-gap: 15rem;
gap-64gap: 16rem;
gap-x-64column-gap: 16rem;
gap-y-64row-gap: 16rem;
gap-72gap: 18rem;
gap-x-72column-gap: 18rem;
gap-y-72row-gap: 18rem;
gap-80gap: 20rem;
gap-x-80column-gap: 20rem;
gap-y-80row-gap: 20rem;
gap-96gap: 24rem;
gap-x-96column-gap: 24rem;
gap-y-96row-gap: 24rem;

Usage

Use gap-{size} to change the gap between both rows and columns in grid and flexbox layouts.

<div class="grid gap-4 grid-cols-2">
  <div>1</div>
  <div>2</div>
  <div>3</div>
  <div>4</div>
</div>

Changing row and column gaps independently

Use gap-x-{size} and gap-y-{size} to change the gap between rows and columns independently.

<div class="grid gap-x-8 gap-y-4 grid-cols-3">
  <div>1</div>
  <div>2</div>
  <div>3</div>
  <div>4</div>
  <div>5</div>
  <div>6</div>
</div>

Responsive

To control the gap at a specific breakpoint, add a {screen}: prefix to any existing gap utility. For example, use md:gap-6 to apply the gap-6 utility at only medium screen sizes and above.

<div class="grid gap-4 md:gap-6 ...">
  <!-- ... -->
</div>

For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.


Customizing

By default, Tailwind’s gap scale matches your configured spacing scale.

You can customize the global spacing scale in the theme.spacing or theme.extend.spacing sections of your tailwind.config.js file:

  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        spacing: {
+         '72': '18rem',
+         '84': '21rem',
+         '96': '24rem',
        }
      }
    }
  }

To customize the gap scale separately, use the gap section of your Tailwind theme config.

  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        gap: {
+         '11': '2.75rem',
+         '13': '3.25rem',
        }
      }
    }
  }

Learn more about customizing the default theme in the theme customization documentation.

Variants

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

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

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

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

Disabling

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

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