分享 8 个有趣且实用的 API

(给前端大全加星标,提升前端技能

作者:小生方勤 公号 / 小生方勤 (本文来自作者投稿)


前言

在日常开发中总是和各种 API 打交道,我们名为前端工程师实为 API 调用工程师。这篇文章我就分享 8 个有趣的 API,你若通过阅读这篇文章对前端增加一点点的乐趣,对我来说也是一种鼓励。

这几个 API 使用得当的话,可以提高你应用的友好性。

这些 API 的示例代码我已放在 github 上了,地址:https://github.com/wanqihua/The-dictionary-of-front-end-test。感兴趣的可以 clone 代码到本地运行。望给个 star 支持一下。

API 也可以如此有趣

先看效果图:


640?wx_fmt=gif

1. 监听屏幕旋转变化接口: orientationchange

定义:

这个 API 可以将你手机是否横屏的情况暴露给需要知道的人知道。

使用:

 
 
  1. screenOrientation: function(){

  2. let self = this;

  3. let orientation = screen.orientation || screen.mozOrientation || screen.msOrientation;

  4. window.addEventListener("onorientationchange" in window ? "orientationchange" : "resize", function() {

  5. self.angle = orientation.angle;

  6. });

  7. },

orientation.angle 值屏幕方向
0竖屏
90向左横屏
-90/270向右横屏
180倒屏

通过这个 API 我们在横屏和竖屏的时候可以添加一些动作或者是样式的改变。

如果只是样式的改变也可以通过媒体查询来监听:

 
 
  1. /* 竖屏 */

  2. @media screen and (orientation: portrait) {

  3. // some css code

  4. }

  5. /* 横屏 */

  6. @media screen and (orientation: landscape) {

  7. // some css code

  8. }

2. 电池状态:navigator.getBattery()

定义:

这个 API 可以将你手机电池状态的情况暴露给需要知道的人知道。

这个 api 返回的是一个 promise 对象,会给出一个 BatteryManager 对象,对象中包含了以下信息:

key描述备注
charging是否在充电可读属性
chargingTime若在充电,还需充电时间可读属性
dischargingTime剩余电量可读属性
level剩余电量百分数可读属性
onchargingchange监听充电状态的改变可监听事件
onchargingtimechange监听充电时间的改变可监听事件
ondischargingtimechange监听电池可用时间的改变可监听事件
onlevelchange监听剩余电量百分数的改变可监听事件

使用:

 
 
  1. getBatteryInfo: function(){

  2. let self = this;

  3. if(navigator.getBattery){

  4. navigator.getBattery().then(function(battery) {

  5. // 判断是否在充电

  6. self.batteryInfo = battery.charging ? `在充电 : 剩余 ${battery.level * 100}%` : `没充电 : 剩余 ${battery.level * 100}%`;

  7. // 电池充电状态改变事件

  8. battery.addEventListener('chargingchange', function(){

  9. self.batteryInfo = battery.charging ? `在充电 : 剩余 ${battery.level * 100}%` : `没充电 : 剩余 ${battery.level * 100}%`;

  10. });

  11. });

  12. }else{

  13. self.batteryInfo = '不支持电池状态接口';

  14. }

  15. },

3. 让你的手机震动: window.navigator.vibrate(200)

定义:

这个 API 可以让你的手机按你的想法震动。

使用:
震动效果会在很多游戏使用。比如欢乐斗地主中,地主打完王炸后手机都会有震动的效果,以此来表达地主嘚瑟的心情也很是合理。

示例代码如下:

 
 
  1. vibrateFun: function(){

  2. let self = this;

  3. if( navigator.vibrate ){

  4. navigator.vibrate([500, 500, 500, 500, 500, 500, 500, 500, 500, 500]);

  5. }else{

  6. self.vibrateInfo = "您的设备不支持震动";

  7. }

  8. <!--

  9. // 清除震动

  10. navigator.vibrate(0);

  11. // 持续震动

  12. setInterval(function() {

  13. navigator.vibrate(200);

  14. }, 500);

  15. -->

  16. },

4. 当前语言:navigator.language

定义:

这个 API 可以告诉你当前应该使用什么语言。

如果你需要和我一样做多语言适配,这个 API 或许可以给你提供一个不错的思路。

使用:

640?wx_fmt=png

不同浏览器返回的值稍微有点差异。你可以通过以下封装好的方法来消除这种差异:

 
 
  1. function getThisLang(){

  2. const langList = ['cn','hk','tw','en','fr'];

  3. const langListLen = langList.length;

  4. const thisLang = (navigator.language || navigator.browserLanguage).toLowerCase();

  5. for( let i = 0; i < langListLen; i++ ){

  6. let lang = langList[i];

  7. if(thisLang.includes(lang)){

  8. return lang

  9. }else {

  10. return 'en'

  11. }

  12. }

  13. }

不同的语言就对应不同的语言文案就好。

5. 联网状态:navigator.onLine

定义:

这个 API 可以告诉让你知道你的设备的网络状态是否连接着。

使用:

比如我上午登陆了掘金在看一篇文章,可是没看完就到了吃饭的点,这么热爱学习的我肯定是选择吃完午饭回来继续看。

30 分钟过后……

吃晚饭回到公司,打开电脑继续把那篇文章看完,看完了打算点了赞,发现给了这个提示:

640?wx_fmt=png

这个提示让我有点懵(就是没网络了)。

这个时候我们就可以使用这个 API,这样就可以准确的告诉用户“您的网络无法连接,请检查”。这样用户是不是可以有更好的体验呢?

代码如下:

 
 
  1. mounted(){

  2. let self = this;

  3. window.addEventListener('online', self.updateOnlineStatus, true);

  4. window.addEventListener('offline', self.updateOnlineStatus, true);

  5. },

  6. methods: {

  7. updateOnlineStatus: function(){

  8. var self = this;

  9. self.onLineInfo = navigator.onLine ? "online" : "offline";

  10. },

  11. }

注意:navigator.onLine 只会在机器未连接到局域网或路由器时返回 false,其他情况下均返回 true。也就是说,机器连接上路由器后,即使这个路由器没联通网络, navigator.onLine 仍然返回 true

6. 页面可编辑:contentEditable

定义:

这个 API 可以使页面所有元素成为可编辑状态,使浏览器变成你的编辑器。

使用:

  1. 你可以在地址栏输入 data:text/html,<html contenteditable>, 这样浏览器就变成了编辑器。

640?wx_fmt=gif

使用场景:

需求 —— 页面需要一个文本输入框。

  1. 该文本输入框默认状态下有默认文本提示信息

  2. 文本框输入状态下其高度会随文本内容自动撑开

像这样的需求我们就可以使用 <divcontentEditable='true'></div> 代替 <textarea>标签。

不过 contentEditable='true' 是不会有 placeholder 的,那 placeholder 怎么办呢?

我一般会使用如下方案,输入内容后改变 class:

 
 
  1. <div class='haveInput' contentEditable='true' placeholder='请输入'></div>

  2. // css 样式

  3. .haveInput:before {

  4. content: attr(placeholder);

  5. display: block;

  6. color: #333;

  7. }

7. 浏览器活跃窗口监听: window.onblur & window.onfocus

定义:

这两个 api 分别表示窗口失去焦点和窗口处于活跃状态。

浏览其他窗口、浏览器最小化、点击其他程序等, window.onblur 事件就会触发;
回到该窗口, window.onfocus 事件就会触发。

使用:640?wx_fmt=gif

上面的截图是微信网页版的消息提示。

代码很简单:

 
 
  1. mounted(){

  2. let self = this;

  3. window.addEventListener('blur', self.doFlashTitle, true);

  4. window.addEventListener('focus', function () {

  5. clearInterval(self.timer);

  6. document.title = '微信网页版';

  7. }, true);

  8. },

  9. methods: {

  10. doFlashTitle: function(){

  11. var self = this;

  12. self.timer = setInterval( () => {

  13. if (!self.flashFlag) {

  14. document.title = "微信网页版";

  15. } else {

  16. document.title = `微信(${self.infoNum})`;

  17. }

  18. self.flashFlag = ! self.flashFlag

  19. }, 500)

  20. },

  21. }

8. 全屏 API(Fullscreen API)

定义:

这个 API 可以使你所打开的页面全屏展示,没有其他页面外的内容展示在屏幕上。

使用:

Element.requestFullscreen() 方法用于发出异步请求使元素进入全屏模式。

调用此 API 并不能保证元素一定能够进入全屏模式。如果元素被允许进入全屏幕模式,document 对象会收到一个 fullscreenchange 事件,通知调用者当前元素已经进入全屏模式。如果全屏请求不被许可,则会收到一个 fullscreenerror 事件。

当进入/退出全屏模式时,会触发 fullscreenchange 事件。你可以在监听这个事件,做你想做的事。

 
 
  1. fullScreenFun: function(){

  2. let self = this;

  3. var fullscreenEnabled = document.fullscreenEnabled ||

  4. document.mozFullScreenEnabled ||

  5. document.webkitFullscreenEnabled ||

  6. document.msFullscreenEnabled;


  7. if (fullscreenEnabled) {

  8. let de = document.documentElement;

  9. if(self.fullScreenInfo === '打开全屏'){

  10. if( de.requestFullscreen ){

  11. de.requestFullscreen();

  12. }else if( de.mozRequestFullScreen ){

  13. de.mozRequestFullScreen();

  14. }else if( de.webkitRequestFullScreen ){

  15. de.webkitRequestFullScreen();

  16. }

  17. self.fullScreenInfo = '退出全屏'

  18. } else {

  19. if( document.exitFullscreen ){

  20. document.exitFullscreen();

  21. }else if( document.mozCancelFullScreen ){

  22. document.mozCancelFullScreen();

  23. }else if( document.webkitCancelFullScreen ){

  24. document.webkitCancelFullScreen();

  25. }

  26. self.fullScreenInfo = '打开全屏'

  27. }

  28. } else {

  29. self.fullScreenInfo = '浏览器当前不能全屏';

  30. }

  31. }

相关:

  1. document.fullscreenElement: 当前处于全屏状态的元素 element

  2. document.fullscreenEnabled: 标记 fullscreen 当前是否可用

  3. document.exitFullscreen(): 退出全屏

后记

这篇文章很简单。我的目的是想介绍一下有趣的 API,来提高大家对前端的一点兴趣。

我认为这些 API 比较有趣,若你一直疲于业务,那么这些 API 或许可以给你不一样的感受。


【本文作者】


小生方勤:「前端词典」系列文章作者,致力于输出对读者有帮助的文章。



推荐阅读

(点击标题可跳转阅读)

为什么 'XX' 不是一个 Hooks API?

认识 Fetch API

Page Lifecycle API 教程


觉得本文对你有帮助?请分享给更多人

关注「前端大全」加星标,提升前端技能

640?wx_fmt=png

好文章,我在看❤️

  • 0
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值