jQuery post() メソッド

❮ jQuery AJAX メソッド

例 1

HTTP POST リクエストを使用し、サーバからデータをロードする：

$("button").click(function(){
    $.post("demo_test.html", function(data, status){
        alert("Data: " + data + "\nStatus: " + status);
    });
});
Try it Yourself »

例 2

HTTP POST リクエストを使用し、<div> 要素のテキストを変更する：

$("input").keyup(function(){
    var txt = $("input").val();
    $.post("demo_ajax_gethint.html", {suggest: txt}, function(result){
        $("span").html(result);
    });
});
Try it Yourself »

定義と用法

$.post() メソッドは、HTTP POST リクエストを使用しサーバからデータをロードします。

構文

$(selector).post(URL,data,function(data,status,xhr),dataType)

パラメータ 説明
URL 必須。リクエストを送信する url を指定する
data 任意。リクエストと一緒にサーバに送信するデータを指定
function(data,status,xhr) 任意。リクエストが成功した場合に実行する関数を指定する
追加パラメータ：
  • data - リクエストの結果のデータが含まれる
  • status - リクエストのステータスが含まれる（"success"、"notmodified"、"error"、"timeout"、"parsererror"）
  • xhr - XMLHttpRequest オブジェクトを含む
dataType 任意。サーバからの応答で期待するデータ・タイプを指定する。
デフォルトは、jQuery が自動的に推測する。
指定可能なタイプ：
  • "xml" - XML 文書
  • "html" - プレーンテキストとしての HTML
  • "text" - プレーンテキスト文字列g
  • "script" - JavaScript としてレスポンスを実行し、プレーンテキストとして返す
  • "json" - JSONとしてレスポンスを実行し、JavaScriptオブジェクトを返す
  • "jsonp" - JSONPを使用してJSONブロックにロードする。コールバックを指定するため、URL へ "?callback=?" が追加される

❮ jQuery AJAX メソッド