width()

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

.width()

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

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

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

$(window).width();   // returns width of browser viewport
$(document).width(); // returns width of HTML document

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

例子

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

<!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="./static/js/jquery-3.5.0.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>
div

Sample paragraph to test width

width(value)

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

.width(value)
  • value 类型: String, Number 。一个正整数代表的像素数,或是整数和一个可选的附加单位(默认是:“px”)(作为一个字符串)。

当调用 .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,并改变颜色。

<!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="./static/js/jquery-3.5.0.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>
d
d
d
d
d

下篇: height()