• $( selector [ , context ] ) 1.0追加
• $( element ) 1.0追加
• $( object ) 1.0追加
• $( elementArray ) 1.0追加
• $( jQuery Object ) 1.0追加
• $() 1.4追加
• $( html [, ownerDocument] ) 1.0追加
• $( html, props ) 1.4追加
• $( callback ) 1.0追加

$( selector [ , context ] ) 1.0追加

戻り値:jQuery

セレクター文字列を指定して、マッチした要素群のjQueryオブジェクトを返します。

引数	説明
selector	要素を特定するセレクター文字列を指定します。
context	contextにDOM要素、document、jQueryオブジェクト等を指定することで、 selectorはcontexに指定されたものの中から、要素を特定するようになります。

$()とjQuery()の書き方があり、どちらでも同じ処理を行います。 selectorにマッチする要素が見つからなかった場合、要素を含まないlengthが0の 空のjQueryオブジェクトを返します。 通常は「$」を使用しますが、名前のコンフリクトを避ける際にjQueryが使用されます。

$('div.foo');
jQuery('div.foo');

contextを指定しなければ、セレクターはドキュメントルートから対象となる要素を探します。 contextを指定することで、探す対象をそのcontextの中に絞り込みます。

$('div.foo').click(function() {

  //contextにthisを指定することで、
  //this(div.foo)要素内のspanを対象としています。
  $('span', this).addClass('bar');
});

1つ目のフォーム内の全radioタイプのinputが対象

$("input:radio", document.forms[0]);

Ajaxで返されたXML内に含まれるDIV要素を対象

$("div", xml.responseXML);

ページの背景を黒にします。

$(document.body).css( "background", "black" );

フォーム内の全てのinput要素を非表示にします。

$(myForm.elements).hide();

$( element ) 1.0追加

戻り値:jQuery

指定したDOM要素をjQueryオブジェクトにして返します。

引数	説明
element	jQueryオブジェクトにしたいDOM要素を指定します。

$('div.foo').click(function() {

  //thisはDOM要素。
  //jQueryメソッドのslideUP()を使用するため、$()でthisを囲っています。
  $(this).slideUp();
});

$( object ) 1.0追加

戻り値:jQuery

プレーンなオブジェクトをjQueryオブジェクトにして返します。

引数	説明
object	jQueryオブジェクトにしたいプレーンなオブジェクトを指定します。

$( elementArray ) 1.0追加

戻り値:jQuery

配列で複数のDOM要素を指定することで、その要素群のjQueryオブジェクトを返します。

引数	説明
elementArray	jQueryオブジェクトにしたい配列にした複数のDOM要素を指定します。

$( jQuery Object ) 1.0追加

戻り値:jQuery

指定したjQueryオブジェクトのクローンを返します。

引数	説明
jQuery Object	jQueryオブジェクトのクローンを生成します。 生成されたオブジェクトは同じDOM要素を参照します。

$() 1.4追加

戻り値:jQuery

空のjQueryオブジェクトを返します。

$( html [, ownerDocument] ) 1.0追加

戻り値:jQuery

jQueryオブジェクトにしたいHTML文字列を指定します。

引数	説明
html	HTML文字列を解析して、jQueryオブジェクトにします。XMLを指定することは出来ません。
ownerDocument

//$()内のHTMLをjQueryオブジェクトにして、
//appendToメソッドを使用して、body内にこのHTMLを挿入します。
$('<p id="test">My <em>new</em> text</p>').appendTo('body');

$( html, props ) 1.4追加

戻り値:jQuery

単体のHTML文字列を指定し、propsで指定した属性を付与します。

引数	説明
html	単体のHTMLタグを指定します。(例:<div></div>, <div />)
props	htmlに指定した要素が作成された際に、追加したい属性を指定します。 (他にもメソッドやイベントを指定可能？)

//この書き方はIEではサポートされていない。
$('<input />', {
    type: 'text',
    name: 'test'
}).appendTo("body");

//次のようにすれば、問題は回避される。
$('<input type="text" />').attr({
    name: 'test'
}).appendTo("body");

$( callback ) 1.0追加

戻り値:jQuery

ページのDOMが読み込まれ準備が出来たタイミングで実行したい処理を指定します。

引数	説明
callback	ページのDOMが全て読みこまれ使用可能になったタイミングで、実行したいコールバック関数を指定します。

「$(document).ready()」と全く同じ振る舞いをします。

$(function(){
   //ページのDOMが全て読みこまれ、
   //使用可能になった際に実行したい処理を記述。
 });

 Back to top