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>

width:

要素の幅を数値で設定

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

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

要素の幅を関数で設定

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

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

関連記事

• CSS width
• jQuery after()
• jQuery animate()
• jQuery each()
• jQuery empty()
• jQuery height()
• jQuery hide()
• jQuery resize()
• jQuery text()

参考文献

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