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