WKScriptMessageHandler
是WebKit
提供的一種在WKWebView
上進(jìn)行JS
消息控制的協(xié)議篡诽。
JS調(diào)用iOS:
實現(xiàn)邏輯:點擊JS的登錄按鈕,JS將登錄成功后的token數(shù)據(jù)傳遞給iOS溯街,iOS將收到的數(shù)據(jù)展示出來。
-
實現(xiàn)效果:
image JS代碼:
//! 登錄按鈕
<button onclick = "login()" style = "font-size: 18px;">登錄</button>
//! 登錄
function login() {
var token = "js_tokenString";
loginSucceed(token);
}
//! 登錄成功
function loginSucceed(token) {
var action = "loginSucceed";
window.webkit.messageHandlers.jsToOc.postMessage(action, token);
}
- iOS代碼:
//! 導(dǎo)入WebKit框架頭文件
#import <WebKit/WebKit.h>
//! WKWebViewWKScriptMessageHandlerController遵守WKScriptMessageHandler協(xié)議
@interface WKWebViewWKScriptMessageHandlerController () <WKScriptMessageHandler>
//! 為userContentController添加ScriptMessageHandler洋丐,并指明name
WKUserContentController *userContentController = [[WKUserContentController alloc] init];
[userContentController addScriptMessageHandler:self name:@"jsToOc"];
//! 使用添加了ScriptMessageHandler的userContentController配置configuration
WKWebViewConfiguration *configuration = [[WKWebViewConfiguration alloc] init];
configuration.userContentController = userContentController;
//! 使用configuration對象初始化webView
_webView = [[WKWebView alloc] initWithFrame:self.view.bounds configuration:configuration];
#pragma mark - WKScriptMessageHandler
//! WKWebView收到ScriptMessage時回調(diào)此方法
- (void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message {
if ([message.name caseInsensitiveCompare:@"jsToOc"] == NSOrderedSame) {
[WKWebViewWKScriptMessageHandlerController showAlertWithTitle:message.name message:message.body cancelHandler:nil];
}
}
- 實現(xiàn)原理:
1呈昔、JS與iOS約定好jsToOc
方法,用作JS在調(diào)用iOS時的方法友绝;
2堤尾、iOS使用WKUserContentController
的-addScriptMessageHandler:name:
方法監(jiān)聽name
為jsToOc
的消息;
3迁客、JS通過window.webkit.messageHandlers.jsToOc.postMessage()
的方式對jsToOc
方法發(fā)送消息郭宝;
4、iOS在-userContentController:didReceiveScriptMessage:
方法中讀取name
為jsToOc
的消息數(shù)據(jù)message.body
掷漱。
PS:
[userContentController addScriptMessageHandler:self name:@"jsToOc"]
會引起循環(huán)引用問題粘室。一般來說,在合適的時機(jī)removeScriptMessageHandler
可以解決此問題卜范。比如:在-viewWillAppear:方法中
執(zhí)行add
操作衔统,在-viewWillDisappear:
方法中執(zhí)行remove
操作。如下:
- (void)viewWillAppear:(BOOL)animated {
[super viewWillAppear:animated];
[_webView.configuration.userContentController addScriptMessageHandler:self name:@"jsToOc"];
}
- (void)viewWillDisappear:(BOOL)animated {
[super viewWillDisappear:animated];
[_webView.configuration.userContentController removeScriptMessageHandlerForName:@"jsToOc"];
}