jQuery.extend()メソッド
例
配列要素を走査し、最初のオブジェクトを変更する
<div id="log"></div>
<script>
$(function () {
var object1 = {
apple: 0,
banana: {weight: 52, price: 100},
cherry: 97
};
var object2 = {
banana: {price: 200},
durian: 100
};
/*object2 を object1 にマージする*/
$.extend(object1, object2);
var printObj = typeof JSON != "undefined" ? JSON.stringify : function(obj) {
var arr = [];
$.each(obj, function(key, val) {
var next = key + ": ";
next += $.isPlainObject(val) ? printObj(val) : val;
arr.push( next );
});
return "{ " + arr.join(", ") + " }";
};
$("#log").append( printObj(object1) );
})
</script>
試してみる »
定義と使い方
jQuery.extend() 関数は、1つまたは複数のオブジェクトの内容をターゲットオブジェクトにマージするために使用されます。
注意:1. $.extend() にパラメータを1つだけ指定した場合、パラメータ target が省略されたことを意味します。この場合、target は jQuery オブジェクト自体です。この方法により、グローバルオブジェクト jQuery に新しい関数を追加できます。
2. 複数のオブジェクトが同じプロパティを持つ場合、後者のオブジェクトが前者のプロパティ値を上書きします。
構文
$.extend( target [, object1 ] [, objectN ] )
ディープマージを行うかどうかを示します
$.extend( [deep ], target, object1 [, objectN ] )
警告:最初のパラメータに false を渡すことはサポートされていません。
| パラメータ | 説明 |
|---|---|
| deep | 省略可能。Boolean型 オブジェクトをディープマージするかどうかを示します。デフォルトは false です。この値が true で、複数のオブジェクトのある同名プロパティがすべてオブジェクトである場合、その「プロパティオブジェクト」のプロパティもマージされます。 |
| target | Object型 ターゲットオブジェクト。他のオブジェクトのメンバープロパティがこのオブジェクトに追加されます。 |
| object1 | 省略可能。Object型 最初にマージされるオブジェクト。 |
| objectN | 省略可能。Object型 N番目にマージされるオブジェクト。 |
その他の例
再帰方式で2つのオブジェクトをマージする
再帰方式で2つのオブジェクトをマージし、最初のオブジェクトを変更します。
defaults オブジェクトと options オブジェクトをマージする
defaults オブジェクトと options オブジェクトをマージし、defaults オブジェクトを変更しません。これは一般的なプラグイン開発パターンです。
その他の拡張
jQuery 雑多メソッド