.width()

分类: CSS | Dimensions | Manipulation > Style Properties
为匹配的元素集合中获取第一个元素的当前计算宽度值或给每个匹配的元素设置宽度。

Contents:

.width()返回: Integer

描述: 为匹配的元素集合中获取第一个元素的当前计算宽度值。

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

    • 这个方法不接受任何参数。

.css(width) 和 .width()之间的区别是后者返回一个没有单位的数值（例如，400），前者是返回带有完整单位的字符串（例如，400px）。当一个元素的宽度需要数学计算的时候推荐使用.width() 方法 。

图1 - 测量宽度的插图

这个方法同样能计算出window和document的宽度。

1
2
3
4
5
 
// Returns width of browser viewport
$( window ).width();
 
// Returns width of HTML document
$( document ).width();

注意.width()总是返回容器的宽度,不管CSS box-sizing属性值。截至jQuery 1.8，这可能需要检索的CSS的宽度加加上box-sizing的属性，然后当元素有 box-sizing: border-box时候，减去个元素上任何潜在border和padding值。为了避免这种问题，使用.css( "width" )而非.width()。

注意: 虽然当style 和 script标签 绝对定位 并且给定 display:block 时， .width() 或者 height()方法将返回一个值，我们强烈呼吁不要在这些标签中使用.width() 或者 height()方法。这是一种不好的做法，其返回值也可能是不可靠。

其他注意事项:

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

例子:

显示各个宽度。注意这个来自值iframe的值可能小于你的预期。黄色高亮显示iframe body。

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
 
<!DOCTYPE html>
<html>
<head>
  <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="//code.jquery.com/jquery-latest.js"></script>
</head>
<body>
  <button id="getp">Get Paragraph Width</button>
  <button id="getd">Get Document Width</button>
  <button id="getw">Get Window Width</button>
 
  <div>&nbsp;</div>
  <p>
    Sample paragraph to test width
  </p>
<script>
function showWidth(ele, w) {
  $("div").text("The width for the " + ele +
                " is " + w + "px.");
}
$("#getp").click(function () {
  showWidth("paragraph", $("p").width());
});
$("#getd").click(function () {
  showWidth("document", $(document).width());
});
$("#getw").click(function () {
  showWidth("window", $(window).width());
});
 
</script>
 
</body>
</html>

Demo:

.width( value )返回: jQuery

描述: 给每个匹配的元素设置CSS宽度。

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

    • value
      一个正整数代表的像素数,或是整数和一个可选的附加单位（默认是：“px”）(作为一个字符串)。

  • 添加的版本: 1.4.1.width( function(index, width) )

    • function(index, width)
      类型: Function()
      返回用于设置宽度的一个函数。接收元素的索引位置和元素旧的高度值作为参数。在函数中 this指向集合中当前的元素。

当调用.width(value)方法的时候，这个“value”参数可以是一个字符串（数字加单位）或者是一个数字。如果这个“value”参数只提供一个数字，jQuery会自动加上单位px。如果只提供一个字符串，任何有效的CSS尺寸都可以为宽度赋值（就像100px, 50%, 或者 auto）。注意在现代浏览器中，CSS宽度属性不包含padding, border, 或者 margin。除非box-sizing CSS属性被使用。

如果没有给定明确的单位（像'em' 或者 '%'），那么默认情况下"px"会被直接添加上去（也理解为"px"是默认单位）。

注意.width('value')设置的容器宽度是根据CSS box-sizing属性来定的, 将这个属性值改成border-box将造成这个函数改变成获取这个容器的outerWidth替换原来的内容宽度。

例子:

点击每个div时设置该div宽度为30px，并改变颜色。

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
 
<!DOCTYPE html>
<html>
<head>
  <style>
div { width: 70px; height: 50px; float:left; margin: 5px;
        background: red; cursor: pointer; }
.mod { background: blue; cursor: default; }
  </style>
  <script src="//code.jquery.com/jquery-latest.js"></script>
</head>
<body>
 
  <div>d</div>
  <div>d</div>
  <div>d</div>
  <div>d</div>
  <div>d</div>
 
<script>
(function() {
  var modWidth = 50;
  $("div").one('click', function () {
    $(this).width(modWidth).addClass("mod");
  modWidth -= 8;
  });
})();
</script>
 
</body>
</html>

Demo: