DIV CSS 佈局教程網

用 Web Notifications API 實作跨裝置通知提示:從能力檢測到事件綁定
編輯:關於JavaScript     

今天專案基本都提測完了,趁著空檔寫兩篇記錄。上一篇《如何搭建 node 工程》想必有需要的讀者已經看過。這篇要展示的效果相當實用——在頁面右下角跳出作業系統層級的通知訊息——因此特別記錄下來,方便日後回頭查閱。

套路一樣,我們一步一步來,思路會比較清楚。

先看效果。注意右下角出現的彈出訊息,這正是我們要實作的:

第一步:先搭一個架子

以下程式碼都寫在 script 標籤內,只要關注 script 標籤裡的內容即可:

 <!DOCTYPE html>
<html>
<head lang="en">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta charset="utf-8">
<meta content="" name="description">
<meta content="" name="keywords">
<meta content="eric.wu" name="author">
<meta content="application/xhtml+xml;charset=UTF-8" http-equiv="Content-Type">
<meta property="qc:admins" />
<meta content="telephone=no, address=no" name="format-detection">
<meta content="width=device-width, initial-scale=1.0, minimum-scale=1.0,
               maximum-scale=1.0, user-scalable=no" name="viewport">
<title>消息推送實例</title>
</head>
<body>
查看右下角,的消息通知..........
</body>
</html>
<script type="text/javascript">
</script>

第二步:檢測瀏覽器是否支援 Web Notifications API

這一步是必要的入場檢查——只有支援這個 API,後續的一切才有意義。

 function justify_notifyAPI(){
  if (window.Notification) {
    // 支援
    console.log("支援" + "Web Notifications API");
  } else {
    // 不支援
    console.log("不支援" + "Web Notifications API");
  }
}

第三步:檢測瀏覽器是否允許彈出通知

這裡要先向使用者請求權限。若使用者曾經按下「封鎖」,後續建立通知的嘗試都會失敗,因此這個判斷不可省略。(圖片位址換成自己的即可)

 function justify_showMess(){
  if (window.Notification && Notification.permission !== "denied") {
    Notification.requestPermission(function(status) {
      if (status === "granted") {
        var n = new Notification('收到信息:-O', {
          body: '這裡是通知內容!你想看什麼客官?',
          icon: "../../images/headerPic/QQ圖片20160525234650.jpg"
        });
      } else {
        var n = new Notification("baby! i will leave you!");
      }
    });
  }
}

這裡有個關鍵設計:Notification.requestPermission 應該在使用者主動操作(例如點擊「開啟通知」按鈕)時呼叫,而不是頁面一載入就跳出詢問。前者是良好 manners,後者則會讓使用者反感並直接封鎖,反而永久失去機會。

第四步:Notification 構造函數的參數

Notification 構造函數的 title 屬性為必填,用於指定通知標題,格式為字串。options 屬性為選填,格式為一個物件,用於設定各項選項。該物件的屬性如下:

dir:文字方向,可能的值為 auto、ltr(從左到右)和 rtl(從右到左),一般繼承瀏覽器設定。

lang:使用的語種,比如 en-US、zh-CN。

body:通知內容,格式為字串,用於進一步說明通知的目的。

tag:通知的 ID,格式為字串。一組相同 tag 的通知不會同時顯示,只會在使用者關閉前一個通知後,於原位置顯示。

icon:圖示的 URL,用於顯示在通知上。

 function otification_construct(){
  var notification = new Notification('收到新郵件', {
    body: '您有1封來自雪靜的未讀郵件。',
    dir: "auto",
    lang: "zh-CN",
    tag: "a1",
    icon: "../../images/headerPic/772513932673948130.jpg"
  });

  console.log(notification.title); // "收到新郵件"
  console.log(notification.body);  // "您有1封來自雪靜的未讀郵件。"
}

tag 這個屬性實務上很好用:當同一類通知連續發生(例如新訊息),設定相同 tag 就能避免通知層層堆疊,永遠只保留最新一則。

第五步:Notifications API 的相關事件

Notification 實例會觸發以下四種事件:

show:通知顯示給使用者時觸發。

click:使用者點擊通知時觸發。

close:使用者關閉通知時觸發。

error:通知出錯時觸發(通知無法正確顯示時出現)。

