<webview> 标签

如果可能的话，后退导航至历史记录中的前一项，等价于 go(-1)。

表示能否后退导航历史记录。

表示能否前进导航历史记录。

从 Chrome 33 开始支持。

清除 webview 分区中的浏览数据。

参数
ClearDataOptions	options	指定清除哪些数据的选项。
ClearDataTypeSet	types	要清除的数据类型。
function	（可选） callback	数据成功清除后调用。 如果您指定了 callback 参数，它应该是一个如下形式的函数： function() {...};

向来宾网页插入 JavaScript 代码。

以下示例代码使用脚本插入的方式将来宾网页的背景颜色设置为红色：

webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });

参数
InjectDetails	details	要运行的脚本详情。
function	（可选） callback	所有 JavaScript 执行弯后调用。 如果您指定了 callback 参数，它应该是一个如下形式的函数： function(array of any result) {...}; array of any （可选） result 插入的每一个框架中脚本的结果。

从 Chrome 35 开始支持。

开始在网页中查找的请求。

参数
string	searchText	需要在网页中查找的字符串。
FindOptions	（可选） options	查找请求的选项。
function	（可选） callback	本次查找请求的所有结果都返回后调用。 如果您指定了 callback 参数，它应该是一个如下形式的函数： function( FindCallbackResults results) {...}; FindCallbackResults （可选） results 包含本次查找请求的所有结果。如果回调函数体中未使用 results 则可以省略，例如如果回调函数只是用来检测查找请求什么时候完成。

如果可能的话，前进导航至历史记录中的前一项，等价于 go(1)。

返回来宾网页当前进程所对应的 Chrome 浏览器内部进程标识符，允许嵌入者了解终止该进程会影响多少来宾。只有两个来宾属于同一应用并且具有相同的存储分区标识符时，它们才会共用同一个进程。该调用是同步的，返回嵌入者缓存中的当前进程标识符，这一进程标识符与操作系统的进程标识符不同。

从 Chrome 33 开始支持。

返回由 webview 来宾网页请求使用的用户代理字符串。

从 Chrome 36 开始支持。

获取当前缩放比例。

参数
function	callback	获取当前缩放比例后调用。 callback 参数应该是一个如下形式的函数： function(double zoomFactor) {...}; double zoomFactor 当前缩放比例。

通过相对于当前导航的历史记录索引导航至历史记录中的某一项。如果请求的导航不可能完成，该方法没有任何效果。

参数
integer	relativeIndex	webview 应该导航至的相对历史记录索引。例如，2 会前进导航两个历史记录项（如果可能的话），-3 会后退导航三次。

在来宾网页中嵌入 CSS。

参数
InjectDetails	details	要嵌入的 CSS 详情。
function	（可选） callback	CSS 嵌入后调用。 如果您指定了 callback 参数，它应该是一个如下形式的函数： function() {...};

从 Chrome 33 开始支持。

指示 webview 的用户代理字符串是否由 webviewTag.setUserAgentOverride 覆盖。

从 Chrome 38 开始支持。警告：目前为 Dev 分支。了解更多内容

打印 WebView 的内容，等价于在 WebView 中调用 JavaScript print 函数。

重新加载当前的顶层网页。

从 Chrome 33 开始支持。

覆盖由 webview 来宾网页请求使用的用户代理字符串。

参数
string	userAgent	要使用的用户代理字符串。

从 Chrome 36 开始支持。

更改网页的当前缩放比例。同样网页来源的缩放比例会保存下来，即使导航之后仍然继续使用。

参数
double	zoomFactor	新的缩放比例。
function	（可选） callback	网页缩放后调用。 如果您指定了 callback 参数，它应该是一个如下形式的函数： function() {...};

停止加载当期 <webview> 导航（如果正在进行的话）。

从 Chrome 35 开始支持。

结束当前的查找会话（清除所有高亮标记），并取消所有正在进行的查找请求。

参数
enum of "clear", "keep", or "activate"	（可选） action	决定查找会话结束后如何处理目前匹配的内容。clear 清除当前匹配内容上的高亮，keep 保留当前匹配内容的高亮状态，activate 保留当前匹配内容的高亮状态，并模拟用户单击匹配内容。默认的操作是 keep（保留）。

强制终止来宾网页的渲染进程，这样可能会影响当前应用中共享同一个进程的多个 webview 标签，但不会影响其他应用中的 webview 标签。

来宾窗口尝试将自己关闭时产生。

以下例子在来宾尝试关闭自己时将 webview 导航至 about:blank。

webview.addEventListener('close', function() {
  webview.src = 'about:blank';
});

来宾窗口记录控制台消息时产生。

以下例子将所有日志消息转发至嵌入者的控制台，忽略日志级别和其他属性。

webview.addEventListener('consolemessage', function(e) {
  console.log('来宾网页记录了一条消息：', e.message);
});

integer level

日志消息的严重性级别，从 0 到 4。

string message

日志消息的内容。

integer line

消息来源行号。

string sourceId

表示记录消息的资源的字符串。

来宾窗口产生 load 事件时产生，即新文档加载之后，不包括当前文档内部的网页导航或异步资源加载。

以下例子在网页加载后修改来宾 body 元素的默认字体大小

webview.addEventListener('contentload', function() {
  webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});

来宾窗口通过 window.alert、window.confirm 或 window.prompt 尝试打开有模式对话框时产生。

处理该事件时会阻塞来宾进程，直到每一个事件监听器都返回或 dialog 对象不可访问（如果调用了 preventDefault()）。

默认行为是取消对话框。

