級聯下拉選單就是選了第一層之後,第二層的選項內容跟著改變。常見做法有三種:每次選擇都送出表單刷新整頁(體驗最差)、初次載入時把全部選項塞進 JavaScript 陣列(資料量大時首屏很慢),以及用 Ajax 按需載入。第三種效果最好,但 traditional 寫法要處理不少細節。本文用 PHPRPC 來做,程式碼量極少,可重複利用性也很高。
以省市兩級為例,使用 SQLite 這個檔案型資料庫,部署容易、查詢效率高。資料表只有兩個:province 表有 id 與 name(省份編號、省名);city 表有 id、name、pid(城市編號、城市名、所屬省份編號,對應 province 的 id)。
function.php 定義實際的查詢函式,這些函式也可以當成普通的本地函式使用,寫法與一般 PHP 函式沒有任何差別:
<?php
$sqlite = new SQLiteDatabase('area.db');
function get_province() {
global $sqlite;
$sql = "select * from province order by id";
return $sqlite->arrayQuery($sql, SQLITE_ASSOC);
}
function get_city($pid) {
global $sqlite;
$pid = sqlite_escape_string($pid);
$sql = "select * from city where pid = $pid order by id";
return $sqlite->arrayQuery($sql, SQLITE_ASSOC);
}
?>
rpc.php 更短,只負責把函式暴露給客戶端:
<?php
require_once('function.php');
require_once('phprpc_server.php');
new PHPRpc_server(array('get_province', 'get_city'));
?>
最後那行的陣列就是白名單,只有列在裡面的函式客戶端才呼叫得到,這是保護伺服器不被任意呼叫的關鍵。伺服器端的工作就到這裡,它只負責查資料並回傳,其他什麼都不做。
// 建立 PHPRPC 客戶端物件
PHPRpc_client.create('rpc');
var city = []; // 用來快取已載入的城市資料
// 清除 select 的選項(可重複使用)
function clear_select(so) {
for (var i = so.options.length - 1; i > -1; i--) {
// 部分瀏覽器不支援 options 的 remove 方法,但支援 DOM 的 removeChild
if (so.options.remove) {
so.options.remove(i);
} else {
so.removeChild(so.options[i]);
}
}
}
// 設定 select 的選項(可重複使用)
// d: 選項資料陣列 vf: 值的欄位名 tf: 文字的欄位名
function set_select(so, d, vf, tf) {
for (var i = 0, n = d.length; i < n; i++) {
var opt = document.createElement('option');
opt.text = d[i][tf];
opt.value = d[i][vf];
if (so.options.add) {
so.options.add(opt);
} else {
so.appendChild(opt);
}
}
}
// 設定省份下拉選單
function set_province_select(d) {
var so = document.getElementById('province');
set_select(so, d, 'id', 'name');
change_province(1); // 設定首選省份的城市列表
}
// 設定城市下拉選單
function set_city_select(d, vf, tf) {
var so = document.getElementById('city');
clear_select(so);
set_select(so, d, vf, tf);
}
// 省份改變時,同步更新城市列表
function change_province(pid) {
if (city[pid]) {
// 已快取,直接顯示
set_city_select(city[pid], 'id', 'name');
} else {
// 先顯示載入中
set_city_select([['', 'Loading...']], 0, 1);
// 呼叫遠端程序載入城市資料,最後一個參數是回呼函式
rpc.get_city(pid, function (result) {
city[pid] = result; // 寫入快取
set_city_select(result, 'id', 'name'); // 更新列表
});
}
}
// rpc 客戶端初始化完成後執行
rpc.onready = function () {
rpc.get_province(set_province_select);
};
<html> <head> <script type="text/javascript" src="PHPRpc_client.js"></script> <script type="text/javascript" src="area.js"></script> </head> <body> <select id="province" onchange="change_province(this.value)"></select> <select id="city"></select> </body> </html>
這裡引用的是壓縮過的 lite 版用戶端程式庫,省去載入多個 JS 檔的麻煩。