Gtalk 最下方有個相當實用的小功能:定時更新 Gmail 的未讀郵件數。如果把這個功能搬到 Firefox 上,用 Jetpack 來做,會是個很好的練習題。

有了「如何創建 Firefox 的 Jetpack 擴展」那篇打底,建立一個狀態欄項目並不難:
jetpack.statusBar.append({
html: '<img src="https://mail.google.com/mail/images/favicon.ico"/><span id="count"></span>',
width: 55,
onReady: function(widget) {
$("#count", widget).css({
cursor: "pointer",
paddingLeft: "4px",
fontFamily: "Tahoma, Arial, sans-serif",
verticalAlign: "top",
fontSize: "10px",
lineHeight: "18px",
});
}
});
html 裡放 Gmail 的 favicon 與一個空的 span 作為數字容器,width 決定狀態欄上佔的寬度,onReady 則負責替數字套上樣式。
Gmail 本身提供了 Feed,登入後即可取用:
https://mail.google.com/mail/feed/atom
Feed 原始碼中的 fullcount 標籤,記錄的就是當前未讀郵件數。資料來源有了,剩下的就是用 Ajax 抓回來,塞給指定元素:
function update(widget) {
var widget = $(widget);
$.get("https://mail.google.com/mail/feed/atom", function(xml) {
var el = $(xml).find("fullcount"); // 記錄未讀新郵件數的節點
if(el){
var newcount = parseInt(el.get(0).textContent);
widget.find("#count").text(newcount);
} else {
widget.find("#count").text( "Login" );
}
});
}
可以再往前一步:當未讀數比上次多,就跳個通知出來。這裡用 jetpack.notifications.show(options),options 有三個屬性——title(通知標題)、icon(圖示 URL)、body(通知本文)。
var count = 0;
function update(widget) {
var widget = $(widget),
notify = function(msg) {
jetpack.notifications.show({
title: "Gmail",
body: msg,
icon: "https://mail.google.com/mail/images/favicon.ico"
});
};
$.get("https://mail.google.com/mail/feed/atom", function(xml) {
var el = $(xml).find("fullcount");
if(el){
var newcount = parseInt(el.get(0).textContent);
if(newcount > count) {
var sender = $(xml).find("name").get(0).textContent;
notify("New message from " + sender);
}
count = newcount;
widget.find("#count").text(count);
} else {
widget.find("#count").text( "Login" );
notify("Please login to Gmail");
}
});
}
這裡額外做了一件事:從 Feed 裡取出 name 節點,把寄件者名稱一起放進通知本文,提醒就有意義多了。
設成每分鐘更新一次:
setInterval( function() { update(widget) }, 60*1000 );
點擊狀態欄圖示時,開一个新分頁直奔 Gmail 並把焦點移過去:
$(widget).click(function() {
jetpack.tabs.open("https://mail.google.com");
jetpack.tabs[ jetpack.tabs.length-1 ].focus();
});
其中 jetpack.tabs 是瀏覽器分頁的集合物件,.open(url) 開啟新分頁,.focus() 把該分頁切為當前分頁。
var count = 0;
function update(widget) {
var widget = $(widget),
notify = function(msg) {
jetpack.notifications.show({
title: "Gmail",
body: msg,
icon: "https://mail.google.com/mail/images/favicon.ico"
});
};
$.get("https://mail.google.com/mail/feed/atom", function(xml) {
var el = $(xml).find("fullcount");
if(el){
var newcount = parseInt(el.get(0).textContent);
if(newcount > count) {
var sender = $(xml).find("name").get(0).textContent;
notify("New message from " + sender);
}
count = newcount;
widget.find("#count").text(count);
} else {
widget.find("#count").text( "Login" );
notify("Please login to Gmail");
}
});
}
jetpack.statusBar.append({
html: '<img src="https://mail.google.com/mail/images/favicon.ico"/><span id="count"></span>',
width: 40, // 預留三位數的寬度
onReady: function(widget) {
$("#count", widget).css({
cursor: "pointer",
paddingLeft: "4px",
fontFamily: "Tahoma, Arial, sans-serif",
verticalAlign: "top",
fontSize: "10px",
lineHeight: "18px",
});
$(widget).click(function() {
jetpack.tabs.open("https://mail.google.com");
jetpack.tabs[ jetpack.tabs.length-1 ].focus();
});
update(widget);
setInterval( function() {update(widget) }, 60*1000 );
}
});
四個步驟,一個能用的 Gmail 提醒擴展就完成了。
測試 Demo:https://www.planabc.net/lab/jetpack/gmail/
更完整的 Jetpack API 說明,可參考 about:jetpack 頁面裡的 API Reference 分頁。案例原始碼來自:https://jetpack.mozillalabs.com/demos/gmail-checker.js