若你對 Ajax 還不熟,建議先讀〈Ajax 初體驗之上手篇〉再回到這裡。
部落格相當盛行,上網時間稍長的朋友大概都在某處擁有一個屬於自己的部落格。有些朋友喜歡自行下載部落格程式架站,而不使用服務商的現成服務。無奈的是,多數部落格程式的搜尋都是把關鍵字提交到搜尋頁、由後端產生結果頁再呈現給使用者,過程中連側邊欄這種不變的內容也得重傳一次,白白耗掉頻寬。用 Ajax 就能省下這筆浪費。
本教學以 L-Blog 的資料表與頁面命名為例(筆者的部落格正是改自 L-Blog),範例已通過實測,可直接用於 L-Blog 或 FBS,正式上線前再補上美化與細節即可。
資料表 blog_Content 中,日誌 ID 為 log_ID、標題為 log_Title,檢視頁為 blogview.asp,參數為 logID。顯示結果時需要標題與 ID——ID 用來組出檢視連結。
<?xml version="1.0" encoding="utf-8"?>
<blogsearch>
<!-- 每一個 result 就是一個搜尋結果 -->
<result>
<!-- 日誌的 ID -->
<logid>1</logid>
<!-- 日誌的標題 -->
<logtitle>AJAX初體驗之上手篇</logtitle>
</result>
</blogsearch>
約定:搜尋結果為空時,logid 回傳 # 作為記號。
關鍵字以 POST 傳遞:
<!-- #include file="commond.asp" -->
<!-- #include file="include/function.asp" -->
<%
' commond.asp 為資料庫連線檔
' function.asp 中有會用到的函式 CheckStr
Dim Search_Word, XML_Result, rsSearch, sqlSearch
Set rsSearch = Server.CreateObject("ADODB.RecordSet")
' 取得搜尋關鍵字
Search_Word = CheckStr(Trim(Request.Form("searchword")))
' XML 文件頭
XML_Result = "<?xml version=""1.0"" encoding=""utf-8""?><blogsearch>"
IF Search_Word <> Empty Then
' 建立查詢 SQL 語句
sqlSearch = "SELECT log_ID,log_Title,log_Content FROM blog_Content WHERE log_Title LIKE '%" _
& Search_Word & "%' AND log_IsShow=True ORDER BY log_ID DESC"
' 開啟記錄集
rsSearch.open sqlSearch, Conn, 1, 1
' 若無結果,產生一筆 logid 為 # 的結果作為記號
IF rsSearch.BOF AND rsSearch.EOF Then
XML_Result = XML_Result & "<result><logid>#</logid><logtitle /></result>"
End IF
' 迴圈輸出搜尋結果
Do While Not rsSearch.EOF
' 用 CDATA 包住標題,避免特殊字元破壞 XML 結構
XML_Result = XML_Result & "<result><logid>" & rsSearch("log_ID") & "</logid>" _
& "<logtitle><![CDATA[" & rsSearch("log_Title") & "]]></logtitle></result>"
rsSearch.MoveNext
Loop
Else
' 關鍵字為空,同樣回傳無結果
XML_Result = XML_Result & "<result><logid>#</logid><logtitle /></result>"
End IF
XML_Result = XML_Result & "</blogsearch>"
' 設定 MIME Type 為 XML 文件
Response.ContentType = "application/xml"
' 輸出搜尋結果
Response.Write(XML_Result)
%>
<!-- 要用到 JavaScript,外部鏈入 -->
<script type="text/javascript" src="ajaxsearch.js"></script>
<!-- 使用者輸入部分 -->
<div>
<!-- 因為沒有用 form,所以要處理 input 的 keydown 事件,按下 Enter 就搜尋 -->
<input type="text" id="searchword" onkeydown="if(event.keyCode==13) AjaxSearch();" />
<!-- 搜尋按鈕 -->
<input type="button" onclick="AjaxSearch();" value="搜尋" />
</div>
<!-- 搜尋結果顯示部分 -->
<div id="search_result">
<!-- 初始時提示使用者輸入關鍵字 -->
<ul><li>請輸入關鍵字</li></ul>
</div>
第 1 部分,建立 XMLHttpRequest 物件:
var xmlObj = false;
var xmlResult;
try {
xmlObj = new XMLHttpRequest;
}
catch(e) {
try {
xmlObj = new ActiveXObject("MSXML2.XMLHTTP");
}
catch(e2) {
try {
xmlObj = new ActiveXObject("Microsoft.XMLHTTP");
}
catch(e3) {
xmlObj = false;
}
}
}
if (!xmlObj) {
alert("XMLHttpRequest init Failed!");
}
第 2 部分,送出搜尋請求:
function AjaxSearch() {
var searchword;
// 取得關鍵字並做 URL 編碼
searchword = escape(document.getElementById("searchword").value);
if (searchword == "") {
// 關鍵字為空,提示使用者輸入
document.getElementById("search_result").innerHTML = "<ul><li>請輸入關鍵字!</li></ul>";
return;
}
// 給出提示,正在搜尋
document.getElementById("search_result").innerHTML = "<ul><li>正在加載,請稍候</li></ul>";
// 開啟連線,採用 POST
xmlObj.open("POST", "ajaxsearch.asp", true);
// 設定請求標頭,表單內容格式為 URL encoded
xmlObj.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
// 設定完成請求後的回應函式
xmlObj.onreadystatechange = function() {
if (xmlObj.readyState == 4) { // 完成回應
if (xmlObj.status == 200) { // 狀態正常
xmlResult = xmlObj.responseXML;
AjaxShowResult(); // 顯示搜尋結果
}
}
}
// 送出請求,內容為搜尋關鍵字
xmlObj.send("searchword=" + searchword);
}
第 3 部分,顯示結果:
function AjaxShowResult() {
var results, i, strTemp;
// 取得搜尋結果集合
results = xmlResult.getElementsByTagName("result");
// 用無序清單來顯示
strTemp = "<ul>";
// 先判斷是否為空結果
if (results[0].getElementsByTagName("logid")[0].firstChild.data == "#")
// 是空的,顯示沒有符合的結果
strTemp = strTemp + "<li>無搜索結果</li>";
else
// 迴圈輸出每一筆結果
for (i = 0; i < results.length; i++)
strTemp = strTemp + "<li><a href='blogview.asp?logID="
+ results[i].getElementsByTagName("logid")[0].firstChild.data
+ "'>"
+ results[i].getElementsByTagName("logtitle")[0].firstChild.data
+ "</a></li>";
strTemp = strTemp + "</ul>";
// 顯示搜尋結果
document.getElementById("search_result").innerHTML = strTemp;
}
getElementsByTagName 回傳的是集合,取值時務必加上下標,例如 results[0].getElementsByTagName("logid")[0].firstChild.data。document.getElementById() 取物件,不要使用 document.all 這類非標準寫法。至此,一個完整的 Ajax 實例就完成了。三個檔案(ajaxsearch.htm、ajaxsearch.asp、ajaxsearch.js)可打包為 ajaxsearch.rar 一起部署。