iOS8之后,苹果推出了WebKit这个框架,用来替换原有的UIWebView,新的控件优点多多,不一一叙述。由于一直在适配iOS7,就没有去替换,现在仍掉了iOS7,以为很简单的就替换过来了,然而在替换的过程中,却遇到了很多坑。
WKWebView使用及注意点
WKWebView只能用代码创建,而且自身就支持了右滑返回手势allowsBackForwardNavigationGestures和加载进度estimatedProgress等一些UIWebView不具备却非常好用的属性。在创建的时候,指定初始化方法中要求传入一个WKWebViewConfiguration对象,一般我们使用默认配置就好,但是有些地方是要根据自己的情况去做更改。比如,配置中的allowsInlineMediaPlayback这个属性,默认为NO,如果不做更改,网页中的视频将弹出一个全屏的控制器来播放,设置为YES,将内嵌在网页中播放。
更改User-Agent
有时我们需要在User-Agent添加一些额外的信息,这时就要更改默认的User-Agent.
self.wkWebView = [[WKWebView alloc] initWithFrame:CGRectZero];
// 获取默认User-Agent
[self.wkWebView evaluateJavaScript:@"navigator.userAgent" completionHandler:^(id result, NSError *error) {
NSString *oldAgent = result;
// 给User-Agent添加额外的信息
NSString *newAgent = [NSString stringWithFormat:@"%@;%@", oldAgent, @"extra_user_agent"];
// 设置global User-Agent
NSDictionary *dictionary = [NSDictionary dictionaryWithObjectsAndKeys:newAgent, @"UserAgent", nil];
[[NSUserDefaults standardUserDefaults] registerDefaults:dictionary];
}];
需要注意的是App内所有Web请求的User-Agent全部被修改。在iOS9,WKWebView提供了一个非常便捷的属性去更改User-Agent,就是customUserAgent属性。这样使用起来不仅方便,也不会全局更改User-Agent,可惜的是iOS9才有,如果适配iOS8,还是要使用上面的方法。
WKWebView的相关的代理方法分别在WKNavigationDelegate和WKUIDelegate以及WKScriptMessageHandler这个与JavaScript交互相关的代理方法。
WKNavigationDelegate: 此代理方法中除了原有的UIWebView的四个代理方法,还增加了其他的一些方法,具体可参考我下面给出的Demo。
WKUIDelegate: 此代理方法在使用中最好实现,否则遇到网页alert的时候,如果此代理方法没有实现,则不会出现弹框提示。
WKScriptMessageHandler: 此代理方法就是和JavaScript交互相关,具体介绍参考下面的专门讲解。
加载网页或HTML代码的方式与UIWebView相同,代码示例如下:
WKWebView *webView = [[WKWebView alloc] initWithFrame:self.view.bounds];
[webView loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@"http://www.baidu.com"]]];
[self.view addSubview:webView];
用来追踪加载过程(页面开始加载、加载完成、加载失败)的方法:
// 页面开始加载时调用
(void)webView:(WKWebView )webView didStartProvisionalNavigation:(WKNavigation )navigation;
// 当内容开始返回时调用
(void)webView:(WKWebView )webView didCommitNavigation:(WKNavigation )navigation;
// 页面加载完成之后调用
(void)webView:(WKWebView )webView didFinishNavigation:(WKNavigation )navigation;
// 页面加载失败时调用
(void)webView:(WKWebView )webView didFailProvisionalNavigation:(WKNavigation )navigation;
页面跳转的代理方法:
// 接收到服务器跳转请求之后调用
(void)webView:(WKWebView )webView didReceiveServerRedirectForProvisionalNavigation:(WKNavigation )navigation;
// 在收到响应后,决定是否跳转
(void)webView:(WKWebView )webView decidePolicyForNavigationResponse:(WKNavigationResponse )navigationResponse decisionHandler:(void (^)(WKNavigationResponsePolicy))decisionHandler;
// 在发送请求之前,决定是否跳转
(void)webView:(WKWebView )webView decidePolicyForNavigationAction:(WKNavigationAction )navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler;
三、新的WKUIDelegate协议
--
这个协议主要用于WKWebView处理web界面的三种提示框(警告框、确认框、输入框),下面是警告框的例子:
/**
web界面中有弹出警告框时调用
*
@param webView 实现该代理的webview
@param message 警告框中的内容
@param frame 主窗口
@param completionHandler 警告框消失调用
*/
(void)webView:(WKWebView )webView runJavaScriptAlertPanelWithMessage:(NSString )message initiatedByFrame:(void (^)())completionHandler;
四、动态加载并运行JS代码
--
用于在客户端内部加入JS代码,并执行,示例如下:
// 图片缩放的js代码
NSString *js = @"var count = document.images.length;for (var i = 0; i < count; i++) {var image = document.images[i];image.style.width=320;};window.alert('找到' + count + '张图');";
// 根据JS字符串初始化WKUserScript对象
WKUserScript *script = [[WKUserScript alloc] initWithSource:js injectionTime:WKUserScriptInjectionTimeAtDocumentEnd forMainFrameOnly:YES];
// 根据生成的WKUserScript对象,初始化WKWebViewConfiguration
WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
[config.userContentController addUserScript:script];
_webView = [[WKWebView alloc] initWithFrame:self.view.bounds configuration:config];
[_webView loadHTMLString:@"
用户调用用JS写过的代码,一般指服务端开发的:
//javaScriptString是JS方法名,completionHandler是异步回调block
[self.webView evaluateJavaScript:javaScriptString completionHandler:completionHandler];
再WKWebView里面注册供JS调用的方法,是通过WKUserContentController类下面的方法:
(void)addScriptMessageHandler:(id
scriptMessageHandler是代理回调,JS调用name方法后,OC会调用scriptMessageHandler指定的对象。
JS在调用OC注册方法的时候要用下面的方式:
window.webkit.messageHandlers.
注意,name(方法名)是放在中间的,messageBody只能是一个对象,如果要传多个值,需要封装成数组,或者字典。整个示例如下:
//OC注册供JS调用的方法
[[_webView configuration].userContentController addScriptMessageHandler:self name:@"closeMe"];
//OC在JS调用方法做的处理
(void)userContentController:(WKUserContentController )userContentController didReceiveScriptMessage:(WKScriptMessage )message
{
NSLog(@"JS 调用了 %@ 方法,传回参数 %@",message.name,message.body);
}
//JS调用
window.webkit.messageHandlers.closeMe.postMessage(null);
如果你在self的dealloc打个断点,会发现self没有释放!这显然是不行的!谷歌后看到一种解决方法,如下:
@interface WeakScriptMessageDelegate : NSObject
@property (nonatomic, weak) id
(instancetype)initWithDelegate:(id
@end
@implementation WeakScriptMessageDelegate
(instancetype)initWithDelegate:(id
{
self = [super init];
if (self) {
_scriptDelegate = scriptDelegate;
}
return self;
}
(void)userContentController:(WKUserContentController )userContentController didReceiveScriptMessage:(WKScriptMessage )message
{
[self.scriptDelegate userContentController:userContentController didReceiveScriptMessage:message];
}
@end
思路是另外创建一个代理对象,然后通过代理对象回调指定的self,
WKUserContentController *userContentController = [[WKUserContentController alloc] init];
[userContentController addScriptMessageHandler:[[WeakScriptMessageDelegate alloc] initWithDelegate:self] name:@"closeMe"];
运行代码,self释放了,WeakScriptMessageDelegate却没有释放啊啊啊!
还需在self的dealloc里面 添加这样一句代码:
[[_webView configuration].userContentController removeScriptMessageHandlerForName:@"closeMe"];