常聽人說「說起來容易做起來難」。Ajax 裡其實沒有什麼新技術,只是思想的轉變與舊技術的重新整合,但真的動手寫,問題還是接二連三。
我平常習慣用火狐,寫完範例一跑卻發現文字沒顯示。一開始找不到原因,後來才想到可能是相容性問題,查了一下果然如此:Firefox 要用 textContent,而 innerText 是 IE 的非標準擴充。
另一個相關的習慣問題是取元素的方式。直接寫 document.getElementById 是 W3C 標準做法,而 IE 早期還支援用 id 當全域變數直接存取。圖一時方便用後者,在 IE 上行得通,換到 Firefox 或其他瀏覽器就未必了。既然標準寫法也不麻煩,就照標準來,可讀性也更好。
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<title>Ajax 的第一個經典例子 Hello World</title>
<script type="text/javascript">
var xmlHttp;
function createXMLHttpRequest(){
if (window.ActiveXObject) {
xmlHttp = new ActiveXObject("Microsoft.XMLHTTP");
} else if (window.XMLHttpRequest) {
xmlHttp = new XMLHttpRequest();
}
}
function startRequest(){
createXMLHttpRequest();
try {
xmlHttp.onreadystatechange = handleStateChange;
xmlHttp.open("GET", "data.xml", true);
xmlHttp.send(null);
} catch (exception) {
alert("您要訪問的資源不存在!");
}
}
function handleStateChange(){
if (xmlHttp.readyState == 4) {
if (xmlHttp.status == 200 || xmlHttp.status == 0) {
// 取得 XML 的 DOM 物件
var xmlDOM = xmlHttp.responseXML;
var root = xmlDOM.documentElement;
try {
// 取得 <info> 節點
var info = root.getElementsByTagName('info');
// 取出文字內容
changeText(info[0].firstChild.nodeValue, 'showText');
// innerHTML 的寫法在各瀏覽器間是一致的
document.getElementById("showTextHTML").innerHTML =
'<strong>' + info[0].firstChild.nodeValue + '</strong>';
} catch (exception) {}
}
}
}
// 相容 IE 與 Firefox 的寫法
function changeText(str, element){
if (navigator.appName.indexOf("Explorer") > -1) {
document.getElementById(element).innerText = str;
} else {
document.getElementById(element).textContent = str;
}
}
</script>
</head>
<body>
<div>
<input type="button" value="return ajax responseXML's value" onclick="startRequest();" />
</div>
<div id="showText"></div>
<div id="showTextHTML"></div>
</body>
</html>
配套的 data.xml 只要有一個根節點與一個 <info> 子節點即可,例如:
<?xml version="1.0" encoding="UTF-8"?>
<root>
<info>Hello World</info>
</root>
為什麼判斷 status == 200 || status == 0。用 file:// 協定直接開啟本機 HTML 檔時,部分瀏覽器不會給 200,而是給 0;把 0 一起納入判斷,本機測試與正式環境都能動。
讀文字節點用 nodeValue 而非 .data。原範例寫的是 info[0].firstChild.data,這在多数瀏覽器上能運作,但 DOM 標準定義的屬性名稱是 nodeValue,用標準名稱較保險。
判斷瀏覽器的方式可以更精準。用 navigator.appName 來分流的年代已經過去,比較好的寫法是直接做特性偵測:
function changeText(str, element){
var el = document.getElementById(element);
if ('textContent' in el) {
el.textContent = str; // 標準做法,現代瀏覽器皆支援
} else {
el.innerText = str; // 舊版 IE 的退路
}
}
兩個空 catch 應該補上處理。原範例中包了 try 卻不做任何事,出錯時畫面會靜靜地什麼都不顯示,除錯時反而更難找。至少該在 catch 中顯示錯誤訊息或寫入 console。
把這個範例跑通之後,再回頭看那些框架的原始碼,會發現它們做的事其實就是 these 幾段的加強版:更完整的狀態判斷、更嚴謹的錯誤處理,以及把相容性細節收進一個乾淨的介面底下。