HTML5 帶給我們的不只是更多語意化的標籤,還有一批更強大的特性,其中「離線儲存」最值得注意。對桌上電腦而言,它或許算不上驚喜;但對行動裝置來說,離線儲存幾乎是個神蹟。只要裝置上的瀏覽器支援,你就能針對 iPhone、iPod touch 這類設備,做出真正能離線運作的 Web 應用。
先誠實說明限制。以當時的情況而言,HTML5 的本地儲存還很受限:其一,瀏覽器支援有限,只有 Safari 3.1 以後、以及 iPhone OS 2.0 以後原生支援 JavaScript database,其他環境得靠 Taffy DB 之類的方案迂迴實現。其二,伺服器端需要調整設定,不過若是自己的主機,這一步很簡單。
下面以一個簡單的離線 Web App——notebook——為例,記錄為 iPhone/iPod touch 開發 Web App 的過程。這不是經驗談,只是初探。
UI 設計不是本文重點,有興趣的可以另找資料。這裡只強調一個關鍵點:預設做出的頁面放到 iPhone 上看會變得很窄、字很小。原因是 iPhone 用 320px 寬的螢幕去顯示一個預設 980px 寬的頁面,你的內容被等比縮小了。
解法很簡單,在 HTML 的 head 區域加一行 meta 宣告即可:

解決這件事之後,就能盡情用 HTML5 與 CSS3 打造介面。針對單一設備開發不必考慮相容性,實在暢快。
以下是一個(相當樸素的)介面:

UI 完成後,接著要處理資料。
在動手之前,先認識這個 API:
The client-side database storage API allows web applications to store structured data locally using a medium many web developers are already familiar with – SQL. —— webkit blog
也就是說,它讓網頁應用能用 SQL 在本地儲存結構化資料。當時只有 WebKit 核心的瀏覽器支援,你甚至無法在 W3C 的 HTML5 工作草案中找到它的詳細描述。
try {
if (!window.openDatabase) {
// 檢測瀏覽器是否支援 cs-db
alert('not supported cs-db!');
} else {
var shortName = 'noteDB';
var version = '1.0';
var displayName = 'Notebook database';
var maxSize = 65536;
// 建立一個資料庫
var db = openDatabase(shortName, version, displayName, maxSize);
}
} catch (e) {
// 捕捉錯誤
if (e == 2) {
alert('Invalid database version.');
} else {
alert("Unknown error " + e + ".");
}
}
若這段代碼無誤,你就會在 Safari 或 Chrome 的開發者工具中看到這個資料庫。

右側區域可以直接執行一些 SQL 查詢。
db.transaction(function (transaction) {
transaction.executeSql(sqlquery, [], dataHandler, errorHandler);
});
transaction.executeSql 的參數依序是:SQL 查詢字串、傳給查詢的參數、資料處理函式、錯誤處理函式。只有第一項是必填,其餘皆可選。
第二個參數的用法是這樣:
transaction.executeSql("UPDATE people set age=? where name=?;", [ age, name ]);
查詢字串中的每一個「?」會被後面陣列中的變數依序替換。這種參數化寫法不只是方便,更是避免 SQL injection 的關鍵,值得養成習慣。
db.transaction(function (transaction) {
transaction.executeSql(
'CREATE TABLE IF NOT EXISTS notes (id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT, titel TEXT, note TEXT NOT NULL, date DATE);',
errorHandler
);
});
錯誤處理函式:
function errorHandler(transaction, error) {
alert('Error was: ' + error.message + '(Code:' + error.code + ')');
var fatal_error = true;
if (fatal_error) { return true; }
return false;
}
其中 error.message 是錯誤描述,error.code 是錯誤代碼。
db.transaction(function (transaction) {
transaction.executeSql("SELECT * from notes;", [], dataHandler, errorHandler);
});
function dataHandler(transaction, results) {
var string = "";
for (var i = 0; i < results.rows.length; i++) {
var row = results.rows.item(i);
string += "<li>" + row['titel'] + "</li>";
}
var listConts = $('listCont');
listConts.innerHTML = string;
}
可以看出來,它與 PHP 這類後端語言的操作邏輯大同小異。更多細節可直接看範例程式的完整代碼。
為了實現檔案層級的離線快取,HTML5 引入了一個名為 manifest 的檔案。它本質上是一份快取清單,用來告訴瀏覽器哪些檔案需要存到用戶端。
manifest 的 MIME 類型必須是 text/cache-manifest,這一點非常重要。
下面是一個 manifest 檔案的範例:

manifest 必須以 CACHE MANIFEST 開頭。其後要下載並快取的檔案,用相對或絕對路徑皆可,每個資源一行。
NETWORK 段用來標示線上資源所在的網域。這個網域下的資源不會被快取,即使用戶端處於離線狀態,仍會嘗試請求這些資源。
CACHE 段列出需要快取的資源。
FALLBACK 段每行包含兩部分,以空格分隔。後半段是當前半段路徑無法存取時的備選路徑。如上圖所示:若 demoimages 目錄無法存取,就改試 images 目錄。
我們只需要快取 nbStyle.css 與 nbScript.js 兩個檔案。至於 index.html 本身,由於 manifest 會預設快取引用它的檔案,因此不能寫進清單裡:
CACHE MANIFEST # version: 2010-01-20 22:30 nbStyle.css nbScript.js
就是這麼簡單。存成 notebook.manifest,與其他檔案一起放在根目錄。
最後一個問題:怎麼讓伺服器把 notebook.manifest 標識為 text/cache-manifest?有兩種做法:
1. 在站點根目錄建立 .htaccess,在其中宣告 .manifest 的 MIME 類型。這需要調整伺服器設定,我當時沒有嘗試成功。
2. 在 Apache 目錄下找到名為 mime.types 的設定檔,在最後加一行:
text/cache-manifest manifest
接著在 index.html 中引用它:

完成這些設定之後,就可以用 WebKit 瀏覽器開啟你的應用,然後斷網,再試著操作——程式應該仍能正常運作。
把打包的代碼附上,代碼本身難度不高,只是我寫得不太好。
其實故事遠未結束:快取下來的檔案如果被更新了怎麼辦?如何通知用戶端更新快取?這部分同樣有 API 可用,得慢慢再探索。很期待與大家討論 HTML5 相關的議題。
補充給今天的讀者:當年的 Web SQL Database 方案後來已被廢棄,取而代之的是 IndexedDB 與 Cache Storage,再搭配 Service Worker 構成完整的離線方案。上面這套思路——UI 適配、資料落地、檔案快取——至今仍然是打造離線 Web App 的三個核心環節,只是工具換了一代。