RSS 聚合器是 Ajax 相當合適的入門題目:資料格式固定(XML)、需要解析多個節點、還牽涉到載入狀態與瀏覽器回退按鈕的處理。本文的範例以純 JavaScript 實作,不依賴任何框架。
程式碼分為幾個區塊:DOM 取用與樣式控制、RSS 來源對照表、XMLHttpRequest 建立與請求、狀態回呼、XML 解析與列表渲染,以及利用隱藏 IFRAME 實作的瀏覽器歷史記錄機制。
// 控制 ID
function getId(objId) {
return document.getElementById(objId);
}
// 側邊欄控制
function closebar(targetid, objId) {
if (document.getElementById) {
target = getId(targetid);
objsty = getId(objId);
if (target.style.display == "none") {
target.style.display = "";
main.style.width = "800px";
objsty.innerHTML = "關閉側邊欄";
} else {
target.style.display = "none";
main.style.width = "100%";
objsty.innerHTML = "開啟側邊欄";
}
}
}
// 載入變灰
function listen(a) { getId("prolist").className = a; }
function btnSty(objId, objStyle) { getId(objId).style.display = objStyle; }
// 提示視窗控制
function ifodis() { btnSty("loadifo", "none"); }
function settime(a) { setTimeout(a, 1000); }
function loadtime() { getId("loadifo").innerHTML += "."; }
用一個 switch 把簡短的代稱映射為實際的 feed 網址,呼叫端只需傳入代稱:
function urlArrary(urlName) {
switch (urlName) {
case "clear": return "https://www.cnrui.cn/blog/feed.asp";
case "a-fei": return "https://www.a-fei.net/blog/rss.xml";
case "ryanxia": return "https://www.ryanxia.com/blog/feedrss2.asp";
case "awflasher": return "https://www.awflasher.com/blog/feed.asp";
case "seles": return "https://www.cnrui.cn/seles/feedrss2.asp";
case "wawa": return "https://a-fei.net/wawa/blog/rss2.php";
case "dreammx": return "https://www.dreammx.com/xhyl/feed.asp";
default: return false;
}
}
進入函式先更新 hash(供瀏覽器歷史機制使用),再寫入 IFRAME 記錄狀態,最後才發起 Ajax 請求:
function ent(urlName) {
window.location.hash = urlName;
var frmUrl = saveState(urlName); // 寫入信息到 iframe
var gamestart = loadrss(urlName); // Ajax 數據過程
}
var xmldoc = false;
function loadrss(urlName) {
var myurl = urlArrary(urlName);
if (myurl) {
listen("mainbg2");
// 生成隨機數,同時限制刷新次數
var Num = Math.floor(Math.random() * 100);
url = myurl + "?id=" + Num;
xmldoc = false;
// Mozilla、Safari 等瀏覽器
if (window.XMLHttpRequest) {
xmldoc = new XMLHttpRequest();
if (xmldoc.overrideMimeType) {
xmldoc.overrideMimeType('text/xml');
}
}
// IE 瀏覽器:逐層降級嘗試
else if (window.ActiveXObject) {
try {
xmldoc = new ActiveXObject("Msxml3.XMLHTTP");
} catch (e) {
try {
xmldoc = new ActiveXObject("Msxml2.XMLHTTP");
} catch (e) {
try {
xmldoc = new ActiveXObject("Microsoft.XMLHTTP");
} catch (e) { }
}
}
}
// 不能建立物件時直接返回
if (!xmldoc) { return false; }
xmldoc.onreadystatechange = CheckState;
xmldoc.open('GET', url, true);
xmldoc.send(null);
} else {
getId("listnum").innerHTML = "您輸入的地址錯誤,請重試!";
}
}
這裡有兩個值得注意的細節:一是用 overrideMimeType('text/xml') 明確要求以 XML 解析回應,避免瀏覽器依 Content-Type 猜測而導致 responseXML 為 null;二是網址後附加隨機數,同時兼顧了防快取與限制重複刷新。
function CheckState() {
var response = xmldoc.responseXML.documentElement;
btnSty("loadifo", "block");
if (xmldoc.readyState == 1) {
getId("loadifo").innerHTML = "連接服務器";
} else if (xmldoc.readyState == 2) {
getId("loadifo").innerHTML = "開始加載數據";
} else if (xmldoc.readyState == 3) {
getId("loadifo").innerHTML = "正在加載數據";
settime(loadtime);
} else if (xmldoc.readyState == 4) {
if (xmldoc.status == 200) {
getId("loadifo").innerHTML = "加載完成";
settime(ifodis);
num(response);
} else {
getId("loadifo").innerHTML = "錯誤" + xmldoc.status + "點這裡刷新";
}
}
}
把 readyState 的四個階段各自對應一句提示文字,第 3 階段還會啟動一秒一次的定時器持續追加句點,讓「正在讀取」這件事在視覺上活起來。這種做法比單純顯示一個轉圈圈動圖更容易讓使用者理解目前進度。
不同網站的 RSS 欄位名稱並不統一,有的用 dc:creator,有的用 author;有的有 pubDate,有的沒有。與其在每個地方寫 if-else,不如包一個容錯函式,讓它依序嘗試多個候選節點,全部落空時回傳預設文字:
function trydata(nodeName, nodeName2) {
try {
var nodeV = nodeName.firstChild.nodeValue;
} catch (e) {
try {
var nodeV = nodeName2.firstChild.nodeValue;
} catch (e) {
var nodeV = "沒有可用信息";
}
}
return nodeV;
}
function num(b) {
try {
var titleNode = b.selectNodes("//rss/channel/title");
var a = b.getElementsByTagName("item").length;
titleV = trydata(titleNode(0));
getId("listnum").innerHTML = "共有" + a + "篇文章 來源於:" + titleV;
setlist(a, b);
} catch (e) { }
}
setlist() 則先以 selectNodes 一次抓出所有需要的節點集合(標題、連結、分類、作者、時間、摘要,以及 Dublin Core 的 dc:subject/dc:creator/dc:date 作為後備),再用迴圈逐筆組出 HTML 字串,最後一次寫入容器:
function setlist(a, b) {
var adminlinkNode = b.selectNodes("//rss/channel/link");
var titleNode = b.selectNodes("//rss/channel/item/title");
var linkNode = b.selectNodes("//rss/channel/item/link");
var categoryNode = b.selectNodes("//rss/channel/item/category");
var authorNode = b.selectNodes("//rss/channel/item/author");
var pubDateNode = b.selectNodes("//rss/channel/item/pubDate");
var descriptionNode = b.selectNodes("//rss/channel/item/description");
var category2sNode = b.selectNodes("//rss/channel/item/dc:subject");
var author2sNode = b.selectNodes("//rss/channel/item/dc:creator");
var pubDate2sNode = b.selectNodes("//rss/channel/item/dc:date");
var listchar = "";
for (i = 0; i < a; i++) {
titleV = trydata(titleNode(i));
linkV = trydata(linkNode(i));
categoryV = trydata(categoryNode(i), category2sNode(i));
authorV = trydata(authorNode(i), author2sNode(i));
pubDateV = trydata(pubDateNode(i), pubDate2sNode(i));
descriptionV = trydata(descriptionNode(i));
adminlinkV = trydata(adminlinkNode(0));
listchar += "<h5><a href='" + linkV + "' target='_blank'>" + titleV + "</a></h5>" +
"<span>發表時間:" + pubDateV + "</span>" +
"<div class='article'>" + descriptionV + "</div>" +
"<div class='bottom'>文章分類:" + categoryV +
" <a href='" + adminlinkV + "' target='_blank'>作者:" + authorV + "</a></div>";
}
getId("prolist").innerHTML = listchar;
listen("mainbg");
}
這是全篇最容易被忽略、卻最影響體驗的部分。Ajax 應用不產生頁面跳轉,使用者的「上一頁」按鈕自然失效。解法是搭配隱藏 IFRAME 與 location.hash:
function saveState(message) {
var hisFrm = getId("historyFrame");
hisFrm.src = "blank.html?" + message;
}
window.dhtmlHistory = {
iframeLoaded: function (newLocation) {
var hash = new String(newLocation.search);
if (hash.length >= 2 && hash.charAt(0) == "?" && hash.substring(1) != delChar()) {
hash = hash.substring(1);
window.location.hash = hash;
loadrss(hash);
}
}
};
function delChar() {
var a = window.location.hash;
return a.substring(1);
}
window.onload = function () {
if (window.location.hash.length >= 2) {
ent(delChar());
}
};
運作原理是:每次切換來源時,同時改動 hash 並更新隱藏 IFRAME 的 src,讓瀏覽器產生一筆歷史記錄;使用者按上一頁時,IFRAME 觸發 onload,再由 iframeLoaded 比對 hash 差異並重新載入對應的 feed。此外 window.onload 中那段判斷,讓使用者直接開啟帶 hash 的網址或重新整理時,仍能還原到正確的來源。
下頁將接續說明頁面結構與 CSS 樣式。