Interactivity

scroll-margin

用於控制貼齊容器中項目周圍捲動偏移量的通用類別。

ClassStyles
scroll-m-<number>
scroll-margin: calc(var(--spacing) * <number>);
-scroll-m-<number>
scroll-margin: calc(var(--spacing) * -<number>);
scroll-m-(<custom-property>)
scroll-margin: var(<custom-property>);
scroll-m-[<value>]
scroll-margin: <value>;
scroll-mx-<number>
scroll-margin-inline: calc(var(--spacing) * <number>);
-scroll-mx-<number>
scroll-margin-inline: calc(var(--spacing) * -<number>);
scroll-mx-(<custom-property>)
scroll-margin-inline: var(<custom-property>);
scroll-mx-[<value>]
scroll-margin-inline: <value>;
scroll-my-<number>
scroll-margin-block: calc(var(--spacing) * <number>);
-scroll-my-<number>
scroll-margin-block: calc(var(--spacing) * -<number>);

範例(Examples)

基本範例(Basic example)

使用 scroll-mt-<number>scroll-mr-<number>scroll-mb-<number>scroll-ml-<number> 等通用類別(如 scroll-ml-4scroll-mt-6)來設定貼齊容器中項目周圍的捲動偏移量:

在圖片網格中捲動以查看預期行為

<div class="snap-x ...">  <div class="snap-start scroll-ml-6 ...">    <img src="/img/vacation-01.jpg"/>  </div>  <div class="snap-start scroll-ml-6 ...">    <img src="/img/vacation-02.jpg"/>  </div>  <div class="snap-start scroll-ml-6 ...">    <img src="/img/vacation-03.jpg"/>  </div>  <div class="snap-start scroll-ml-6 ...">    <img src="/img/vacation-04.jpg"/>  </div>  <div class="snap-start scroll-ml-6 ...">    <img src="/img/vacation-05.jpg"/>  </div></div>

使用負值(Using negative values)

要使用負的捲動邊距值,請在類別名稱前加上破折號將其轉換為負值:

<div class="snap-start -scroll-ml-6 ...">  <!-- ... --></div>

使用邏輯屬性(Using logical properties)

使用 scroll-ms-<number>scroll-me-<number> 通用類別來設定 scroll-margin-inline-startscroll-margin-inline-end 邏輯屬性,這些屬性會根據文字方向對應到左側或右側:

在圖片網格中捲動以查看預期行為

Left-to-right

Right-to-left

<div dir="ltr">  <div class="snap-x ...">    <div class="snap-start scroll-ms-6 ...">      <img src="/img/vacation-01.jpg"/>    </div>    <!-- ... -->  </div></div><div dir="rtl">  <div class="snap-x ...">    <div class="snap-start scroll-ms-6 ...">      <img src="/img/vacation-01.jpg"/>    </div>    <!-- ... -->  </div></div>

如需更多控制,你也可以使用 LTR 和 RTL 修飾符 根據目前的文字方向有條件地套用特定樣式。

使用自訂值(Using a custom value)

使用 scroll-ml-[<value>]scroll-me-[<value>] 等通用類別,根據完全自訂的值來設定 scroll margin

<div class="scroll-ml-[24rem] ...">  <!-- ... --></div>

對於 CSS 變數,你也可以使用 scroll-ml-(<custom-property>) 語法:

<div class="scroll-ml-(--my-scroll-margin) ...">  <!-- ... --></div>

這只是 scroll-ml-[var(<custom-property>)] 的簡寫形式,會自動為你加上 var() 函式。

響應式設計(Responsive design)

scroll-margin 通用類別前面加上像 md: 這樣的中斷點變體,讓該通用類別只在中型螢幕尺寸及以上時套用:

<div class="scroll-m-8 md:scroll-m-0 ...">  <!-- ... --></div>

變體文件中了解更多關於使用變體的資訊。

自訂你的主題(Customizing your theme)

scroll-m-<number>scroll-mx-<number>scroll-my-<number>scroll-ms-<number>scroll-me-<number>scroll-mt-<number>scroll-mr-<number>scroll-mb-<number>scroll-ml-<number> 通用類別由 --spacing 主題變數驅動,可以在你自己的主題中自訂:

@theme {  --spacing: 1px; }

主題變數文件中了解更多關於自訂間距比例的資訊。

Copyright © 2026 Tailwind Labs Inc.·商標政策(Brand)