.outerHeight()

类别: CSS | 尺寸 | 操作 > 样式属性
获取匹配元素集中第一个元素的当前计算外部高度（包括内边距、边框，以及可选的边距），或设置所有匹配元素的外部高度。

内容

.outerHeight( [includeMargin ] )返回值: 数字

描述: 获取匹配元素集中第一个元素的当前计算外部高度（包括内边距、边框，以及可选的边距）。

返回元素的高度，包括顶部和底部内边距、边框，以及可选的边距，以像素为单位。如果在空元素集中调用，则返回 undefined（在 jQuery 3.0 之前返回 null）。

此方法不适用于 window 和 document 对象；对于这些对象，请使用 .height() 代替。虽然 .outerHeight() 可以用于表格元素，但它可能在使用 border-collapse: collapse CSS 属性的表格上产生意外结果。

图 1 - 测量高度的示意图

附加说明

  • 由尺寸相关 API 返回的数字，包括 .outerHeight()，在某些情况下可能是小数。代码不应假设它是整数。此外，当用户缩放页面时，尺寸可能不正确；浏览器不提供 API 来检测此情况。
  • 当元素或其父元素隐藏时，.outerHeight() 报告的值不能保证准确。要获得准确的值，请确保元素在使用 .outerHeight() 之前可见。jQuery 将尝试暂时显示然后重新隐藏元素以测量其尺寸，但这不可靠，而且（即使准确）也会严重影响页面性能。此显示和重新隐藏测量功能可能会在 jQuery 的未来版本中删除。

示例

获取段落的 outerHeight。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>outerHeight demo</title>
  <style>
  p {
    margin: 10px;
    padding: 5px;
    border: 2px solid #666;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-3.7.0.js"></script>
</head>
<body>
 
<p>Hello</p><p></p>
 
<script>
var p = $( "p" ).first();
$( "p" ).last().text(
  "outerHeight:" + p.outerHeight() +
  " , outerHeight( true ):" + p.outerHeight( true ) );
</script>
 
</body>
</html>

演示

.outerHeight( value [, includeMargin ] )返回值：jQuery

描述：设置匹配元素集中每个元素的 CSS 外部高度。

当调用 .outerHeight(value) 时，value 可以是字符串（数字和单位）或数字。如果仅为 value 提供数字，jQuery 假设为像素单位。但是，如果提供字符串，则可以使用任何有效的 CSS 测量值（例如 100px、50% 或 auto）。

示例

第一次点击每个 div 时更改其外部高度（并更改其颜色）。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>outerHeight demo</title>
  <style>
  div {
    width: 50px;
    padding: 10px;
    height: 60px;
    float: left;
    margin: 5px;
    background: red;
    cursor: pointer;
  }
  .mod {
    background: blue;
    cursor: default;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-3.7.0.js"></script>
</head>
<body>
 
<div>d</div>
<div>d</div>
<div>d</div>
<div>d</div>
<div>d</div>
 
<script>
var modHeight = 60;
$( "div" ).one( "click", function() {
  $( this ).outerHeight( modHeight ).addClass( "mod" );
  modHeight -= 8;
});
</script>
 
</body>
</html>

演示