EEUI.APP EEUI.APP 首页 文档 - 指南 - 组件 - 模块 插件 - 插件市场 - 开发文档 热更新 控制台 Editor 例子 社区 GitHub 首页 文档 - 指南 - 组件 - 模块 插件 - 插件市场 - 开发文档 热更新 控制台 Editor 例子 社区 GitHub - 模块 - adDialog广告弹窗 - ajax异步请求 - alert对话框 - caches缓存管理 - captcha验证弹窗 - keyboard键盘功能 - loading等待动画 - navigationBar标题栏 - navigator路由功能 - newPage页面功能 - eeui.openPage - eeui.getPageInfo - eeui.getPageInfoAsync - eeui.reloadPage - eeui.setSoftInputMode - eeui.setPageBackPressed - eeui.setOnRefreshListener - eeui.setRefreshing - eeui.setStatusBarStyle - eeui.setPageStatusListener - eeui.clearPageStatusListener - eeui.onPageStatusListener - eeui.getCacheSizePage - eeui.clearCachePage - eeui.closePage - eeui.closePageTo - eeui.openWeb - eeui.goDesktop - eeui.getConfigString - eeui.setCustomConfig - eeui.getCustomConfig - eeui.clearCustomConfig - eeui.realUrl - eeui.rewriteUrl - openOtherApp打开其他APP - plate复制粘贴 - saveImage保存图片 - getImageSize图片尺寸 - scaner二维码扫描 - share文字图片分享 - storage数据储存 - system系统信息 - toast提示功能 - version版本相关 - weex模块 - animation - clipboard - dom - globalEvent - meta - modal - picker - storage - stream - webview
    # # 页面功能

    需要加载的模块

    1. const eeui = app.requireModule('eeui');
    ## # eeui.openPage - 打开新App Js页面 或 打开新Web页面
    1. /
    2. @param params 详细参数
    3. @param callback 回调事件
    4. */
    5. eeui.openPage({params}, callback(result))

    params 参数说明(参数支持url字符串请求,如:http://abc.com/xxx.js?statusBarType=immersion

    属性名 类型 必须 描述 默认值
    url String 页面地址 ①支持本地地址,如:xxx.js ②支持远程地址,如:http://abc.com/xxx.js 可使用 root:// 表示 src 目录,比如首页: root://pages/index.js -
    pageName String - 页面名称 -
    pageTitle String - 页面标题,设置显示标题栏 statusBarType 为 normal 时有效。(标题栏更多设置) -
    pageType String - 页面类型:appweb 可填写 auto 系统自动识别 (不建议) app
    params Object - 页面传递参数,通过app.config.params获取 -
    cache Number - 页面缓存时间,仅app类型且非本地页面有效, 设置0不缓存(单位:毫秒) 0
    loading Boolean - 是否显示等待效果:truefalse true
    loadingBackground Boolean - 是否显示等待效果过渡背景:truefalse false
    animated Boolean - 是否进入页面需要动画效果:truefalse true
    animatedType String - 页面动画效果类型: push 右侧打开 present 底部弹出 animated 为 true 时有效 iOS:push Android:跟随系统
    swipeBack Boolean - 是否支持滑动返回:truefalse true
    swipeFullBack Boolean - 是否支持全屏滑动返回:truefalse swipeBack 为 true 时有效 false
    swipeColorBack Boolean - 是否为滑动返回界面设置状态栏颜色跟随滑动:truefalse swipeBack 为 true 时有效 true
    statusBarType String - 状态栏样式: normal 正常 fullscreen 全屏 immersion 沉浸式 normal
    statusBarColor String - 状态栏颜色值 statusBarType 为 normal 时有效 继承 > #3EB4FF
    statusBarAlpha Number - 状态栏透明度, 0-255 statusBarType 为 normal 时有效 0
    statusBarStyle Boolean - 状态栏字体颜色: true 状态栏的字体为白色 false 状态栏的字体为黑色 iOS:黑 Android:白
    softInputMode String - 键盘弹出方式: 详见下文 params.softInputMode 参数说明 auto
    backgroundColor String - 页面背景颜色 继承 > #ffffff
    backPressedClose Boolean - 允许按返回键关闭页面 true
    safeAreaBottom Number - iPhone X+底部安全距离 -

    params.softInputMode 参数说明

    说明
    auto iOS:当显示软键盘时,自动调整window的布局; Android:系统去判断内容区域可滚动为pan,不可滚动为resize。
    pan iOS:当显示软键盘时,自动调整window的布局; Android:当显示软键盘时,调整window的空白区域来显示软键盘。
    resize 当显示软键盘时,自动调整window的布局。
    nothing 当显示软键盘时,不调整window的布局。

    callback 回调result说明

    1. {
    2. pageName: '页面名称',
    3. status: 'create', //状态,详见:注①
    4. //status=statusChanged|errorChanged|titleChanged
    5. webStatus: '', //Web状态
    6. //status=errorChanged
    7. errCode: '', //错误代码
    8. errMsg: '', //错误描述
    9. errUrl: '', //错误地址
    10. //status=titleChanged
    11. title: '', //网页标题
    12. }

    注①:

    - create页面创建完毕 - start页面正在启动 - resume页面已在前台可见 - pause页面正在停止 - stop页面即将停止或者完全被覆盖 - restart页面正在重新启动 - destroy页面已销毁 - viewCreatedAppJS第一个视图的呈现完成 - renderSuccessAppJS呈现视图阶段结束 - errorAppJS运行时报告异常 - statusChangedWeb状态发生改变 - errorChangedWeb运行时报告异常 - titleChangedWeb标题发生改变

    简单示例

    1. const eeui = app.requireModule('eeui');
    2. //示例①
    3. eeui.openPage({
    4. url: 'http://dotwe.org/raw/dist/ad0045a7cff0b3a680d9de6dd4806e81.bundle.wx',
    5. }, function(result) {
    6. //……
    7. });
    8. //示例②
    9. eeui.openPage({
    10. url: 'http://dotwe.org/raw/dist/ad0045a7cff0b3a680d9de6dd4806e81.bundle.wx?statusBarType=immersion',
    11. }, function(result) {
    12. //……
    13. });
    14. //示例③
    15. eeui.openPage({
    16. pageName: 'pageName_1',
    17. pageType: 'app',
    18. url: 'xxxx.js'
    19. }, function(result) {
    20. //……
    21. });
    22. //示例④
    23. eeui.openPage({
    24. pageType: 'web',
    25. url: 'https://eeui.app'
    26. }, function(result) {
    27. //……
    28. });
    ## # eeui.getPageInfo - 获取页面信息
    1. /
    2. @param params 详细参数
    3. /
    4. eeui.getPageInfo({params})

    params 参数说明

    属性名 类型 必须 描述 默认值
    pageName String - 页面名称,留空获取当前页面(不建议留空) -

    简单示例

    1. //示例①
    2. let variable = eeui.getPageInfo({
    3. pageName: 'pageName_1',
    4. });
    5. //示例②
    6. let variable = eeui.getPageInfo('pageName_1');
    7. //variable返回示例
    8. {
    9.   "url": "http://....../dist/index.js",
    10.   "pageName": "open_qGRQ9fHP",
    11.   "pageType": "app",
    12.   "params": { },
    13.   "cache": 0,
    14.   "loading": true,
    15.   "swipeBack": true,
    16.   "swipeFullBack": false,
    17.   "statusBarType": "default",
    18.   "statusBarColor": "#3EB4FF",
    19.   "statusBarAlpha": 0,
    20.   "softInputMode": "auto",
    21.   "translucent": false,
    22.   "backgroundColor": "#f4f8f9",
    23.   "backPressedClose": true,
    24. }
    ## # eeui.getPageInfoAsync - 获取页面信息(异步)
    1. /
    2. @param params 详细参数
    3. /
    4. eeui.getPageInfoAsync({params}, callback(pageInfo))
    ## # eeui.reloadPage - 重新加载App Js页面Web页面
    1. /
    2. @param params 详细参数
    3. /
    4. eeui.reloadPage({params})

    params 参数说明

    属性名 类型 必须 描述 默认值
    pageName String - 页面名称,留空重载当前页面(不建议留空) -
    url String - 页面新地址 -

    简单示例

    1. //示例①
    2. eeui.reloadPage({
    3. pageName: 'pageName_1',
    4. });
    5. //示例②
    6. eeui.reloadPage('pageName_1');
    ## # eeui.setSoftInputMode - 设置键盘弹出方式
    1. /
    2. @param params 页面名称参数
    3. @param mode 键盘弹出方式:
    4. auto: iOS:当显示软键盘时,自动调整window的布局;Android:系统去判断内容区域可滚动为pan,不可滚动为resize
    5. pan: iOS:当显示软键盘时,自动调整window的布局;Android:当显示软键盘时,调整window的空白区域来显示软键盘。
    6. resize: 当显示软键盘时,自动调整window的布局。
    7. nothing: 当显示软键盘时,不调整window的布局。
    8. */
    9. eeui.setSoftInputMode({params}, mode)

    params 参数说明

    属性名 类型 必须 描述 默认值
    pageName String - 页面名称,留空表示当前页面(不建议留空) -

    简单示例

    1. //示例①
    2. eeui.setSoftInputMode({
    3. pageName: 'pageName_1',
    4. }, 'pan');
    5. //示例②
    6. eeui.setSoftInputMode('pageName_1', 'resize');
    ## # eeui.setPageBackPressed - 拦截返回按键事件
    1. /
    2. @param params 页面名称参数
    3. @param callback 返回键触发事件
    4. /
    5. eeui.setPageBackPressed({params}, callback())

    params 参数说明

    属性名 类型 必须 描述 默认值
    pageName String - 页面名称,留空拦截当前页面(不建议留空) -

    简单示例

    1. //示例①
    2. eeui.setPageBackPressed({
    3. pageName: 'pageName_1',
    4. }, function(){
    5. //返回键触发事件
    6. });
    7. //示例②
    8. eeui.setPageBackPressed('pageName_1', function(){
    9. //返回键触发事件
    10. });
    ## # eeui.setOnRefreshListener - 仅对App Js页面有效,监听下拉刷新事件,下拉刷新事件结束后请使用eeui.setRefreshing(pageName, false)设置下拉刷新结束状态
    1. /**
    2. @param params 页面名称参数
    3. @param callback 下拉刷新回调事件
    4. /
    5. eeui.setOnRefreshListener({params}, callback(pageName))

    params 参数说明

    属性名 类型 必须 描述 默认值
    pageName String - 页面名称,留空表示当前页面(不建议留空) -

    简单示例

    1. //示例①
    2. eeui.setOnRefreshListener({
    3. pageName: 'pageName_1',
    4. }, function(pageName){
    5. //下拉刷新回调事件
    6. eeui.setRefreshing(pageName, false);
    7. });
    8. //示例②
    9. eeui.setOnRefreshListener('pageName_1', function(pageName){
    10. //下拉刷新回调事件
    11. eeui.setRefreshing(pageName, false);
    12. });
    ## # eeui.setRefreshing - 仅对App Js页面有效,设置下拉刷新状态,主要用于eeui.setOnRefreshListener回调处理完成后设置结束状态
    1. /
    2. @param params 页面名称参数
    3. @param refreshing 状态:true|fals
    4. */
    5. eeui.setRefreshing({params}, refreshing)

    params 参数说明

    属性名 类型 必须 描述 默认值
    pageName String - 页面名称,留空表示当前页面(不建议留空) -
    ## # eeui.setStatusBarStyle - 修改当前页面状态栏样式(字体颜色)
    1. /
    2. @param isLight 详见 isLight 参数说明
    3. /
    4. eeui.setStatusBarStyle(isLight)

    isLight 参数说明

    - true状态栏的字体为白色 - false状态栏的字体为黑色 ## # eeui.setPageStatusListener - 添加监听页面状态变化
    1. /
    2. @param params 监听名称(参数)
    3. @param callback 回调事件,参数详见【eeui.openPage】的回调事件
    4. */
    5. eeui.setPageStatusListener({params}, callback(result))

    params 参数说明

    属性名 类型 必须 描述 默认值
    listenerName String 监听名称(用于防止重复监听) -
    pageName String - 页面名称,留空表示当前页面 -

    简单示例

    1. //示例①
    2. eeui.setPageStatusListener('listenerName_1', function(pageName){
    3. //回调事件,参数详见【eeui.openPage】的回调事件
    4. });
    5. //示例②
    6. eeui.setPageStatusListener({
    7. listenerName: 'listenerName_1',
    8. pageName: 'pageName_1',
    9. }, function(pageName){
    10. //回调事件,参数详见【eeui.openPage】的回调事件
    11. });
    ## # eeui.clearPageStatusListener - 清除监听页面状态变化
    1. /
    2. @param params 监听名称(参数)
    3. /
    4. eeui.clearPageStatusListener({params})

    params 参数说明

    属性名 类型 必须 描述 默认值
    listenerName String 监听名称 -
    pageName String - 页面名称,留空表示当前页面 -

    简单示例

    1. //示例①
    2. eeui.clearPageStatusListener('listenerName');
    3. //示例②
    4. eeui.clearPageStatusListener({
    5. listenerName: 'listenerName_1',
    6. pageName: 'pageName_1',
    7. });
    ## # eeui.onPageStatusListener - 手动执行(触发)页面状态
    1. /
    2. @param params 监听名称(参数)
    3. @param status 状态标识
    4. */
    5. eeui.onPageStatusListener({params}, status)

    params 参数说明

    属性名 类型 必须 描述 默认值
    listenerName String - 监听名称,留空表示当前页面所有 -
    pageName String - 页面名称,留空表示当前页面 -
    extra Object - 额外传递参数 -

    简单示例

    1. //示例①
    2. eeui.onPageStatusListener('status_1');
    3. //示例②
    4. eeui.onPageStatusListener('listenerName_1', 'status_1');
    5. //示例③
    6. eeui.onPageStatusListener({
    7. listenerName: 'listenerName_1',
    8. pageName: 'pageName_1',
    9. }, 'status_1');
    ## # eeui.getCacheSizePage - 获取App Js页面缓存大小
    1. /
    2. @param callback 回调事件,{size:123123},单位:字节B
    3. /
    4. eeui.getCacheSizePage(callback(result))
    ## # eeui.clearCachePage - 手动清除缓存App Js页面
    1. eeui.clearCachePage()
    ## # eeui.closePage - 关闭App Js页面Web页面
    1. /
    2. @param params 详细参数
    3. /
    4. eeui.closePage({params})

    params 参数说明

    属性名 类型 必须 描述 默认值
    pageName String - 页面名称,留空关闭当前页面(不建议留空) -
    animated Boolean - 是否弹出页面需要动画效果:truefalse true

    简单示例

    1. //示例①
    2. eeui.closePage({
    3. pageName: 'pageName_1',
    4. });
    5. //示例②
    6. eeui.closePage('pageName_1');
    ## # eeui.closePageTo - 关闭至某个App Js页面Web页面 - 场景示例:目前顺序打开a、b、c、d、e五个页面,e为当前页面,想要直接回到a页面时可以使用此方法。
    1. /
    2. @param params 详细参数
    3. /
    4. eeui.closePageTo({params})

    params 参数说明

    属性名 类型 必须 描述 默认值
    pageName String - 页面名称,留空关闭当前页面(不建议留空) -

    简单示例

    1. //示例①
    2. eeui.closePageTo({
    3. pageName: 'pageName_1',
    4. });
    5. //示例②
    6. eeui.closePageTo('pageName_1');
    ## # eeui.openWeb - 调用系统浏览器打开页面
    1. /
    2. @param url
    3. /
    4. eeui.openWeb(url)

    url 参数说明

    类型 必须 描述 默认值
    String 打开的页面url -

    简单示例

    1. eeui.openWeb('https://eeui.app');
    ## # eeui.goDesktop - 返回手机桌面
    1. /
    2. @param url
    3. /
    4. eeui.goDesktop()
    ## # eeui.getConfigString - 获取eeui.config.js配置文件指定参数
    1. /
    2. @param key 参数名称
    3. @return String
    4. */
    5. let appKey = eeui.getConfigString("appKey");
    ## # eeui.setCustomConfig - 自定义eeui.config.js配置参数(比如:用于动态设置homePage主页的JS地址) - 注意:有新的热更新或通过系统级清理app缓存后eeui.setCustomConfig设置的内容将失效。
    1. /
    2. @param key 参数名称(类型:字符串)
    3. @param value 参数值(类型:Object
    4. /
    5. eeui.setCustomConfig("homePage", "index.js");
    ## # eeui.getCustomConfig - 获取eeui.config.js所有自定义的配置参数(仅返回自定义的配置参数)
    1. /**
    2. @return Object
    3. /
    4. let config = eeui.getCustomConfig();
    ## # eeui.clearCustomConfig - 清除eeui.config.js自定义的配置参数(仅清除自定义的配置参数)
    1. eeui.clearCustomConfig();
    ## # eeui.realUrl - 规范化url,删除多余的符号连接(比如'/./', '/../' 以及多余的'/')
    1. /**
    2. @param url 要处理的原地址
    3. @return String
    4. /
    5. let newUrl = eeui.realUrl("http://abc.com/aa/bb/cc/.././demo.js");
    ## # eeui.rewriteUrl - 将相对地址基于当前地址补全
    1. /*
    2. @param url 要补全的相对地址
    3. @return String
    4. /
    5. let newUrl = eeui.rewriteUrl("demo.js");
    在 GitHub 上编辑此页

    最后一次更新: 3/11/2020, 10:10:56 PM

    navigator openOtherApp