DIV CSS 佈局教程網

原生 JS + JSON:員工查詢與新增的完整 AJAX 範例
編輯:AJAX基礎知識     

環境準備

1. 安裝 WAMPServer 或 phpStudy 這類整合環境,本文使用 phpStudy。
2. HTML、JS、CSS 檔案要放在 phpStudy 的 WWW 目錄下,預設會執行 index 頁面。
3. 樣式使用 Bootstrap。

phpStudy 用起來很方便。如果電腦沒裝過 PHP,記得先把系統環境變數設定好,把 php.exe(在 phpStudy 安裝目錄裡)的路徑加進 PATH,然後在命令提示字元輸入 php -v,看到版本資訊就代表安裝成功。

接著在 WWW 資料夾下新增一個專案,這裡取名為 AjaxDemo。

index.html

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>員工管理</title>
<link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" />
<style>
.container { width: 50%; margin-top: 30px; }
.text-danger { margin-top: 6px; }
</style>
</head>
<body>
<div class="container">
  <div class="panel panel-default">
    <div class="panel-heading"><div class="panel-title">員工查詢</div></div>
    <div class="panel-body">
      <div class="form-horizontal">
        <div class="form-group">
          <label class="col-md-2 control-label">員工編號:</label>
          <div class="col-md-8"><input type="text" class="form-control" id="keyword"></div>
          <div class="col-md-1"><button class="btn btn-primary" id="search">查詢</button></div>
        </div>
        <div class="form-group">
          <label class="col-md-2 control-label">查詢結果:</label>
          <p class="text-danger col-md-8" id="searchResult"></p>
        </div>
      </div>
    </div>
  </div>
</div>

<div class="container">
  <div class="panel panel-default">
    <div class="panel-heading"><div class="panel-title">員工新增</div></div>
    <div class="panel-body">
      <div class="form-horizontal">
        <div class="form-group">
          <label class="col-md-2 control-label">員工編號:</label>
          <div class="col-md-8"><input type="text" class="form-control" id="add-number"></div>
        </div>
        <div class="form-group">
          <label class="col-md-2 control-label">員工姓名:</label>
          <div class="col-md-8"><input type="text" class="form-control" id="add-name"></div>
        </div>
        <div class="form-group">
          <label class="col-md-2 control-label">員工性別:</label>
          <div class="col-md-8"><input type="text" class="form-control" id="add-sex"></div>
        </div>
        <div class="form-group">
          <label class="col-md-2 control-label">員工職位:</label>
          <div class="col-md-8"><input type="text" class="form-control" id="add-job"></div>
        </div>
        <div class="form-group">
          <div class="col-md-offset-2 col-md-1">
            <button class="btn btn-primary" id="add-search">增加員工</button>
          </div>
        </div>
        <div class="form-group">
          <label class="col-md-2 control-label">結果:</label>
          <p class="text-danger col-md-8" id="add-resultshow"></p>
        </div>
      </div>
    </div>
  </div>
</div>

<script src="staffManage.js"></script>
</body>
</html>

建立 XMLHttpRequest 的五個步驟

1. new 一個 XMLHttpRequest 物件(記得處理舊版 IE)

var xhr;
if (window.XMLHttpRequest) {
    xhr = new XMLHttpRequest();
} else {
    xhr = new ActiveXObject('Microsoft.XMLHTTP');
}

2. 呼叫 open(method, url, asyn) 三個參數分別是請求方法、網址、是否異步(預設 true,可省略)。

3. 若為 POST,加上請求標頭

xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

4. 呼叫 send() 真正送出請求。GET 不帶參數,POST 則把 body 以字串或 FormData 傳入。

5. 設定 onreadystatechange,並由 responseText 取出回應

staffManage.js

// 查詢員工
var oKeyword  = document.getElementById('keyword'),
    oSearchBtn = document.getElementById('search'),
    oSearchRes = document.getElementById('searchResult');

oSearchBtn.onclick = function () {
    searchStaff();
};

function searchStaff() {
    var xhr;
    if (window.XMLHttpRequest) {
        xhr = new XMLHttpRequest();
    } else {
        xhr = new ActiveXObject('Microsoft.XMLHTTP');
    }

    xhr.open('GET', 'serverjson.php?number=' + oKeyword.value);
    xhr.send();

    // onreadystatechange 要在 send 之後設定
    xhr.onreadystatechange = function () {
        if (xhr.readyState == 4) {
            if (xhr.status === 200) {          // 注意這裡是比較運算子
                var data = JSON.parse(xhr.responseText);
                oSearchRes.innerHTML = data.msg;
            }
        }
    };
}

