- 索引
-
- ├ 目次
- ├ jQuery(selector)
- ├ jQuery(html)
- ├ jQuery(function)
- ├ jQuery.holdReady()
- ├ jQuery.noConflict()
- └ jQuery.sub()
- 他ページ参照
- └ jQuery.when()
-
- └ 目次
- 基礎
- ├ *(すべて)
- ├ element(html要素)
- ├ #id名(ID属性)
- ├ .class名(clas属性)
- ├ 複数のセレクタ(and)
- └ 複数のセレクタ(or)
- 階層関連
- ├ 先祖 子孫
- ├ >(子要素)
- ├ +(直近の後要素)
- └ ~(後要素)
- 属性
- ├ [属性名]
- ├ [属性名='値']
- ├ [属性名!='値']
- ├ [属性名^='値']
- ├ [属性名$='値']
- ├ [属性名*='値']
- ├ [属性名-='値']
- ├ [属性名|='値']
- └ 複数の属性
- 基本フィルタ
- ├ :root
- ├ :header
- ├ :lang()
- ├ :target
- ├ :animated
- ├ :first
- ├ :last
- ├ :even
- ├ :odd
- ├ :eq()
- ├ :gt()
- ├ :lt()
- └ :not()
- 子要素フィルタ
- ├ :first-child
- ├ :first-of-type
- ├ :last-child
- ├ :last-of-type
- ├ :only-child
- ├ :only-of-type
- ├ :nth-child()
- ├ :nth-of-type()
- ├ :nth-last-child()
- └ :nth-last-of-type()
- 可視性フィルタ
- ├
- └ :visible
- コンテンツフィルタ
- ├ :contains()
- ├ :has()
- ├ :empty
- └ :parent
- フォーム
- ├ :checked
- ├ :selected
- ├ :disabled
- ├ :enabled
- ├ :focus
- ├
- ├ :checkbox
- ├ :file
- ├ :image
- ├ :input
- ├ :password
- ├ :radio
- ├ :reset
- ├ :submit
- └ :text
-
- ├ .目次
- ├ .hasClass()
- ├ .addClass()
- ├ .removeClass()
- ├ .toggleClass()
- ├ .attr()
- ├ .removeAttr()
- ├ .prop()
- ├ .removeProp()
- └ .val()
-
- └ 目次
- ツリー(階層)
- ├ .siblings()
- ├ .next()
- ├ .nextAll()
- ├ .nextUntil()
- ├ .prev()
- ├ .prevAll()
- ├ .prevUntil()
- ├ .children()
- ├ .find()
- ├ .parent()
- ├ .parents()
- ├ .parentsUntil()
- ├ .offsetParent()
- └ .closest()
- フィルタリング
- ├ .eq()
- ├ .slice()
- ├ .first()
- ├ .last()
- ├ .filter()
- ├ .has()
- ├ .not()
- ├ .is()
- └ .map()
- その他
- ├ .add()
- ├ .andSelf()
- ├ .addBack()
- ├ .end()
- ├ .contents()
- └ .each()
-
- ├ 目次
- 要素の挿入
- ├ .after()
- ├ .before()
- ├ .append()
- ├ .prepend()
- ├ .insertAfter()
- ├ .insertBefore()
- ├ .appendTo()
- └ .prependTo()
- 要素の削除
- ├ .empty()
- └ .remove()
- ├ .detach()
- 要素を囲む
- ├ .wrap()
- ├ .wrapAll()
- └ .wrapInner()
- ├ .unwrap()
- その他
- ├ .text()
- ├ .html()
- ├ .clone()
- ├ .replaceAll()
- └ .replaceWith()
- 他ページ参照
- ├ .toggleClass()
- ├ .hasClass()
- ├ .addClass()
- ├ .removeClass()
- ├ .attr()
- ├ .removeAttr()
- ├ .prop()
- ├ .removeProp()
- ├ .val()
- ├ .css()
- ├ .offset()
- ├ .position()
- ├ .height()
- ├ .innerHeight()
- ├ .outerHeight()
- ├ .width()
- ├ .innerWidth()
- ├ .outerWidth()
- ├ .scrollLeft()
- └ .scrollTop()
-
- ├ 目次
- ├ jQuery.cssHooks
- ├ .css()
- ├ .height()
- ├ .innerHeight()
- ├ .outerHeight()
- ├ .width()
- ├ .innerWidth()
- ├ .outerWidth()
- ├ .offset()
- ├ .position()
- ├ .scrollTop()
- └ .scrollLeft()
- 他ページ参照
- ├ .addClass()
- ├ .hasClass()
- ├ .removeClass()
- └ .toggleClass()
-
- └ 目次
- マウスイベント
- ├ .click()
- ├ .dblclick()
- ├ .mousedown()
- ├ .mouseup()
- ├ .mouseover()
- ├ .mouseout()
- ├ .mouseenter()
- ├ .mouseleave()
- ├ .mousemove()
- ├ .hover()
- └ .toggle()
- キーイベント
- ├ .keydown()
- ├ .keypress()
- ├ .keyup()
- ├ .focusin()
- └ .focusout()
- フォームイベント
- ├ .focus()
- ├ .blur()
- ├ .change()
- ├ .select()
- └ .submit()
- ブラウザイベント
- ├ .resize()
- ├ .scroll()
- └ .error()
- ロードイベント
- ├ .load()
- ├ .unload()
- └ .ready()
- イベントハンドラアタッチ
- ├ .bind()
- ├ .unbind()
- ├ .live()
- ├ .die()
- ├ .delegate()
- ├ .undelegate()
- ├ .on()
- ├ .off()
- ├ .one()
- ├ .triggerHandler()
- └ .trigger()
- イベントオブジェクト
- ├ jQuery.Event
- ├ eo.type
- ├ eo.data
- ├ eo.pageX
- ├ eo.pageY
- ├ eo.timeStamp
- ├ eo.which
- ├ eo.result
- ├ eo.namespace
- ├ eo.target
- ├ eo.currentTarget
- ├ eo.delegateTarget
- ├
- ├ eo.stopPropagation()
- ├ eo.stopImmediateP...
- ├ eo.preventDefault()
- ├ eo.isPropagationSt...
- ├ eo.isImmediatePre...
- └ eo.isDefaultPreven...
-
- └ 目次
- 基礎
- ├ .hide()
- ├ .show()
- └ .toggle()
- スライド
- ├ .slideUp()
- ├ .slideDown()
- └ .slideToggle()
- フェード
- ├ .fadeOut()
- ├ .fadeIn()
- ├ .fadeTo()
- └ .fadeToggle()
- カスタム
- ├ .animate(prop)
- ├ .animate(prop,opt...
- ├ .stop()
- ├ .delay()
- ├ .queue()
- ├ .dequeue()
- ├ .clearQueue()
- ├ .finish()
- ├ jQuery.queue()
- ├ jQuery.dequeue()
- ├ jQuery.fx.interval
- └ jQuery.fx.off
-
- └ 目次
- 簡易メソッド
- ├ .load()
- ├ jQuery.get()
- ├ jQuery.getJSON()
- ├ jQuery.getScript()
- └ jQuery.post()
- グローバルイベントハンドラ
- ├ .ajaxComplete()
- ├ .ajaxSuccess()
- ├ .ajaxError()
- ├ .ajaxSend()
- ├ .ajaxStart()
- └ .ajaxStop()
- 低レベル・インターフェイス
- ├ jQuery.ajax()
- ├ jQuery.ajaxSetup()
- └ jQuery.ajaxPrefilt...
- お助け機能
- ├ jQuery.param()
- ├ .serialize()
- └ .serializeArray()
-
- └ 目次
- チェック
- ├ jQuery.contains()
- ├ jQuery.isArray()
- ├ jQuery.isEmptyO...
- ├ jQuery.isPlainO...
- ├ jQuery.isNumeric()
- ├ jQuery.isFunction()
- ├ jQuery.isWindow()
- └ jQuery.isXMLDoc()
- 配列/Object関連
- ├ jQuery.makeArray()
- ├ jQuery.inArray()
- ├ jQuery.grep()
- ├ jQuery.each()
- ├ jQuery.map()
- ├ jQuery.merge()
- ├ jQuery.extend()
- └ jQuery.unique()
- その他
- ├ jQuery.globalEval()
- ├ jQuery.noop()
- ├ jQuery.now()
- ├ jQuery.parseHTML()
- ├ jQuery.parseJSON
- ├ jQuery.parseXML()
- ├ jQuery.proxy()
- ├ jQuery.trim()
- ├ jQuery.type()
- ├ jQuery.support
- ├ jQuery.boxModel
- └ jQuery.browser
- 他ページ参照
- ├ .queue()
- ├ .dequeue()
- ├ .clearQueue()
- ├ jQuery.queue()
- ├ jQuery.dequeue()
- ├ jQuery.data()
- └ jQuery.removeData()
-
- ├ 目次
- ├ .data()
- ├ .removeData()
- ├ jQuery.data()
- ├ jQuery.removeData()
- └ jQuery.hasData()
- 他ページ参照
- ├ .queue()
- ├ .dequeue()
- ├ .clearQueue()
- ├ jQuery.queue()
- └ jQuery.dequeue()
-
- └ 目次
- deferredの作成
- └ jQuery.deferred()
- promiseの作成
- ├ jQuery.when()
- ├ .promise()
- └ deferred.promise()
- コールバックの設定
- ├ deferred.done()
- ├ deferred.fail()
- ├ deferred.always()
- ├ deferred.progress()
- ├ deferred.then()
- └ deferred.pipe()
- 状態の取得
- ├ deferred.state()
- ├ deferred.isReso...
- └ deferred.isReje...
- 状態の変更
- ├ deferred.resolve()
- ├ deferred.resolveW...
- ├ deferred.reject()
- ├ deferred.rejectW...
- ├ deferred.notify()
- └ deferred.notifyW...
-
- ├ 目次
- ├ jQuery.error()
- ├ .context
- ├ .jquery
- └ .pushStack()
jQuery(セレクタ)jQueryオブジェクトを作成
構文
- 引数にマッチしたjQueryオブジェクトを作成する返値:jQueryオブジェクト
-
jQuery( セレクタ [,コンテキスト] )ver1.0〜
jQuery( DOM )ver1.0〜
jQuery( jQuery )ver1.0〜
jQuery( Object/Array )ver1.0〜
jQuery( )ver1.4〜
機能
jQueryメソッドは引数にマッチした要素をjQueryオブジェクトとして返します。jQueryで一番利用されるメソッドのため、$で置き換えることが可能になっています。
第2引数のコンテキストにセレクタ等(xmlデータも可能なようです)を指定することで、検索対象を絞ることができます。省略した場合はdocumentが対象となります。他にも様々な構文があるので、以下の解説で説明していきます。
解説
セレクタで指定した内容にマッチしたjQueryオブジェクトを作成
セレクタで指定した内容にマッチした要素をjQueryオブジェクトに変換します。サンプル(jquery1/01.html)を開いてbody内に2つのdiv要素と1つのspan要素があることを確認してください。
jQueryは以下の様に記述され、1行目で「div」にマッチする要素をjQueryオブジェクトに変換し変数joに代入しています。jQueryオブジェクトはjQueryのメソッドに直接利用できるので3行目でcssメソッドを利用し背景色を緑に変更しています。
var jo = jQuery("div"); $("button").click(function(){ jo.css("background-color","#cfc"); })
結果として、buttonをクリックすると2つのdiv要素の背景色が緑に変わります(span要素は変更されません)。このようにjQueryオブジェクトはセレクタにマッチした要素が複数あっても問題ありません。
第2引数「コンテキスト」を利用
jQueryメソッドに第2引数「コンテキスト」を設定することで検索対象を絞ることができます。
サンプル(jquery1/02.html)を開いて2つのul要素に5つずつli要素があることを確認してください。また各ul要素にはid属性が設定されています。
jQueryは以下の様に記述され、第2引数「コンテキスト」にtest1のid属性のセレクタを指定しました。このため検索対象はtest1のid属性が付いたul要素内に限定されます。
$("button").click(function(){ $("li","#test1").css("background-color","#f99"); })
結果として、buttonをクリックすると、test1のid属性が付いたul内のli要素しか選択されません。
DOM要素の利用
jQueryメソッドは引数にDOM要素を設定すると、DOM要素をjQueryオブジェクトに変換します。
サンプル(jquery1/03.html)を開いてhtmlの構成はサンプルjquery1/01.htmlと同じ事を確認してください。jQueryは以下の部分だけが異なり、jQUeryメソッドの引数に直接DOM要素を設定しています。
var jo = jQuery(document.getElementsByTagName("div")[0]);
上記ではDOMで最初のdiv要素を指定しているため、buttonをクリックすると一番上のdiv要素だけが変わります。DOM要素に対し、jQueryのメソッドを使いたい時に利用します。
jQueryオブジェクトの複製
引数にjQueryオブジェクトを設定することで、jQueryオブジェクトを複製することができます。
サンプル(jquery1/04.html)を開いて以下の部分を確認して下さい。1行目で作成したjQueryオブジェクト「jo」を2行目でjQueryメソッドの引数に設定し、複製されたjQueryオブジェクトjo2を得ています。jo2は4行目でcssメソッドに利用しています。
var jo = jQuery("div"); var jo2 = jQuery(jo); $("button").click(function(){ jo2.css("background-color","#cfc"); })
buttonをクリックするとdiv要素の背景色が変わることから、jo2がjoのコピーであることが確認できます。
→ページ最下段の「個人的なメモ」に追加記事あり。
objectオブジェクトもjQueryオブジェクトに変換
引数にobjectオブジェクトを設定することでjQueryオブジェクトに変換できます。変換後はjQueryデータなのでjQueryのメソッドが利用できます。とはいえ元がシンプルなオブジェクトなので、dataメソッドやpropメソッドくらいしか利用しなさそうです。
サンプル(jquery1/05.html)を開いて以下の部分を確認してください。1行目でobjectオブジェクト「testObj」を作成しています。これを4行目でセレクタとして利用し、propメソッドを利用してクリックされたdivのidと同じ名前のプロパティの値を取り出し、アラートで表示するようにしています。
testObj = {aaa:"my id is aaa", bbb:"my id is bbb"}; $(function () { $("div").click(function(){ var myName = $(testObj).prop(this.id); alert(myName) }); });
html上の複数の要素とデータを紐つけることができるので、何かの役に立ちそうな気がしつつも実用的な例が思い浮かびません。というかサンプルjquery/03.htmlのレベルならjQueryオブジェクトにしなくても同じ事ができますし...。→参考:サンプル(jquery1/05b.html)
testObj = {aaa:"my id is aaa", bbb:"my id is bbb"}; $(function () { $("div").click(function(){ alert(testObj[this.id]); }); });
空のjQueryオブジェクトを作成
引数に何も設定しないと、空のjQueryオブジェクトを返します。ver1.4未満では引数を設定しないとdocumentが返ってきていました。保存したjQueryオブジェクトをリセット(何も選択されていない状態)する時や、変数の初期値として利用するのだと思います。
XMLにも利用可能
本家サイトの「Using DOM elements」の後半部分にXML要素を操作するサンプルがあったのでサンプルを作成しました。サンプル(jquery1/06.html)を開いてbody内にbutton要素とdiv要素があることを確認して下さい。
<button>get</button> <div></div>
jQueryは、まず以下の部分を確認して下さい。buttonをクリックすると$.getメソッドを利用して外部にあるxmlデータ「sample.xml」を読込、読込が完了したらgetFuncを実行するようにしています。
$("button").click(function(){ $.get("../../ajax/data/simple.xml", getFunc); });
getFuncは以下の様に記述され読み込まれたxmlデータ「myXML」にjQueryメソッドを利用しjQueryオブジェクトに変換しています。ですのでトラバースのfindメソッドを利用してnameタグを見つけ、textメソッドを利用してテキスト内容を取得しています。取得した結果はtextメソッドを利用してdiv要素に表示しています。
function getFunc(myXML, myStatus){ var myName = $(myXML).find("name").text(); $("div").text(myName); };
結果として、buttonをクリックするとXMLデータ内にあるnameタグのテキスト情報である「bob」がdiv要素内に表示されます。本家サイトでは以下の様な記述がありトラバースのみ言及されています。しかし、紹介したサンプルのようにtextメソッドなども利用できることから部分的には他のメソッドも利用できそうです。
「XML data returned from an Ajax call can be passed to the $() function so individual elements of the XML structure can be retrieved using .find() and other DOM traversal methods.」
メモ
jQueryの複製って...
jQueryメソッドを利用してjQueryオブジェクトを複製する必要があるということは、jQueryは「値渡し」ではないと思うのです。「値渡し」がよく分からない方はrubyですが、以下の記事が詳しいです
→参考:値渡しと参照渡しの違いを理解する
例えばjavaScriptのObjectオブジェクトは参照の値渡しのため、不慣れな方には不思議な振る舞いをします。サンプル(jquery1/test01.html)を開いてjavaScriptを確認してください。ポイントは以下の4行です。
var myObj = {a:10, b:20, c:30}; var myObj2 = myObj; myObj2.d = 40; alert(myObj.d)
1行目でObjectオブジェクトの「myObj」を作成し、2行目でmyObj2に代入して複製しています。3行目で複製したmyObj2に新たなプロパティd(値は40)を追加しました。最後にアラートでmyObjのプロパティdを表示します。
buttonをクリックすると上記の処理が開始されるので、buttonをクリックするとmyObjのプロパティdを表示されます。ここでよく考えてください。プロパティdを追加したのはmyObj2でありmyObjではありません。にも関わらずmyObj2にもプロパティdが追加されてしまっています。
jQueryオブジェクトもこれと同じ仕様だから、コピーするのにjQueryメソッドを使うのだと思ったのですが、そうではありませんでした。サンプル(jquery1/test02.html)では、以下の様に普通にコピーしたjo2に空のjQueryを代入して要素を消しています。しかしコピー元であるjoの状態は変化しないため、buttonをクリックしても相変わらずdiv要素が着色されます。
var jo = jQuery("div"); var jo2 = jo; jo2 = $(); jo.css("background-color","#cfc");
上記のように、objectオブジェクトと異なりjQueryオブジェクトは代入演算子「=」で複製が作成できるのであれば、jQueryメソッドを利用して複製を必要はないと思うのですが...。他に何か理由があるのでしょうか?
コンテキストを利用することによる高速化
第2引数のコンテキストを「正しく」利用することで、速度を向上できるそうです。
→参考:[斜め読み]Brandon Aaron「誤解されてるjQueryの"Context"」
要はコンテキストはDOM要素で選択すべし!ということでしょうか?。しかし以前に使い方の高速化でサンプルを作成したものの、高速化されないのでボツにしたサンプルがあります。以下がその結果です。複雑な構造の方が差が出ると思ったので、div要素の入れ子をたくさん設定しています。
サンプル「jQuery1/test03.html」→選択対象がid属性:コンテキスト利用せず→結果「20ミリ秒」
サンプル「jQuery1/test03b.html」→選択対象がid属性:コンテキスト利用→結果「36ミリ秒」
コンテキストを利用した方が時間が掛かる結果に...。
サンプル「jQuery1/test04.html」→選択対象がclass属性:コンテキスト利用せず→結果「44ミリ秒」
サンプル「jQuery1/test04b.html」→選択対象がclass属性:コンテキスト利用→結果「44ミリ秒」
変化なしという結果に...。