.innerHeight()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

.innerHeight()

分类:CSS | 维度 | 操纵 > 样式属性

返回: Number

.innerHeight()

描述:针对匹配的元素集合中的第一个元素,获得它当前经计算的内部高度(包括padding,但是不包括border)。

加入于: 1.2.6
.innerHeight()

该方法不接受任何参数

这个方法返回元素的高度,包括上补衬(padding-top)和下补衬(padding-bottom),以像素计。

该方法不适用于window对象和document对象;要想获得这两者的高度,请使用.height()来代替。

插图1

其它说明

  • 维度相关的API返回的数字,包括.innerHeight(),在一些情况中可能是分数。代码不应该假定它是一个整数。当用户缩放网页的时候,维度可能不正确;浏览器没有提供侦测这种情况的API。
  • 当元素或者它的父元素是隐藏元素的时候,.innerHeight所报告的值不能保证精确。要想获得精确的值,在使用.innerHeight()之前请先检查元素的可见性。jQuery会试图临时地显示,然后再次隐藏元素,以测量它的维度,但是这是不可靠的,而且(甚至当精确测量时)会显著地影响了网页的性能。这种显示再重新隐藏的测主功能可能在jQuery的未来版本中被删除。

示例

获得一个段落文本的innerHeight。

<!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.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<p>Hello</p>
<p></p>
 
<script>
var p = $( "p:first" );
$( "p:last" ).text( "innerHeight:" + p.innerHeight() );
</script>
 
</body>
</html>

演示结果

返回: jQuery

.innerHeight()

描述:针对每个匹配的元素设置它们的内部高度。

加入于: 1.8.0
.innerHeight( value )
  • value
    类型:String or Number
    一个数字,它代表了像素数,或者是一个数字后面跟着一个可选的度量单位(作为一个字符串)。
加入于: 1.8.0
.innerHeight( function )
  • function
    类型:FunctionInteger index, Number height ) => String or Number
    一个函数,它返回了要设置的内部高度(包括padding,但不包括border)。检索集合中元素的索引位置以及旧内部高度值作为参数。在这个函数内部,this引用了集合中的当前元素。

在调用.innerHeight("value")时,这个值可以是字符串(数字加单位)或者是数字。如果只为该值提供了一个数字,jQuery假定单位是px。 然而如果提供了一个字符串,必须为高度提供一个有效的CSS测量(比如说100px50%或者auto)。注意,在现代浏览器中,CSS高度属性不包括padding、border或者margin,除非用了CSS属性box-sizing

如果没有明确指定单位(比如说“em”或者“%”),则单位就是“px”。

示例

在每个div被第一次点击时,改变它们的内部高度(并改变它的字色)。

<!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.jquery.com/jquery-1.10.2.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>

演示结果

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/innerheight.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。