outerHeight()

概述 .outerHeight( [includeMargin ] )

返回值：Integer

实例获取匹配元素集合中第一个元素的当前计算外部高度（包括padding，border和可选的margin）。

V :1.2.6.outerHeight( [includeMargin ] )
- includeMargin (默认: false)
  
  类型： Boolean
  
  一个布尔值，表明是否在计算时包含元素的margin值。

返回元素的高度，包含上下 padding值，border值和可选择性的margin。单位为像素。如果在一组空的元素集合上调用，返回undefined（在jQuery 3.0之前返回null）。

这个方法不适用于window 和 document对象，可以使用.height()代替。虽然.outerHeight()可以用于表格（table）元素，它可能会在使用border-collapse: collapseCSS属性的表格（table）元素上给出意外的结果。

其他注意事项:

尺寸相关的API返回的数字，包括 .outerHeight()，在某些情况下可能是小数。你的代码不应该假定它是一个整数。另外，当页面被用户放大或缩小时，尺寸可能不正确的;浏览器没有公开的API来检测这种情况。
当元素或其父元素被隐藏时，.outerHeight()得到的值不能保证准确。要得到准确的值，你应该确保该元素在使用.outerHeight()前可见。jQuery将尝试临时显示，然后再隐藏元素来测量元素尺寸，但这是不可靠的，（即使得到准确的值）也会显著影响页面的性能。这总临时显示然后再隐藏的测量功能，可能在jQuery未来的版本中删除。

Example

获取一个段落的outerHeight。

<!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="//code.jquery.com/jquery-1.10.2.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 )

返回值：jQuery

实例为匹配集合中的每个元素设置CSS外部高度。

V :1.8.0.outerHeight( value )
- value
  
  类型： String, Number
  
  一个表示像素数的数字，或带有一个附加可选的尺寸衡量单位的数字（作为一个字符串）。
V :1.8.0.outerHeight( function(index, height) )
- function(index, height)
  
  类型： Function()
  
  一个函数，返回值用来设置外部高度值。接收的集合中元素的索引位置和原来的外部高度值作为参数。在这个函数中，this 指向集合中的当前元素。

当调用.outerHeight("value")方法的时候，这个“value”参数可以是一个字符串（数字加单位）或者是一个数字。如果这个“value”参数只提供一个数字，jQuery会自动加上像素单位（px）。应该是任何有效的可以为高度赋值的CSS尺寸（就像100px, 50%, 或者 auto）。

Example

每个div首次被点击时改变它的外部高度（和改变其颜色）。

<!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="//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 = 60;
$( "div" ).one( "click", function() {
  $( this ).outerHeight( modHeight ).addClass( "mod" );
  modHeight -= 8;
});
</script>
 
</body>
</html>

运行一下

outerHeight()

概述 .outerHeight( [includeMargin ] )

V :1.2.6.outerHeight( [includeMargin ] )

其他注意事项:

概述 .outerHeight( value )

V :1.8.0.outerHeight( value )

V :1.8.0.outerHeight( function(index, height) )