1 WKScriptMessageHandler
1.1 WKScriptMessageHandler协议
WKScriptMessageHandler 是一个遵循的协议,它能让网页通过JS把消息发送给 OC。其中协议方法。
/*! @abstract Invoked when a script message is received from a webpage.
@param userContentController The user content controller invoking the
delegate method.
@param message The script message received.
1.1.1 - (void)userContentController:(WKUserContentController*)userContentController didReceiveScriptMessage:(WKScriptMessage*)message;(JS和OC交互的主要方法)
这个协议可以看出这里使用了两个类WKUserContentController和WKScriptMessage。WKUserContentController 为web和OC的协调器,WKScriptMessage则是JS传给OC携带的数据。
1.2现在先说WKUserContentController怎么使用和方法
WKUserContentController有两个核心方法,也是它的核心功能。
1.2.1、 (void)addUserScript:(WKUserScript *)userScript;
-------> js注入,即向网页中注入我们的js方法,这是一个非常强大的功能,开发中要慎用。
1.2.2、(void)addScriptMessageHandler:(id )scriptMessageHandler name:(NSString *)name;
-------> 添加供js调用oc的桥梁。这里的name对应WKScriptMessage中的name,我们可以认为它就是方法名。(是通过获取JS的方法名一样的并取JS传回来数据的标识[self.userContentController addScriptMessageHandler:self name:@"JSCall"],注册完了,在1.1.1获取JS数据,就可以通过[message.name isEqualToString:@"JSCall"] 判断了)
1.3 WKScriptMessage
WKScriptMessage就是js通知oc的数据。其中有两个核心属性用的很多。
1.3.1 @property (nonatomic, readonly, copy) NSString *name;
(void)addScriptMessageHandler:(id )scriptMessageHandler name:(NSString *)name;添加的name。看1.2.2
1.3.2 @property (nonatomic, readonly, copy) id body;:携带的核心数据。
web H5那边js调用时只需
window.webkit.messageHandlers.name(OC添加的Name).postMessage({
JS端要传给OC端的数据
})这里的name就是我们添加的name 下面我们就来具体实现。
2 JS调用OC
2.1 配置WKUserContentController
使用WKUserContentController为web页面添加桥梁,只需配置到 WKWebViewConfiguration就行。
- (WKWebView*)webView {
if(_webView ==nil)
{
// js配置
WKUserContentController*userContentController = [[WKUserContentControlleralloc] init];
[userContentController addScriptMessageHandler:selfname:@"JSCall"];
// WKWebView的配置
WKWebViewConfiguration*configuration = [[WKWebViewConfigurationalloc] init]; configuration.userContentController = userContentController;
// 显示
WKWebView_webView = [[WKWebViewalloc] initWithFrame:self.view.frame configuration:configuration];
_webView.UIDelegate =self;
// 设置WKUIDelegate代理
[self.view addSubview:_webView];
}
return_webView;
}
2.2 实现WKScriptMessageHandler
在当前页面引入WKScriptMessageHandler,并实现WKScriptMessageHandler协议。
- (void)userContentController:(WKUserContentController*)userContentController didReceiveScriptMessage:(WKScriptMessage*)message
{
NSLog(@"方法名:%@", message.name);
NSLog(@"参数:%@", message.body);
// 方法名
NSString*methods = [NSStringstringWithFormat:@"%@:", message.name];
这里你可以根据需求写相关的方法OC实现
web端写法
使用了window.webkit.messageHandlers.JSCall.postMessage(dict);通知oc,"JSCall" 这个属性就是前面我们通过WKUserContentController注入的。
3 OC调用JS
3.1 OC通知JS
只需WKWebView调用
- (void)evaluateJavaScript:(NSString *)javaScriptString completionHandler:(void (^ __nullable)(__nullable id, NSError * __nullable error))completionHandler;方法即可。
4 WKUserScript JS注入
4.1 WKUserScript核心方法
在WebKit框架中,我们还可以预先添加JS方法,供其他人员调用。WKUserScript就是帮助我们完成JS注入的类,它能帮助我们在页面填充前或js填充完成后调用。核心方法。
/*! @abstract Returns an initialized user script that can be added to a @link WKUserContentController @/link.
@param source The script source.
@param injectionTime When the script should be injected.
@param forMainFrameOnly Whether the script should be injected into all frames or just the main frame.
*/
- (instancetype)initWithSource:(NSString *)source injectionTime:(WKUserScriptInjectionTime)injectionTime forMainFrameOnly:(BOOL)forMainFrameOnly;
4.2 WKUserScriptInjectionTime枚举
在WKUserScriptInjectionTime枚举中有两个状态。
WKUserScriptInjectionTimeAtDocumentStart:js加载前执行。
WKUserScriptInjectionTimeAtDocumentEnd:js加载后执行。
4.3 js注入
WKUserScript的运行需依托WKUserContentController,接下来我们就为WKWebView注入一个js执行完毕后执行的alert方法。
方法
- (WKWebView*)webView
{
if(_webView ==nil)
{// js配置
WKUserContentController*userContentController = [[WKUserContentControlleralloc] init];
[userContentController addScriptMessageHandler:selfname:@"JSCall"];// js注入,注入一个alert方法,页面加载完毕弹出一个对话框。
NSString*javaScriptSource =@"alert(\"WKUserScript注入js\");";
WKUserScript*userScript = [[WKUserScriptalloc] initWithSource:javaScriptSource injectionTime:WKUserScriptInjectionTimeAtDocumentEndforMainFrameOnly:YES];// forMainFrameOnly:NO(全局窗口),yes(只限主窗口)
[userContentController addUserScript:userScript];// WKWebView的配置WKWebViewConfiguration*configuration = [[WKWebViewConfigurationalloc] init]; configuration.userContentController = userContentController;// 显示WKWebView_webView = [[WKWebViewalloc] initWithFrame:self.view.frame configuration:configuration];
[self.view addSubview:_webView];
}
return_webView;
}
总结:一路学习,一路分享,同时也感慨现在技术越来越好用,越来越成熟。
参考的学习链接:https://www.jianshu.com/p/ca7eb797c8a0
网友评论