通知選項分為兩個部分,一個用於處理視覺方面 (本節),另一個則用於說明通知的行為方面 (下一節)。
您可以使用 Peter Beverloo 的通知產生器,在各種平台上的各種瀏覽器中試用各種通知選項。
視訊選項
顯示通知的 API 很簡單:
<ServiceWorkerRegistration>.showNotification(<title>, <options>);
title 和 options 這兩個引數都是選用引數。
標題是字串,選項可以是下列任一項:
{
"//": "Visual Options",
"body": "<String>",
"icon": "<URL String>",
"image": "<URL String>",
"badge": "<URL String>",
"dir": "<String of 'auto' | 'ltr' | 'rtl'>",
"timestamp": "<Long>"
"//": "Both visual & behavioral options",
"actions": "<Array of Strings>",
"data": "<Anything>",
"//": "Behavioral Options",
"tag": "<String>",
"requireInteraction": "<boolean>",
"renotify": "<Boolean>",
"vibrate": "<Array of Integers>",
"sound": "<URL String>",
"silent": "<Boolean>",
}
以下是視覺選項:

標題和內文選項
在 Windows 上的 Chrome 中,沒有標題和選項的通知會像這樣:

如您所見,瀏覽器名稱會做為標題,「New notification」預留位置則會做為通知內文。
如果裝置上安裝了漸進式網頁應用程式,系統會使用網頁應用程式名稱,而非瀏覽器名稱:

如果執行下列程式碼:
const title = 'Simple Title';
const options = {
body: 'Simple piece of body text.\nSecond line of body text :)',
};
registration.showNotification(title, options);
Linux 上的 Chrome 會顯示以下通知:

在 Linux 上的 Firefox 中,看起來會像這樣:

在 Linux 上的 Chrome 中,標題和內文含有大量文字的通知看起來像這樣:

Linux 上的 Firefox 會收合內文,直到你將滑鼠游標懸停在通知上,通知才會展開:


在 Windows 上的 Firefox 中,相同的通知會顯示如下:


如您所見,同一則通知在不同瀏覽器中可能會有不同的外觀。在不同平台上使用相同瀏覽器,也可能會有不同的外觀。
Chrome 和 Firefox 會在支援系統通知和通知中心的平台上使用這些功能。
舉例來說,macOS 上的系統通知不支援圖片和動作 (按鈕和內嵌回覆)。
Chrome 也為所有電腦平台提供自訂通知。如要啟用,請將 chrome://flags/#enable-system-notifications 旗標設為 Disabled 狀態。
圖示
icon 選項基本上是一張小圖片,可顯示在標題和內文旁邊。
您必須在程式碼中提供要載入的圖片網址:
const title = 'Icon Notification';
const options = {
icon: '/images/demos/icon-512x512.png',
};
registration.showNotification(title, options);
在 Linux 上的 Chrome 中,你會收到以下通知:
![]()
Linux 上的 Firefox:
![]()
很遺憾,目前沒有任何明確的指南,說明圖示應使用多大的圖片。
Android 似乎需要 64dp 的圖片 (即 64px 乘以裝置像素比例)。
假設裝置的最高像素比例為 3,則圖示大小至少應為 192 像素。
徽章
badge 是單色小圖示,用於向使用者提供更多資訊,說明通知來源:
const title = 'Badge Notification';
const options = {
badge: '/images/demos/badge-128x128.png',
};
registration.showNotification(title, options);
撰寫本文時,這個徽章僅用於 Android 版 Chrome。

在其他瀏覽器 (或沒有徽章的 Chrome) 上,則會看到瀏覽器圖示。

與 icon 選項一樣,沒有實際的大小使用指南。
根據 Android 指南,建議的大小為 24 像素乘以裝置像素比例。
也就是說,72 像素以上的圖片應該就足夠 (假設裝置像素比例上限為 3)。
圖片
image 選項可用來向使用者顯示較大的圖片。這項功能特別適合用來向使用者顯示預覽圖片。
const title = 'Image Notification';
const options = {
image: '/images/demos/unsplash-farzad-nazifi-1600x1100.jpg',
};
registration.showNotification(title, options);
在 Linux 上的 Chrome 中,通知會如下所示:

