html5 api navigator,Navigator - 《HTML5 Plus API 指南》 - 书栈网 · BookStack

navigator

navigator用于管理浏览器运行环境信息

方法：

对象：

回调方法：

权限：

5+功能模块(permissions){

// ...

"permissions":{

// ...

"Navigator":{

"description":"浏览器信息"

}

}

}

checkPermission

检查运行环境的权限Stringplus.navigator.checkPermission(permission);

说明：

向系统检查当前程序的权限状态，不触发权限相对应的功能API的调用。

参数：permission:

返回值：

String: 可返回以下值："authorized"表示程序已被用户授权使用此权限；"denied"表示程序已被用户拒绝使用此权限；"undetermined"表示程序未确定是否可使用此权限，此时调用对应的API时系统会弹出提示框让用户确认；"notdeny"表示程序未被用户拒绝使用此权限(与denied相反，可能是"authorized"或者"undetermined")；"unknown"表示程序未知此权限状态(系统存在权限管理但无法查询)；"unsupported"表示程序不支持此权限。

示例：

navigator Example

// H5 plus事件处理

functionplusReady(){

}

if(window.plus){

plusReady();

}else{

document.addEventListener('plusready',plusReady,false);

}

// 检查定位权限

functioncheckPermissionPos(){

varpp=plus.navigator.checkPermission('LOCATION');

switch(pp){

case'authorized':

plus.nativeUI.alert('已开启定位权限');

break;

case'denied':

plus.nativeUI.alert('已关闭定位权限');

break;

case'undetermined':

plus.nativeUI.alert('未确定定位权限');

break;

case'unknown':

plus.nativeUI.alert('无法查询定位权限');

break;

default:

plus.nativeUI.alert('不支持定位权限');

break;

}

}

检查权限

检查定位权限

closeSplashscreen

关闭应用启动界面void plus.navigator.closeSplashscreen();

说明：

很多情况下，应用启动后需要一段时间加载数据，为了避免界面显示空白内容，提高用户体验效果，这时可显示启动界面。等数据加载完成后再关闭启动界面进入应用，通常可在应用首界面加载数据完成并更新显示内容后调用此方法。注意：HBuilder7.1版本后启动界面不调用此方法超过6秒后会自动关闭。

参数：

无

返回值：

void: 无

示例：

navigator Example

// H5 plus事件处理

function plusReady(){

// 关闭程序启动界面

plus.navigator.closeSplashscreen();

}

if(window.plus){

plusReady();

}else{

document.addEventListener('plusready', plusReady, false);

}

关闭程序启动界面

hasNotchInScreen

查询设备是否为刘海屏Boolean plus.navigator.hasNotchInScreen();

说明：

刘海屏返回true，否则返回false。

参数：

无

返回值：

Boolean: true表示设备屏幕为刘海屏，false表示设备屏幕不是刘海屏。

平台支持：Android- ALL(支持): 暂时仅支持华为、小米、Oppo、Vivo等品牌设备。

iOS- ALL(支持)

示例：

navigator Example

// H5 plus事件处理

function plusReady(){

// 关闭程序启动界面

plus.navigator.closeSplashscreen();

}

if(window.plus){

plusReady();

}else{

document.addEventListener('plusready', plusReady, false);

}

// 查询是否刘海屏设备

function hasNotch(){

if(plus.navigator.hasNotchInScreen()){

alert('此设备是刘海屏');

}else{

alert('此设备不是刘海屏');

}

}

查询设备是否为刘海屏

查询

hasSplashscreen

查询应用启动界面是否已关闭Boolean plus.navigator.hasSplashscreen();

说明：

如果启动界面显示返回true，否则返回false。

参数：

无

返回值：

Boolean: true表示启动界面还存在(未关闭)，false表示启动界面不存在(已关闭)。

示例：

navigator Example

// H5 plus事件处理

function plusReady(){

// 关闭程序启动界面

plus.navigator.closeSplashscreen();

}

if(window.plus){

plusReady();

}else{

document.addEventListener('plusready', plusReady, false);

}

// 查询是否关闭启动界面

function hasSplash(){

if(plus.navigator.hasSplashscreen()){

alert('启动界面未关闭');

}else{

alert('启动界面已关闭');

}

}

查询应用启动界面是否已关闭

查询

updateSplashscreen

更新程序启动界面void plus.navigator.updateSplashscreen(options);

说明：

可设置启动界面显示的图片(仅支持本地文件路径，如果是网络资源可先通过plus.downloader.*下载到本地)，更新启动界面后程序下次启动时生效。

参数：options:

返回值：

void: 无

平台支持：Android- ALL(支持)

iOS- ALL(不支持)

示例：

navigator Example

// H5 plus事件处理

function plusReady(){

}

if(window.plus){

plusReady();

}else{

document.addEventListener('plusready', plusReady, false);

}

// 更新启动界面

function updateSplash(){

plus.navigator.updateSplashscreen({image:'_www/splash.png'});

}

更新程序启动界面

Update

createShortcut

创建应用快捷方式void plus.navigator.createShortcut(options, successCallback);

说明：

在系统桌面创建应用的快捷方式，点击后可直接启动应用。

参数：