From 53c4ae8b0f15c31cf06ab924af5a7a0ae2005e94 Mon Sep 17 00:00:00 2001
From: yanyilin <yanyilin@dcloud.io>
Date: Mon, 14 Mar 2022 12:49:20 +0800
Subject: [PATCH] add app-webview-error.md

---
 docs/app-webview-error.md | 71 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 docs/app-webview-error.md

diff --git a/docs/app-webview-error.md b/docs/app-webview-error.md
new file mode 100644
index 000000000..e31c7264b
--- /dev/null
+++ b/docs/app-webview-error.md
@@ -0,0 +1,71 @@
+当webview组件(窗口)加载错误地址（如本地页面不存在）或者访问网络资源失败（如无法访问网络）时会自动显示默认错误页面：  
+![](https://native-res.dcloud.net.cn/images/uniapp/others/error-default.jpg)  
+
+如需修改默认错误页面样式，可以通过以下方法自定义Webview的404等错误页面。
+
+### 设置自定义错误页面
+
+**可视化界面配置**  
+
+打开项目的manifest.json文件，在 “App常用其它设置” -> “自定义404错误页面” 下点击 “浏览” 选择页面文件：
+![](https://native-res.dcloud.net.cn/images/uniapp/others/error-manifest.png)
+
+> 注：建议使用html文件，并放到项目根目录下的 hybrid/html 文件夹中
+
+**源码视图配置**  
+打开项目的manifest.json文件，切换到“源码视图”，根据项目类型进行配置错误页面路径，推荐使用本地地址，相对于应用根目录；设置 url 属性值为 "none" 表示关闭自定义错误页面功能，加载页面错误时显示系统默认错误页面内容。  
+
+- uni-app项目  
+在 "app-plus" -> "error" 节点的 url 属性配置自定义错误页面路径，示例如下：
+``` js  
+  "app-plus": {
+    "error": {
+      "url": "hybrid/html/error.html"
+    },
+    //...
+  },
+  //...
+```
+
+- 5+App/Wap2App项目  
+在 "plus" -> "error" 节点的 url 属性配置自定义错误页面路径，示例如下：
+``` javascript
+  "plus": {
+    "error": {
+      "url": "error.html"
+    },
+    //...
+  },
+  //...
+```
+其中url地址推荐使用本地地址，相对于应用根目录。
+设置为“none”则关闭跳转到错误页面功能，此时页面显示Webview默认的错误页面内容。
+
+
+### 错误页面中监听事件  
+自定义404错误页面时，可能需要在 error.html 页面中获取错误原因，可以通过以下方法监听 "error" 事件获取完整错误信息，示例如下：  
+```javascript
+// 获取错误信息
+document.addEventListener("error", function(e){
+	var url = e.url;  // 错误页面的url地址
+ 	var href = e.href; // 错误页面的完整路径（包括完整的协议头）
+},false);
+```
+
+
+### 运行时动态设置自定义错误页面  
+如果需要单独自定义某个Webview窗口的错误页面，则需要在创建时通过[WebviewStyle](http://www.dcloud.io/docs/api/zh_cn/webview.html#plus.webview.WebviewStyle)对象的errorPage属性控制:  
+```js
+var styles = {errorPage: "error.html"}; // 设置为“none”则关闭此Webview窗口的跳转到错误页面功能
+var webview = plus.webview.create("url", "id", styles);   
+webview.show();
+```
+
+> 注：仅5+App/Wap2App项目支持  
+
+
+### 常见问题  
+- Android平台使用iframe时如果无法加载页面在不同版本系统上存在差异：
+  + Android5.0及以上版本：Webview窗口对象不会加载错误页面，仅iframe节点显示无法加载页面；
+  + 5.0以下版本：Webview窗口对象会加载错误页面。
+
-- 
GitLab