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

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


获取匹配元素集中第一个元素的当前计算的外部宽度(包括填充、边框和可选的边距)，或设置每个匹配元素的外部宽度。

用法一

.outerWidth(  [includeMargin ] ) => Number

说明：获取匹配元素集中第一个元素的当前计算的外部宽度(包括填充、边框和可选的边距)。

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

    • includeMargin(默认：false)
      类型：Boolean
      一个布尔值，指示是否在计算中包括元素的边距。

返回元素的宽度，包括左右填充、边框和可选的边距，以像素为单位。如果在一组空元素上调用，则返回 undefined(jQuery 3.0 之前的 null)。

此方法不适用于window 和document 对象；对于这些，请改用.width()。虽然 .outerWidth() 可以用于表格元素，但它可能会在使用 border-collapse: collapse CSS 属性的表格上产生意外结果。

图 1 - 测量宽度示意图

其他注意事项：

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

例子：

获取段落的outerWidth。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>outerWidth 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(
  "outerWidth:" + p.outerWidth() +
  " , outerWidth( true ):" + p.outerWidth( true ) );
</script>
 
</body>
</html>

演示：

用法二

.outerWidth( value [, includeMargin ] ) => jQuery

说明：设置匹配元素集中每个元素的 CSS 外部宽度。

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

    • value
      类型：String 或 Number
      一个表示像素数的数字，或一个数字以及附加的可选测量单位(作为字符串)。
    • includeMargin(默认：false)
      类型：Boolean
      一个布尔值，指示新值是否应考虑元素的边距。

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

    • function
      类型：Function(Integer 索引，Number 宽度)=> String 或 Number
      返回要设置的外部宽度的函数。接收集合中元素的索引位置和旧的外部宽度作为参数。在函数中，this 指的是集合中的当前元素。

调用 .outerWidth(value) 时，该值可以是字符串(数字和单位)或数字。如果只为该值提供了一个数字，则 jQuery 假定一个像素单位。但是，如果提供了字符串，则可以使用任何有效的 CSS 测量值(例如 100px 、 50% 或 auto )。

例子：

第一次单击时更改每个 div 的外部宽度(并更改其颜色)。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>outerWidth demo</title>
  <style>
  div {
    width: 60px;
    padding: 10px;
    height: 50px;
    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 modWidth = 60;
$( "div" ).one( "click", function() {
  $( this ).outerWidth( modWidth ).addClass( "mod" );
  modWidth -= 8;
});
</script>
 
</body>
</html>

演示：

相关用法


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