当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


JQuery .height()用法及代码示例


获取匹配元素集中第一个元素的当前计算高度或设置每个匹配元素的高度。

用法一

.height() => Number

说明:获取匹配元素集中第一个元素的当前计算高度。

  • 添加的版本:1.0.height()

    • 此方法不接受任何参数。

.css( "height" ).height() 之间的区别在于后者返回一个 unit-less 像素值(例如 400 ),而前者返回一个单位完整的值(例如 400px )。当需要在数学计算中使用元素的高度时,建议使用.height() 方法。

图 1 - 测量高度示意图

此方法还能够找到窗口和文档的高度。

// Returns height of browser viewport
$( window ).height();
 
// Returns height of HTML document
$( document ).height();

请注意,无论 CSS box-sizing 属性的值如何,.height() 将始终返回内容高度。从 jQuery 1.8 开始,这可能需要检索 CSS 高度加上 box-sizing 属性,然后当元素具有 box-sizing: border-box 时减去每个元素上的任何潜在边框和填充。为避免这种惩罚,请使用 .css( "height" ) 而不是 .height()

注意:虽然stylescript标签将报告一个值.width()或者height()当绝对定位和给定display:block,强烈建议不要在这些标签上调用这些方法。除了是一种不好的做法外,结果也可能被证明是不可靠的。

其他注意事项:

  • dimensions-related API(包括 .height() )返回的数字在某些情况下可能是小数。代码不应假定它是整数。此外,当用户缩放页面时,尺寸可能不正确;浏览器不会公开 API 来检测这种情况。
  • 当元素或其父元素被隐藏时,.height() 报告的值不能保证准确。要获得准确的值,请确保在使用 .height() 之前元素可见。 jQuery 将尝试暂时显示然后重新隐藏元素以测量其尺寸,但这是不可靠的,并且(即使准确)会显著影响页面性能。这个 show-and-rehide 测量函数可能会在 jQuery 的未来版本中被删除。

例子:

显示各种高度。请注意,这些值来自 iframe,因此可能比您预期的要小。黄色高亮显示 iframe 主体。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>height demo</title>
  <style>
  body {
    background: yellow;
  }
  button {
    font-size: 12px;
    margin: 2px;
  }
  p {
    width: 150px;
    border: 1px red solid;
  }
  div {
    color: red;
    font-weight: bold;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.5.0.js"></script>
</head>
<body>
 
<button id="getp">Get Paragraph Height</button>
<button id="getd">Get Document Height</button>
<button id="getw">Get Window Height</button>
 
<div>&nbsp;</div>
<p>
  Sample paragraph to test height
</p>
 
<script>
function showHeight( element, height ) {
  $( "div" ).text( "The height for the " + element + " is " + height + "px." );
}
$( "#getp" ).click(function() {
  showHeight( "paragraph", $( "p" ).height() );
});
$( "#getd" ).click(function() {
  showHeight( "document", $( document ).height() );
});
$( "#getw" ).click(function() {
  showHeight( "window", $( window ).height() );
});
</script>
 
</body>
</html>

演示:

用法二

.height( value ) => jQuery

说明:设置每个匹配元素的 CSS 高度。

  • 添加的版本:1.0.height( value )

    • value
      类型:StringNumber
      表示像素数的整数,或附加可选测量单位的整数(作为字符串)。
  • 添加的版本:1.4.1.height( function )

    • function
      类型:Function(Integer 索引,Integer 高度)=> StringNumber
      返回要设置的高度的函数。接收集合中元素的索引位置和旧高度作为参数。在函数中,this 指的是集合中的当前元素。

调用 .height(value) 时,该值可以是字符串(数字和单位)或数字。如果只为该值提供了一个数字,则 jQuery 假定一个像素单位。但是,如果提供了字符串,则必须为高度提供有效的 CSS 测量值(例如 100px50%auto )。请注意,在现代浏览器中,CSS 高度属性不包括填充、边框或边距。

如果未指定明确的单位(如 'em' 或 '%'),则将 "px" 连接到该值。

请注意,无论 CSS box-sizing 属性的值如何,.height(value) 都会设置框的内容高度。

例子:

将点击时每个 div 的高度设置为 30px 加上颜色变化。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>height demo</title>
  <style>
  div {
    width: 50px;
    height: 70px;
    float: left;
    margin: 5px;
    background: rgb(255,140,0);
    cursor: pointer;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.5.0.js"></script>
</head>
<body>
 
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
 
<script>
$( "div" ).one( "click", function() {
  $( this ).height( 30 ).css({
    cursor: "auto",
    backgroundColor: "green"
  });
});
</script>
 
</body>
</html>

演示:

相关用法


注:本文由纯净天空筛选整理自jquery.com大神的英文原创作品 .height()。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。