jquery の ajax メソッドのパラメーター属性と関数: 1. options 属性、ajax リクエストの設定に使用されます; 2. async、デフォルトは非同期リクエストであり、false に設定すると同期リクエストになります; 3. キャッシュ、使用 キャッシュ インターフェイスの設定に使用; 4. データ、サーバーに送信されるデータの設定に使用; 5. グローバル、ローカル Ajax イベントをトリガーするかどうかの設定に使用; 6. パスワード、 HTTPアクセス認証要求時のパスワードなど
このチュートリアルの動作環境: Windows10 システム、jquery3.6.0 バージョン、Dell G3 コンピューター。
ajax() メソッドは、HTTP リクエストを通じてリモート データを読み込みます。
このメソッドは、jQuery の基礎となる AJAX 実装です。シンプルで使いやすい高レベルの実装については、$.get、$.post などを参照してください。 $.ajax() は、作成した XMLHttpRequest オブジェクトを返します。ほとんどの場合、柔軟性を高めるためにあまり使用されないオプションを操作する必要がない限り、この関数を直接操作する必要はありません。
最も単純なケースでは、$.ajax() をパラメーターなしで直接使用できます。
注: すべてのオプションは、$.ajaxSetup() 関数を通じてグローバルに設定できます。
構文
jQuery.ajax([settings])
設定
オプション。 Ajax リクエストの構成に使用されるキーと値のペアのコレクション。
$.ajaxSetup()
options
Type: Object を通じてオプションのデフォルト値を設定できます。
オプション。 AJAXリクエストの設定。すべてのオプションはオプションです。
async
タイプ: ブール値
デフォルト値: true。デフォルトでは、すべてのリクエストは非同期です。同期リクエストを送信する必要がある場合は、このオプションを false に設定します。
同期リクエストはブラウザをロックするため、他のユーザー操作はリクエストが完了するまで待ってから実行する必要があることに注意してください。
beforeSend(XHR)
タイプ: Function
カスタム HTTP の追加など、リクエストを送信する前に XMLHttpRequest オブジェクトを変更できる関数ヘッダ。
XMLHttpRequest オブジェクトが唯一のパラメータです。
これは Ajax イベントです。 false が返された場合、この ajax リクエストはキャンセルできます。
cache
タイプ: Boolean
デフォルト値: true、dataType が script および jsonp の場合、デフォルトは false です。このページをキャッシュしない場合は false に設定します。
jQuery 1.2 の新機能。
complete(XHR, TS)
タイプ: Function
リクエスト完了後のコールバック関数 (リクエストが成功または失敗した後に呼び出されます) 。
パラメータ: XMLHttpRequest オブジェクトとリクエストの種類を説明する文字列。
これは Ajax イベントです。
contentType
タイプ: 文字列
デフォルト値: "application/x-www-form-urlencoded"。サーバーに情報を送信するときのコンテンツのエンコード タイプ。
デフォルト値はほとんどの状況に適しています。 content-type を $.ajax() に明示的に渡すと、(送信するデータがない場合でも) 確実にサーバーに送信されます。
context
Type: Object
このオブジェクトは、Ajax 関連のコールバック関数のコンテキストを設定するために使用されます。つまり、コールバック関数の this がこのオブジェクトを指すようにします (このパラメーターが設定されていない場合、この AJAX リクエストを呼び出すときに渡されるオプション パラメーターを指します)。たとえば、コンテキスト パラメーターとして DOM 要素を指定すると、成功コールバック関数のコンテキストがこの DOM 要素に設定されます。
次のようになります:
$.ajax({ url: "test.html", context: document.body, success: function(){ $(this).addClass("done"); }});
data
タイプ: String
サーバーに送信されるデータ。リクエスト文字列形式に自動的に変換されます。 GET リクエストの URL に追加されます。この自動変換を無効にするには、processData オプションの説明を参照してください。キー/値形式である必要があります。配列の場合、jQuery は異なる値に同じ名前を自動的に割り当てます。たとえば、{foo:["bar1", "bar2"]} は '&foo=bar1&foo=bar2' に変換されます。
dataFilter
タイプ: Function
Ajax から返された元のデータを前処理するための関数。 data と type の 2 つのパラメータを指定します。data は Ajax によって返される元のデータで、type は jQuery.ajax を呼び出すときに提供される dataType パラメータです。関数によって返された値は、jQuery によってさらに処理されます。
dataType
Type: String
サーバーから返される予期されるデータ型。指定しない場合、jQuery は HTTP パッケージの MIME 情報に基づいて自動的にインテリジェントな判断を行います (たとえば、XML の MIME タイプは XML として認識されます)。 1.4 では、JSON が JavaScript オブジェクトを生成し、script がスクリプトを実行します。サーバーから返されたデータは、この値に基づいて解析され、コールバック関数に渡されます。使用可能な値:
"xml": jQuery で処理できる XML ドキュメントを返します。
"html": プレーン テキストの HTML 情報を返します。含まれているスクリプト タグは、DOM に挿入されると実行されます。
"script": プレーンテキストの JavaScript コードを返します。結果は自動的にキャッシュされません。 「キャッシュ」パラメータが設定されていない限り。注: リモート要求 (同じドメインの下ではない) を行う場合、すべての POST 要求は GET 要求に変換されます。 (読み込みにDOMスクリプトタグを使用するため)
"json": JSONデータを返します。
"jsonp": JSONP 形式。 「myurl?callback=?」などの JSONP 形式を使用して関数を呼び出すと、jQuery は ? を正しい関数名に自動的に置き換えて、コールバック関数を実行します。
"text": 平文文字列を返す
error
型: 関数
デフォルト値: 自動判定(xmlまたはhtml)。この関数は、リクエストが失敗したときに呼び出されます。
には、XMLHttpRequest オブジェクト、エラー メッセージ、(オプション) キャプチャされた例外オブジェクトの 3 つのパラメータがあります。
エラーが発生した場合、エラー メッセージ (2 番目のパラメーター) には、null に加えて、「timeout」、「error」、「notmodified」、および「parsererror」が含まれる場合があります。
これは Ajax イベントです。
global
Type: Boolean
グローバル AJAX イベントをトリガーするかどうか。デフォルト値: true。 false に設定すると、さまざまな Ajax イベントの制御に使用できる ajaxStart や ajaxStop などのグローバル AJAX イベントはトリガーされません。
ifModified
Type: Boolean
サーバー データが変更された場合にのみ新しいデータを取得します。デフォルト値: false。 HTTP パケットの Last-Modified ヘッダー情報を使用して決定します。 jQuery 1.4 では、サーバー指定の「etag」もチェックして、データが変更されていないことを確認します。
jsonp
Type: String
jsonp リクエスト内のコールバック関数の名前をオーバーライドします。この値は、{jsonp:'onJsonPLoad'} などの GET または POST リクエストの URL パラメーターの「コールバック」部分を置き換えるために使用され、「onJsonPLoad=?」がサーバーに渡されます。
jsonpCallback
Type: String
jsonp リクエストのコールバック関数名を指定します。この値は、jQuery によって自動的に生成されるランダムな関数名の代わりに使用されます。これは主に、jQuery が一意の関数名を生成できるようにして、リクエストの管理やコールバック関数とエラー処理の提供を容易にするために使用されます。ブラウザで GET リクエストをキャッシュする場合は、このコールバック関数名を指定することもできます。
password
タイプ: 文字列
HTTP アクセス認証リクエストに応答するために使用されるパスワード
processData
タイプ: ブール値
デフォルト値: true。デフォルトでは、data オプションを通じて渡されたデータは、それがオブジェクトである場合 (技術的に言えば、文字列でない限り)、デフォルトのコンテンツ タイプ「application/x」に一致するように処理され、クエリ文字列に変換されます。 -www-form-urlencoded" "。 DOM ツリー情報または変換したくないその他の情報を送信する場合は、false に設定します。
scriptCharset
Type: String
リクエスト時のdataTypeが「jsonp」または「script」で、タイプが「GET」の場合のみ文字セットを強制的に変更するために使用されます。通常、ローカルとリモートのコンテンツのエンコーディングが異なる場合にのみ使用されます。
success
タイプ: 関数
リクエストが完了した後のコールバック関数。
パラメータは、サーバーから返され、dataType パラメータに従って処理されるデータであり、ステータスを説明する文字列です。
これは Ajax イベントです。
traditional
型: ブール値
従来の方法でデータをシリアル化する場合は、true に設定します。 「ツール」カテゴリの「jQuery.param」メソッドを参照してください。
timeout
Type: Number
リクエストのタイムアウト (ミリ秒) を設定します。この設定はグローバル設定をオーバーライドします。
type
タイプ: String
デフォルト値: "GET")。リクエストメソッド (「POST」または「GET」)、デフォルトは「GET」です。注: PUT や DELETE などの他の HTTP リクエスト メソッドも使用できますが、一部のブラウザでのみサポートされます。
url
タイプ: 文字列
デフォルト値: 現在のページのアドレス。リクエストの送信先のアドレス。
username
Type: String
HTTP アクセス認証リクエストに応答するために使用されるユーザー名。
xhr
タイプ: 関数
XMLHttpRequest オブジェクトを返す必要があります。デフォルトは、IE の場合は ActiveXObject、それ以外の場合は XMLHttpRequest です。拡張された XMLHttpRequest オブジェクトをオーバーライドまたは提供するために使用されます。このパラメーターは、jQuery 1.3 より前では使用できませんでした。
ビデオ チュートリアルの推奨: jQuery ビデオ チュートリアル
以上がjqueryのajaxメソッドのパラメータ属性と機能は何ですかの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。