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
移除网页缓存
let websiteDataTypes = NSSet(array: [WKWebsiteDataTypeDiskCache]) let dateFrom = Date(timeIntervalSince1970: 0) if let types = websiteDataTypes as? Set{ 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)
Social Menu