ユーティリティ

二つの配列をマージ

JS
1
2
3
<script>
$.merge(配列1, 配列2);
</script>
引数で指定した配列1に配列2が追加されます。処理前の状態を保存したい時は前もってコピーしておきます。

配列とオブジェクトをそれぞれコールバック関数処理して新たな配列で返す

JS
1
2
3
<script>
$.map(配列, function(配列要素, インデックス){処理});
</script>

配列から特定条件で要素を取得

JS
1
2
3
<script>
$.grep(配列, function(配列要素, インデックス){処理}, true);
</script>
grep()は配列を識別関数に渡し、その条件に一致する要素を新しい配列にして返します。第三引数がtrueの場合、この識別関数がfalseを返した要素が戻り値の配列に含まれます。第三引数がfalseの場合、識別関数がtrueを返した要素が戻り値の配列に含まれます。

配列の要素を一つずつ処理

JS
1
2
3
<script>
$.each(オブジェクト及び配列, function(インデックス, 配列要素){処理});
</script>
オブジェクトや配列を順番にスキャンし、それぞれの要素に対してコールバック関数が実行されます。

対象要素に要素が含まれているかをチェック

JS
1
2
3
<script>
$.contains(対象要素, 存在を調べたい要素);
</script>

配列に特定の要素が含まれているかを調べる

JS
1
2
3
<script>
$.inArray(値, 配列);
</script>
配列に要素が含まれているかを調べ、最初に一致した要素のインデックス番号を返します。存在しなかった場合は-1が返されます。

配列かどうかをチェック

JS
1
2
3
<script>
$.isArray(対象);
</script>
配列ならtrue、違えばfalseを返します。

オブジェクトを配列に変換

JS
1
2
3
<script>
$.makeArray(オブジェクト);
</script>
javaScriptのpopメソッドやreverseメソッドなど配列操作関数を使う時に利用されます。

要素に任意のデータを保存させる

JS
1
2
3
4
<script>
$.data(要素, キー, 値);
$.removeData(要素, キー);
</script>
data()メソッドは、第一引数に指定した要素にキーと値をセットで保存できます。読み出す際はキーのみで行えます。
removeData()は、$.data()でセットした情報を削除します。第二引数にキーを渡すと、それに対応するデータのみ削除します。

複数のオブジェクトマージ(併合)する

JS
1
2
3
<script>
$.extend(true, 対象オブジェクト, オブジェクト,・・・);
</script>
マージは左側に右側のオブジェクトを順番に上書きしていきます。その際、同名のプロパティが存在すると右側のプロパティで左側のプロパティのオブジェクトや配列が丸ごと上書きされてしまいます。第一引数にtrueを設定すると再帰的にディープコピーするため、右側のプロパティ内のオブジェクトや配列の変更部分以外は残して左側にコピーされます。

文字列前後の空白を削除

JS
1
2
3
<script>
$.trim(文字列);
</script>
スペースをはじめ、タブ文字、改行文字を取り除きます。

何もしないメソッド

JS
1
2
3
<script>
$.noop();
</script>
コールバック関数に何もさせたくない時などに利用されます。

要素を一個ずつスキャン

JS
1
2
3
<script>
$(要素).each(function(インデックス番号, 要素){処理});
</script>
各要素を一個ずつ調べ、それぞれの要素にコールバック関数が用いられます。反復処理で多用されます。

DOM要素を取得

JS
1
2
3
<script>
$(要素).get(インデックス番号);
</script>
引数を省略すると、全てのDOM要素が配列として返されます。引数にインデックス番号を指定すると該当するインデックス番号に一致する一つの要素を取得します。

指定した要素のjQueryオブジェクト内のインデックス番号を取得

JS
1
2
3
4
5
<script>
$(要素).index();
$(要素).index(要素);
$(要素).index(セレクタ);
</script>
引数を省略すると兄弟要素の中でのインデックス番号が取得できます。指定した場合、jQueryオブジェクト内での指定された要素のインデックス番号を返します。指定された要素が見つからなければ-1を返します。