.outerWidth()

类别：CSS | 尺寸 | 文档处理 > 样式属性
针对匹配的元素集合中的第一个元素，取得当前的计算外部宽度（包括补白、边框和可选的边距），或者针对每个匹配的元素设置外部宽度。

内容：

.outerWidth( [includeMargin ] )返回类型：Number

描述：针对匹配的元素集合中的第一个元素，取得当前的计算外部宽度（包括补白、边框和可选的边距）。

返回元素的高度，包括顶部和底部补白、边框，视情况还包括边距，以像素计。如果在元素的空集上调用，就返回undefined（在jQuery 3.0以前是null）。

此方法并不适用于window和document对象；对于这些，请用.width()代替。虽然.outerWidth()可用于表格元素，但是如果使用了CSS属性border-collapse: collapse，它可能给出不期待的结果。

插图 1 - 测量宽度的演示

补充说明：

  • 由尺寸相关的API返回的数字，包括.outerWidth()，在某些情况下可能是分数。代码并不假设它是一个整型数。而且，当用户缩放网页时，尺寸可能不正确；浏览器并不曝露一个API，以诊测此条件。
  • 当元素或它的父元素是隐藏的时候，.outerWidth()报告的值，不保证是准确的。若要取得一个准确的值，请在使用.outerWidth()之前，确保元素可见。jQuery将尝试临时显示，然后再次隐藏一个元素，以测量出它的尺寸，但是这是不可靠的，而且（哪怕准确）也会显著影响网页的性能。在未来的jQuery版本中，可能删除这种先显示再隐藏的测量功能。

示例：

取得一个段落的外部宽度。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
 
<!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-1.10.2.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 )返回类型：jQuery

描述：在匹配的元素集合中设置CSS外部宽度。

  • 增补版本：1.8.0.outerWidth( value )

    • value
      类型：String or Number
      一个数字，代表像素的数量，或一个数字，以及可选的测量附加的单位（作为一个字符串）。

  • 增补版本：1.8.0.outerWidth( function )

    • function
      类型：Function( Integer index, Number width ) => String or Number
      一个函数，返回要设置的外部宽度。检索元素在集合中的索引位置，以及旧的外部宽度作为参数。在此函数内部，this指的是集合中的当前元素。

如果调用.outerWidth(value)，该值既可以是一个字符串（数字和单位），也可以是一个数字。如果只向该值提供一个数字，jQuery会假定它的单位是像素。如果提供了一个字符串，则任何有效的CSS度量都可以用（譬如100px、50%或auto）。

示例：

在点击时，改变每个<div>的外部高度并改变它的颜色。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
 
<!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-1.10.2.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>

演示：