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

自定义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

要回复文章请先登录注册

1***@qq.com

1***@qq.com

我刚下载运行一下就404,看控制台显示3个警告说什么webhint.io修复方法我看不懂求解答
2024-02-16 13:26
test2023

test2023

回复 k***@163.com :
你解决了吗
2024-01-29 21:44
test2023

test2023

回复 k***@163.com :
你解决了吗
2024-01-26 09:30
test2023

test2023

IOS不兼容,图片不显示,方法不兼容,安卓正常
2024-01-23 10:12
m***@163.com

m***@163.com

error事件不触发是什么原因
2023-12-08 14:50
9***@qq.com

9***@qq.com

uni-app-x webview 组件如何自定义错误页面?
2023-11-09 09:34
无糖

无糖

document.addEventListener("error", function(err){},false) 监听方法不执行,怎么会是呢?
2023-05-06 12:00
k***@163.com

k***@163.com

回复 小明子 :
你好,请问你的解决了吗?
2023-04-12 10:46
k***@163.com

k***@163.com

IOS document.addEventListener("error",function(e){ 这个监听函数监听不到。请问有小伙伴遇到吗?如何处理
2023-04-12 09:18
z***@outlook.com

z***@outlook.com

能自定义被劫持的页面吗?请前辈们教我
2023-01-14 20:35