在 Android 版 Chrome 中,裁剪和比例有所不同:

由於電腦和行動裝置的比例不同,因此很難提供準則。
由於電腦版 Chrome 不會填滿可用空間,且比例為 4:3,因此最好的做法可能是提供這個比例的圖片,並允許 Android 裁剪圖片。不過,image 選項仍可能有所變動。
在 Android 上,唯一的指南是寬度為 450dp。
根據這項準則,寬度 1350 像素以上的圖片會是理想選擇。
動作 (按鈕)
您可以定義 actions,在通知中顯示按鈕:
const title = 'Actions Notification';
const options = {
actions: [
{
action: 'coffee-action',
type: 'button',
title: 'Coffee',
icon: '/images/demos/action-1-128x128.png',
},
{
action: 'doughnut-action',
type: 'button',
title: 'Doughnut',
icon: '/images/demos/action-2-128x128.png',
},
{
action: 'gramophone-action',
type: 'button',
title: 'Gramophone',
icon: '/images/demos/action-3-128x128.png',
},
{
action: 'atom-action',
type: 'button',
title: 'Atom',
icon: '/images/demos/action-4-128x128.png',
},
],
};
registration.showNotification(title, options);
您可以為每個動作定義 title、action (基本上是 ID)、icon 和 type。通知中會顯示標題和圖示。偵測到使用者點選動作按鈕時,系統會使用這個 ID (詳情請參閱下一節)。由於 'button' 是預設值,因此可以省略類型。
撰寫本文時,只有 Chrome 和 Opera for Android 支援動作。
在上述範例中,我們定義了四個動作,說明您可以定義的動作數量多於顯示的數量。如要瞭解瀏覽器會顯示多少動作,可以查看 window.Notification?.maxActions:
const maxVisibleActions = window.Notification?.maxActions;
if (maxVisibleActions) {
options.body = `Up to ${maxVisibleActions} notification actions can be displayed.`;
} else {
options.body = 'Notification actions are not supported.';
}
在電腦上,動作按鈕圖示會顯示顏色 (請見粉紅色甜甜圈):

在 Android 6 以下版本中,圖示會根據系統色彩配置上色:

在 Android 7 以上版本中,則完全不會顯示動作圖示。
Chrome 預計會變更電腦版的行為,使其與 Android 版一致 (即套用適當的色彩配置,讓圖示與系統外觀和風格一致)。在此期間,您可以將圖示顏色設為 #333333,以符合 Chrome 的文字顏色。
另外值得注意的是,圖示在 Android 裝置上看起來很清晰,但在電腦上則否。
在電腦版 Chrome 上,我能使用的最佳大小是 24px x 24px。在 Android 上,這看起來很不協調。
根據這些差異,我們建議的最佳做法如下:
- 圖示應採用一致的色彩配置,至少所有圖示都能一致地向使用者顯示。
- 請確認圖示在單色模式下也能正常顯示,因為部分平台可能會以這種方式顯示圖示。
- 請測試大小,找出最適合你的尺寸。128px × 128px 在 Android 上運作良好,但在電腦上品質不佳。
- 動作圖示完全不會顯示。
Notification 規格正在探索定義多種圖示大小的方法,但似乎還需要一段時間才能達成共識。
動作 (內嵌回覆)
您可以使用 'text' 類型定義動作,在通知中加入內嵌回覆:
const title = 'Alexey Rodionov';
const options = {
body: 'How are you doing? )',
image: '/images/demos/avatar-512x512.jpg',
icon: '/images/demos/icon-512x512.png',
badge: '/images/demos/badge-128x128.png',
actions: [
{
action: 'reply',
type: 'text',
title: 'Reply',
icon: '/images/demos/action-5-128x128.png',
}
],
};
registration.showNotification(title, options);
在 Android 裝置上,畫面會像這樣:

點選動作按鈕後,會開啟文字輸入欄位:

您可以自訂文字輸入欄位的預留位置:
const title = 'Alexey Rodionov';
const options = {
body: 'How are you doing? )',
icon: '/images/demos/avatar-512x512.jpg',
badge: '/images/demos/badge-128x128.png',
actions: [
{
action: 'reply',
type: 'text',
title: 'Reply',
icon: '/images/demos/action-5-128x128.png',
placeholder: 'Type text here',
}
],
};
registration.showNotification(title, options);

