我們一直在尋找改善瀏覽體驗的方法,有些家喻戶曉,有些則鮮為人知。我原本以為書籤小工具屬於後者,是種麻煩又沒必要的東西——後來發現自己完全錯了。它一點也不惱人,而是徹底以使用者為中心,能實現許多漂亮的功能,甚至成為我與瀏覽器、與網路互動的核心環節。
書籤小工具(bookmarklet)是一個偽裝成小應用的 JavaScript 片段,它駐留在你的瀏覽器裡,只需點一下就能為當前網頁加上額外功能。這個词是 bookmark 與 applet 的合成,也叫 favelet。
因為完全由 JavaScript 構成,它天生可攜帶——所有瀏覽器都支援,甚至行動裝置與平板也能跑。安裝方式同樣簡單:把它拖進書籤列即可。
它的關鍵意義在於:讓原本需要開發人員在控制台敲半天的事,變成一個按鈕。書籤小工具大致可分為三類:
第一件事:所有程式碼前必須加上 javascript: 這個 URI。瀏覽器實作了這個前綴,讓後續內容被當成 JavaScript 正確解析。
<a href="javascript: alert('文字鏈接');">這個鏈接</a>
你的程式碼運行在當前頁面,而該頁面很可能也有自己的 JavaScript,命名衝突隨時可能發生。最糟的結果是你的小工具把母頁搞掛。用匿名函式包起來就能徹底隔離:
javascript:(function(){ // your code here })();
這其實是任何環境下都該養成的好習慣:時刻保持自己的程式碼隔離。
書籤小工具不必寫得很小。當規模變大時,為了發布方便,也為了不必要求使用者手動更新,最好做一層「載入器」去抓外部程式碼:
javascript: (function () {
var jsCode = document.createElement('script');
jsCode.setAttribute('src', 'https://path/to/external/file.js');
document.body.appendChild(jsCode);
}());
這段程式建立一個 script 標籤、指向外部檔案,再附加到文件中。於是無論你改動哪一部分,只要部署更新後的檔案,所有使用者立刻同步。而且這招不限於 JavaScript——如果你的小工具帶有 UI,外部 HTML 與 CSS 同樣可以這樣引入,做到真正自動更新。
大型工具往往需要 JavaScript 類庫,但直接把 jQuery 塞進頁面並不是好主意:你得先確認它沒有被載入過。像 jQuery、MooTools 這類市佔率極高的庫,必須小心處理,避免重複載入與 $ 符號衝突,版本衝突在特定情境下也會發生。
if (!($ = window.jQuery)) { // typeof jQuery == 'undefined' 亦可
script = document.createElement('script');
script.src = 'https://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js';
script.onload = releasetheKraken;
document.body.appendChild(script);
} else {
releasetheKraken();
}
function releasetheKraken() {
// 你的主程式碼放在這裡
}
流程很清晰:先判斷 jQuery 是否已存在於命名空間;不存在就透過 CDN 載入(這是公認的最佳實踐),並把主函式掛在 onload 上;已存在則直接執行。
如果不想自己處理這些細節,強烈推薦 Ben Alman 的「書籤小工具產生器」,它用很完整的方式解決了命名空間與版本衝突問題。
這一點無比重要。如果不小心破壞了母頁,小工具就毫無價值。請注意,需要處理的不只是 JavaScript——若你有前端,HTML 與 CSS 同樣會在頁面中運行。
不要替容器與 class 取「container」這種通用名字。簡單有效的做法是為所有識別名稱加上具工具特色的前綴或後綴。寫 CSS 時更要謹慎,使用盡可能高的選擇器精度,樣式洩漏到母頁既不專業,也會讓使用者失去信任。
若你的小工具依賴脆弱的第三方類庫,跨瀏覽器相容性就是場噩夢。這點看似理所當然,卻是許多人反覆忽略的地方。
另一個陷阱是:你期望它能在所有網站上工作,結果它只在少數幾個網站有效。網頁的結構層次與方法論各異——有些站用了 HTML5 語意容器,有些則保守地全用通用 div。蒐集資料時務必把各種情況都納入考量。