iOS中WKWebview与H5页面中间的交互

作者: MambaYong | 来源:发表于2021-12-13 11:39 被阅读0次

iOS开发中经常需要和WKWebview进行打交道,其中最常见的就是和WKWebview中的H5页面之间的交互,H5页面是通过JavaScriptiOS进行交互的,本编文章探究下JavaScriptSwift之间的交互。

H5页面的嵌入

首先我们新建一个HTML格式的文件并命名为index.html其代码如下:

<!DOCTYPE html>
<html>
    <head>
        <meta name="viewport" content="width=device-width, initial-scale=1"/>
        <style>
            .switch { position: relative; display: inline-block; width: 60px; height: 34px; }
            .switch input { opacity: 0; width: 0; height: 0; }
            label.switch { outline: none; }
            .slider { position: absolute; cursor: pointer; top: 0; left: 0; right: 0; bottom: 0; background-color: #ccc; -webkit-transition: .4s; transition: .4s; outline: none; }
            .slider:before { position: absolute; content: ""; height: 26px; width: 26px; left: 4px; bottom: 4px; background-color: white; -webkit-transition: .4s; transition: .4s; }
            input:checked + .slider { background-color: #2196F3; }
            input:focus + .slider { box-shadow: 0 0 1px #2196F3; }
            input:checked + .slider:before { -webkit-transform: translateX(26px); -ms-transform: translateX(26px); transform: translateX(26px); }
            .slider.round { border-radius: 34px; }
            .slider.round:before { border-radius: 50%; }
        </style>
    </head>
    <body>
        <h2 id="value">Toggle Switch is off</h2>
        <label class="switch">
            <input type="checkbox" name="myCheckbox">
            <span class="slider round"></span>
        </label>
    </body>
</html>

这个H5页面的内容非常简单,一个label和一个toggle switch,接下来我们在iOS界面中监听toggle switch的改变,并同步与H5进行交互更新label的值。

WKWebview

利用WKWebview加载上面创建的HTML文件:

import UIKit
import WebKit
class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        view.addSubview(webView)
        NSLayoutConstraint.activate([
            webView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            webView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            webView.bottomAnchor.constraint(equalTo: view.layoutMarginsGuide.bottomAnchor),
            webView.topAnchor.constraint(equalTo: view.layoutMarginsGuide.topAnchor)
        ])
        if let url = Bundle.main.url(forResource: "index", withExtension: "html") {
            webView.loadFileURL(url, allowingReadAccessTo: url.deletingLastPathComponent())
        }
    }
    private lazy var webView: WKWebView = {
        let webView = WKWebView()
        webView.translatesAutoresizingMaskIntoConstraints = false
        return webView
    }()
}

message handel

由于H5页面是用WKWebview加载的,WKWebview又是依托于UIViewController的,Swift接受JavaScript的消息是通过WKScriptMessageHandler这个协议实现,这个协议提供了一个方法来接受JavaScript的消息,所以这里我们让UIViewController遵守WKScriptMessageHandler协议,并实现一个必要的方法:

extension ViewController: WKScriptMessageHandler{
    func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {
        guard let dict = message.body as? [String : AnyObject] else {
            return
        }

        print(dict)
    }
}

这里假设JavaScript发送的消息为Dic并简单的进行了打印。上面的协议只是让UIViewController单方面的能接受JavaScript的消息,内在的WKWebview是不知道UIViewController这个角色的存在的,简单的理解是能接受
WKWebview消息的千万个,我怎么知道是你UIViewController?为此需要通过WKUserContentController这个桥梁告知WKWebview,有一个UIViewController正在准备接受JavaScript发出的消息,这里奉上英文解析的WKUserContentController可能更加贴切:

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.

在上面AutoLayout的约束后面加上下面这个:

let contentController = self.webView.configuration.userContentController
contentController.add(self, name: "toggleMessageHandler")

JavaScript发送消息:

把下面这段JavaScript代码放入到HTML文件的</body>标签的上面:

<script>
    var _selector = document.querySelector('input[name=myCheckbox]');
    _selector.addEventListener('change', function(event) {
        var message = (_selector.checked) ? "Toggle Switch is on" : "Toggle Switch is off";
        if (window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers.toggleMessageHandler) {
            window.webkit.messageHandlers.toggleMessageHandler.postMessage({
                "message": message
            });
        }
    });
</script>

上面的JavaScript代码在当toggle switch打开时向webkit发送"Toggle Switch is on"消息,关闭则放送"Toggle Switch is off"消息。

运行项目后当点击Toggle Switch后在控制台会有相应的消息输出!

Injecting JavaScript

上面的例子庆幸的拥有HTML的源码,并且里面写好了JavaScript的交互代码,但是实际开发中大多数情况下是没有HTML源码的,此时如果Swift想和HTML页面进行交互可以采取Injecting JavaScript的形式,简而言之就是Swift注入一段JavaScript代码到WKWebview加载的HTML页面中来进行二者之间的交互。

注释掉index.html文件中关于JavaScript的那段代码,随后在ViewControllercontentController.add(self, name: "toggleMessageHandler")的下面加上如下代码:

let js = """
    var _selector = document.querySelector('input[name=myCheckbox]');
    _selector.addEventListener('change', function(event) {
        var message = (_selector.checked) ? "Toggle Switch is on" : "Toggle Switch is off";
        if (window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers.toggleMessageHandler) {
            window.webkit.messageHandlers.toggleMessageHandler.postMessage({
                "message": message
            });
        }
    });
"""
let script = WKUserScript(source: js, injectionTime: .atDocumentEnd, forMainFrameOnly: false)
contentController.addUserScript(script)

当运行项目会发现打印的结果和之前是一样的。

Evaluating JavaScript

通过Injecting JavaScript可以让JavaScript发送消息给Swift,而通过Evaluating JavaScript则可以让Swift发送消息给JavaScript

更新userContentController(_: didReceive:)中的代码如下:

guard let message = dict["message"] else {
    return
}
let script = "document.getElementById('value').innerText = \"\(message)\""
webView.evaluateJavaScript(script) { (result, error) in
    if let result = result {
        print("Label is updated with message: \(result)")
    } else if let error = error {
        print("An error occurred: \(error)")
    }
}

首先拿到JavaScript发送过来的消息,并利用script来表示让JavaScript更新HTMLlabel的值,利用SwiftWKWebViewEvaluating JavaScript来让JavaScript立马执行这段代码达到更新HTML文本的目的。

总结

在这篇文章中,我们已经看到了如何实现WKWebView和它所加载的网页之间的双向交互。利用这一点,我们可以使用网页上的事件来触发应用程序上的动作,同样也可以根据我们在应用程序上的信息来更新加载的网页。

相关文章

网友评论

    本文标题:iOS中WKWebview与H5页面中间的交互

    本文链接:https://www.haomeiwen.com/subject/nrfffrtx.html