隨著行動裝置與 Web 應用的普及,使用者對網站與應用程式的體驗要求也越來越高。作為開發者,我們需要打造更貼近人性的應用。以微博這類社交平台為例,良好的使用體驗尤其重要。
我們在發微博時,文字方塊會即時提示剩餘字數,這種貼心的設計既方便使用者掌握字數限制,也達到了限制輸入的效果。有一句話值得牢記:凡是輸入,必有限制;凡是輸入,必須校驗。
接下來,本文將介紹如何實作即時字數提示功能與本機儲存(localStorage)技術。
我們以新浪微博的发微博輸入框為例。新浪微博限制 140 個中文字(約 280 個英文),當使用者接近或達到限制時,好的體驗應該給予提示,例如透過不同顏色或加粗字體提醒。

圖1 新浪微博使用者輸入限制
字數統計插件會在輸入框後建立一個同層的 span 元素,用來顯示剩餘字數。當觸發輸入框的 keyup、keydown 與 change 事件時,即時更新 span 內容;若剩餘字數接近警告值,就套用對應的 CSS 樣式提醒使用者。
插件會動態插入如下程式碼:
<!-- adds element dynamic --> <span class="counter">140</span>
預設字數限制為 140 個,當可輸入字數少於等於 25 時提示接近上限,少於等於 0 時提示已超出限制。預設的條件物件如下:
// The default limitation. var defaults = { allowed: 140, warning: 25, css: 'counter', counterElement: 'span', cssWarning: 'warning', cssExceeded: 'exceeded', counterText: '' };
各屬性說明如下:
接著定義 calculate() 方法,用來計算剩餘字數,並在進入警告範圍時加上 warning 樣式,剩餘字數少於等於零時加上 exceeded 樣式。
/*** * Calculates the char * @param obj */ function calculate(obj) { // Get the count. var count = getLength($(obj).val()); var available = options.allowed - count; if (available <= options.warning && available >= 0) { $(obj).next().addClass(options.cssWarning); } else { $(obj).next().removeClass(options.cssWarning); } if (available < 0) { $(obj).next().addClass(options.cssExceeded); } else { $(obj).next().removeClass(options.cssExceeded); } $(obj).next().html(options.counterText + available); }
再定義 getLength() 方法:遇到中文字 totLen 加 1,遇到英文或數字加 0.5(預設允許 140 個中文字)。
/** * Get the length of char. * @param str * @return {Number} */ function getLength(str) { var totLen = 0; for (var i = 0; i < str.length; i++) { // If the char is Chinese. if (str.charCodeAt(i) > 256) { totLen += 1; } else { totLen += 0.5; } } return Math.floor(totLen); }
接著為控件綁定 keyup、keydown 與 change 事件,觸發時呼叫 calculate() 計算剩餘字數並套用樣式。
// Binds text area keyup, keydown and change event. this.each(function() { $(this).after('<' + options.counterElement + ' class="' + options.css + '">' + options.counterText + '</' + options.counterElement + '>'); calculate(this); $(this).keyup(function() { calculate(this), storeWeibo(this) }); $(this).keydown(function() { calculate(this), storeWeibo(this) }); $(this).change(function() { calculatea(this) }); });
現在字數統計插件的功能大致完成。相信不少人注意到:若發微博時未送出,下次打開頁面時輸入框仍保存著未發送的內容,即使關閉瀏覽器重新開啟,資料依然存在。要實現這個功能的方法有很多,例如 Cookies、Session 等。
隨著 HTML5 的制訂,W3C 也訂出了 Web Storage 規範,它將資料存在客戶端,直到 Session 過期(工作階段儲存)或超出本機容量(本機儲存),比傳統 Cookies 更強大、更容易實作、容量也更大(多數瀏覽器支援約 5M)。
工作階段儲存(sessionStorage):將資料存在工作階段中,一旦關閉瀏覽器分頁,資料即失效。
本機儲存(localStorage):當資料需要長期保存在客戶端時使用,以 key/value 形式儲存,關閉頁面或瀏覽器後重新開啟,資料依然存在。一個簡單應用是記錄使用者造訪頁面的次數。

圖2 儲存空間的對比
localStorage 提供了 setItem()、getItem()、removeItem()、key()、clear() 五個方法與一個 length 屬性:
// Storage definition. interface Storage { readonly attribute unsigned long length; DOMString key(in unsigned long index); getter any getItem(in DOMString key); setter creator void setItem(in DOMString key, in any value); deleter void removeItem(in DOMString key); void clear(); };
在現代瀏覽器中使用本機儲存非常簡單,直接呼叫 localStorage 的方法或屬性即可:
// stores the username 'jkrush', // then get the username. localStorage.setItem('username', 'jkrush'); var userName = localStorage.getItem('username');
由於 localStorage 以 Key/Value 形式儲存資料,儲存字串很輕鬆,但若要儲存物件就會顯得吃力。以下示範直接儲存 student 物件的情況:
// Defines a student object. var student = { name: 'JK_Rush', age: '26', sex: 'male' }; // Prints student object console.log(student); // Stores student object. // Gets student object again. localStorage.setItem('student', student); console.log(localStorage.getItem('student'));

圖3 localStorage 儲存物件
可以發現,控制台輸出的並不是真正的 student 物件,而是它的字串資訊。解決之道是將物件序列化為 JSON 字串儲存,取出時再反序列化:
// Defines a student object. var student = { name: 'JK_Rush', age: '26', sex: 'male' }; console.log(student); // Serializes the object to json string. localStorage.setItem('student', JSON.stringify(student)); // Deserializes the json string to object. console.log(JSON.parse(localStorage.getItem('student')));

圖4 localStorage 儲存物件
接著把 localStorage 功能加入前面的範例,並針對舊版瀏覽器(如 IE6、IE7)提供以 Cookies 實作的相容方案:
/** * Store user data into local storage. * @param obj */ function storeWeibo(obj) { // Checks the browser supports local storage or not. if (window.localStorage) { localStorage.setItem('publisherTop_word', $(obj).val()); } else { // For instance, ie 6 and 7 do not support local storage, // so we need to provider other way. window.localStorage = { getItem: function(sKey) { if (!sKey || !this.hasOwnProperty(sKey)) { return null; } return unescape(document.cookie.replace(new RegExp("(?:^|.*;\\s*)" + escape(sKey).replace(/[\-\.\+\*]/g, "\\$&") + "\\s*\\=\\s*((?:[^;](?!;))*[^;]?).*"), "$1")); }, key: function(nKeyId) { return unescape(document.cookie.replace(/\s*\=(?:.(?!;))*$/, "").split(/\s*\=(?:[^;](?!;))*[^;]?;\s*/)[nKeyId]); }, setItem: function(sKey, sValue) { if (!sKey) { return; } document.cookie = escape(sKey) + "=" + escape(sValue) + "; expires=Tue, 19 Jan 2038 03:14:07 GMT; path=/"; this.length = document.cookie.match(/\=/g).length; }, length: 0, removeItem: function(sKey) { if (!sKey || !this.hasOwnProperty(sKey)) { return; } document.cookie = escape(sKey) + "=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/"; this.length--; }, hasOwnProperty: function(sKey) { return (new RegExp("(?:^|;\\s*)" + escape(sKey).replace(/[\-\.\+\*]/g, "\\$&") + "\\s*\\=")).test(document.cookie); } }; window.localStorage.length = (document.cookie.match(/\=/g) || window.localStorage).length; } }
storeWeibo() 會先判斷瀏覽器是否支援 localStorage。主流瀏覽器如 Chrome、Firefox、Opera、Safari 及 IE8 都支援 localStorage 與 sessionStorage;若支援,就直接呼叫 setItem() 儲存 textarea 內容,再次開啟時先檢查是否有資料,有的話再取出顯示。由於舊版瀏覽器支援 Cookies 的持久化儲存,因此以 Cookies 實作 getItem()、setItem()、removeItem() 等方法作為相容方案。


圖5 主流瀏覽器支援 Web Storage
完成 jquery.charcount.js 後,介面部分的 HTML 如下:
<!-- From design--> <body> <form id="form" method="post"> <h2> 有什麼新鮮事想告訴大家?</h2> <div> <label class="mali_oglas_kategorija" for="message"> 有什麼新鮮事想告訴大家?<b></b></label> <textarea id="weiboMsg" placeholder="請Fun享"></textarea> <span class="counter"></span> <input onclick="SaveCache()" type="submit" value="發布"> </div> </form> </body>

圖6 發送框介面設計
接著在頁面中引用 jQuery 與自訂插件:
<!-- Adds Javascript reference --> <script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/1.6.1/jquery.min.js"></script> <script type="text/javascript" src="./js/jquery.charcount.js"></script>
然後呼叫字數統計插件:
<!-- When document ready invokes charCount function--> <script type="text/javascript"> $(document).ready(function () { // Uses default setting. $("#weiboMsg").charCount(); }); </script>
如此一來,每次在文字方塊輸入時都會即時顯示剩餘字數,同時輸入的內容也會保存到 localStorage。
接著分別在 Chrome 與 Firefox 中查看 localStorage 的資料。開啟 Chrome 的「開發者工具」(Ctrl+Shift+I),選擇「Resources」即可看到:

圖7 Chrome 的本機儲存
同樣地,開啟 Firefox 的「Firebug」(F12),選擇「DOM」,找到 window 的 localStorage 物件即可查看:

圖8 Firefox 的本機儲存
IE8 同樣支援 localStorage 物件,但測試時會發現它一直提示 localStorage 未定義。查詢後得知,IE8 中的 localStorage 依賴於網域,需運行於 Web 伺服器中才能成功保存資料。
由此可見,微博正是透過本機儲存技術保存使用者輸入框中的資料,一旦送出就清空本機儲存,否則保留使用者的輸入。
本文以微博發送框為例,介紹了如何定義 jQuery 字數統計插件與本機儲存技術。限制使用者輸入是必要的,而透過定義插件動態統計剩餘字數,就能有效且貼心地提示輸入限制,希望對大家學習 JavaScript 有所啟發。