這些事件對應 onshow、onclick、onclose、onerror 方法,用於指定相應的回呼函數。addEventListener 也可用來為這些事件指定回呼函數。

 function otification_event(){
  var MM = new Notification("Hi! My beautiful little princess!", {
    body: '您有1封來外太空的郵件。',
    icon: "../../images/headerPic/20100114212301-1126264202.jpg"
  });

  MM.onshow = function() {
    console.log('Notification showning!');
  };

  MM.onclick = function() {
    console.log('Notification have be click!');
  };

  MM.onerror = function() {
    console.log('Notification have be click!');
    MM.close(); // 手動關閉
  };
}

其中 onclick 在實務上最常被使用——通常會在這裡加上 window.focus() 把原視窗拉回前台,或 window.open() 導向相關頁面。少了這一步,使用者點了通知卻什麼都沒發生,體驗會很差。

完整 Demo 原始碼

 <!DOCTYPE html>
<html>
<head lang="en">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta charset="utf-8">
<meta content="" name="description">
<meta content="" name="keywords">
<meta content="eric.wu" name="author">
<meta content="application/xhtml+xml;charset=UTF-8" http-equiv="Content-Type">
<meta property="qc:admins" />
<meta content="telephone=no, address=no" name="format-detection">
<meta content="width=device-width, initial-scale=1.0, minimum-scale=1.0,
               maximum-scale=1.0, user-scalable=no" name="viewport">
<title>Web Notifications API</title>
</head>
<body>
查看右下角,的消息通知..........
</body>
</html>
<script type="text/javascript">
window.onload = function(){
  justify_notifyAPI();     // 判斷瀏覽器是否支援 Web Notifications API
  justify_showMess();      // 瀏覽器是否允許彈出實例
  otification_construct(); // 實例展示彈出的內容
  otification_event();     // Notifications API 的相關事件
}

// 判斷瀏覽器是否支援 Web Notifications API
function justify_notifyAPI(){
  if (window.Notification) {
    console.log("支援" + "Web Notifications API");
  } else {
    console.log("不支援" + "Web Notifications API");
  }
}

// 瀏覽器是否允許彈出實例
function justify_showMess(){
  if (window.Notification && Notification.permission !== "denied") {
    Notification.requestPermission(function(status) {
      if (status === "granted") {
        var n = new Notification('收到信息:-O', {
          body: '這裡是通知內容!你想看什麼客官?',
          icon: "../../images/headerPic/QQ圖片20160525234650.jpg"
        });
      } else {
        var n = new Notification("baby! i will leave you!");
      }
    });
  }
}

// 實例展示彈出的內容
function otification_construct(){
  var notification = new Notification('收到新郵件', {
    body: '您有1封來自雪靜的未讀郵件。',
    dir: "auto",
    lang: "zh-CN",
    tag: "a1",
    icon: "../../images/headerPic/772513932673948130.jpg"
  });

  console.log(notification.title);
  console.log(notification.body);
}

// Notifications API 的相關事件
function otification_event(){
  var MM = new Notification("Hi! My beautiful little princess!", {
    body: '您有1封來外太空的郵件。',
    icon: "../../images/headerPic/20100114212301-1126264202.jpg"
  });

  MM.onshow = function() { console.log('Notification showning!'); };
  MM.onclick = function() { console.log('Notification have be click!'); };
  MM.onerror = function() {
    console.log('Notification have be click!');
    MM.close();
  };
}
</script>

兩個實務上的重要限制

第一,必須在 HTTPS 環境下才能運作(localhost 例外)。以 http 提供的頁面,Notification API 會被瀏覽器直接停用,這是開發時最常踩的坑。

第二,行動裝置上的支援情況差異很大。在手機瀏覽器中,這個 API 長期支援不佳;若要在手機上收到通知,通常得走 PWA 搭配 Service Worker 與 Push API 的路線,或直接用各平台的推播服務。因此標題所說的「適用於手機和電腦」,在今日的實務中應該理解為:桌面瀏覽器可直接使用,行動裝置則需要額外的 PWA 建置。

最後提醒,Notification 一律需在 HTTPS 且取得使用者授權後才能建立。把請求權限的時機放在使用者明確表達意願的那一刻,是能否成功的一半關鍵。

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