作者:Jonathan Fenocchi | 原文發表:2005.10.25 | 中文譯稿:Sheneyan
在 Ajax 出現之前,Web 應用程式的發展一直受到一個限制:只要想拿到新的資料,就必須重新載入整個頁面,或乾脆跳到另一個頁面。當時雖然也有幾種「不換頁」的變通做法,但它們普遍缺乏標準支援,相容性問題與 bug 層出不窮。
而在過去幾個月裡,一項原本乏人問津的技術卻迅速被廣大使用者與開發者接受,它把「頁面可以不重新載入就更新」這件事變成了現實。這類以 JavaScript 非同步取得 XML 資料的應用程式,被親切地稱為 Ajax 應用程式(Asynchronous JavaScript and XML)。
本文會示範如何用 Ajax 取得一個遠端的 XML 檔案,並把內容寫回目前的網頁;後續文章則會談到更多組合方式,協助你把 Web 應用程式帶到另一個層次。
我們先建立名為 data.xml 的檔案。真實專案中的結構會複雜得多,但對教學而言,越簡單越容易看清原理:
<?xml version="1.0" encoding="UTF-8"?>
<root>
<data>這是一些示例數據,它被保存在一個XML文件中,並被JavaScript取回。</data>
</root>
接著建立 ajax.html。這個頁面既是我們的展示場,也是 JavaScript 的落腳處:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
"https://www.w3.org/TR/html4/strict.dtd">
<html lang="zh" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<title>使用ajax開發web應用程序 - 示例</title>
</head>
<body>
<h1>使用ajax開發web應用程序</h1>
<p>這個頁面演示了AJAX技術如何通過動態讀取一個遠程文件來更新一個網頁的內容--不需要任何網頁的重新加載。注意:這個例子對於禁止js的用戶來說沒有效果。</p>
<p id="xmlObj">
這是一些示例數據,它是這個網頁的默認數據
<a href="data.xml" title="查看這個XML數據."
onclick="ajaxRead('data.xml'); this.style.display='none'; return false">查看XML數據.</a>
</p>
</body>
</html>
請留意這個細節:對於停用 JavaScript 的使用者,我們保留了一條直接指向 data.xml 的連結;而對允許執行 JavaScript 的使用者,點擊時會改為執行 ajaxRead(),同時把連結隱藏起來,不再真的跳轉。這是一種稱之為「逐步增強」的寫法,讓功能失效時仍有可用的退路。
此時 ajaxRead 尚未定義,直接測試這段程式碼會得到一個 JavaScript 錯誤。接下來就把函式補上。
把下面的腳本放進 <head> 區塊:
<script type="text/javascript"><!--
function ajaxRead(file){
var xmlObj = null;
if(window.XMLHttpRequest){
xmlObj = new XMLHttpRequest();
} else if(window.ActiveXObject){
xmlObj = new ActiveXObject("Microsoft.XMLHTTP");
} else {
return;
}
xmlObj.onreadystatechange = function(){
if(xmlObj.readyState == 4){
updateObj('xmlObj',
xmlObj.responseXML.getElementsByTagName('data')[0].firstChild.data);
}
}
xmlObj.open('GET', file, true);
xmlObj.send('');
}
function updateObj(obj, data){
document.getElementById(obj).firstChild.data = data;
}
//--></script>
這段程式碼看起來不少,我們逐段拆解。
xmlObj 是使用者正在瀏覽的頁面(Client)與網站伺服器(Server)之間的中介者。由於各家瀏覽器實作的差異,我們必須用條件判斷決定怎麼建立它:
if(window.XMLHttpRequest){
xmlObj = new XMLHttpRequest();
} else if(window.ActiveXObject){
xmlObj = new ActiveXObject("Microsoft.XMLHTTP");
} else {
return;
}
這裡只是在測試哪一種物件可用。若兩者都不存在,就執行 return 提早結束函式,避免拋出腳本錯誤。這段程式碼在絕大多數瀏覽器上都能正常運作,只有少數相當老舊的環境會有例外——它在 IE 5.01 上可以跑,但在 Netscape 4 上會直接讓函式中止。
xmlObj.onreadystatechange = function(){
if(xmlObj.readyState == 4){
updateObj('xmlObj',
xmlObj.responseXML.getElementsByTagName('data')[0].firstChild.data);
}
}
每次 XMLHttpRequest 的狀態改變,onreadystatechange 事件就會被觸發。透過這個事件,我們得以在狀態每次跳動時立刻執行一段程式。readyState 共有五個階段:
第五個狀態(數值 4)正是「資料已經可取用」的訊號,所以我們檢查 readyState 是否等於 4;若是,就呼叫 updateObj。這個函式收兩個參數:目前頁面上要更新的元素 ID,以及用來填入該元素的資料。
我們頁面上的段落元素帶有 id="xmlObj",這就是要更新的目標。資料來自 XML 檔,取值方式稍嫌繁瑣,原理如下:
xmlObj.responseXML 是一個 DOM 物件,非常類似我們熟悉的 document,只不過它來源於遠端的 XML 檔。換句話說,如果你是在 data.xml 裡跑腳本,那麼 xmlObj.responseXML 就相當於一個 document 物件。理解這一點之後,我們就能用 getElementsByTagName 取得任何 XML 節點。
資料包在名為 <data> 的節點裡,所以任務很單純:取出第一個(也是唯一一個)data 節點。
注意:xmlObj.responseXML.getElementsByTagName("data")[0] 回傳的是「節點」,不是節點內的文字。真正的內容必須再往下一層取得,也就是 firstChild.data——firstChild 指向被 <data> 包住的文字節點,而 data 屬性才是那段實際文字。
xmlObj.open('GET', file, true);
xmlObj.send('');
open() 開啟一條通往伺服器的連線:指定協定(這裡是 GET)、要請求的檔案(變數 file 由呼叫時傳入,本例為 data.xml),以及是否以非同步方式處理。既然我們做的是 Asynchronous JavaScript and XML,就採用預設的非同步模式 true;這個例子若改成同步反而無法運作。
最後一行只是送出一個空字串。少了這行,readyState 永遠不會走到 4,頁面也就永遠不會更新。send() 當然能做更多事,但本文只取資料、不送資料,所以不深入談它的細節。
function updateObj(obj, data){
document.getElementById(obj).firstChild.data = data;
}
這個函式用新值更新頁面上指定的元素:第一個參數 obj 是目標元素的 ID,第二個參數 data 是要寫入的內容。實務上比較嚴謹的做法會先確認頁面上真的存在這個 ID,但對這個示範規模而言並非必要。它更新的方式與前面取值的方式如出一則:先定位元素(此處用 ID 代替標籤名與索引),再把它的第一個子節點(文字節點)的 data 屬性設為新值。
如果你想寫入的是 HTML 而非純文字,可以改用:
document.getElementById(obj).innerHTML = data
概念單純,程式碼也不難:你可以從某處讀取一個檔案,而不必重新載入整個網頁。剩下的空間就交給你的想像力了——包括在不換頁的情況下送出表單資料,或搭配伺服器端語言動態產生 XML。想更進一步,官方文件與搜尋引擎會是你最好的朋友。後續文章我會說明如何結合伺服器端技術,用 Ajax 打造更強大的 Web 應用程式。
關於作者:Jonathan Fenocchi 是一名網站開發者,專長於 Web 設計、客戶端腳本與 PHP 程式設計,個人網站為 slightlyremarkable.com。