ios WKWebView 与 JS 交互实战技巧
发布日期:2022-02-17 02:39:55 浏览次数:42 分类:技术文章

本文共 7230 字,大约阅读时间需要 24 分钟。

作者:张文宇 // iOS高级软件工程师

最近公司需要针对和 做与HTML5交互的App,优点就是开发周期短,可随时更新内容。所以在这整理了一些 AppWeb 交互的方法。

一、WKWebView

由于Xcode8发布之后,编译器开始不支持iOS 7了,这样我们的app也改为最低支持iOS 8.0,既然需要与web交互,那自然也就选择使用了 iOS 8.0之后 才推出的新控件 WKWebView.

相比与 UIWebView, WKWebView 存在很多优势:

  • 支持更多的HTML5的特性
  • 高达60fps滚动刷新频率与内置手势
  • Safari相容的JavaScript引擎
  • 在性能、稳定性方面有很大提升占用内存更少
    协议方法及功能都更细致
  • 可获取加载进度等。

二、WKWebView 用法简介

注:本文主要说明WKWebView与JS的交互,这里只简单介绍WKWebView基础用法,其他具体详细用法详见

需要引入WebKit

#import 

实例化

/*! @abstract Returns a web view initialized with a specified frame and configuration. @param frame The frame for the new web view. @param configuration The configuration for the new web view. @result An initialized web view, or nil if the object could not be initialized. @discussion This is a designated initializer. You can use @link -initWithFrame: @/link to initialize an instance with the default configuration. The initializer copies the specified configuration, so mutating the configuration after invoking the initializer has no effect on the web view. */- (instancetype)initWithFrame:(CGRect)frame configuration:(WKWebViewConfiguration *)configuration NS_DESIGNATED_INITIALIZER;

加载HTML页面

WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc]init];WKWebView *webView = [[WKWebView alloc]initWithFrame:self.view.bounds configuration:config];NSURLRequest *request = [[NSURLRequest alloc]initWithURL:[NSURL URLWithString:@"https://www.baidu.com"]];[webView loadRequest:request];[self.view addSubview:webView];

这里只需load即可 与UIWebView使用相同,下面简单介绍一下两个常用的代理

三、WKWebView 代理

WKWebView 有两个代理:

/*! @abstract The web view's navigation delegate. */@property (nullable, nonatomic, weak) id 
navigationDelegate;/*! @abstract The web view's user interface delegate. */@property (nullable, nonatomic, weak) id
UIDelegate;

WKNavigationDelegate 协议

WKNavigationDelegate主要处理页面跳转相关事件

//判断链接是否允许跳转- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler;//拿到响应后决定是否允许跳转- (void)webView:(WKWebView *)webView decidePolicyForNavigationRe-sponse:(WKNavigationResponse *)navigationResponse decisionHandler:(void (^)(WKNavigationResponsePolicy))decisionHandler;//链接开始加载时调用- (void)webView:(WKWebView *)webView didStartProvisionalNavigation:(null_unspecified WKNavigation *)navigation;//收到服务器重定向时调用- (void)webView:(WKWebView *)webView didReceiveServerRedirectForProvisionalNavigation:(null_unspecified WKNavigation *)navigation;//加载错误时调用- (void)webView:(WKWebView *)webView didFailProvisionalNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error;//当内容开始到达主帧时被调用(即将完成)- (void)webView:(WKWebView *)webView didCommitNavigation:(null_unspecified WKNavigation *)navigation;//加载完成- (void)webView:(WKWebView *)webView didFinishNavigation:(null_unspecified WKNavigation *)navigation;//在提交的主帧中发生错误时调用- (void)webView:(WKWebView *)webView didFailNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error;//当webView需要响应身份验证时调用(如需验证服务器证书)- (void)webView:(WKWebView *)webView didReceiveAuthenticationChal-lenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential * _Nullable creden-tial))completionHandler;//当webView的web内容进程被终止时调用。(iOS 9.0之后)- (void)webViewWebContentProcessDidTerminate:(WKWebView *)webView API_AVAILABLE(macosx(10.11), ios(9.0));

WKUIDelegate 协议

WKUIDelegate主要处理一些页面上的事件,如警告框、对话框等。

常用的方法:

//接收到警告面板- (void)webView:(WKWebView *)webView runJavaScriptAlertPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(void))completionHandler;//接收到确认面板- (void)webView:(WKWebView *)webView runJavaScriptConfirmPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(BOOL result))completionHandler;//接收到输入框- (void)webView:(WKWebView *)webView runJavaScriptTextInputPanelWithPrompt:(NSString *)prompt defaultText:(nullable NSString *)defaultText initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(NSString * _Nullable result))completionHandler;

