在我们的项目中,很多情况下我们需要实现类似微信内置浏览器加载网页的形式,今天就让我们自己来动手实现吧!
新特性
在iOS8之后,苹果推出了新的网页浏览器控件WKWebView,相比于之前的UIWebView
,其主要特点非常明显:
- 提供了更好的性能、更高的稳定性
- 支持了更多的HTML5特性
- 高达60fps的滚动刷新率和丰富的内置手势
- 占用内存可能只有UIWebView的1/3 - 1/4
- 具有Safari相同的JavaScript引擎
- 高达60fps的滚动刷新率和丰富的内置手势
框架解读
WKBackForwardList 此对象是浏览器之前浏览过的网页的列表,你可以通过WebView的前进或者后退访问其中记录的任何一个页面,注意这是个对象,并不是数组
WKBackForwardListItem 此对象被包含在上边的
WKBackForwardList
之中WKFrameInfo 包含网页主要的结构信息
WKNavigationAction 这是WebKit框架中比较重要的一个文件,其中包含了网页的结构信息、网页交互时触发的导航类型以及网页的请求信息等
WKPreferences 在这里用户可以配置网页字体大小、是否允许JavaScript交互等
WKScriptMessage 交互中的重要文件 如果涉及到原生用JavaScript的交互,这个文件提供了在原生接收到交互响应之后所调用的接口名称以及接收到的信息数据
WKScriptMessageHandler 交互中的重要文件 里边只有一个方法,当原生用JavaScript进行交互时,会走这个方法
WKSecurityOrigin 主要包含网页的安全信息,例如请求的Host地址,端口号等
WKUserContentController 交互中的重要文件 包含同JavaScript交互时接口注册/删除的方法等
WKWebView 重要文件 包含WKWebView的初始化、操作方法以及一系列属性
WKWebViewConfiguration 重要文件 在WKWebView初始化时需要的一个对象,在这里我们可以提前对WKWebView的很多属性进行提前配置
WKNavigationDelegate 两个代理之一,重要文件 在WKWebView的整个声明周期中,比如当决定页面是否加载、页面即将加载、页面加载成功/失败时都有所触发的代理方法,在其对应的方法里边我们可以按照需求进行设置
WKUIDelegate 两个代理之二,重要文件 当WKWebView页面创建、遇到网页弹窗时都有对应的触发的方法
WKNavigationDelegate
/**
在即将加载网页时决定WKWebView是否进行加载/导航
@param webView 加载网页的WKWebView控件
@param navigationAction 包含网页的导航信息,可根据需求获取界面加载信息
@param decisionHandler 在决定导航之前,不管你是否允许网页加载,你都必须实现这个Block,否则程序会崩溃。如果你设置了`WKNavigationActionPolicyCancel`,那么网页将不会被加载,并且之后的一系列代理方法都不会走
*/
- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler
/**
在收到响应后,决定是否跳转/加载
@param webView 加载网页的WKWebView控件
@param navigationResponse 接收到的服务器返回信息
@param decisionHandler 在接收到服务器相应之后,不管你是否允许网页加载,你都必须实现这个Block,否则程序会崩溃。如果你设置了`WKNavigationActionPolicyCancel`,那么网页将不会被加载,并且之后的一系列代理方法都不会走
*/
- (void)webView:(WKWebView *)webView decidePolicyForNavigationResponse:(WKNavigationResponse *)navigationResponse decisionHandler:(void (^)(WKNavigationResponsePolicy))decisionHandler
/**
页面开始加载触发的方法
@param webView 加载网页的WKWebView控件
@param navigation 页面导航信息
*/
- (void)webView:(WKWebView *)webView didStartProvisionalNavigation:(null_unspecified WKNavigation *)navigation
/**
接收到服务器跳转请求触发的方法
@param webView 加载网页的WKWebView控件
@param navigation 页面导航信息
*/
- (void)webView:(WKWebView *)webView didReceiveServerRedirectForProvisionalNavigation:(null_unspecified WKNavigation *)navigation
/**
页面开始加载时数据加载失败触发的方法
@param webView 加载网页的WKWebView控件
@param navigation 页面导航信息
@param error 错误信息
*/
- (void)webView:(WKWebView *)webView didFailProvisionalNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error
/**
当内容开始返回触发的方法
@param webView 加载网页的WKWebView控件
@param navigation 页面导航信息
*/
- (void)webView:(WKWebView *)webView didCommitNavigation:(null_unspecified WKNavigation *)navigation
/**
页面加载完成触发的方法
@param webView 加载网页的WKWebView控件
@param navigation 页面导航信息
*/
- (void)webView:(WKWebView *)webView didFinishNavigation:(null_unspecified WKNavigation *)navigation
/**
页面加载过程中数据加载失败触发的方法
@param webView 加载网页的WKWebView控件
@param navigation 页面导航信息
@param error 错误信息
*/
- (void)webView:(WKWebView *)webView didFailNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error
/**
这与用于授权验证的API,与AFN、UIWebView的授权验证API是一样的
*/
- (void)webView:(WKWebView *)webView didReceiveAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential * _Nullable credential))completionHandler
WKUIDelegate
/**
点击网页上某个标签时,是否创建新的WebView
*/
- (WKWebView *)webView:(WKWebView *)webView createWebViewWithConfiguration:(WKWebViewConfiguration *)configuration forNavigationAction:(WKNavigationAction *)navigationAction windowFeatures:(WKWindowFeatures *)windowFeatures
/**
当网页有JavaScript弹窗时触发的方法
@param webView 加载网页的WKWebView控件
@param message 弹窗提示信息
@param frame 页面结构信息
@param completionHandler 你必须实现这个Block,否则可能报错
*/
- (void)webView:(WKWebView *)webView runJavaScriptAlertPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(void))completionHandler
/**
当网页有JavaScript弹窗时触发的方法
*/
- (void)webView:(WKWebView *)webView runJavaScriptConfirmPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(BOOL))completionHandler
/**
当网页有JavaScript带输入框样式的弹窗时触发的方法
*/
- (void)webView:(WKWebView *)webView runJavaScriptTextInputPanelWithPrompt:(NSString *)prompt defaultText:(NSString *)defaultText initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(NSString * _Nullable))completionHandler
WKWebView与KVO
WKWebView有几个属性是可以通过KVO的方式进行监听的
/**
网页标题
*/
@property (nullable, nonatomic, readonly, copy) NSString *title;
/**
网页加载的URL
*/
@property (nullable, nonatomic, readonly, copy) NSURL *URL;
/**
网页是否正在加载
*/
@property (nonatomic, readonly, getter=isLoading) BOOL loading;
/**
页面加载进度
*/
@property (nonatomic, readonly) double estimatedProgress;
/**
标识加载的链接是否安全
*/
@property (nonatomic, readonly) BOOL hasOnlySecureContent;
/**
?
*/
@property (nonatomic, readonly, nullable) SecTrustRef serverTrust
/**
页面是否可回退
*/
@property (nonatomic, readonly) BOOL canGoBack;
/**
页面是否可前进
*/
@property (nonatomic, readonly) BOOL canGoForward;
对于这几个属性,我们都可以通过- (void)addObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath options:(NSKeyValueObservingOptions)options context:(nullable void *)context
的方式进行监听,不过在界面销毁时不要忘记移除监听状态。
WKWebView与JavaScript交互
在之前我使用过WebViewJavaScriptBridge第三方库进行原生同JavaScript的交互,但是有个问题,如果使用这个第三方库的话,我们自己就拿不到WKUIDelegate了,除非再把它从中调出,所以笔者自己简单写了个用于WKWebView同JavaScript交互的文件,源代码在工程里边都有。
笔者在研究WKWebView同JavaScript交互的过程中,发现不少坑
- 如果原生要发送数据到JavaScript端,可以调用
- (void)evaluateJavaScript:(NSString *)javaScriptString completionHandler:(void (^ _Nullable)(_Nullable id, NSError * _Nullable error))completionHandler
方法,其中javaScriptString
是要传递的数据,这个是字符串类型的,如果你要发送的是NSDictionary/NSArray等类型,必须首先转换为NSString类型 - JavaScript端的写法
window.webkit.messageHandlers.YourAPI.postMessage("这里边是JS传递过来的数据");
,其中YourAPI
是你注册的接口名字,两边必须一致,小括号里边的东西是JS传递过来的数据,里边必须是 NSString 类型的,而且参数只能有一个
第三方库
这个库是我根据项目需要以及在学习WebKit框架时写的,如果有同样需求的朋友应该会用到,当然这个库并不完善,日后我会不断修改以求做到最好,欢迎Star/issue
License
WebViewBrowser is released under the MIT license. See LICENSE for details.