HTML5 web通知API介绍

2015/04/17 · HTML5 · 2
评论 ·
web通知

本文由 伯乐在线 –
ElvisKang
翻译,周进林
校稿。未经许可,禁止转载!
英文出处:www.sevensignature.com。欢迎加入翻译组。

图片 1

在使用网页版Gmail的时候,每当收到新邮件,屏幕的右下方都会弹出相应的提示框。借助HTML5提供的Notification
API,我们也可以轻松实现这样的功能。

使用HTML5的Notification API制作web通知的教程,html5notification

这篇文章主要介绍了使用HTML5的Notification
API制作web通知的教程,示例包括需要使用到的相关CSS以及Javascript代码,需要的朋友可以参考下

在使用网页版Gmail的时候,每当收到新邮件,屏幕的右下方都会弹出相应的提示框。借助HTML5提供的Notification
API,我们也可以轻松实现这样的功能。
确保浏览器支持

如果你在特定版本的浏览器上进行开发,那么我建议你先到 caniuse
查看浏览器对Notification
API的支持情况,避免你将宝贵时间浪费在了一个无法使用的API上。
如何开始
 

JavaScript Code复制内容到剪贴板

  1. var notification=new Notification(‘Notification Title’,{  
  2.     body:’Your Message’   
  3. });   
  4.   

上面的代码构造了一个简陋的通知栏。构造函数的第一个参数设定了通知栏的标题,而第二个参数则是一个option
对象,该对象可设置以下属性:

  •     body :设置通知栏的正文内容。
        dir
    :定义通知栏文本的显示方向,可设为auto(自动)、ltr(从左到右)、rtl(从右到左)。
        lang
    :声明通知栏内文本所使用的语种。(译注:该属性的值必须属于BCP 47
    language tag。)
        tag:为通知栏分配一个ID值,便于检索、替换或移除通知栏。
        icon :设置作为通知栏icon的图片的URL

获取权限

在显示通知栏之前需向用户申请权限,只有用户允许,通知栏才可出现在屏幕中。对权限申请的处理将有以下返回值:

  •    
    default:用户处理结果未知,因此浏览器将视为用户拒绝弹出通知栏。(“浏览器:你没要求通知,我就不通知你了”)
        denied:用户拒绝弹出通知栏。(“用户:从我的屏幕里滚开”)
       
    granted:用户允许弹出通知栏。(“用户:欢迎!我很高兴能够使用这个通知功能”)
       
       

JavaScript Code复制内容到剪贴板

  1. Notification.requestPermission(function(permission){   
  2.     //display notification here making use of constructor
      
  3.     });   
  4.   

用HTML创建一个按钮
 

XML/HTML Code复制内容到剪贴板

  1. <button id=”button”>Read your notification</button>  
  2.   

不要忘记了CSS
 

CSS Code复制内容到剪贴板

  1. #button{   
  2.   font-size:1.1rem;   
  3.   width:200px;   
  4.   height:60px;   
  5.   border:2px solid #df7813;   
  6.   border-radius:20px/50px;   
  7.   background:#fff;   
  8.   color:#df7813;   
  9. }   
  10. #button:hover{   
  11.   background:#df7813;   
  12.   color:#fff;   
  13.   transition:0.4s ease;   
  14. }   
  15.   

全部的Javascript代码如下:
 

JavaScript Code复制内容到剪贴板

  1. document.addEventListener(‘DOMContentLoaded’,function(){   
  2.         document.getElementById(‘button’).addEventListener(‘click’,function(){   
  3.             if(! (‘Notification’ in window) ){   
  4.                 alert(‘Sorry bro, your browser is not good enough to display notification’);
      
  5.                 return;   
  6.             }       
  7.             Notification.requestPermission(function(permission){   
  8.                 var config = {   
  9.                               body:’Thanks for clicking that button. Hope you liked.’,
      
  10.                               icon:”,
      
  11.                               dir:’auto’  
  12.                               };   
  13.                 var notification = new Notification(“Here I am!”,config);   
  14.             });   
  15.         });   
  16.     });   
  17.   

从这段代码可以看出,如果浏览器不支持Notification
API,在点击按钮时将会出现警告“兄弟,很抱歉。你的浏览器并不能很好地支持通知功能”(Sorry
bro, your browser is not good enough to display
notification)。否则,在获得了用户的允许之后,我们自制的通知栏便可以出现在屏幕当中啦。

为什么要让用户手动关闭通知栏?

对于这个问题,我们可以借助setTimeout函数设置一个时间间隔,使通知栏能定时关闭。
 

JavaScript Code复制内容到剪贴板

  1. var config = {   
  2.                body:’Today too many guys got eyes on me, you did the same thing. Thanks’,
      
  3.                icon:’icon.png’,   
  4.                dir:’auto’  
  5.              }   
  6. var notification = new Notification(“Here I am!”,config);   
  7. setTimeout(function(){   
  8.     notification.close(); //closes the notification   
  9. },5000);   
  10.   

该说的东西就这些了。如果你意犹未尽,希望更加深入地了解Notification
API,可以阅读以下的页面:

    MDN
    Paul lund’s tutorial on notification API

在CodePen上查看demo

你可以在CodePen上看到由Prakash (@imprakash)编写的demo。

API制作web通知的教程,html5notification
这篇文章主要介绍了使用HTML5的Notification
API制作web通知的教程,示例包括需要使用到…

确保浏览器支持

如果你在特定版本的浏览器上进行开发,那么我建议你先到
caniuse
查看浏览器对Notification
API的支持情况,避免你将宝贵时间浪费在了一个无法使用的API上。

如何开始

JavaScript

var notification=new Notification(‘Notification Title’,{ body:’Your
Message’ });

1
2
3
var notification=new Notification(‘Notification Title’,{
    body:’Your Message’
});

上面的代码构造了一个简陋的通知栏。构造函数的第一个参数设定了通知栏的标题,而第二个参数则是一个option
对象,该对象可设置以下属性:

  • body :设置通知栏的正文内容。
  • dir
    :定义通知栏文本的显示方向,可设为auto(自动)、ltr(从左到右)、rtl(从右到左)。
  • lang
    :声明通知栏内文本所使用的语种。(译注:该属性的值必须属于BCP 47
    language tag。)
  • tag:为通知栏分配一个ID值,便于检索、替换或移除通知栏。
  • icon :设置作为通知栏icon的图片的URL

相关文章