DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5教程
HTML5 Web Storage 實戰:用 localStorage 做一個簡易通訊錄
編輯:HTML5教程     

Web Storage 是 HTML5 相當重要的一項功能,讓資料能存在客戶端。它概念上像 cookie,但能力強得多——cookie 被限制在 4KB,而 Web Storage 官方建議每個網站可用到 5MB。

兩種類型

sessionStorage:資料存在 session 中,瀏覽器(分頁)關閉即消失。

localStorage:資料長期保存在客戶端,除非手動刪除。

兩者的 API 完全相同,以下以 localStorage 為例:

localStorage.setItem(key, value);  // 保存資料
localStorage.getItem(key);         // 讀取資料
localStorage.removeItem(key);      // 刪除單筆
localStorage.clear();              // 刪除全部
localStorage.key(index);           // 取得某索引的 key
localStorage.length;               // 資料筆數

關鍵限制:key 與 value 都必須是字串。換句話說,Web Storage 的 API 只能操作字串,存物件時必須自行序列化——這點後面會示範解法。

需求規劃

我們要做一個簡單的通訊錄,功能有三項:

  1. 錄入聯絡人(姓名、手機號碼),以手機號作為 key 存入 localStorage。
  2. 依手機號碼查詢機主姓名。
  3. 列出目前所有已存的聯絡人。

頁面結構

<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8"/>
<title>HTML5 本地存儲之 Web Storage 篇</title>
</head>
<body>
<div style="border:2px dashed #ccc; width:320px; text-align:center;">
  <label for="user_name">姓名:</label>
  <input type="text" id="user_name" name="user_name" class="text"/>
  <br/>
  <label for="mobilephone">手機:</label>
  <input type="text" id="mobilephone" name="mobilephone"/>
  <br/>
  <input type="button" onclick="save()" value="新增記錄"/>
  <hr/>
  <label for="search_phone">輸入手機號:</label>
  <input type="text" id="search_phone" name="search_phone"/>
  <input type="button" onclick="find()" value="查找機主"/>
  <p id="find_result"></p>
</div>
<br/>
<div id="list"></div>
</body>
</html>

畫面大致如下:

功能一:新增記錄

function save() {
    var mobilephone = document.getElementById("mobilephone").value;
    var user_name   = document.getElementById("user_name").value;
    localStorage.setItem(mobilephone, user_name);
}   // 用於保存數據

實務上這裡應該先驗證手機號格式與必填欄位,並在 setItem 外圍包上 try/catch 以處理容量耗盡的情況。

功能二:查詢機主

// 查找數據
function find() {
    var search_phone = document.getElementById("search_phone").value;
    var name = localStorage.getItem(search_phone);
    var find_result = document.getElementById("find_result");
    find_result.innerHTML = search_phone + "的機主是:" + name;
}

若查無此號,getItem 會回傳 null,畫面上會顯示「null」這個字串。記得加一段判斷:

if (name === null) {
    find_result.textContent = "查無此號碼";
    return;
}

功能三:列出全部聯絡人

需要用到 localStorage.key(index) 搭配 length 遍歷:

// 將所有儲存在 localStorage 中的物件提取出來並呈現在界面上
function loadAll() {
    var list = document.getElementById("list");
    if (localStorage.length > 0) {
        var result = "<table border='1'>";
        result += "<tr><td>姓名</td><td>手機號碼</td></tr>";
        for (var i = 0; i < localStorage.length; i++) {
            var mobilephone = localStorage.key(i);
            var name = localStorage.getItem(mobilephone);
            result += "<tr><td>" + name + "</td><td>" + mobilephone + "</td></tr>";
        }
        result += "</table>";
        list.innerHTML = result;
    } else {
        list.innerHTML = "目前數據為空,趕緊開始加入聯系人吧";
    }
}

這段程式碼有 XSS 風險:使用者輸入的姓名會被直接拼進 innerHTML,若有人填入 <img src=x onerror=alert(1)> 就會被執行。正確做法是用 document.createElement 建立節點、以 textContent 填入文字,或至少先做 HTML 轉義。

進階:存更豐富的聯絡人資訊

上面的範例只有姓名與手機兩個欄位。若要加入公司名稱、家庭地址等,該怎麼辦?Web Storage 不是只能存字串嗎?

解法是用 JSON 序列化:存入前用 JSON.stringify() 把物件轉成字串,取出後用 JSON.parse() 還原成物件。

// 保存數據
function save() {
    var contact = new Object();
    contact.user_name   = document.getElementById("user_name").value;
    contact.mobilephone = document.getElementById("mobilephone").value;
    contact.company     = document.getElementById("company").value;

    var str = JSON.stringify(contact);
    localStorage.setItem(contact.mobilephone, str);
    loadAll();
}

// 將所有儲存在 localStorage 中的物件提取出來並呈現在界面上
function loadAll() {
    var list = document.getElementById("list");
    if (localStorage.length > 0) {
        var result = "<table border='1'>";
        result += "<tr><td>姓名</td><td>手機</td><td>公司</td></tr>";
        for (var i = 0; i < localStorage.length; i++) {
            var mobilephone = localStorage.key(i);
            var str = localStorage.getItem(mobilephone);
            var contact = JSON.parse(str);
            result += "<tr><td>" + contact.user_name
                    + "</td><td>" + contact.mobilephone
                    + "</td><td>" + contact.company + "</td></tr>";
        }
        result += "</table>";
        list.innerHTML = result;
    } else {
        list.innerHTML = "目前數據為空,趕緊開始加入聯系人吧";
    }
}

JSON.parse() 拋錯時(例如資料被使用者手動改壞)也要處理,建議包一層 try/catch,失敗就跳過該筆或清除它。

還可以再加的東西

這個通訊錄要變完整,至少還需要:以手機號為 key 的修改與刪除功能(用 removeItem)、輸入時的即時驗證,以及一個「清空全部」的按鈕(localStorage.clear(),但要加確認對話框)。另外别忘了 localStorage 是同步 API,大量資料的讀寫會阻塞主執行緒,資料量大時該換成 IndexedDB。

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