在 Windows 版 Chrome 中,文字輸入欄位一律會顯示,不必點選動作按鈕:

您可以新增多個內嵌回覆,或結合按鈕和內嵌回覆:
const title = 'Poll';
const options = {
body: 'Do you like this photo?',
image: '/images/demos/cat-image.jpg',
icon: '/images/demos/icon-512x512.png',
badge: '/images/demos/badge-128x128.png',
actions: [
{
action: 'yes',
type: 'button',
title: '👍 Yes',
},
{
action: 'no',
type: 'text',
title: '👎 No (explain why)',
placeholder: 'Type your explanation here',
},
],
};
registration.showNotification(title, options);

方向
dir 參數可讓您定義文字的顯示方向,從右到左或從左到右。
在測試中,方向似乎主要由文字決定,而非這個參數。根據規格,這項屬性旨在向瀏覽器建議如何配置動作等選項,但我並未看到任何差異。
建議您盡可能定義,否則瀏覽器應根據提供的文字執行正確操作。
參數應設為 auto、ltr 或 rtl。
在 Linux 上的 Chrome 中,由右向左書寫的語言看起來像這樣:

在 Firefox 中 (將滑鼠游標懸停在上方時),您會看到以下內容:

震動
震動選項可讓您定義顯示通知時執行的震動模式,前提是使用者目前的設定允許震動 (即裝置未處於靜音模式)。
震動選項的格式應為數字陣列,用於描述裝置應震動的毫秒數,後面接著裝置「不」應震動的毫秒數。
const title = 'Vibrate Notification';
const options = {
// Star Wars shamelessly taken from the awesome Peter Beverloo
// https://tests.peter.sh/notification-generator/
vibrate: [
500, 110, 500, 110, 450, 110, 200, 110, 170, 40, 450, 110, 200, 110, 170,
40, 500,
],
};
registration.showNotification(title, options);
這項設定只會影響支援震動功能的裝置。
音效
sound 參數可讓您定義收到通知時要播放的音效。
撰寫本文時,沒有任何瀏覽器支援這個選項。
const title = 'Sound Notification';
const options = {
sound: '/demos/notification-examples/audio/notification-sound.mp3',
};
registration.showNotification(title, options);
時間戳記
時間戳記可讓您告知平台事件發生的時間,以便傳送推播通知。
timestamp 應為自 1970 年 1 月 1 日 00:00:00 UTC (即 UNIX 紀元) 起算的毫秒數。
const title = 'Timestamp Notification';
const options = {
body: 'Timestamp is set to "01 Jan 2000 00:00:00".',
timestamp: Date.parse('01 Jan 2000 00:00:00'),
};
registration.showNotification(title, options);
使用者體驗最佳做法
我見過最嚴重的通知使用者體驗失敗,就是通知顯示的資訊不夠具體。
您應該考慮一開始傳送推播訊息的原因,並確保使用所有通知選項,協助使用者瞭解閱讀該通知的原因。
老實說,看到這些例子時,我們很容易會覺得「我絕對不會犯這種錯」。但其實比想像中更容易落入這個陷阱。
應避免的常見錯誤:
- 請勿在標題或內文中加入網站。瀏覽器會在通知中加入您的網域,因此請勿重複。
- 請善用所有可用資訊。如果因為有人傳送訊息給使用者而傳送推播訊息,請不要使用「新訊息」標題和「按這裡閱讀」內文,而是使用「John 剛傳送新訊息」標題,並將通知內文設為訊息的一部分。
瀏覽器和功能偵測
在撰寫本文時,Chrome 和 Firefox 在通知功能支援方面有很大的差異。
幸好,您可以查看 window.Notification 原型,偵測是否支援通知功能。
假設我們想知道通知是否支援動作按鈕,可以按照下列步驟操作:
if ('actions' in window.Notification?.prototype) {
// Action buttons are supported.
} else {
// Action buttons are NOT supported.
}
這樣一來,我們就能變更向使用者顯示的通知。
其他選項的操作方式與上述相同,只要將 'actions' 替換為所需參數名稱即可。