// 新增員工
var oAddnumber  = document.getElementById('add-number'),
    oAddname    = document.getElementById('add-name'),
    oAddsex     = document.getElementById('add-sex'),
    oAddjob     = document.getElementById('add-job'),
    oAddSearch  = document.getElementById('add-search'),
    oAddResult  = document.getElementById('add-resultshow');

oAddSearch.onclick = function () {
    createStaff();
};

function createStaff() {
    var xhr;
    if (window.XMLHttpRequest) {
        xhr = new XMLHttpRequest();
    } else {
        xhr = new ActiveXObject('Microsoft.XMLHTTP');
    }

    xhr.open('POST', 'serverjson.php');

    // 等號兩側不要留空格,否則後端會收到錯誤的值
    var data = 'name='   + oAddname.value
             + '&number=' + oAddnumber.value
             + '&sex='    + oAddsex.value
             + '&job='    + oAddjob.value;

    // Content-Type 必須在 open 之後、send 之前設定
    xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
    xhr.send(data);

    xhr.onreadystatechange = function () {
        if (xhr.readyState == 4) {
            if (xhr.status === 200) {
                var data = JSON.parse(xhr.responseText);
                if (data.success) {
                    oAddResult.innerHTML = data.msg;
                } else {
                    oAddResult.innerHTML = '出現錯誤:' + data.msg;
                }
            } else {
                alert('發生錯誤!' + xhr.status);
            }
        }
    };
}

serverjson.php

<?php
// 明確告訴瀏覽器回應的型別與編碼
header("Content-Type: application/json;charset=utf-8");

$staff = array(
    array("name" => "洪七", "number" => "101", "sex" => "男", "job" => "總經理"),
    array("name" => "郭靖", "number" => "102", "sex" => "男", "job" => "開發工程師"),
    array("name" => "黃蓉", "number" => "103", "sex" => "女", "job" => "產品經理")
);

// $_SERVER 是超全域變數,任何作用域都能直接取用
if ($_SERVER["REQUEST_METHOD"] == "GET") {
    search();
} elseif ($_SERVER["REQUEST_METHOD"] == "POST") {
    create();
}

// 依員工編號搜尋
function search() {
    // isset 判斷變數是否存在,empty 判斷是否為空
    if (!isset($_GET["number"]) || empty($_GET["number"])) {
        echo '{"success":false,"msg":"參數錯誤"}';
        return;
    }

    global $staff;   // 函式外宣告的變數要用 global 才能讀取
    $number = $_GET["number"];
    $result = '{"success":false,"msg":"沒有找到員工。"}';

    foreach ($staff as $value) {
        if ($value["number"] == $number) {
            $result = '{"success":true,"msg":"找到員工:編號 '
                    . $value["number"]
                    . ',姓名 ' . $value["name"]
                    . ',性別 ' . $value["sex"]
                    . ',職位 ' . $value["job"] . '"}';
            break;
        }
    }
    echo $result;
}

// 新增員工
function create() {
    if (!isset($_POST["name"])   || empty($_POST["name"])
     || !isset($_POST["number"]) || empty($_POST["number"])
     || !isset($_POST["sex"])    || empty($_POST["sex"])
     || !isset($_POST["job"])    || empty($_POST["job"])) {
        echo '{"success":false,"msg":"參數錯誤,員工資訊填寫不全"}';
        return;
    }

    // TODO: 實際寫入資料庫
    echo '{"success":true,"msg":"員工:' . $_POST["name"] . ' 資訊儲存成功!"}';
}
?>

流程總結

整體流程就是:使用者操作 → JS 建立 xhr → open 設定目標 → send 送出 → 監聽 readyState 與 status → 解析 JSON → 更新畫面。把這條鏈路走順,原生 AJAX 就不再需要死背。

相較於原始寫法,這裡修正了兩個常見的複製錯誤:if (xhr.status = 200) 是把比較寫成了指派(永遠為真),應為 ===;以及 POST 參數組字串時等號兩側不可有空格。

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