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

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


获取匹配元素集中第一个元素的当前计算宽度或设置每个匹配元素的宽度。

用法一

.width() => Number

说明：获取匹配元素集中第一个元素的当前计算宽度。

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

    • 此方法不接受任何参数。

.css( "width" ) 和 .width() 之间的区别在于后者返回一个 unit-less 像素值(例如 400 )，而前者返回一个单位完整的值(例如 400px )。当需要在数学计算中使用元素的宽度时，建议使用.width() 方法。

图 1 - 测量宽度示意图

此方法还能够找到窗口和文档的宽度。

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

请注意，无论 CSS box-sizing 属性的值如何，.width() 将始终返回内容宽度。从 jQuery 1.8 开始，这可能需要检索 CSS 宽度加上 box-sizing 属性，然后当元素具有 box-sizing: border-box 时减去每个元素上的任何潜在边框和填充。为避免这种惩罚，请使用 .css( "width" ) 而不是 .width() 。

注意：虽然style和script标签将报告一个值.width()或者height()当绝对定位和给定display:block，强烈建议不要在这些标签上调用这些方法。除了是一种不好的做法外，结果也可能被证明是不可靠的。

其他注意事项：

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

例子：

显示各种宽度。请注意，这些值来自 iframe，因此可能比您预期的要小。黄色高亮显示 iframe 主体。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>width demo</title>
  <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="https://code.jquery.com/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>

演示：

用法二

.width( value ) => jQuery

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

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

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

  • 添加的版本：1.4.1.width( function )

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

调用 .width("value") 时，该值可以是字符串(数字和单位)或数字。如果只为该值提供了一个数字，则 jQuery 假定一个像素单位。但是，如果提供了字符串，则任何有效的 CSS 测量值都可以用于宽度(例如 100px 、 50% 或 auto )。请注意，在现代浏览器中，CSS 宽度属性不包括填充、边框或边距，除非使用了 box-sizing CSS 属性。

如果未指定明确的单位(如"em" 或"%")，则假定为"px"。

请注意，无论 CSS box-sizing 属性的值如何，.width("value") 都会设置框的内容宽度。

例子：

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

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

演示：

相关用法


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