在有限的頁面空間裡塞進大量連結,是網頁設計的經典難題。一次全部攤開,頁面雜亂;藏進好幾層子頁,使用者又找不到。DHtml 提供了一條折衷路:一次點擊就能抵達所有連結,同時把頁面空間留給其他內容。
本文示範一個與 Windows「開始」選單相當類似的選單系統:選單內容由 XML 文件定義,客戶端行為由 DHtml 實作,而 XML 的解析在伺服器端完成,因此使用者瀏覽器是否支援 XML 並不重要。
動態內容在使用者請求時才即時產生;靜態內容則是預先產生並存成檔案,請求時直接送出。如果選單不大、內容也不常變,其實可以選擇靜態方案:先執行一次產生腳本,把輸出的 HTML 存成 include 檔,之後直接引用即可,能省下可觀的伺服器資源。
下載包中提供了兩個版本的伺服器腳本,分別用於動態產生選單與產生靜態選單 HTML。使用靜態版本時,開啟 XMLCreateMenu_Entry.asp,輸入 XML 檔路徑與要輸出的 include 檔路徑,執行後即完成。日後若要改選單,只要改 XML 再重跑一次。要切換成靜態模式,只需把 default.asp 中的 <!--#include file="XMLCreateMenu_Dynamic.asp"--> 換成包含靜態選單檔即可。
用 XML 定義選單有兩個實際理由。第一,選單通常整站共用,需要能快速存取定義資料;XML 檔不需要額外的網路連線,也不必登入資料庫。第二,選單本身就是層級結構,而 XML 天生擅長描述層級關係——這不只讓從屬關係一目了然,也讓後續用遞迴函式解析變得相當容易。
每個選單項由一個 <menuItem> 標籤定義,至少包含兩個子節點:<hyperLink> 是連結目標,<name> 是顯示文字。
<menuItem>
<hyperLink />
<name>娛樂休閒</name>
<menuItem>
<hyperLink>link1.asp</hyperLink>
<name>遊戲</name>
</menuItem>
<menuItem>
<hyperLink>link4.asp</hyperLink>
<name>汽車/摩托車</name>
</menuItem>
</menuItem>
注意第一個 <hyperLink> 沒有內容,因為這個選單項的作用是彈出子選單,本身不指向任何網頁。子節點的定義方式與父節點相同,都使用 <menuItem>,因此這種結構可以一直嵌套下去——但嵌套層次不宜過深,選單的唯一目的是讓存取更方便,而不是更困難。本範例以三層為上限。
取得文件根節點:
var XMLRoot = XMLDoc.documentElement;
接著建立用來描述選單層級的陣列。陣列名稱以 JavaScript 的 eval 動態產生,變數 startMenu 決定選單名稱的基底,客戶端程式碼稍後也會用它來啟動選單。
var image = '<img align="right" vspace="2" height="10" width="10" border="0" src="arrow.gif">';
var currentNode = "", newNode = "", currentMenu = "";
var startMenu = "menu1";
var level = 1;
var arrayHolderArray = new Array();
var arrayNamesArray = new Array();
var tempString = "";
// 陣列名稱 = DIV 名稱 + "_Array"
eval("var " + startMenu + "_Array = new Array()");
for (var i = 0; i < XMLRoot.childNodes.length; i++) {
currentNode = XMLRoot.childNodes.item(i);
if (currentNode.hasChildNodes() == true && currentNode.childNodes.length > 1) {
currentMenu = startMenu + "_" + (i + 1);
thisMenu = startMenu;
if (currentNode.childNodes.length > 2) {
// 有子選單:滑鼠移過時展開
sMenuItem = escape("<span id=\"" + thisMenu + "_span" + (i + 1) +
"\" class='cellOff' onMouseOver=\"stateChange('" + currentMenu +
"',this," + level + ")\" onMouseOut=\"stateChange('',this,'')\">" +
image + currentNode.childNodes.item(1).text + "</span><br>");
eval(startMenu + "_Array[i] = sMenuItem");
walkTree(currentNode);
} else {
// 葉節點:點擊直接跳頁
sMenuItem = escape("<span id=\"" + thisMenu + "_span" + (i + 1) +
"\" class='cellOff' onMouseOver=\"stateChange('',this,'');hideDiv(" + level + ")\" " +
"onMouseOut=\"stateChange('',this,'')\" " +
"onClick=\"location.href='" + currentNode.childNodes.item(0).text + "'\">" +
currentNode.childNodes.item(1).text + "</span><br>");
eval(startMenu + "_Array[i] = sMenuItem");
}
}
}
判斷條件之所以寫成 childNodes.length > 1 而非 = 1,是因為節點中的文字本身也是一個節點,length 值會把它算進去。若用等於 1 來判斷,即使唯一的子節點是文字節點而非元素節點,if 也會成立。
遞迴非常適合處理層級資料,一個簡單的遞迴結構就能應付數量龐大的子選單。
function walkTree(node) {
level += 1;
eval("var " + currentMenu + "_Array = new Array()");
for (var j = 2; j < node.childNodes.length; j++) {
newNode = node.childNodes.item(j);
// 每個節點的 0 是連結、1 是文字,若僅有這些子節點就不必再遞迴
if (newNode.hasChildNodes() == true && newNode.childNodes.length > 2) {
currentMenu = currentMenu + "_" + (j - 1);
thisMenu = currentMenu.substring(0, currentMenu.length - 2);
sMenuItem = escape("<span id=\"" + thisMenu + "_span" + (j - 1) +
"\" class='cellOff' onMouseOver=\"stateChange('" + currentMenu +
"',this," + level + ")\" onMouseOut=\"stateChange('',this,'')\">" +
image + newNode.childNodes.item(1).text + "</span><br>");
eval(thisMenu + "_Array[j - 2] = sMenuItem");
walkTree(newNode);
} else {
sMenuItem = escape("<span id=\"" + currentMenu + "_span" + (j - 1) +
"\" class='cellOff' onMouseOver=\"stateChange('',this,'');hideDiv(" + level + ")\" " +
"onMouseOut=\"stateChange('',this,'')\" " +
"onClick=\"location.href='" + newNode.childNodes.item(0).text + "'\">" +
newNode.childNodes.item(1).text + "</span><br>");
eval(currentMenu + "_Array[j - 2] = sMenuItem");
}
}
arrayNamesArray[arrayNamesArray.length] = currentMenu;
tempString = unescape(eval(currentMenu + "_Array.join('')"));
arrayHolderArray[arrayHolderArray.length] = tempString;
currentMenu = currentMenu.substring(0, currentMenu.length - 2); // 返回上一層
level -= 1;
}
函式每次呼叫自己,都會產生對應的陣列與 sMenuItem。當前選單名稱存在 currentMenu,thisMenu 則保存上一層名稱,客戶端腳本正是靠這個命名約定判斷層級關係。
兩個陣列的分工是:arrayNamesArray 保存各選單(DIV)的名稱,arrayHolderArray 保存要寫進各 DIV 的內容(項目名稱、連結與事件屬性)。
// 反轉陣列以形成正確的 DIV 次序
arrayHolderArray.reverse();
arrayNamesArray.reverse();
for (i = 0; i < arrayNamesArray.length; i++) {
Response.Write("<div id='" + arrayNamesArray[i] + "' class='clsMenu'>");
Response.Write(arrayHolderArray[i]);
Response.Write("</div>\n");
}
為什麼要反轉?因為反轉之後,DIV 在 Z 軸方向上的堆疊次序才會正確:較外層的選單在下、較內層的在上,子選單才不會被父層蓋住。如果不反轉,就會看到子選單被遮住的效果。
輸出的其中一段 DIV 大致如下:
<div id='menu1' class='clsMenu'>
<span id="menu1_span1" class='cellOff'
onMouseOver="stateChange('',this,'');hideDiv(1)"
onMouseOut="stateChange('',this,'')"
onClick="location.href='/default/default.asp'">首頁</span><br>
<span id="menu1_span2" class='cellOff'
onMouseOver="stateChange('menu1_2',this,1)"
onMouseOut="stateChange('',this,'')">
<img align="right" vspace="2" height="10" width="10" border="0" src="arrow.gif">娛樂休閒
</span><br>
</div>
XMLMenuScript.js 包含所有支援客戶端操作的 JavaScript,檔案開頭的變數可以自訂選單項在選取與未選取狀態下的顏色。目前版本要求 IE 4 以上;若要支援 Netscape,這部分需要改寫。
使用者點擊某個連結時選單啟動:
<a id="start" onClick="startIt('menu1',this,0)">
<b><font color="#FFFFFF">網站</font></b>
<img src="arrow.gif" width="20" height="11" border="0" />
</a>
startIt() 有三個參數:選單名稱、連結本身的參照、選單層級(啟動時為 0)。它會先檢查選單是否已啟動,若未啟動則呼叫 stateChange();此外還必須在選單顯示期間隱藏頁面上的 <select> 元素與 Java Applet,否則它們會浮在選單之上。
function stateChange(menu, thisItem, level) {
// menu = 待顯示的選單;thisItem = 當前選單項的 SPAN;level = 嵌套層級
// 滑鼠指向的項目改變時,切換高亮度狀態
if (currentSpanElement != thisItem.id && started != true) {
if (currentSpanElement == "") currentSpanElement = thisItem.id;
eItemOld = eval("document.all('" + currentSpanElement + "')");
eItemNew = eval("document.all('" + thisItem.id + "')");
eParent = eItemNew.parentElement;
eParent.style.background = offCellColor; // DIV 必須設背景色,否則預設透明
eItemOld.style.background = offCellColor; // 取消舊項目的高亮度
eItemOld.style.color = offTextColor;
eItemNew.style.background = onCellColor; // 標示新選取的項目
eItemNew.style.color = onTextColor;
currentSpanElement = thisItem.id;
}
if (menu != "") {
eMenu = eval("document.all('" + menu + "')");
eItem = eval("document.all('" + thisItem.id + "')");
hideDiv(level);
menuArray[menuArray.length] = menu; // 記錄已展開的選單
var positionX = eItem.parentElement.offsetLeft + offsetMenuX + document.body.scrollLeft;
var positionY = eItem.parentElement.offsetTop + eItem.offsetTop + offsetMenuY + document.body.scrollTop;
if (started) {
positionX = clickX + startDistanceX + document.body.scrollLeft;
positionY = clickY + startDistanceY + document.body.scrollTop;
}
// 螢幕寬度不足時左移
if ((positionX + eMenu.offsetWidth) >= document.body.clientWidth) {
positionX -= (eMenu.offsetWidth * 1.3);
positionY += 15;
}
// 位置偏左時右移
if ((positionX + eMenu.offsetWidth) <= eMenu.offsetWidth) {
positionX += (eMenu.offsetWidth * 1.3);
}
// 超出視窗底部時上移,使選單底部與視窗底部對齊
if ((positionY + eMenu.offsetHeight) >= document.body.clientHeight) {
if (started != true) positionY = document.body.clientHeight - eMenu.offsetHeight;
}
eMenu.style.left = positionX;
eMenu.style.top = positionY;
eMenu.style.visibility = 'visible';
}
started = false;
}
這個函式做三件事:切換滑鼠所在項目的高亮度、計算並修正子選單的顯示位置、以及把展開中的選單記進 menuArray 以便後續隱藏。位置計算特意處理了四種邊界狀況(右側溢出、左側溢出、底部溢出、啟動時的初始定位),這是這類浮動選單最容易出問題的地方。
選單的樣式集中在 menuStyle.css,修改該檔即可調整外觀,不必觸碰程式邏輯。