siblings"):not():nth-child():nth-last-child():nth-last-of-type():nth-of-type():odd:only-child:only-of-type:parent:password:radio:reset:root:selected:submit:target:text:visibleTraversing.add().addBack().andSelf().children().closest().contents().each().end().eq().filter().find().first().has().is().last().map().next().nextAll().nextUntil().not().offsetParent().parent().parents().parentsUntil().prev().prevAll().prevUntil().siblings().slice()Utilities$.boxModel$.browser$.contains()$.each()$.extend()$.globalEval()$.grep()$.inArray()$.isArray()$.isEmptyObject()$.isFunction()$.isNumeric()$.isPlainObject()$.isWindow()$.isXMLDoc()$.makeArray()$.map()$.merge()$.noop()$.now()$.parseHTML()$.parseJSON()$.parseXML()$.proxy()$.support$.trim()$.type()$.unique()$.ajax()http://api.jquery.com/jQuery.ajax/Ajaxリクエストを送信するオプションをキーと値のペアで指定します。$.ajaxSetup()を使用します。Ajaxリクエストを送信するURLを指定します。$.ajax(setting)と同じです。この書き方はsettingsのurlを第1引数に指定する書き方です。説明[settings]型:PlainObjectAjaxリクエスト設定のためのキーと値のペアを設定します。全ての設定は任意になります。デフォルトでは$.ajaxSetup()を使用した設定が使用されます。下記は、サーバにユーザー情報をPOST送信し、通信完了時にアラートダイアログを表示する例になります。);});settings引数についてsettings引数は下記のキーと値のペアにより設定します。初期値:DataTypeに依存サーバーにどの種類のレスポンスを返して欲しいのかを伝える、リクエストヘッダー内に指定されるコンテンツタイプです。初期値:trueデフォルトでは、全てのリクエストは非同期です。同期リクエストをする必要があれば、このオプションをfalseにします。"jsonp"のリクエストは、同期操作はサポートされません。同期リクエストは一時的にブラウザをロックし、リクエスト処理中は全てのアクションが無効になることに注意してください。falseの使用は非推奨になりました。jqXHRオブジェクトのメソッドに沿ったsuccess/error/completeのコールバックオプションを使用する必要があります。)送信される直前にjqXHR(jQuery1.4.xではXMLHTTPRequest)オブジェクトの変更が可能な、コールバック関数です。これを使用してカスタマイズヘッダーの設定等を行います。jqXHRとsettingsオブジェクトは引数として渡されます。beforeSend関数からfalseが返されるとリクエストがキャンセルされます。1.5で、beforeSendオプションはリクエストのタイプに関係なく呼び出されるようになりました。cache型:Boolean初期値:true、ただし、dataTypeが'script'または'jsonp'の場合は、falsefalseを設定すると、ブラウザによってリクエストされたページを強制的にキャッシュしないようにします。cacheへのfalse設定は、HEADとGETリクエスト時のみ正しく動作します。これは"_={timestamp}"をGETパラメーターに追加することで動作します。その他のタイプのリクエストでは不要です。)リクエストが完了した際に呼び出される関数です。この関数は2つの引数を受け取ります。2つ目はtextStatusは、リクエストのステータスを分類するための文字列です。各関数は順に呼び出されます。これはAjaxイベントです。文字列/正規表現のオブジェクトのペアとなるオブジェクトです。charset=UTF-8'サーバーへデータが送信される際に、ここで指定されたコンテンツタイプが指定されます。ほとんどのケースは、これで問題ありません。明示的にcontent-typeを$.ajax()へ渡すと、常にそれがサーバーへ送信されます。その他のcharsetをブラウザにエンコーディングを変更させることを強制しません。(翻訳に自信なし)context型:Objectここに指定されたオブジェクトが、全てのAjax関連のコールバックのコンテキストにされます。デフォルトでは、このコンテキストは呼び出し時に使用されるajaxの設定が反映されるオブジェクトになります。($.ajaxSettingsとマージされた設定が、$.ajaxに渡されます。DOMを指定することで、関連するAjaxのコールバック関数全てでthisを指定した際にcontextに指定したDOMが参照されるようになります。例として、contextとして指定されたDOM要素は、下記のようにリクエストの完了コールバック時のコンテキストになります。jQuery.parseXML})dataTypeオプション毎のコンバーターを含むオブジェクトです。各コンバーターの値は、レスポンスの変換された値を返す関数です。通信後の戻り値はこの関数によってそれぞれパース処理されます。この値をtrueに設定します。サーバサイドで別ドメインへリダイレクトされるような場合は、trueを指定します。data型:PlainObjectまたはStringサーバーへ送信するデータです。文字列で無ければ、クエリー文字列に変換されます。これはGETリクエストのURLに追加されます。この自動的に行われるプロセスを防ぎたい場合は、processDataのオプションを参照してください。オブジェクトは、キー/値のペアでなければいけません。値が配列の場合、jQueryは従来の設定の、値をベースとした同じキーを使用した複数の値のシリアライズを行います。ObjectXMLHttpRequestの生のレスポンスデータを扱うのに使用する関数を指定します。サニタイズされたデーターが返されるべきです。2つ目は'dataType'の値になります。typeを元に判別あなたが期待するサーバーから返されるデータの型を指定します。typeを元に推察することを試みます。その他は文字列として返されるようになりました。利用可能な型(そして、successのコールバックへ第1引数として渡される結果)は、下記の通りです。"xml"jQueryを介して処理することが可能なXMLドキュメントが返されます。"html"プレーンテキストとしてのHTMLを返します。含まれるscriptタグはDOMに挿入された際に評価されます。"script"JavaScriptとしてレスポンスを評価し、プレーンテキストとしてそれを返します。URLへクエリー文字列パラメーター"_=[TIMESTAMP]"の追加によるキャッシュの無効化が行われます。注意:クロスドメイン間の送信ではPOST送信は自動的にGET送信に切り替わります。"json"JSONとしてレスポンスを評価し、JavaScriptオブジェクトが返されます。このJSONデータは厳格な作法によってパースされるため、奇形と判断されたJSONは拒絶され、パースエラーがスローされます。サーバーは代わりにnullまたは{}を返す必要があります。json.orgを参照してください。"jsonp"JSONPを使用してJSONブロックを読み込みます。コールバック関数を指定するために、URLの最後に"?callback=?"を追加します。URLへクエリー文字列パラメーター"_=[TIMESTAMP]"の追加によるキャッシュの無効化が行われます。JavaScriptのコールバック関数の実行が出力されます。ランダムな関数名が割り当てられるのは、他のグローバルなJavaScriptの関数名とバッティングしない等の理由が考えられます。"text"プレーンなテキスト文字列です。複数、空白区切りの値jQuery1.5からは、jQueryはContent-Type内で受け取ったdataTypeを、あなたが必要とするものに変換出来るようになりました。xml"を指定します。jQueryにXMLとして解釈させることも可能です。それが失敗するとjsonpからtextへ変換し、次にtextからxmlに変換します。)リクエストが失敗すると呼び出される関数です。任意指定の例外オブジェクトの3つの引数を受け取ります。第2引数に指定される可能のある値は、(nullの他に、)"timeout"、"error"、"abort"、"parsererror"です。HTTPステータスのテキスト部分を受け取ります。jQuery1.5からは、errorの設定は関数の配列を受け取れるようになり、各関数は順に呼び出されます。このハンドラはクロスドメイン・スクリプトとクロスドメイン・JSONPリクエストに対しては呼び出されません。これはAjaxイベントです。初期値:trueこのリクエストがグローバルAjaxイベントハンドラをトリガするか否かを決定します。デフォルトはtrueです。falseに設定すると、ajaxStartやajaxStopのようなグローバルのハンドラがトリガされることを防ぎます。これは、様々なAjaxイベントを制御するのに使用することが可能です。HTTPリクエストのヘッダーのキー/値のペアの追加オブジェクトを指定します。このデフォルトの値をここで変更することが出来てしまいます。beforeSend関数によって上書きすることも可能です。初期値:falsetrueに設定すると、レスポンスが最後のリクエストから変更されている場合のみ、リクエストを成功とみなします。Last-Modifiedヘッダーを確認することで、それが行われます。デフォルトの値はfalseで、ヘッダーの内容は無視されます。1.4で、変更されていないデータの確認のためにサーバによって指定される'etag'も確認するようになりました。現在の環境を"ローカル"である(例えばファイルシステム)と認識することを可能とします。file、*-extension、widgetのプロトコルがローカルであると認識されます。$.ajaxSetup()メソッドでこれを行うことが推奨されています。jsonp型:Stringjsonpリクエストのコールバック関数名を上書きするのに使用されます。この値はURLのクエリー文字列部分'callback=?'の、'callback'の代わりとして使用されます。クエリー文字列は'onJSONPLoad=?'としてサーバーへ渡されることになります。"=?"を変換する試みを止めさせることが出来るようになりました。jsonpCallback設定を明示的に指定する必要があります。');'のようにしてコールバック関数が実行されます。jQuery側では動的にjQuery1234567890という関数が作成されているものと思われます。jsonpCallback型:StringまたはFunction()JSONPリクエストのためのコールバック関数名を指定します。この値はjQueryによって自動的に生成されるランダムなコールバック関数名の代わりに使用されます。通常はjQueryの自動生成に任せることが推奨されています。GETリクエストでブラウザキャッシュを有効にしたい場合に、このコールバック名を指定したいというケースがあります。この関数の戻り値が設定されます。typeを上書きします。password型:StringHTTPアクセスの認証リクエストに応答するXMLHttpRequestに使用されるパスワードを指定します。デフォルトのcontent-typeである"application/x-www-form-urlencoded"に合わせた形式でクエリー文字列へ変換されます。DOMDocument、またはその他の形式のデータを送信したい場合は、このオプションをfalseに設定します。scriptCharset型:String"script"通信での使用時での用途に限られます。scriptタグでのcharset属性の設定は、このリクエストでの指定が使用されます。ローカルページ上で設定された文字コードと、リモートスクリプト上での文字コードが異なる場合に使用します。初期値:{}HTTPコードの数値と、それに相当するコードが応答された際に呼び出される関数のオブジェクト(マップ)を指定します。404を受け取った場合に、alertダイアログを表示したい場合は下記のように指定します。同様に通信が失敗(300番台のリダイレクトも含む)した場合も、errorコールバックと同じ値を引数として受け取ります。)リクエストが成功した祭に呼び出される関数を指定します。この関数は下記の3つの引数を受け取ります。dataサーバが返すデータ(例えば、json値など)をdataTYpeに沿ってフォーマットされた値が格納されています。"parsererror"」のいずれかが指定されます。jqXHRjqXHRオブジェクトです。(jQuery1.4.xまでは、XMLHttpRequestです。)jQuery1.5からは、successの設定は関数の配列が受け取れるようになりました。各関数は順に呼び出されます。このsuccessは、Ajaxイベントです。timeout型:Numberリクエストのタイムアウト(ミリ秒)で設定します。グローバルなタイムアウトを上書きします。送信が行われる前にリクエストがタイムアウトされることもあります。オブジェクトのメンバへアクセスしようとすると、例外がスローされるかもしれません。タイムアウト期限後でもスクリプトが実行されてしまいます。traditional型:Boolean従来のパラメーターのシリアル化を使用したいのであれば、これをtrueに設定します。初期値:'GET'リクエストのタイプ("POST"または"GET")を指定します。全てのブラウザでサポートされている保証がありません。初期値:現在のページリクエストを送信するURLを指定します。username型:StringHTTPアクセスの認証リクエストに応答するXMLHttpRequestに使用されるユーザー名を指定します。xhr型:Function()初期値:IEでこれが利用可能な場合はActiveXObject、それ以外はXMLHttpRequestXMLHttpRequestオブジェクトが生成された際のコールバック関数を指定します。デフォルトは、ActiveXObject(IE)が利用可能であればそれを、それ以外はXMLHttpRequestになります。独自実装のXMLHttpRequestの上書きや、ファクトリーによる拡張が可能です。型:PlainObjectネイティブのXHRオブジェクト上に設定する、フィールド名/フィールド値のペアのオブジェクトを指定します。withCredentialsへtrueを指定することが可能です。これを必要とするCORSリクエストは、このフラグを無視していました。1.5.1以上を使用する事が推奨されています。$.ajax()はjQueryによる全てのAjaxリクエスト処理の基盤となる関数です。代わりとなる高階層の扱い易い関数が用意されています。一般的ではないオプションが必要となるケースで、柔軟に対応出来る$.ajax()を使用します。$.ajax()関数は引数無しで呼び出される事が可能です。設定(settings)には$.ajaxSetup()関数によるグローバルな設定が行われます。この例ではオプションを使用せず、現在のページのコンテンツを読み込みますが、結果に対して何も行いません。得られた結果を使用するには、コールバック関数のいずれかを実装する必要があります。ブラウザネイティブのXMLHttpRequestオブジェクトのスーパーセットです。responseTextとresponseXMLプロパティも含みます。jqXHRオブジェクトは可能であれば、ネイティブのXHRの機能をシミュレートします。1.5.1では、jqXHRオブジェクトはoverrideMimeType()メソッドも含むようになりました。(これはjQuery1.4.xで利用可能でしたが、jQuery1.5で一時的に取り除かれていました。beforeSend()コールバック関数で使用されるかもしれません。$.ajax()によって返されるようになりました。これらのメソッドは、$.ajax()リクエストが終了した際に呼び出される、1つ以上の関数の引数を取得します。リクエストが完了している可能性がある後にでもコールバックを割り当てることが出来ます。(もしリクエストが既に完了している場合、コールバックは即座に実行されます。jqXHRオブジェクトに含まれる利用可能なPromiseメソッドは下記の通りです。.done()メソッドに置き換えられました。実装の詳細については、deferred.done()を参照してください。.fail()メソッドに置き換えられました。実装の詳細については、deferred.fail()を参照してください。.always()メソッドに置き換えられました。data、textStatus、jqXHRオブジェクトになります。jqXHRオブジェクト、textStatus、errorThrownになります。実装の詳細については、deferred.always()を参照してください。(jQuery1.8では)Promiseを基にした柔軟な扱いを可能とします。実装の詳細については、deferred.then()を参照してください。jQury1.8で非推奨になりました。jqXHR.fail()、jqXHR.always()を使用するようにしてください。このリクエストの事をjqXHRオブジェクトは覚えています。その他の処理を実行します...。上記のリクエストに、もう1つの完了時の関数を設定します。設定(settings)で$.ajaxに渡されたcontextオプションのオブジェクトになります。contextが指定されていなければ、thisはAjaxのsettings自体の参照となります。XMLHttpRequestの後方互換のために、jqXHRオブジェクトは下記のプロパティとメソッドを公開します。それぞれのリクエストの応答のxmlと/またはtextに基づきます。古い値を新しいものに置き換えるため、標準からは外れます。done、fail、alwaysとstatusCodeで考えられる必要事項を満たす事が出来るはずです。適切なタイミングで実行されます。先入れ先出し管理のキューとなり、各フックのために1つ以上のコールバックが可能になりました。内部的に実装されているDeferredオブジェクトのメソッドを参照してください。$.ajax()によって提供されるコールバックのフックは、下記の通りです。jqXHRオブジェクトとsettingsオブジェクトをパラメータとして受け取った際に実行されます。errorコールバックオプションは、リクエスト失敗時に実行されます。これは、jqXHR、エラーのタイプを示す文字列、該当する例外オブジェクトを受け取ります。Transport"の文字列を提供します。dataFilterコールバックオプションは、レスポンスデータの受け取りの成功直後に実行されます。successへ渡す(おそらく変更が行われた)データを返さなければいけません。successコールバックオプションは、リクエストが成功すると実行されます。これはサーバーから返されたデータ、成功コードを含む文字列、jqXHRオブジェクトを受け取ります。.done()、.fail()、.always()、.then()は、それぞれ登録された順に実行されます。completeコールバックオプションは、リクエスト完了時に成功か失敗かに関わらず実行されます。これは成功またはエラーのコードを含む文字列だけでなく、jqXHRオブジェクトを受け取ります。異なる種類に変換するためのプリプロセスの処理が行われます。dataTypeオプションを使用することでこれを明示的に設定することが可能です。dataTypeオプションが提供されると、レスポンスのContent-Typeヘッダーは無視されます。json、jsonp、scriptになります。textまたはhtmlが指定された場合は、プリプロセスの処理は実行されません。データは単にsucessのハンドラへ渡され、jqXHRオブジェクトのresponseTextを通して利用されます。XMLDocumentとしてレスポンスが解析されます。XMLドキュメントは、jqXHRオブジェクトのresponseXMLプロパティを通して利用可能になります。オブジェクトとしてレスポンスが解析されます。解析されたJSONオブジェクトは、jqXHRオブジェクトのresponseJSONプロパティを通して利用可能になります。$.ajax()はサーバーから受け取ったJavaScriptを実行します。jsonpが指定された場合、$.ajax()は(デフォルトで)自動的にURLへcallback=?のクエリー文字列パラメーターを追加します。それぞれクエリー文字列パラメーターの名前、JSONPコールバック関数の名前になります。サーバーはJSONレスポンスをコールバック関数へ渡す適切なJavaScriptを返す必要があります。返されたJavaScript(JSONPコールバック関数の呼び出し)を実行します。JSONPを参照してください。サーバへのデータ送信についてデフォルトでは、AjaxリクエストはGETのHTTPメソッドを使用して送信されます。POSTメソッドが必要な場合は、typeオプションの設定の値によって指定することが可能です。このオプションはdataオプションの中身がどのようにサーバーへ送信されるかにも影響します。POSTデータは、W3CのXMLHTTPRequest標準に従い、常にUTF-8の文字セットを使用してサーバーへ運ばれます。'value2'}形式のオブジェクトのどちらかを含む事が出来ます。送信される直前にjQuery.param()を使用してクエリー文字列に変換されます。この処理は、processDataをfalseに設定することで回避することが可能です。この処理は、XMLオブジェクトをサーバーへ送信したい場合には不適切かもしれません。typeに変更してください。リクエストがそれらをトリガする際に、発火することを妨げます。瞬間的且つ頻繁にリクエストが発生してインディケーターが繰り返し表示・非表示をしてしまう事を抑えたいようなケースで便利です。クロスドメイン・スクリプトとJSONPリクエストでは、globalオプションは自動的にfalseに設定されます。これらのメソッドの詳細については、後述します。ユーザー名とパスワードのペアをusernameとpasswordオプションを通して送信することが可能です。Ajaxリクエストは時間制限が掛けられるため、そのエラーをキャッチして、より良いユーザー体験を提供するために扱うことが可能です。グローバルなデフォルト設定が使用されることが一般的です。デフォルトでは、ブラウザは常にリクエストを発行しますが、ブラウザがその結果のキャッシュを提供する事があるかもしれません。このキャッシュされた結果の使用を避けたい場合は、cacheをfalseに設定します。ifModifiedをtrueに設定します。scriptCharsetは、<script>タグで使用される文字コードを明示的に指定することを可能にします。これはスクリプトとホストページの文字セットが異なる場合に便利です。これはその処理は平行に行われ、それは完了することが保証されない事を意味します。これはコードの実行がリクエスト後に続けられる事を示します。ブラウザの反応が悪くなることがあるかもしれないため、推奨されません。$.ajax()関数は、作成したXMLHttpRequestオブジェクトを返します。xhrオプションを使用して、これを作り出すカスタム関数を指定することが可能です。監視用の低階層のインターフェースを提供し、そのリクエストを操作することが出来ます。オブジェクトの.abort()の呼び出しは、そのリクエストが完了する前に中断させることが可能です。Ajaxを柔軟に扱えるような拡張が出来るようになりました。コンバーターの使用$.ajax()コンバーターは、データ(data)のタイプと他のデータ(data)のタイプのマッピングをサポートします。contentsオプションを使用して、そのレスポンスのContent-Typeと実際のデータのタイプが一致するものを追加しなければいけません。これが必要になります。別にパスを通すコンバーターを使用します。}});こうすることで、textからmycustomtypeを通し、次にmycustomtypeからjsonに通すことが出来るようになります。異なるドメイン、サブドメイン、ポートまたはプロトコルからのデータの取得は成功しません。scriptとJSONPリクエストは、"同一生成元ポリシー"の制限を受けません。サンプルサーバへデータを保存し、完了した事をユーザーに通知します。});ページの最新状態を取得し、id="results"要素内に受け取ったHTMLを挿入します。jQueryが自動変換する事を防ぎます。完了するとユーザーへ通知します。リクエストが失敗すると、ユーザーへ警告(alert)します。);});JavaScriptファイルを読み込み、実行します。