當前位置: 首頁>>代碼示例 >>用法及示例精選 >>正文

JQuery .outerHeight()用法及代碼示例


獲取匹配元素集中第一個元素的當前計算的外部高度(包括填充、邊框和可選的邊距)或設置每個匹配元素的外部高度。

用法一

.outerHeight(  [includeMargin ] ) => Number

說明：獲取匹配元素集中第一個元素的當前計算的外部高度(包括填充、邊框和可選的邊距)。

  • 添加的版本：1.2.6.outerHeight( [includeMargin ] )

    • includeMargin(默認：false)
      類型：Boolean
      一個布爾值，指示是否在計算中包括元素的邊距。

返回元素的高度，包括頂部和底部填充、邊框和可選的邊距，以像素為單位。如果在一組空元素上調用，則返回 undefined(jQuery 3.0 之前的 null)。

此方法不適用於window 和document 對象；對於這些，請改用.height()。雖然 .outerHeight() 可以用於表格元素，但它可能會在使用 border-collapse: collapse CSS 屬性的表格上產生意外結果。

圖 1 - 測量高度示意圖

其他注意事項：

  • dimensions-related API(包括 .outerHeight() )返回的數字在某些情況下可能是小數。代碼不應假定它是整數。此外，當用戶縮放頁麵時，尺寸可能不正確；瀏覽器不會公開 API 來檢測這種情況。
  • 當元素或其父元素被隱藏時，.outerHeight() 報告的值不能保證準確。要獲得準確的值，請確保在使用 .outerHeight() 之前元素可見。 jQuery 將嘗試暫時顯示然後重新隱藏元素以測量其尺寸，但這是不可靠的，並且(即使準確)會顯著影響頁麵性能。這個 show-and-rehide 測量函數可能會在 jQuery 的未來版本中被刪除。

例子：

獲取段落的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="https://code.jquery.com/jquery-3.5.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 外部高度。

  • 添加的版本：1.8.0.outerHeight( value [, includeMargin ] )

    • value
      類型：String 或 Number
      一個表示像素數的數字，或一個數字以及附加的可選測量單位(作為字符串)。
    • includeMargin(默認：false)
      類型：Boolean
      一個布爾值，指示新值是否應考慮元素的邊距。

  • 添加的版本：1.8.0.outerHeight( function )

    • function
      類型：Function(Integer 索引，Number 高度)=> String 或 Number
      返回要設置的外部高度的函數。接收集合中元素的索引位置和舊的外部高度作為參數。在函數中，this 指的是集合中的當前元素。

調用 .outerHeight(value) 時，該值可以是字符串(數字和單位)或數字。如果隻為該值提供了一個數字，則 jQuery 假定一個像素單位。但是，如果提供了字符串，則可以使用任何有效的 CSS 測量值(例如 100px 、 50% 或 auto )。

例子：

第一次單擊時更改每個 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="https://code.jquery.com/jquery-3.5.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>

演示：

相關用法


注：本文由純淨天空篩選整理自jquery.com大神的英文原創作品 .outerHeight()。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。