enum of "alert", "confirm", or "prompt" messageType

来宾请求的有模式对话框类型。

string messageText

来宾希望在有模式对话框中显示的字符串。

DialogController dialog

用于响应来宾的有模式对话框请求的接口。

渲染来宾网页内容的进程退出时产生。

以下例子在来宾网页崩溃时显示告别消息：

webview.addEventListener('exit', function(e) {
  if (e.reason === 'crash') {
    webview.src = 'data:text/plain,再见！';
  }
});

integer processID

退出的进程对应的 Chrome 浏览器内部标识符。

enum of "normal", "abnormal", "crash", or "kill" reason

表示退出原因的字符串。

活动查找请求有新的查找结果可用时产生，随着匹配项被找到，一次查找请求可能会多次产生该事件。

string searchText

在网页中搜索的字符串。

integer numberOfMatches

目前为止在网页中找到的 searchText 数目。

integer activeMatchOrdinal

当前匹配内容的序号，如果找到的话，找到之前则一直为 0。

SelectionRect selectionRect

以屏幕坐标表示当前匹配内容所在区域（如果找到的话）。

boolean canceled

表示查找请求是否已经取消。

string finalUpdate

表示所有查找请求是否都已经完成，不会再产生 findupdate 事件，除非再次发出查找请求。

顶层加载未提交就终止时产生。

注：资源加载终止后，最终 loadabort 事件产生之后还会产生loadstop 事件，即使上一次 loadstop 事件（如果有的话）以来所有提交的加载都被终止。

string url

请求的 URL。

boolean isTopLevel

本次加载是在顶层还是子框架中。

enum of "networkError", "download", "canceled", "sslError", or "safeBrowsingError" reason

表示终止类型的字符串。

加载提交后产生，包括当前文档内的导航以及子框架的文档级加载，但不包括异步资源加载。

string url

提交的 URL。

boolean isTopLevel

本次加载是在顶层还是子框架中。

顶层加载请求重定向至另一个 URL 时产生。

string oldUrl

重定向前的请求 URL。

string newUrl

重定向后的 URL。

boolean isTopLevel

重定向是在顶层还是子框架中发生。

开始加载时产生。

string url

请求的 URL。

boolean isTopLevel

本次加载是在顶层还是子框架中。

来宾网页中的所有框架级加载操作（包括所有子框架）完成后产生，包括当前文档内的导航以及子框架的文档级加载，但不包括异步资源加载。每当文档级加载的数量从一（或更多）过渡到零时就会产生该事件。例如，如果网页已经加载完成（即产生了一次 loadstop 事件），并创建了一个新的嵌套框架，加载某个网页，嵌套框架的网页加载完成时就会产生第二个 loadstop 事件。加载广告的网页中经常会观察到这样的模式。

注：已提交的加载终止后，loadabort 事件产生后最终还会产生loadstop 事件，即使上一次 loadstop 事件（如果有的话）以来所有提交的加载都被终止。

来宾网页尝试打开新的浏览器窗口时产生。

以下例子在嵌入者中为每一个请求的新窗口创建新的 webview 并开始导航：

webview.addEventListener('newwindow', function(e) {
  var newWebview = document.createElement('webview');
  document.body.appendChild(newWebview);
  e.window.attach(newWebview);
});

NewWindow window

可以用来将请求的目标网页附加至现有的 webview 元素或显式取消请求的接口。

string targetUrl

请求打开新窗口的目标 URL。

double initialWidth

请求打开的新窗口的初始宽度。

double initialHeight

请求打开的新窗口的初始高度。

string name

请求打开的新窗口名称。

enum of "ignore", "save_to_disk", "current_tab", "new_background_tab", "new_foreground_tab", "new_window", or "new_popup" windowOpenDisposition

请求打开新窗口的方式。

来宾网页需要向嵌入者请求特殊权限时产生。

以下例子授予来宾网页访问 webkitGetUserMedia API 的权限。注意，使用该例子的应用本身必须指定 audioCapture 和/或 videoCapture 清单文件权限：

webview.addEventListener('permissionrequest', function(e) {
  if (e.permission === 'media') {
    e.request.allow();
  }
});

enum of "media", "geolocation", "pointerLock", "download", "loadplugin", or "filesystem" permission

请求的权限类型。

integer requestId

标志来宾的这一请求的数。

object request

包含请求权限详情的对象，取决于请求的权限类型，可能为 webviewTag.MediaPermissionRequest、webviewTag.GeolocationPermissionRequest、webviewTag.PointerLockPermissionRequest、webviewTag.DownloadPermissionRequest 或 webviewTag.LoadPluginPermissionRequest 对象。

渲染来宾网页内容的进程失去响应后再恢复响应时产生。

以下例子在 webview 失去响应时淡出，恢复响应时淡入：

webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
  webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
  webview.style.opacity = '1';
});

integer processID

恢复响应的进程所对应的 Chrome 浏览器内部标识符。

嵌入的网页内容大小更改时产生，只有在启用 autosize 时才会产生。

double oldWidth

嵌入的网页内容原来的宽度。

double oldHeight

嵌入的网页内容原来的高度。

double newWidth

嵌入的网页内容的新宽度。

double newHeight

嵌入的网页内容的新高度。

渲染来宾网页内容的进程失去响应时产生，如果来宾恢复响应，则会产生与之对应的 responsive 事件。

integer processID

失去响应的进程所对应的 Chrome 浏览器内部标识符。

网页缩放比例更改时产生。

double oldZoomFactor

网页原来的缩放比例。

double newZoomFactor

网页缩放之后的新缩放比例。