HTML5 的桌面通知(Web Notifications)能在使用者桌面彈出一則訊息框,它的特性是跨分頁——不管使用者目前停在產品頁還是購物車,通知都會浮在系統層級出現。當使用者開著十幾個分頁時,這比在頁面裡彈個提示有效得多。
使用上有兩個前提:瀏覽器核心需支援(當時主要是 WebKit 系),且在 Chrome 下必須以 http 協定開啟頁面,直接雙擊本機檔案是叫不動它的。
功能由 window.webkitNotifications 提供。這個物件本身沒有屬性,只有四個方法。
向使用者申請通知權限。若尚未決定過,瀏覽器會跳出授權介面,使用者的選擇會在物件內部形成一個狀態值:
0:使用者已同意。只有這個狀態下才能發出通知。1:預設狀態,使用者既沒同意也沒拒絕。2:使用者已拒絕。讀取目前 requestPermission() 的狀態值,回傳上面那三個數字之一。實務上通常用它當作前置判斷,避免每次都跳出授權視窗騷擾使用者。
以純文字方式建立通知,接受三個參數:
iconUrl:通知中顯示的圖示網址title:通知標題body:通知本文它會回傳一個 Notification 物件,你可以對它做更細的控制。
dir: ""
onclick: null
onclose: null
ondisplay: function (event) {}
onerror: null
onshow: null
replaceId: ""
tag: ""
addEventListener / removeEventListener
cancel() / close() / show()
dir 決定文字排列方向,可取 auto、ltr、rtl。
tag 是通知的分組標籤。設了它之後,標籤相同的新通知會在同一個訊息框中替換掉舊的,不會疊出一堆視窗。若不設,通知會一個個堆疊,但最多只顯示三個,超出的會被排入等待而被延後顯示。
事件方面:onshow 在通知顯示時觸發、onclick 在使用者點擊時觸發、onclose 在關閉時觸發、onerror 在出錯時觸發。
方法方面:addEventListener 與 removeEventListener 是常規的事件綁定與移除;show() 讓通知實際顯示出來;close() 與 cancel() 效果相同,都是關閉通知。
與 createNotification() 的差别在於它以 HTML 方式呈現通知,只接受一個參數——HTML 檔的網址,同樣回傳 Notification 物件。
<!DOCTYPE html>
<html>
<head>
<title>notifications in HTML5</title>
</head>
<body>
<form>
<input id="trynotification" type="button" value="Send notification" />
</form>
<script type="text/javascript">
document.getElementById("trynotification").onclick = function () {
notify(Math.random());
};
function notify(tab) {
if (!window.webkitNotifications) {
return false;
}
var permission = window.webkitNotifications.checkPermission();
if (permission != 0) {
window.webkitNotifications.requestPermission();
var requestTime = new Date();
var waitTime = 5000;
var checkPerMiniSec = 100;
setTimeout(function () {
permission = window.webkitNotifications.checkPermission();
if (permission == 0) {
createNotification(tab);
} else if (new Date() - requestTime < waitTime) {
setTimeout(arguments.callee, checkPerMiniSec);
}
}, checkPerMiniSec);
} else if (permission == 0) {
createNotification(tab);
}
}
function createNotification(tab) {
var showSec = 10000;
var icon = "/School/UploadFiles_7810/201603/20160313153957930.png";
var title = "[" + new Date().toLocaleTimeString() + "] close after "
+ (showSec / 1000) + " seconds";
var body = "hello world, i am webkitNotifications informations";
var popup = window.webkitNotifications.createNotification(icon, title, body);
popup.tag = tab;
popup.ondisplay = function (event) {
setTimeout(function () {
event.currentTarget.cancel();
}, showSec);
};
popup.show();
}
</script>
</body>
</html>
這段程式示範了幾個實務細節:先檢查瀏覽器是否支援,再查權限狀態;若尚未決定則發起申請,並用輪詢的方式在使用者操作後的 5 秒內等待結果,避免剛按下就立刻判斷而失敗。通知建立後設定 tag 做分組,並在 ondisplay 裡掛一個計時器,讓它 10 秒後自動關閉,不佔著使用者的畫面。
值得補充的是,這套 webkitNotifications 屬於早期實作,後來 W3C 把它標準化為 Notification 建構子,權限改為 Notification.requestPermission() 並以 Promise 回傳結果,也新增了 Service Worker 環境下的推播能力。若你今天要實作,建議直接查閱標準化的 Notification API 與搭配 Service Worker 的做法;上面這套寫法可以作為理解權限模型與事件機制的入門。