DIV CSS 佈局教程網

用免費 JSON 介面做一個「歷史上的今天」頁面
編輯:JavaScript基礎知識     

「歷史上的今天」是個很受歡迎的小功能,資料量不大但趣味十足。網路上有現成的公開介面可以直接呼叫,資料整理自維基百科,拿來做練習或 Side Project 都很合適。

介面位址

https://history.sturgeon.mopaas.com           // 首頁
https://history.sturgeon.mopaas.com/jsonp?callback=?   // JSONP 介面
https://history.sturgeon.mopaas.com/jsonp     // JSON 介面
https://history.sturgeon.mopaas.com/jsonp/1@1  // 歷史上的 1 月 1 日
https://history.sturgeon.mopaas.com/1@1        // 歷史上的 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]); }
  }
}

這裡的關鍵是回傳的 JSON 並不是固定結構,而是以中文標題當鍵。因此用正則去比對鍵名,再分派給對應的處理函式。這種做法很靈活,缺點是關鍵字一改就全盤失效。

四個渲染函式

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 $section = $('<section></section>').append($('<h3>').text(title));
  items.forEach(function(text) {
    $section.append($('<p>').text(text));
  });
  $('body').append($section);
}

用 text() 取代字串拼接。原本用 append("<p>" + item + "</p>"),若資料中帶有角括號就會破壞結構,甚至形成 XSS 風險。改用 .text() 由 jQuery 幫你轉義,安全得多。

避免反覆操作 DOM。迴圈中一次次 append 會觸發多次重排,先把整段組好再一次插入,效能好很多。

加上載入中與失敗狀態。使用者不該盯著空白畫面猜測,也不該在介面掛掉時毫無反應。

用原生 fetch 取代 $.getJSON。若專案沒有其他用到 jQuery 的地方,其實不需要為一個請求引入整個函式庫。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved