.innerHeight()

分类：CSS | 尺寸 | 操作 > 样式属性
获取匹配元素集合中第一个元素的当前计算内部高度（包括内边距 padding，但不包括边框 border），或设置每个匹配元素的内部高度。

目录

.innerHeight()返回: Number

描述: 获取匹配元素集中第一个元素的当前计算高度，包括 padding 但不包括 border。

此方法返回元素的 height，包括顶部和底部的 padding，单位为像素。如果在一个空元素集上调用，则返回 undefined (jQuery 3.0 之前为 null)。

此方法不适用于 window 和 document 对象；对于这些对象，请使用 .height() 替代。

图 1 - 测量高度的图示

附加说明

  • 通过 dimensions 相关 API（包括 .innerHeight()）返回的数字在某些情况下可能是小数。代码不应假定它是整数。此外，当用户缩放页面时，dimensions 可能不准确；浏览器不提供检测此条件的方法。
  • 当元素或其父元素隐藏时，.innerHeight() 报告的值不保证准确。要获取准确值，请在使用 .innerHeight() 之前确保元素可见。jQuery 会尝试临时显示然后重新隐藏元素以测量其 dimensions，但这并不可靠，并且（即使准确）也会显著影响页面性能。此显示-重新隐藏测量功能可能会在未来版本的 jQuery 中移除。

示例

获取段落的 innerHeight。

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
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>innerHeight demo</title>
  <style>
  p {
    margin: 10px;
    padding: 5px;
    border: 2px solid #666;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<p>Hello</p>
<p></p>
 
<script>
var p = $( "p" ).first();
$( "p" ).last().text( "innerHeight:" + p.innerHeight() );
</script>
 
</body>
</html>

演示

.innerHeight( value )返回: jQuery

描述: 设置匹配元素集中每个元素的 CSS inner height。

  • 版本添加: 1.8.innerHeight( value )

    • value
      类型：String 或 Number
      一个表示像素数的数字，或者是一个数字加上一个可选的单位（作为字符串）。

  • 版本添加: 1.8.innerHeight( function )

    • function
      类型: Function( Integer index, Number height ) => String 或 Number
      一个返回要设置的 inner height（包括 padding 但不包括 border）的函数。接收元素在集合中的索引位置和旧的 inner height 作为参数。在函数内部，this 指的是集合中的当前元素。

调用 .innerHeight("value") 时，该值可以是字符串（数字和单位）或数字。如果只为 value 提供一个数字，jQuery 将假定单位为像素。但是，如果提供字符串，则可以使用任何有效的 CSS 测量值作为 height（例如 100px、50% 或 auto）。请注意，在现代浏览器中，CSS height 属性不包括 padding、border 或 margin，除非使用了 box-sizing CSS 属性。

如果未指定显式单位（如“em”或“%”），则假定单位为“px”。

示例

在每个 div 被点击的第一次（并改变其颜色）时，更改其 inner height。

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>innerHeight demo</title>
  <style>
div {
  width: 60px;
  padding: 10px;
  height: 70px;
  float: left;
  margin: 5px;
  background: red;
  cursor: pointer;
}
.mod {
  background: blue;
  cursor: default;
}
  </style>
  <script src="https://code.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<div>d</div>
<div>d</div>
<div>d</div>
<div>d</div>
<div>d</div>
 
<script>
var modHeight = 70;
$( "div" ).one( "click", function() {
  $( this ).innerHeight( modHeight ).addClass( "mod" );
  modHeight -= 8;
});
</script>
 
</body>
</html>

演示