chrome.notifications
API, şablonları kullanarak bildirimler oluşturmanıza ve şu bildirimleri kullanıcının sistem tepsisinde kullanıcılara göstermenize olanak tanır:
Nasıl görünür?
Zengin bildirimler; temel, resim, liste ve ilerleme durumu olmak üzere dört farklı şekilde gelir. Tüm bildirimler bir başlık, mesaj, bildirim mesajının sol tarafında küçük bir simge ve daha açık renkli yazı tipinde üçüncü bir metin alanı olarak görüntülenen contextMessage
alanını içerir.
Temel bir bildirim:
Liste bildirimlerinde istenen sayıda liste öğesi gösterilir:
Resim bildirimleri bir resim önizlemesi içerir:
İlerleme bildirimleri bir ilerleme çubuğu gösterir:
Nasıl davrandıkları
ChromeOS'te bildirimler kullanıcının sistem tepsisinde gösterilir ve kullanıcı kapatana kadar sistem tepsisinde kalır. Sistem tepsisi tüm yeni bildirimlerin sayısını tutar. Kullanıcı sistem tepsisinde bildirimleri gördüğünde, sayı sıfırlanır.
Bildirimlere -2 ile 2 arasında bir öncelik atanabilir. 0'dan küçük öncelikler, ChromeOS bildirim merkezinde gösterilir ve diğer platformlarda hata mesajı verir. Varsayılan öncelik 0'dır. Sürenin uzaması için 0'dan büyük öncelikler gösterilir ve sistem tepsisinde daha yüksek öncelikli bildirimler görüntülenebilir.
priority
ayarı, macOS'te bildirimlerin sırasını etkilemez.
Tüm bildirim türleri, bilgi görüntülemenin yanı sıra en fazla iki işlem öğesi içerebilir. Kullanıcılar bir işlem öğesini tıkladığında uzantınız uygun işlemle yanıt verebilir. Örneğin, kullanıcı Yanıtla'yı tıkladığında e-posta uygulaması açılır ve kullanıcı yanıtı tamamlayabilir:
Bunlar nasıl geliştirilir?
Bu API'yi kullanmak için options
parametresini kullanarak bildirim ayrıntılarını ileterek notifications.create()
yöntemini çağırın:
await chrome.notifications.create(id, options);
notifications.NotificationOptions
, mevcut bildirim ayrıntılarını ve bu ayrıntıların nasıl görüntüleneceğini tanımlayan bir notifications.TemplateType
içermelidir.
Temel bildirim oluşturma
Tüm şablon türleri (basic
, image
, list
ve progress
) bir bildirim title
ve message
ile birlikte, bildirim mesajının sol tarafında görüntülenen küçük bir simgenin bağlantısı olan iconUrl
içermelidir.
Aşağıda basic
şablonu örneği verilmiştir:
var opt = {
type: "basic",
title: "Primary Title",
message: "Primary message to display",
iconUrl: "url_to_small_icon"
}
Resim kullanın
image
şablon türü, bildirim içinde önizlenen bir resmin bağlantısı olan imageUrl
öğesini de içerir. Resimlerin macOS'teki kullanıcılara gösterilmediğine dikkat edin.
var opt = {
type: "image",
title: "Primary Title",
message: "Primary message to display",
iconUrl: "url_to_small_icon",
imageUrl: "url_to_preview_image"
}
Liste oluşturma bildirimi
list
şablonu, items
öğelerini liste biçiminde gösterir. macOS'teki kullanıcılara yalnızca ilk öğenin gösterildiğini unutmayın.
var opt = {
type: "list",
title: "Primary Title",
message: "Primary message to display",
iconUrl: "url_to_small_icon",
items: [{ title: "Item1", message: "This is item 1."},
{ title: "Item2", message: "This is item 2."},
{ title: "Item3", message: "This is item 3."}]
}```
### Create progress notification {: #progress }
The `progress` template displays a progress bar where current progress ranges from 0 to 100. On macOS the progress bar displays as a percentage value in the notification title instead of in the progress bar.
```js
var opt = {
type: "progress",
title: "Primary Title",
message: "Primary message to display",
iconUrl: "url_to_small_icon",
progress: 42
}
Etkinlikleri dinleme ve yanıtlama
Tüm bildirimler, kullanıcı işlemlerine yanıt veren etkinlik işleyicileri ve etkinlik işleyicileri içerebilir (bkz. chrome.events
). Örneğin, bir notifications.onButtonClicked
etkinliğine yanıt verecek bir etkinlik işleyici yazabilirsiniz.
Etkinlik işleyici:
chrome.notifications.onButtonClicked.addListener(replyBtnClick);
Olay işleyici:
function replyBtnClick {
//Write function to respond to user action.
}
Uzantı çalışmıyorken bile bildirimlerin görüntülenebilmesi için hizmet çalışanına etkinlik işleyiciler ve işleyiciler eklemeyi düşünün.