【iOS开发】WKWebView与H5交互

最近因为公司的项目要大量用到H5,公司的适配版本也终于提到了iOS8以上,所以是时候换掉陈旧的UIWebView了。用这篇文章来总结一下最近用到的WKWebView相关知识,欢迎各位留言指正交流。

WKWebView的创建

- (WKWebView *)webView {
    if (!_webView) {
        //初始化WKWebViewConfiguration
        WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
        /**
         设置代理对象
         ScriptMessageHandler:WKScriptMessageHandler的代理对象
         name:跟后端协调好的响应名称
        **/
        [config.userContentController addScriptMessageHandler:self name:@"methodName"];

        _webView = [[WKWebView alloc] initWithFrame:CGRectMake(0, 0, SCREEN_WIDTH, SCREEN_HEIGHT - 64) configuration:config];
        
        [_webView  loadRequest:[ NSURLRequest requestWithURL:url]];
        
        _webView.navigationDelegate = self;
    }
    return _webView;
}

在这段代码中,我们设置了两个代理,所以应该遵守代理协议,分别是WKNavigationDelegate和WKScriptMessageHandler,两个代理方法的具体实现会在下文进行说明。这里特别说明WKScriptMessageHandler代理对象的设置并不是使用点语法的形式,而是在初始化webView的时候先初始化WKWebViewConfiguration类型的对象config,然后使用- (instancetype)initWithFrame:(CGRect)frame configuration:(WKWebViewConfiguration *)configuration方法设置代理。

WKNavigationDelegate

这个代理我用到的代理方法比较简单有三个如下,其他的代理方法也有很多文章进行说明,我就不再赘述。

// 页面开始加载时调用
- (void)webView:(WKWebView *)webView didStartProvisionalNavigation:(WKNavigation *)navigation {
}

// 页面加载完成之后调用
- (void)webView:(WKWebView *)webView didFinishNavigation:(WKNavigation *)navigation {
}

// 页面加载失败时调用
- (void)webView:(WKWebView *)webView didFailProvisionalNavigation:(WKNavigation *)navigation {
}

WKScriptMessageHandler(JS调用原生)

在看这个代理方法之前,我们首先回顾一下webView的创建时调用的一句代码

 [config.userContentController addScriptMessageHandler:self name:@"methodName"];

在创建config对象时,我们给他绑定一个名为methodName的方法,而这个方法就是和H5同事协定好的用来交互的方法的方法名,里面可以通过传参来确定接下来进行何种交互,而交互的代码就写在代理方法里面,接下来看看代理方法。

- (void)userContentController:(nonnull WKUserContentController *)userContentController didReceiveScriptMessage:(nonnull WKScriptMessage *)message {
          NSString *messageStr = [NSString stringWithFormat:@"%@",message.body];
}

这里的message是js调用methodName方法回传的信息,我们可以在代理方法中通过解析message得到和H5协定好的特殊标识来进行交互。当然你必须在js的代码中写如下代码才能保证交互成功(PS:这是H5中的JS代码)。

 window.webkit.messageHandlers. methodName.postMessage()

我个人认为这样的交互方式其实跟UIWebView通过截取字符串的交互方式有些类似,都是通过和前端协定好的特殊标识符来执行所对应的交互内容,举个例子,一个H5中有两个按钮,点击第一个按钮跳转控制器A,第二个按钮跳转控制器B,那H5人员在处理按钮A和B的交互事件的地方分别写下如下代码

 window.webkit.messageHandlers. methodName.postMessage(pushVcA)
 window.webkit.messageHandlers. methodName.postMessage(pushVcB)

我们iOS端在代理方法中写下如下代码

- (void)userContentController:(nonnull WKUserContentController *)userContentController didReceiveScriptMessage:(nonnull WKScriptMessage *)message {
          NSString *messageStr = [NSString stringWithFormat:@"%@",message.body];
          if (messageStr isEqualToString:@"pushVcA") {
                 //跳转控制器A
          }
          if (messageStr isEqualToString:@"pushVcB") {
                //跳转控制器B
          }
}

这只是一个简单的交互场景举例,但是JS调用原生方法就是在这个代理方法中实现。接下来讲一下原生如何调用JS方法。

原生调用JS

原生调用JS需要用到WKWebView的方法

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

我的使用方式为

    NSString *startStr = @"startUploadImgCB('start')";
    [self.webView evaluateJavaScript:startStr completionHandler:^(id _Nullable response, NSError * _Nullable error) {
        NSLog(@"value: %@ error: %@", response, error);
    }];

结合我的使用场景来进行一下说明,我这里的H5需要调用原生相册和拍照进行图片上传,我的代码是写在上传开始前的地方,这里的startUploadImgCB即为JS写好的方法,start是我传给JS的参数,目的是告诉JS原生开始上传图片,开始上传动画。注意这个方法要跟上文中约定好的交互方法methodName方法区分开,methodName是JS调用原生的方法名,而startUploadImgCB是原生调用JS的方法名。
以上就是对本次项目中所用到的原生与H5交互知识的总结,demo需要H5端的配合就不上了,本人才疏学浅,如果有不对的地方烦请各路大神指正,欢迎大家交流!

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,839评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,543评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,116评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,371评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,384评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,111评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,416评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,053评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,558评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,007评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,117评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,756评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,324评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,315评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,539评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,578评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,877评论 2 345

推荐阅读更多精彩内容