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)

Post Author: menglingfeng

发表评论

电子邮件地址不会被公开。 必填项已用*标注

You may also like

iOS OC语言copy修饰符实现原理

前言 在经过频繁的业

Label尺寸自适应与AutoLayout问题小结

水平布局与垂直布局L

iOS7之后的导航栏与控制器原点坐标问题

简单记录关于iOS7

%d bloggers like this: