overflow-y

在此页

句法
形式定义
形式句法
范例
规范
浏览器兼容性
另请参阅
相关话题

overflow-y CSS property sets what shows when content overflows a block-level element's top and bottom edges. This may be nothing, a scroll bar, or the overflow content.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

句法

/* Keyword values */
overflow-y: visible;
overflow-y: hidden;
overflow-y: clip;
overflow-y: scroll;
overflow-y: auto;
/* Global values */
overflow-y: inherit;
overflow-y: initial;
overflow-y: unset;

overflow-y property is specified as a single keyword chosen from the list of values below.

若 overflow-x is hidden , scroll or auto and this property is visible (default) it will implicitly compute to auto .

值

visible
hidden
clip: Like for hidden , the content is clipped to the element's padding box. The difference between clip and hidden is that the clip keyword also forbids all scrolling, including programmatic scrolling. The box is not a scroll container, and does not start a new formatting context. If you wish to start a new formatting context, you can use display: flow-root to do so.
scroll
auto: Depends on the user agent. If content fits inside the padding box, it looks the same as visible , but still establishes a new block-formatting context. Desktop browsers provide scrollbars if content overflows.

形式定义

初始值	`visible`
适用于	Block-containers, flex containers, and grid containers
继承	no
计算值	as specified, except with `visible` / `clip` computing to `auto` / `hidden` respectively if one of `overflow-x` or `overflow-y` is neither `visible` nor clip
动画类型	discrete

形式句法

visible | hidden | clip | scroll | auto

范例

Setting overflow-y behavior

HTML

<ul>
  <li><code>overflow-y:hidden</code> — hides the text outside the box
  <div id="div1">
    Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
    </div>
  </li>
  <li><code>overflow-y:scroll</code> — always adds a scrollbar
  <div id="div2">
    Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
    </div>
  </li>
  <li><code>overflow-y:visible</code> — displays the text outside the box if needed
  <div id="div3">
    Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
    </div>
  </li>
  <li><code>overflow-y:auto</code> — on most browser, equivalent to <code>scroll</code>
  <div id="div4">
    Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
    </div>
  </li>
</ul>

CSS

#div1,
#div2,
#div3,
#div4 {
  border: 1px solid black;
  width:  250px;
  height: 100px;
}
#div1 { overflow-y: hidden; margin-bottom: 12px;}
#div2 { overflow-y: scroll; margin-bottom: 12px;}
#div3 { overflow-y: visible; margin-bottom: 120px;}
#div4 { overflow-y: auto; margin-bottom: 120px;}

结果

规范

规范	状态	注释
CSS Overflow Module Level 3 The definition of 'overflow-y' in that specification.	工作草案

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`overflow-y`	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 3.5	IE 完整支持 5 完整支持 5 完整支持 8 Prefixed Prefixed Implemented with the vendor prefix: -ms-	Opera 完整支持 9.5	Safari 完整支持 3	WebView Android 完整支持 1	Chrome Android 完整支持 18	Firefox Android 完整支持 4	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
`clip` value Experimental	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 81 完整支持 81 不支持 3.5 — 81 Alternate Name Alternate Name Uses the non-standard name: `-moz-hidden-unscrollable`	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 81 完整支持 81 不支持 4 — 81 Alternate Name Alternate Name Uses the non-standard name: `-moz-hidden-unscrollable`	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No

图例

完整支持
不支持
实验。期望将来行为有所改变。
使用非标名称。
要求使用供应商前缀或不同名称。

另请参阅

Related CSS properties: text-overflow , white-space , overflow , overflow-x , clip , display

元数据

最后修改： Jul 20, 2020

CSS
CSS 参考
CSS Overflow
特性
1. -webkit-line-clamp
2. overflow
3. overflow-block
4. overflow-inline
5. overflow-x
6. overflow-y

在此页

句法

值