nativeDialog
论坛示例
为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码供您参考。
概述
nativeDialog模块用原生的方式包裹html页面,从而实现能覆盖在原生页面上且可自定义界面的各种页面/dialog需求等! 比如:能覆盖在一些第三方SDK的原生页面(如:jVerification的手机认证页面、百川的原生页面等)之上,也可以通过设置html页面背景透明来实现原生dialog等功能。
openWin
打开win页面 注意: 1、关闭页面用 api.closeWin(); 2、iOS中想要做透明页面效果或需要覆盖在其他原生页面上,请使用openModal接口
openWin({params})
params
url:
- 类型:string
- 默认:无
- 描述: 页面路径,支持任意协议的路径,如标准的content://,res://,https://,以及APICloud扩展的widget://,fs://
name:
- 类型:string
- 默认:无
- 描述: 页面名称 iOS必传
animated:
- 类型:布尔值
- 默认:true
- 描述: 是否需要过渡动画 仅ios有效
其他参数: ios可以参考api.openWin的参数文档设置;但Android则只支持上面的url字段(如有传其他字段则作为pageParam的参数传入,且只支持字符传类型)
示例代码
var nativeDialog = api.require('nativeDialog');
nativeDialog.openWin({
urL: 'widget://html/win/nativeDialog.html',
name: 'test',
pageParam:{
test: 'testData'
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
openModal
以modal方式打开页面 仅ios
openModal({params})
params
url:
- 类型:string
- 默认:无
- 描述: 页面路径,支持任意协议的路径,如标准的content://,res://,https://,以及APICloud扩展的widget://,fs://
name:
- 类型:string
- 默认:无
- 描述: 页面名称 iOS必传
style:
- 类型:number
- 默认:4
- 描述: modal的呈现方式(modalPresentationStyle),取值范围:-2、 0 ~ 7
animated:
- 类型:布尔值
- 默认:true
- 描述: 是否需要过渡动画 仅ios有效
其他参数: 可以参考api.openWin的参数文档设置
示例代码
var nativeDialog = api.require('nativeDialog');
nativeDialog.openModal({
urL: 'widget://html/win/nativeDialog.html',
name: 'test',
style: 2 //2 7:大半屏可透明 4 5 6: 全屏可透明
});
可用性
ios系统
可提供的1.0.0及更高版本
closeModal
ios 关闭当前打开的modal页面 仅ios
closeModal({params})
params
animated:
- 类型:布尔值
- 默认:true
- 描述: 是否需要过渡动画
示例代码
var nativeDialog = api.require('nativeDialog');
nativeDialog.closeModal();
可用性
iOS系统
可提供的1.0.0及更高版本