outerWidth()函数用于设置或返回当前匹配元素的外宽度。外宽度默认包含元素的内边距(padding)、边框(border),但不包含外边距(margin)部分的宽度。你也能够指定參数为true,以包含外边距(margin)部分的宽度。

例如以下图:


假设你要获取其他情况的宽度。请使用width()和innerWidth()。你能够点此查看三者之间的差别。该函数属于jQuery对象(实例)。而且对不可见的元素依旧有效。语法jQuery 1.2.6 新增该函数。jQueryObject.outerWidth( [ includeMargin ] )注意:假设当前jQuery对象匹配多个元素。则仅仅返回第一个匹配的元素的外宽度。參数參数 描写叙述includeMargin 可选/Boolean类型指示是否包括外边距部分的宽度,默觉得false。返回值outerWidth()函数的返回值为Number类型,返回第一个匹配元素的外宽度。

假设当前jQuery对象匹配多个元素,返回外宽度时,outerWidth()函数仅仅以当中第一个匹配的元素为准。假设没有匹配的元素,则返回null。outerWidth()不适用于window和document,请使用width()替代。演示样例&说明以以下这段HTML代码为例:

<div id="n1" style="margin:5px; padding: 10px; width:100px; height: 100px; border: 1px solid #000;"></div>
<div id="n2" style="width:150px; height: 100px; background: #999;"></div>



下面jQuery演示样例代码用于演示outerWidth()函数的详细使用方法:

var $n1 = $("#n1");
var $n2 = $("#n2");

// outerWidth() = width(100) + padding(10*2) + border(1*2) = 122 
document.writeln( $n1.outerWidth() ); // 122
document.writeln( $n2.outerWidth() ); // 150

var $divs = $("div");
// 假设匹配多个元素。仅仅返回第一个元素的outerWidth
document.writeln( $divs.outerWidth() ); // 122


//outerWidth(true) = width(100) + padding(10*2) + border(1*2) + margin(5*2) = 132 
document.writeln( $n1.outerWidth(true) ); // 132
document.writeln( $n2.outerWidth(true) ); // 150