overflow
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.
試してみましょう
overflow: visible;
overflow: hidden;
overflow: clip;
overflow: scroll;
overflow: auto;
<section class="default-example" id="default-example">
<p id="example-element">
Michaelmas term lately over, and the Lord Chancellor sitting in Lincoln's
Inn Hall. Implacable November weather. As much mud in the streets as if the
waters had but newly retired from the face of the earth.
</p>
</section>
#example-element {
width: 15em;
height: 9em;
border: medium dotted;
padding: 0.75em;
text-align: left;
}
構成要素のプロパティ
このプロパティは以下の CSS プロパティの一括指定です。
構文
/* キーワード値 */
overflow: visible;
overflow: hidden;
overflow: clip;
overflow: scroll;
overflow: auto;
overflow: hidden visible;
/* グローバル値 */
overflow: inherit;
overflow: initial;
overflow: revert;
overflow: revert-layer;
overflow: unset;
overflow
プロパティは、1 つまたは 2 つの <overflow>
キーワード値として指定される。キーワードが 1 つだけ指定された場合、overflow-x
と overflow-y
の両方が同じ値に設定される。2 つのキーワードが指定された場合、最初の値は水平方向の overflow-x
に適用され、2 番目の値は垂直方向の overflow-y
に適用されます。
値
visible
-
溢れたコンテンツは切り取られず、要素のパディングボックスの外側に表示されることがあります。要素ボックスはスクロールコンテナーではありません。これは
overflow
プロパティの既定値です。 -
溢れたコンテンツは要素のパディングボックスで切り取られます。スクロールバーはなく、切り取られたコンテンツは見えなくなります(つまり、切り取られたコンテンツは非表示になります)が、コンテンツはまだ存在しています。ユーザーエージェントはスクロールバーを追加せず、また、タッチスクリーンでのドラッグやマウスのスクロールホイールなどの操作によって、ユーザーが切り取られた領域の外にあるコンテンツを表示することもできません。コンテンツはプログラムによってスクロールさせることができ(例えば、アンカーテキストへのリンク、非表示でありながらフォーカス可能な要素へのタブ操作、
scrollLeft
プロパティの値やscrollTo()
メソッドの設定など)、この場合、要素ボックスはスクロールコンテナーとなります。 clip
-
溢れたコンテンツは、
overflow-clip-margin
プロパティを使用して定義された要素のはみ出しクリップ辺で切り取られます。その結果、コンテンツは要素のパディングボックスをoverflow-clip-margin
の<length>
値分、または設定されていない場合は0px
分はみ出します。切り取られた領域の外側に溢れたコンテンツは表示されず、ユーザーエージェントはスクロールバーを追加せず、プログラムによるスクロールも行われません。新しい整形コンテキストは作成されません。整形コンテキストを確立するには、overflow: clip
をdisplay: flow-root
とともに使用してください。この要素ボックスはスクロールコンテナーにはなりません。 scroll
-
溢れたコンテンツは要素のパディングボックスで切り取られ、スクロールバーを使用してスクロールさせることで、溢れたコンテンツを表示することができます。ユーザーエージェントは、コンテンツが溢れているか否かに関わらずスクロールバーを表示します。そのため、このキーワードを使用すると、コンテンツが変化するたびにスクロールバーが表示されたり非表示になったりすることを防ぐことができます。ただし、印刷時には溢れたコンテンツが印刷される場合があります。要素ボックスはスクロールコンテナーになります。
auto
-
溢れたコンテンツは要素のパディングボックスで切り取られ、溢れたコンテンツはスクロールバーを使ってスクロールして表示することができます。
scroll
とは異なり、ユーザエージェントはコンテンツが溢れた場合にのみスクロールバーを表示します。コンテンツが要素のパディングボックス内に収まる場合、visible
と同じように見えますが、新しい整形コンテキストを確立します。要素ボックスはスクロールコンテナーになります。
メモ:
キーワード値 overlay
は、auto
の値の古い別名です。 overlay
を使用すると、スクロールバーは空間を占有するのではなく、コンテンツの上に描画されます。
解説
overflow のオプションには、溢れたコンテンツを非表示にするもの、スクロールバーを表示して溢れたコンテンツが見られるようにするもの、溢れたコンテンツを要素ボックスの周囲の領域に流すもの、およびそれらの組み合わせがあります。
overflow
の各キーワードを使用する際には、以下の点に留意してください。
overflow
にvisible
(既定値)またはclip
以外の値を指定すると、新しいブロック整形コンテキストが作成されます。これは技術的な理由から必要です。浮動ボックスがスクロール要素と交差する場合、スクロールのステップごとにコンテンツが強制的に再配置されるため、スクロールの使い勝手が悪くなります。overflow
の設定で期待通りの効果を出すには、溢れる方向が垂直方向の場合は高さ(height
またはmax-height
)、溢れる方向が水平方向の場合は幅(width
またはmax-width
)、溢れる方向がブロック方向の場合はブロックサイズ(block-size
またはmax-block-size
)、溢れる方向がインライン方向の場合はインラインサイズ(inline-size
またはmax-inline-size
)に加えてwhite-space
にnowrap
を、いずれかをブロックレベル要素に設定する必要があります。- いずれかの方向で overflow を
visible
(すなわち、overflow-x
またはoverflow-y
)に設定する場合、もう一方の方向をvisible
またはclip
に設定する必要があり、そうしないと、visible
の値はauto
として動作します。 - いずれかの方向で overflow を
clip
に設定する場合、もう一方の方向をvisible
またはclip
に設定する必要があり、そうしないと、clip
の値はhidden
として動作します。 - JavaScript の
Element.scrollTop
プロパティは、overflow
がhidden
に設定されている場合でも HTML 要素をスクロールさせるために使うことができます。
公式定義
初期値 | visible |
---|---|
適用対象 | ブロックコンテナー, フレックスコンテナー, グリッドコンテナー |
継承 | なし |
計算値 | 一括指定の次の各プロパティとして
|
アニメーションの種類 | 離散値 |
形式文法
アクセシビリティ
スクロールするコンテンツ領域は、キーボードのみを使用するユーザーにはスクロールできません。ただし、Firefox を使用しているユーザーは例外です(Firefox では、コンテナーが既定ではキーボード操作可能に設定されています)。
開発者として、Firefox 以外のキーボードのみ操作のユーザーにコンテナーのスクロールを許可するには、tabindex
属性を使用して tabindex="0"
と指定する必要があります。残念ながら、スクリーンリーダーがこのタブストップに遭遇すると、それが何であるかのコンテキストを保有していないため、スクリーンリーダーはそのコンテンツ全体をアナウンスする可能性が高いです。適切な WAI-ARIA ロール(例えば role="region"
)とアクセシブル名(aria-label
または aria-labelledby
によって)を指定することで、この問題を軽減できます。
例
様々な overflow キーワードの結果のデモ
HTML
<div>
<code>visible</code>
<p class="visible">
Maya Angelou: "I've learned that people will forget what you said, people
will forget what you did, but people will never forget how you made them
feel."
</p>
</div>
<div>
<code>hidden</code>
<p class="hidden">
Maya Angelou: "I've learned that people will forget what you said, people
will forget what you did, but people will never forget how you made them
feel."
</p>
</div>
<div>
<code>clip</code>
<p class="clip">
Maya Angelou: "I've learned that people will forget what you said, people
will forget what you did, but people will never forget how you made them
feel."
</p>
</div>
<div>
<code>scroll</code>
<p class="scroll">
Maya Angelou: "I've learned that people will forget what you said, people
will forget what you did, but people will never forget how you made them
feel."
</p>
</div>
<div>
<code>auto</code>
<p class="auto">
Maya Angelou: "I've learned that people will forget what you said, people
will forget what you did, but people will never forget how you made them
feel."
</p>
</div>
<div>
<code>overlay</code>
<p class="overlay">
Maya Angelou: "I've learned that people will forget what you said, people
will forget what you did, but people will never forget how you made them
feel."
</p>
</div>
CSS
p.visible {
overflow: visible;
}
p.hidden {
overflow: hidden;
}
p.clip {
overflow: clip;
overflow-clip-margin: 1em;
}
p.scroll {
overflow: scroll;
}
p.auto {
overflow: auto;
}
p.overlay {
overflow: overlay;
}
結果
仕様書
Specification |
---|
CSS Overflow Module Level 3 # propdef-overflow |
Scalable Vector Graphics (SVG) 2 # OverflowAndClipProperties |
ブラウザーの互換性
関連情報
overflow-x
,overflow-y
overflow-block
,overflow-clip-margin
,overflow-inline
clip
,display
,text-overflow
,white-space
- CSS オーバーフロー
- Keyboard-only scrolling areas on adrianroselli.com (2022)