四、WKWebView与JS的交互

交互方式

iOS 8.0 之前 用UIWebView时,只能OC调用JS代码,但JS是无法直接调用OC代码,需要通过约定特殊请求,并通过UIWebView的协议方法拦截请求的方式来实现JSOC的调用。

但使用 WKWebView 就方便的多,可以直接添加对约定的ScriptMessage(直译为 脚本信息,本文暂定为JS事件)的监听,即可实现JS调用OC

所有的操作都是通过WKUserContentController来处理的


如何获取WKUserContentController

WKUserContentControllerWKWebViewConfiguration 的属性,

WKWebViewConfigurationWKWebView 的属性(也就是在WKWebView实例化的时候传入的configuration

WKUserContentController *conntentController = self.webView.configuration.userContentController;

下面将详细介绍。

五、WKUserContentController & JS调用OC

/*! A WKUserContentController object provides a way for JavaScript to post messages to a web view. The user content controller associated with a web view is specified by its web view configuration. */WK_EXTERN API_AVAILABLE(macosx(10.10), ios(8.0))@interface WKUserContentController : NSObject 

WKUserContentController提供了JavaScriptWeb view 发消息的途径

相关方法介绍

//添加ScriptMessage(JS事件)和处理者- (void)addScriptMessageHandler:(id 
)scriptMessageHandler name:(NSString *)name;//移除指定ScriptMessage(JS事件)监听- (void)removeScriptMessageHandlerForName:(NSString *)name;

JS调用OC

ScriptMessage(JS事件)的添加删除

首先在JS代码中加入对事先约定好的 ScriptMessageJS事件)的调用

window.webkit.messageHandlers.
<事件名>
.postMessage(需要传递的数据)

同时OC端则需要加入对此JS事件的监听


例如:传递一个名为 @”closeWindow” 的消息

window.webkit.messageHandlers.closeWindow.postMessage()

OC端添加一个名为 @”closeWindow”JS的监听

[conntentController addScriptMessageHandler:self name:@"closeWindow"];

这里就添加了对 @”closeWindow” 的监听。但是当截获 此JS事件的时候需要作何处理,则需要在对应的协议方法中实现,则scriptMessageHandler需要实现协议

会在稍后介绍。


移除对一个名为 @”closeWindow”JS事件的监听

[conntentController removeScriptMessageHandlerForName:@"closeWindow"];

WKScriptMessageHandler 协议

//当接收到一个ScriptMessage(JS事件)时调用- (void)userContentController:(WKUserContentController *)userContentController didRe-ceiveScriptMessage:(WKScriptMessage *)message;

例如:处理名为 @”closeWindow” 的事件

- (void)userContentController:(WKUserContentController *)userContentController didRe-ceiveScriptMessage:(WKScriptMessage *)message{    //message.name 为 ScriptMessage 的名称    if ([message.name isEqualToString:@"closeWindow"]) {        //做处理 do something        //message.body 为此 ScriptMessage 传递的消息内容    }}

六、OC调用JS

UIWebView一样WKWebView可直接调用JS方法

WKWebView方法

- (void)evaluateJavaScript:(NSString *)javaScriptString completionHandler:(void (^ _Nullable)(_Nullable id, NSError * _Nullable error))completionHandler;

同样需要事先得知JS端的方法名和对应操作的key值

例如: 通知web某处理完成
约定的 JS函数名为 function ,需要执行一个约定好的操作名为 action,则调用如下

[self.webView evaluateJavaScript:@"function('action')" completionHandler:nil];

七、同步标题

有的时候 WKWebView所在UIViewController(视图控制器)是存在UINavigationController导航控制器的, 这时可能需要根据跳转的网页而变化标题,这时只需要KVO WKWebViewtitle 即可,并将最新的title赋值给 UIViewControllertitle 即可。

[self.webView addObserver:self forKeyPath:@"title" options:NSKeyValueObservingOptionNew context:NULL];
- (void)observeValueForKeyPath:(nullable NSString *)keyPath ofObject:(nullable id)object change:(nullable NSDictionary
*)change context:(nullable void *)context{ if([keyPath isEqualToString:@"title"]){ self.navigationItem.title = self.webView.title; }}

转载地址:https://blog.csdn.net/qq_39815184/article/details/78410826 如侵犯您的版权,请留言回复原文章的地址,我们会给您删除此文章,给您带来不便请您谅解!

上一篇:如何用NAS打造私有协同办公系统?
下一篇:看起来很酷炫的异地组网技能其实并不难学会?

发表评论

最新留言

关注你微信了!
[***.104.42.241]2024年04月03日 07时31分55秒