Notificare - interfețe web api, mdn

proiectant

proprietăți proprii

Proprietățile sunt disponibile numai pentru obiectul Notificare.

Notificare.permiterea numai pentru citire Un șir indicând drepturile de acces curente pentru afișarea notificărilor. Valorile posibile sunt: negat (utilizatorul a refuzat să afișeze notificări), acordate (utilizatorul a consimțit la afișarea notificării), implicit (alegerea utilizatorului nu este cunoscută, și așa mai departe browser-ul va acționa ca în cazul în care valoarea a fost refuzat).

Proprietățile instanței

Proprietățile sunt disponibile numai pentru o instanță a obiectului Notificare.

Notification.title Citește notificare Numai titlu indicat în opțiunile ca parametru constructorului. Notification.dir numai pentru citire Direcția textului de notificare este specificată în opțiuni ca parametru constructor. Notification.lang Citiți observați doar codul de limbă este specificat în opțiunile ca parametru constructorului. Notificare.body Numai pentru citire Corpul principal (textul) notificării este specificat în opțiuni ca parametru constructor. Notification.tag Numai pentru citire Identificatorul de notificare (id) este specificat în opțiuni ca parametru constructor. Notification.icon URL-ul pentru citirea numai pentru imaginea de notificare este specificat în opțiuni ca parametru constructor. Notification.data Read-only Returnă o copie a informațiilor de notificare. Notification.requireInteraction numai citire valoare boolean este identificatorul dispozitivului cu un ecran suficient de mare, iar o notificare va rămâne activă până când utilizatorul face clic pe anunțul, sau închideți-l. Notification.silent numai în citire Indică dacă notificarea trebuie să fie însoțită de sunet sau semnal de vibrații, indiferent de setările dispozitivului.

Proprietăți neacceptate

Următoarele proprietăți sunt enumerate în specificația cea mai recentă, dar până în prezent nu sunt acceptate în toate browserele. Este recomandabil să verificați în mod regulat relevanța informațiilor și dacă observați un material depășit, vă rugăm să ne informați.

Notification.noscreen citit Specifică dacă afișajul polzotelsky ar trebui să includă numai (în cazul în care a fost oprit) atunci când primiți o notificare sau nu Notification.renotify Numai citire Specifică dacă noua notificare de utilizator înlocuiește pe cel anterior. Notification.sound Citiți Definește numai fișierul audio pentru a reda atunci când sistemul de sunet de notificare este instalat în mod implicit. Notification.sticky numai de citire Stabilește dacă un anunț de a fi „lipicios“, care nu este ușor să se închidă. Notification.vibrate Citește Setează Numai modelul de vibrație pentru dispozitivele să vibreze.

Manageri de evenimente

Notificare.onclick Faceți clic pe instrumentul de procesare a evenimentului pentru clicuri. Se procesează de fiecare dată când utilizatorul face clic pe notificare. Notification.onerror Eroare handler de evenimente. Procesată de fiecare dată când apare

Agenți de procesare a evenimentelor depășite

Următoarele dispozitive de tratare a evenimentelor sunt încă acceptate, după cum se arată în secțiunea de mai jos compatibilitatea cu browser-ul. dar care nu sunt incluse în specificația curentă. În versiunile viitoare ale browserului, ei pot să nu mai funcționeze.

Notificare.închidere Operatorul de eveniment se închide. Acesta este procesat când utilizatorul încearcă să închidă notificarea. Notificare.configurabilă Manipularea evenimentului pentru afișare. Procesată când este afișată o notificare.

Metode proprii

Metode disponibile numai pentru obiectul Notificare.

Notification.requestPermission () Promovează utilizatorul să afișeze notificări.

Metode de instanță

Aceste metode sunt disponibile numai pentru o instanță a obiectului Notificare sau printr-un prototip. Obiectul Notificare, de asemenea, moștenește metodele EventTarget ale interfeței.

Notification.close () Software-ul închide notificarea.

Este posibil să trimiteți notificări mai jos. Codul este descris în detaliu în comentarii și poate fi folosit dacă doriți. La început, se verifică dacă notificările sunt acceptate în dispozitivul client, dacă răspunsul este pozitiv, atunci permisiunea de a trimite notificarea este verificată sau este solicitată permisiunea.

În majoritatea cazurilor, nu trebuie să fii atât de verbală. De exemplu, în demo-ul nostru Emogotchi (vezi sursa), vom rula doar Notification.requestPermission indiferent dacă am primit permisiunea de a trimite notificări:

Apoi, vom rula o funcție spawnNotification simplă (), atunci când vrem să rulați argumentele peredaom de notificare pentru a specifica principala parte, pictogramele și antetul pe care ne-o dorim, atunci se creează un obiect de parametri și opțiuni necesare declanșează o notificare folosind notificare () constructor.

specificație

[1] Înainte de Chrome 22, suportul pentru notificare a urmat o versiune veche prefixată a caietului de sarcini și a utilizat obiectul navigator.webkitNotifications pentru a crea o nouă notificare.

Înainte de Chrome 42, adăugările lucrătorilor de serviciu nu sunt acceptate.

[2] Înainte de Firefox 22 (Firefox OS <1.2), the instantiation of a new notification must be done with the navigator.mozNotification object through its createNotification method.

Înainte de Firefox 22 (Firefox OS <1.2), the Notification was displayed when calling the show method and supported only the click and close events.

Nick Desaulniers a scris notificarea shim. Pentru a acoperi atât implementările noi, cât și cele vechi.

O problemă specială pentru sistemul de operare Firefox este că nu puteți utiliza o cale relativă, cum ar fi /my_icon.png. De asemenea, nu se poate folosi window.location.origin + „/my_icon.png“, deoarece window.location.origin este nulă în aplicațiile împachetate. Aceasta este data lansării pentru Firefox OS 1.1+. O soluție potențială pentru susținerea sistemului de operare Firefox <1.1 is to pass an absolute URL to an externally hosted version of the icon. This is less than ideal as the notification is displayed immediately without the icon, then the icon is fetched, but it works on all versions of Firefox OS.

Când utilizați notificările într-o aplicație pentru sistemul de operare Firefox, asigurați-vă că adăugați permisiunea de notificare pentru desktop în fișierul manifest. Notificările pot fi utilizate la orice nivel de permisiune, găzduit sau deasupra: "permisiuni": <"desktop-notification": <>>

[3] Safari a început să susțină notificările cu Safari 6, dar numai pe Mac OSX 10.8+ (Mountain Lion).

Vezi de asemenea

Etichetele și participanții la documente

Mulțumesc! Verificați-vă căsuța de e-mail pentru a vă confirma abonamentul.

Dacă nu ați confirmat anterior un abonament la buletinul informativ Mozilla, este posibil să fie necesar să o faceți. Verificați dosarul Inbox sau Spam în cutia poștală pentru a vedea dacă e-mailul a venit de la noi.

Ascundeți abonamentul la newsletter

Articole similare

Pagina anterioară

Pagina următoare