WKWebView 使用详解
2017-04-12 本文已影响772人
小峰书
WKWebView 使用详解
标签： WebKit WKWebView
也可以关注我的个人博客
iOS中WebKit框架应用与解析
一、前言
在iOS8之前，在应用中浏览网页通常使用UIWebView这样一个类，但是内存消耗非常的大，通常需要开发者自己优化。iOS8以后苹果推出了新的网页框架WebKit,优化了UIWebView的内存问题，功能非常的强大，下面就来了解一下这个框架的使用。
二、WebKit框架概览
-
WKWebView：网页的渲染与展示，通过WKWebViewConfiguration可以进行配置。
-
WKWebViewConfiguration：这个类专门用来配置WKWebView。
-
WKPreference:这个类用来进行M相关设置。
-
WKProcessPool：这个类用来配置进程池，与网页视图的资源共享有关。
-
WKUserContentController：这个类主要用来做native与JavaScript的交互管理。
-
WKUserScript：用于进行JavaScript注入。
-
WKScriptMessageHandler：这个类专门用来处理JavaScript调用native的方法。
-
WKNavigationDelegate：网页跳转间的导航管理协议，这个协议可以监听网页的活动。
-
WKNavigationAction：网页某个活动的示例化对象。
-
WKUIDelegate：用于交互处理JavaScript中的一些弹出框。
-
WKBackForwardList：堆栈管理的网页列表。
-
WKBackForwardListItem：每个网页节点对象。
三、使用WKWebViewConfiguration对WebView进行配置
let webConfiguration = WKWebViewConfiguration()
let webView = WKWebView(frame: CGRect.zero, configuration: webConfiguration)
WKWebViewConfiguration可以配置如下属性
设置进程池 WKProcessPool类中没有暴露任何属性和方法，配置为同一个进程池的WebView会共享数据，例如Cookie、用户凭证等，开发者可以通过编写管理类来分配不同维度的WebView在不同进程池中.
let pool = WKProcessPool()
webConfiguration.processPool = pool
WKPerference设置WebView偏好设置。
//进行偏好设置
let preference = WKPreferences()
//最小字体大小 当将javaScriptEnabled属性设置为false时，可以看到明显的效果
preference.minimumFontSize = 0
//设置是否支持javaScript 默认是支持的
preference.javaScriptEnabled = true
//设置是否允许不经过用户交互由javaScript自动打开窗口
preference.javaScriptCanOpenWindowsAutomatically = true
webConfiguration.preferences = preference
//设置是否将网页内容全部加载到内存后再渲染
webConfiguration.suppressesIncrementalRendering = false
//设置HTML5视频是否允许网页播放 设置为false则会使用本地播放器
webConfiguration.allowsInlineMediaPlayback = true
//设置是否允许ariPlay播放
webConfiguration.allowsAirPlayForMediaPlayback = true
//设置视频是否需要用户手动播放 设置为false则会允许自动播放
webConfiguration.requiresUserActionForMediaPlayback = false
//设置是否允许画中画技术 在特定设备上有效
webConfiguration.allowsPictureInPictureMediaPlayback = true
//设置选择模式 是按字符选择 还是按模块选择
@available(iOS 8.0, *)
public enum WKSelectionGranularity : Int {
case dynamic
case character
}
webConfiguration.selectionGranularity = .character
//设置请求的User-Agent信息中应用程序名称 iOS9后可用
webConfiguration.applicationNameForUserAgent = @"test";
处理与js的交互
let userController = WKUserContentController()
userController.add(self, name: "name")
//js注入，注入一个测试方法。
let javaScriptSource = "function userFunc(){window.webkit.messageHandlers.name.postMessage( {\"name\":\"haha\"})}"
let userScript = WKUserScript(source: script, injectionTime: .atDocumentEnd, forMainFrameOnly: false)
webConfiguration.userContentController.addUserScript(userScript) forMainFrameOnly:false(全局窗口)，true（只限主窗口）
userController.addUserScript(userScript)
webConfiguration.userContentController = userController
WKUserContentController专门用来管理native与JavaScript的交互行为，addScriptMessageHandler:name:方法来注册要被js调用的方法名称，之后再JavaScript中使用window.webkit.messageHandlers.name.postMessage()方法来像native发送消息，支持OC中字典，数组，NSNumber等原生数据类型，JavaScript代码中的name要和上面注册的相同。在native代理的回调方法中，会获取到JavaScript传递进来的消息，如下：
@available(iOS 8.0, *)
public func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage)
WKScriptMessage类是JavaScript传递的对象实例，其中属性如下：
//传递的消息主体
open var body: Any { get }
//传递消息的WebView
weak open var webView: WKWebView? { get }
//传递消息的WebView当前页面对象
@NSCopying open var frameInfo: WKFrameInfo { get }
//消息名称
open var name: String { get }
WebKit框架采用其本身的缓存框架，WKWebsiteDataStore类用来处理数据的存储，其中属性如下：
//获取默认的存储器 此存储器为持久性的会被写入磁盘
open class func `default`() -> WKWebsiteDataStore
//获取一个临时的存储器,自定义浏览器的时候建议用 This is useful for implementing "private browsing" in a web view.
open class func nonPersistent() -> WKWebsiteDataStore
//存储器是否是临时的
open var isPersistent: Bool { get }
//所有可以存储的类型
open class func allWebsiteDataTypes() -> Set<String>
移除网页缓存
let websiteDataTypes = NSSet(array: [WKWebsiteDataTypeDiskCache])
let dateFrom = Date(timeIntervalSince1970: 0)
if let types = websiteDataTypes as? Set<String>{
WKWebsiteDataStore.default().removeData(ofTypes: types, modifiedSince:dateFrom, completionHandler: {
})
}
四、WKNavagationDelegate中方法解析
/*
决定是否响应网页的某个动作，例如加载，回退，前进，刷新等，在这个方法中，必须执行decisionHandler()代码块，并将是否允许这个活动执行在block中进行传入
*/
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, decidePolicyFor navigationAction: WKNavigationAction, decisionHandler: @escaping (WKNavigationActionPolicy) -> Swift.Void)
/*接收到数据后是否允许执行渲染
其中，WKNavigationResponse为请求回执信息
WKNavigationResponsePolicy为开发者回执，枚举如下：
public enum WKNavigationResponsePolicy : Int {
case cancel
case allow
}
*/
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, decidePolicyFor navigationResponse: WKNavigationResponse, decisionHandler: @escaping (WKNavigationResponsePolicy) -> Swift.Void)
//页面加载启动时调用
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, didStartProvisionalNavigation navigation: WKNavigation!)
//当主机接收到的服务重定向时调用
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, didReceiveServerRedirectForProvisionalNavigation navigation: WKNavigation!)
//主页数据加载发生错误时调用
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error)
//内容到达主机时调用
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, didCommit navigation: WKNavigation!)
//主页加载完成时调用
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!)
//提交发生错误时调用
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error)
//需要响应身份验证时调用 同样在block中需要传入用户身份凭证
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, didReceive challenge: URLAuthenticationChallenge, completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Swift.Void){
//用户身份信息
let newCred = URLCredential(user: "", password: "", persistence: .none)
challenge.sender?.use(newCred, for: challenge)
completionHandler(.useCredential,newCred)
}
//进程被终止时调用
@available(iOS 9.0, *)
optional public func webViewWebContentProcessDidTerminate(_ webView: WKWebView)
五、WKUIDelegate协议中方法解析
//创建新的webView时调用的方法
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, createWebViewWith configuration: WKWebViewConfiguration, for navigationAction: WKNavigationAction, windowFeatures: WKWindowFeatures) -> WKWebView?
//关闭webView时调用的方法
@available(iOS 9.0, *)
optional public func webViewDidClose(_ webView: WKWebView)
//JavaScript调用alert方法后回调的方法 message中为alert提示的信息 必须要在其中调用completionHandler()
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, runJavaScriptAlertPanelWithMessage message: String, initiatedByFrame frame: WKFrameInfo, completionHandler: @escaping () -> Swift.Void)
//JavaScript调用confirm方法后回调的方法 confirm是js中的确定框，需要在block中把用户选择的情况传递进去
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, runJavaScriptConfirmPanelWithMessage message: String, initiatedByFrame frame: WKFrameInfo, completionHandler: @escaping (Bool) -> Swift.Void)
//JavaScript调用prompt方法后回调的方法 prompt是js中的输入框 需要在block中把用户输入的信息传入
@available(iOS 8.0, *)
optional public func webView(_ webView: WKWebView, runJavaScriptTextInputPanelWithPrompt prompt: String, defaultText: String?, initiatedByFrame frame: WKFrameInfo, completionHandler: @escaping (String?) -> Swift.Void)
//是否允许3D_Touch
@available(iOS 10.0, *)
optional public func webView(_ webView: WKWebView, shouldPreviewElement elementInfo: WKPreviewElementInfo) -> Bool
//允许3D_Touch后预览的控制器，否则会跳safari
@available(iOS 10.0, *)
optional public func webView(_ webView: WKWebView, previewingViewControllerForElement elementInfo: WKPreviewElementInfo, defaultActions previewActions: [WKPreviewActionItem]) -> UIViewController?
//重按之后跳到上面创建的控制器
@available(iOS 10.0, *)
optional public func webView(_ webView: WKWebView, commitPreviewingViewController previewingViewController: UIViewController)
