在 Web 開發裡,分頁是個老到不能再老的話題,卻也永遠有人津津樂道。隨著 XML 的普及,把 XML 拿來做分頁資料源是完全可行的——只是網路上現成的教學往往寫得含糊,看半天還是霧裡看花。乾脆自己動手做一個,也順便整理成可以複習的筆記。
整個範例只需要兩個檔案:tmh.htm 與 tt.XML。前者負責讀取 XML、切割頁次、渲染表格;後者就是純資料。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>XML 分頁範例</title>
<link rel="stylesheet" href="../website.css" type="text/css">
</head>
<body>
<script language="Javascript">
// ************* 變數定義 *************
var pagenum = 4; // 每頁顯示幾筆
var page = 0; // 目前頁碼(從 0 開始)
var BodyText = "";
var xmlDoc = new ActiveXObject("Microsoft.XMLDOM");
var mode = "member"; // 要分頁的節點名稱
XMLDoc.async = "false";
xmlDoc.load("tt.XML");
// ************* 表頭,依實際欄位調整 *************
header = "<table border=1><tr><td>姓名</td><td>帳號</td><td>email</td></tr>";
var maxNum = xmlDoc.getElementsByTagName(mode).length; // 總筆數
var column = xmlDoc.getElementsByTagName(mode).item(0).childNodes; // 每筆的欄位集合
var colNum = column.length; // 欄位數
var pagesNumber = Math.ceil(maxNum / pagenum) - 1; // 最後一頁的索引
// ---------- 上一頁 / 下一頁連結 ----------
function UpPage(page) {
var thePage = "前一頁";
if (page + 1 > 1) thePage = "<a href='#' onclick='Javascript:return UpPageGo()'>前一頁</a>";
return thePage;
}
function NextPage(page) {
var thePage = "後一頁";
if (page < pagesNumber) thePage = "<a href='#' onclick='Javascript:return NextPageGo()'>後一頁</a>";
return thePage;
}
function UpPageGo() {
if (page > 0) page--;
getContent();
BodyText = "";
}
function NextPageGo() {
if (page < pagesNumber) page++;
getContent();
BodyText = "";
}
// ---------- 頁碼資訊 ----------
function currentPage() { return "當前是第 " + (page + 1) + " 頁"; }
function allPage() { return "總共 " + (pagesNumber + 1) + " 頁"; }
// ---------- 頁碼下拉選單 ----------
function selectPage() {
var sp = "<select name='hehe' onChange='Javascript:changePage(this.options[this.selectedIndex].value)'>";
sp = sp + "<option value=''></option>";
for (var t = 0; t <= pagesNumber; t++) {
sp = sp + "<option value='" + t + "'>" + (t + 1) + "</option>";
}
return sp + "</select>";
}
function changePage(tpage) {
page = tpage;
getContent();
BodyText = "";
}
// ---------- 分頁狀態列 ----------
function pageBar(page) {
return UpPage(page) + " " + NextPage(page) + " "
+ currentPage() + " " + allPage() + " " + selectPage();
}
// ---------- 核心:取出目前這一頁的資料 ----------
function getContent() {
if (!page) page = 0;
var n = page * pagenum; // 起始索引
var endNum = (page + 1) * pagenum; // 結束索引
if (endNum > maxNum) endNum = maxNum; // 避免超出總筆數
BodyText = header + BodyText;
for (; n < endNum; n++) {
BodyText = BodyText + "<tr>";
for (var m = 0; m <= colNum - 1; m++) {
var mName = column.item(m).tagName; // 子節點名稱
BodyText = BodyText + ("<td>" + xmlDoc.getElementsByTagName(mName).item(n).text + "</td>");
}
BodyText = BodyText + "</tr>";
}
showHtml.innerHTML = BodyText + "</table>" + pageBar(page);
BodyText = "";
}
</script>
<div id="showHtml"></div>
<script>
if (maxNum == 0) {
document.write("沒有查到符合條件的資料");
} else {
getContent();
}
</script>
</body>
</html>
<?xml version="1.0" encoding="GB2312"?>
<rautinee>
<member id='1'>
<name>海仔</name>
<loginName>rautinee</loginName>
<email>rautinee@btamail.Net.cn</email>
</member>
<member id='2'>
<name>剛強</name>
<loginName>hehe</loginName>
<email>rautinee@chinamanagers.com</email>
</member>
<member id='3'>
<name>金華剛</name>
<loginName>nature_it</loginName>
<email>rautinee_sea@hotmail.com</email>
</member>
<!-- 其餘 member 節點依此格式往下補即可 -->
</rautinee>
整個分頁其實只做三件事:
getElementsByTagName(mode).length 取得總筆數,除以每頁筆數後無條件進位,就是總頁數。if (endNum > maxNum) 把結尾夾住。column.item(m).tagName 取得子節點名稱再取值,最後寫進 showHtml 這個容器。翻頁時只是改變全域變數 page,然後重跑一次 getContent(),完全不必重新向伺服器要資料。
這個範例寫在 IE 全盛時期,因此只支援 IE5.0 以上:它依賴 ActiveXObject("Microsoft.XMLDOM") 與 innerHtml 這種寫法,在非 IE 瀏覽器上不會動。要在今天 reuse,至少得改三處:改用 new DOMParser() 或 XMLHttpRequest 解析 XML、把 innerHTML 拼字串換成 DOM 節點建立、並對節點文字做轉義處理以避免 XSS。邏輯本身仍然值得參考——「先算區間、再取片段」正是所有分頁的共同骨架。