DCloud_App_Array
DCloud_App_Array
  • 发布:2014-10-20 19:01
  • 更新:2024-02-16 13:26
  • 阅读:64763

自定义Webview的404等错误页面,Webview窗口加载页面错误时显示

分类:HTML5+

此文档将不再维护,请参考新文档:https://uniapp.dcloud.io/tutorial/app-webview-error

当Webview窗口加载错误地址(如本地页面不存在)或者访问网络资源失败(如无法访问网络)时会自动显示默认错误页面:


可以通过以下方法自定义Webview的404等错误页面。

设置应用全局默认错误页面

  • 5+App和wap2app
    在应用的manifest.json文件的"plus"->"error"节点的url属性可配置自定义错误页面替换默认的错误页面。
    打开manifest.json文件,切换到代码视图,添加以下数据:

    "plus": {  
        "error": {  
            "url": "error.html"  
        },  
        //...  
    },  
    //...

    其中url地址推荐使用本地地址,相对于应用根目录。
    设置为“none”则关闭跳转到错误页面功能,此时页面显示Webview默认的错误页面内容。

  • uni-app项目

    "app-plus": {  
        "error": {  
            "url": "hybrid/html/error.html"  
        },  
        //...  
    },  
    //...

    error.html需要放到根目录下的hybrid/html目录下,否则不会被编译进去

单独设置Webview窗口的错误页面

如果需要单独自定义某个Webview窗口的错误页面,则需要在创建时通过WebviewStyle对象的errorPage属性控制:

var styles = {errorPage:"error.html"}; // 设置为“none”则关闭此Webview窗口的跳转到错误页面功能  
var webview = plus.webview.create( "url", "id", styles );     
webview.show();

错误页面中监听事件

在定义的error.html页面中可以通过监听"error"事件获取更多错误信息:

// 获取错误信息  
document.addEventListener("error",function(e){  
    var url = e.url;  // 错误页面的url地址  
    var href = e.href; // 错误页面的完整路径(包括完整的协议头)  
},false);

注意
Android平台使用iframe时如果无法加载页面在不同版本系统上存在差异:
5.0及以上版本:Webview窗口对象不会加载错误页面,仅iframe节点显示无法加载页面;
5.0以下版本:Webview窗口对象会加载错误页面。

15 关注 分享
Eric_Guo hilongjw DIOGO 开心的哈鲁 龙七 wuweitiandian 疯狂的二进制 wolferhua Trust 水果忍着 BruceAn y***@qq.com 1***@qq.com 1***@qq.com s***@163.com

要回复文章请先登录注册

小七ing

小七ing

回复 h***@163.com :
很简单呐
2022-11-08 10:17
w***@126.com

w***@126.com

回复 a***@qq.com :
nvue 配置无效
2021-09-23 14:45
a***@qq.com

a***@qq.com

nvue配置无效 请修复。
2021-06-11 14:47
1***@qq.com

1***@qq.com

1111
2021-03-30 17:10
t***@qq.com

t***@qq.com

errorPage 根本没有用的呢?我在uni项目里使用
2021-02-04 00:44
t***@qq.com

t***@qq.com

回复 DCloud_App_Array :
解压apk修改assets\data\dcloud_error.html后怎么打包成apk呢?
2021-02-04 00:42
小明子

小明子

除了页面找不到,还有其他情况会吗? 目前我测试页面找不到的时候,页面会跳转到error.html。但是 document监听的error事件没有触发。
2020-06-22 16:12
[已删除]

[已删除]

人找资源(外包),前端,熟悉uni、vue,联系wx:Florida_kang
2020-05-07 11:33
k***@foxmail.com

k***@foxmail.com

回复 Flickerx :
你好 , 这个问题你解决嘛? 我也遇到同样的问题
2020-05-07 08:58
DCloud_App_Array

DCloud_App_Array (作者)

回复 湖南盛通 :
把apk当做zip解压,在assets\data\dcloud_error.html
2020-04-28 15:01