DIV CSS 佈局教程網

jQuery $.post() 方法的參數說明與完整範例
編輯:JQuery特效代碼     

jQuery 提供了 $.post() 這個語法糖,用 POST 方式發送非同步請求。

jQuery.post(url, [data], [callback], [type])

參數說明

  • url (String):發送請求的位址。
  • data (Map):(選填)要送給伺服器的資料,以 key/value 的鍵值對表示。
  • callback (Function):(選填)載入成功時的回呼函式,只有當回應狀態為 success 時才會被呼叫。
  • type (String):(選填)期望的資料型別,官方文件寫的是「Type of data to be sent」,實際上指的是預期回應的型別,可為 json、xml、html、text、script 等。

一、前端頁面

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Untitled Document</title>
<script type="text/javascript" src="jquery-1.3.2.js"></script>
<script language="javascript">
  function checkemail() {
    if ($('#email').val() == "") {
      $('#msg').html("please enter the email!");
      $('#email').focus();
      return false;
    }
    if ($('#address').val() == "") {
      $('#msg').html("please enter the address!");
      $('#address').focus();
      return false;
    }
    ajax_post();
  }

  function ajax_post() {
    $.post("action.php",
      { email: $('#email').val(), address: $('#address').val() },
      function (data) {
        $('#msg').html(data);
      },
      "text"   // 回應型別可為 json、html、xml、text
    );
  }
</script>
</head>
<body>
<form id="ajaxform" name="ajaxform" method="post" action="action.php">
  <p>email<input type="text" name="email" id="email" /></p>
  <p>address<input type="text" name="address" id="address" /></p>
  <p id="msg"></p>
  <p><input name="Submit" type="button" value="submit" onclick="return checkemail()" /></p>
</form>
</body>
</html>

二、後端 action.php

<?php
$email = $_POST["email"];
$address = $_POST["address"];

echo "success";
?>

一個容易混淆的關鍵點

注意按鈕的 type 是 button 而非 submit。差別在於:

  • type="submit":按下時瀏覽器會直接把表單資料以 POST 送到 action 指定的頁面,整個頁面跳轉。
  • type="button" + $.post():按下時只觸發 JS 函式,由 ajax_post() 在背景以 POST 送出資料,頁面不跳轉。

這正是「 Ajax 」與「傳統表單提交」在行為上的分野。

幾個實務補充

  • 回呼函式的簽名可擴充為 function(data, textStatus, jqXHR),能取得狀態文字與 XHR 物件。
  • 需要錯誤處理時,改用 $.post(...).fail(function (xhr, status, err) { ... }),或在 $.ajaxSetup 中設定全域的 error。
  • PHP 端收到資料後,若有輸出到 HTML,記得用 htmlspecialchars() 轉義,避免 XSS。
  • 範例中的 jQuery 1.3.2 已非常老舊,新專案請使用目前維護中的版本。

理解 $.post() 之後,$.get() 的用法完全相同,只是把方法名換掉即可。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved