這個範例示範如何以 jQuery 的 getJSON 搭配 JSONP,抓取並解析「歷史上的今天」開放資料,資料來源為 wiki。
// 首頁 https://history.sturgeon.mopaas.com // JSONP 介面 https://history.sturgeon.mopaas.com/jsonp?callback=? // JSON 介面 https://history.sturgeon.mopaas.com/jsonp // 歷史上的 1 月 1 日 https://history.sturgeon.mopaas.com/jsonp/1@1 https://history.sturgeon.mopaas.com/1@1
$.getJSON('https://history.sturgeon.mopaas.com/jsonp?callback=?', function(data){
parserTodayObj(data);
});
function parserTodayObj(todayObj){
for(var key in todayObj){
if(/^.*出生.*$/.test(key)){ doBirthday(todayObj[key]); }
if(/^.*假日.*$/.test(key)){ doHoliday(todayObj[key]); }
if(/^.*風俗.*$/.test(key)){ doHoliday(todayObj[key]); }
if(/^.*逝世.*$/.test(key)){ doDeath(todayObj[key]); }
if(/^.*事記.*$/.test(key)){ doMemorabilia(todayObj[key]); }
}
}
回傳的物件是以中文類別名稱當鍵值,因此用正則比對鍵名來分流,分別交給四個處理函數。
function doBirthday(birthdays){
if(birthdays.length != 0){
$(document.body).append("<h3>出生</h3>");
for (var i = 0; i < birthdays.length; i++) {
$(document.body).append("<p>" + birthdays[i] + "</p>");
}
}
}
function doHoliday(holidays){
if(holidays.length != 0){
$(document.body).append("<h3>節日</h3>");
for (var i = 0; i < holidays.length; i++) {
$(document.body).append("<p>" + holidays[i] + "</p>");
}
}
}
function doDeath(deaths){
if(deaths.length != 0){
$(document.body).append("<h3>逝世</h3>");
for (var i = 0; i < deaths.length; i++) {
$(document.body).append("<p>" + deaths[i] + "</p>");
}
}
}
function doMemorabilia(memorabilias){
if(memorabilias.length != 0){
$(document.body).append("<h3>重大事件</h3>");
for (var i = 0; i < memorabilias.length; i++) {
$(document.body).append("<p>" + memorabilias[i] + "</p>");
}
}
}
四個函數結構幾乎一致,實務上可以合併成一個,把標題當參數傳入:
function renderList(title, items){
if(!items || !items.length) return;
var $list = $("<h3></h3>").text(title);
for(var i = 0; i < items.length; i++){
$list = $list.add? $list : $list;
}
$("body").append($list);
items.forEach(function(t){
$("body").append($("<p></p>").text(t));
});
}
另外要提醒:以 .html() 或字串拼接方式插入外部資料時,若內容未經轉義,可能成為 XSS 的入口。用 .text() 設定文字內容會自動轉義,是更安全的做法。