当前环境: Xcode10.0 Swift4.2 iOS SDK 12.1
官方说明 : 从 iOS 8.0 和 OS X 10.10 开始,使用 WKWebView 将 Web 内容添加到您的应用程序。不要使用 UIWebView 或 WebView。
自诩拥有 60fps 滚动刷新率、内置手势、高效的 app 和 Web 信息交换通道、和 Safari 相同的 JavaScript 引擎,WKWebView 毫无疑问地成为了 WWDC 2014 上的最亮点。
复制 // 加载请求
1.webview.load()
// 网页到上一页
2.webview.goBack()
// 网页到下一页
3.webview.goForward()
// 网页重新加载
4.webview.reload()
// 网页停止加载
5.webview.stopLoading()
// 网页标题
6.webview.title
// 网页能够后退到上一页
7.webview.canGoBack
// 网页能够前进到下一页
8.webview.canGoForward
// 网页加载当中的进度
9.webview.estimatedProgress
官方文档 协议的方法可帮助您实现在 Web 视图接受,加载和完成导航请求的过程中触发的自定义行为。WKNavigationDelegate
复制 // MARK: - WKNavigationDelegate
// 【方法一】
// 决定网页是否允许跳转。
// WebView里面的每一次请求都会被拦截。
// 然后通过 decisionHandler 回调参数 来决定 允许 或者 不允许。
func webView(_ webView: WKWebView, decidePolicyFor navigationAction: WKNavigationAction, decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
if let host = navigationAction.request.url?.host {
if host == "zcoldwater.github.io" {
// 不允许
decisionHandler(WKNavigationActionPolicy.cancel)
return
}
}
// 允许
decisionHandler(WKNavigationActionPolicy.allow)
}
// 【方法二】
// 收到网页 Response 决定是否跳转
// 1. 先经过【方法一】再经过【方法二】
func webView(_ webView: WKWebView, decidePolicyFor navigationResponse: WKNavigationResponse, decisionHandler: @escaping (WKNavigationResponsePolicy) -> Void) {
// 默认回调参数 allow 允许跳转
decisionHandler(WKNavigationResponsePolicy.allow)
}
// 【方法三】
// 页面内容开始加载
func webView(_ webView: WKWebView, didStartProvisionalNavigation navigation: WKNavigation!) {
print("页面内容正在开始加载!")
}
// 【方法四】
// 网页内容加载失败
func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error) {
print("网页内容加载失败!")
}
// 【方法五】
// 网页内容加载完成后,返回内容至 webview
func webView(_ webView: WKWebView, didCommit navigation: WKNavigation!) {
print("网页内容加载完成后,返回内容至 webview")
}
// 【方法六】
// 网页加载完成
func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
print("网页加载完成!")
}
// 【方法七】
// 网页返回内容至 webview 时发生失败
func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error) {
print("网页返回内容至 webview 时发生失败!")
}
// 【方法八】
// 收到网页重新定向的请求
func webView(_ webView: WKWebView, didReceiveServerRedirectForProvisionalNavigation navigation: WKNavigation!) {
print("收到页面重定向请求!")
}
// 【方法九】
// 处理网页过程中发生终止
func webViewWebContentProcessDidTerminate(_ webView: WKWebView) {
print("处理网页过程中发生终止\n 内存占用过大等原因导致的系统调用此方法!")
}
WKUIDelegate 协议【JavaScript -> Native】
Web 视图用户界面委托实现此协议以控制新窗口的打开,增强用户单击元素时显示的默认菜单项的行为,以及执行其他与用户界面相关的任务。可以在处理 JavaScript 或其他插件内容时调用这些方法。默认 Web 视图实现假定每个 Web 视图有一个窗口,因此非传统用户界面可能实现用户界面委托。
复制 // 创建新的webView时调用的方法
// 内部实现根据实际需求写
func webView(_ webView: WKWebView, createWebViewWith configuration: WKWebViewConfiguration, for navigationAction: WKNavigationAction, windowFeatures: WKWindowFeatures) -> WKWebView? {
return nil
}
// 关闭webView时调用的方法
// 内部实现根据实际需求写
func webViewDidClose(_ webView: WKWebView) {
print("webViewDidClose:\(webView)")
}
// 警告框
// Javascript中调用 alert("any") 触发
func webView(_ webView: WKWebView, runJavaScriptAlertPanelWithMessage message: String, initiatedByFrame frame: WKFrameInfo, completionHandler: @escaping () -> Void) {
}
// 确认框
// Javascript中调用 confirm("any") 触发
func webView(_ webView: WKWebView, runJavaScriptConfirmPanelWithMessage message: String, initiatedByFrame frame: WKFrameInfo, completionHandler: @escaping (Bool) -> Void) {
}
// 输入框
// Javascript中调用 prompt("param1", "param2")
func webView(_ webView: WKWebView, runJavaScriptTextInputPanelWithPrompt prompt: String, defaultText: String?, initiatedByFrame frame: WKFrameInfo, completionHandler: @escaping (String?) -> Void) {
}
// 能否预览用户触摸的元素
// 根据需要实现下面协议
func webView(_ webView: WKWebView, shouldPreviewElement elementInfo: WKPreviewElementInfo) -> Bool {
return true
}
WKWebView 必要方法【Native -> JavaScript】
如何我们要实现 Native 调用 JavaScript 的时候就必须要知道下面这个方法了
复制 /* @abstract Evaluates the given JavaScript string.
@param javaScriptString The JavaScript string to evaluate.
@param completionHandler A block to invoke when script evaluation completes or fails.
@discussion The completionHandler is passed the result of the script evaluation or an error.
*/
open func evaluateJavaScript(_ javaScriptString: String, completionHandler: ((Any?, Error?) -> Void)? = nil)