jQueryオブジェクト .width()

jQueryオブジェクトのwidthメソッドを使うと、HTML要素の幅を取得したり、HTML要素の幅を設定できる。

構文

取得

HTML要素の幅を取得する。

jQueryObject.width()

jQueryオブジェクトが複数のHTML要素にマッチする場合は、最初にマッチした要素の幅を取得する。

設定

HTML要素の幅を設定する。

jQueryObject.width(size)
jQueryObject.width(function)

jQueryオブジェクトが複数のHTML要素にマッチする場合は、複数の要素の幅を設定できる。

戻り値

HTML要素の幅を取得するとき(=引数を省略したとき)は、HTML要素の幅を数値で返す。

HTML要素の幅を設定するとき(=引数を指定したとき)は、マッチしたHTML要素のjQueryオブジェクトを返す。

引数

jQueryオブジェクトのwidthメソッドには、以下に示す引数を指定できる。

size
要素の幅を数値で指定する。pxやem等の単位を使うこともできる。
function
要素の幅を戻り値として返す関数を指定する。
function()
function(index)
function(index, width)

jQueryオブジェクトが複数のHTML要素にマッチすることがある。それらを区別するため、マッチした要素のインデックス番号(0始まり)が第1引数 index に渡される。

変更前の幅が第2引数 width に渡される。

jQueryオブジェクトのwidthメソッドの使用例を以下に示す。

要素の幅を取得

画像の幅を取得する例を次に示す。

<img src="portrait.jpg" id="portrait1">
<p>height: <span id="height"></span></p>
<script>
  const width = $('#portrait1').width();
  $('#width').html(width);
</script>

portrait

width:

要素の幅を数値で設定

画像の幅を数値で設定する例を次に示す。

<img src="portrait.jpg" id="portrait2">
<script>
  $('#portrait2').width(200);
</script>

portrait

要素の幅を関数で設定

画像の幅を関数で設定する例を次に示す。

<img src="portrait.jpg" id="portrait3">
<script>
  $('#portrait3').width(function() {
    return 100;
  });
</script>

portrait

関連記事

参考文献

OpenJS Foundation (2025) .width() | jQuery API Documentation