在 jQuery 中,outerWidth() 用來取得或設定目前符合元素的外寬度。所謂外寬度,通常包含元素本身的寬度、內邊距 padding 與邊框 border,但預設不包含外边距 margin。

如果希望連 margin 一起計入,可以在呼叫時傳入 true:
$('#n1').outerWidth();
$('#n1').outerWidth(true);
若只想取得元素內容本身的寬度,可以使用 width()。若想取得包含 padding 的寬度,可以使用 innerWidth()。而 outerWidth() 則是包含 padding 與 border 的外寬度。三者的差異,主要就在於是否包含 padding、border 與 margin。
假設有兩個元素:
第一個元素寬度為 100px,padding 為 10px,border 為 1px,margin 為 5px。
第二個元素寬度為 150px,沒有額外 padding 與 border。
則:
var $n1 = $('#n1');
var $n2 = $('#n2');
$n1.outerWidth();
// 100 + 10 * 2 + 1 * 2 = 122
$n1.outerWidth(true);
// 100 + 10 * 2 + 1 * 2 + 5 * 2 = 132
$n2.outerWidth();
// 150
若目前 jQuery 物件符合多個元素,outerWidth() 只會以第一個符合元素為準。若沒有符合元素,則不會取得有效寬度。
另外,outerWidth() 不適合用於 window 或 document。如果需要取得視窗或文件相關寬度,應改用 width() 或其他對應方式。
在做動態排版、計算元素間距、判斷容器是否足夠容納內容,或需要精準取得包含邊框的實際佔用寬度時,outerWidth() 會比單純使用 width() 更合適。