lionvoom / WeAppTongCeng

小程序同层渲染
144 stars 26 forks source link

自微信小程序火了后, 个大头部厂商也纷纷效仿, 给自己的客户端提供了小程序框架支持. 然而小程序框架为了提升小程序页面的极致用户体验, 做了同层渲染.

抛砖引玉:

我们今天的目标就是: 从0到1实现iOS端WKWebView同层渲染, 文章末尾有DEMO演示, 也有源码地址.

weapp.png

同层渲染原理

「同层渲染」就是把原生组件绘制在 WebView 所渲染的页面中,与其他 HTML 控件在同一层级,效果如下图所示: 同层渲染原理.png

这里我给大家找到三篇比较官方的文章, 建议跳过看总结:

总结

这些文章只阐述了基本实现思路, 并没有教你怎么实现, 然并卵.

看完之后各大技术论坛的“同层渲染原理分析”的你, 还是实现不了. 下面我们一起来实现一个.

实现同层渲染

1. 我们在前端H5页面上创建一个需要生成原生组件的DOM节点.

<div class="container cid_1" data-component-type="input" style="width: 200px; height: 40px">
    <div style="width: 101%; height: 101%">&nbsp;</div>
</div>

<style>
    .container { 
        /* insert WKChildView in WKWebView */
        overflow: scroll;
        -webkit-overflow-scrolling: touch;
    }
</style>

2. 前端会把原生组件类型如cidposition等信息通过window.webkit.messageHandlers.handle.postMessage发送给iOS端.

<script>
    // 管理同层渲染组件, 通知原生创建同层渲染组件
    function insertNativeComponents() {
        var containers = document.getElementsByClassName("container");
        console.log(containers);
        for (var i = 0; i < containers.length; i++) {
            var ct = containers[i];
            var component_type = ct.getAttribute("data-component-type");
            if (!component_type) continue;
            var cid = ct.getAttribute("class").split(" ")[1];
            var cid_num = cid.slice("cid_".length);
            var frame = ct.getBoundingClientRect();
            var args = {
                "position": {
                    "top": frame.top,
                    "left": frame.left,
                    "width": frame.width,
                    "height": frame.height
                },
                "cid": cid_num
            };
            switch (component_type) {
                case "input": {
                    nativeInvoke("insertInput", args);
                }
                break;

                case "textArea": {
                    nativeInvoke("insertTextArea", args);
                }
                break;

                case "video": {
                    nativeInvoke("insertVideo", args);
                }
                break;
            }
        }
    }

    function nativeInvoke(api, args) {
        console.log(api, args);
        //TODO: judge platform iOS / Android
        var platform = "ios";
        if (platform === "ios") {
            window.webkit.messageHandlers.handle.postMessage({
                "api": api,
                "args": args
            });
        }
    }   

    setTimeout("insertNativeComponents()", 100);
</script>

3. iOS端WKWebView消息代理接收到前端发来的消息

- (void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message {
        // 收到前端的消息
        // message.name: handle
    // message.body: {"api":"insertInput","args":{"cid":"1","position":{"top":30,"width":200,"left":87.5,"height":40}}}
}

4. iOS端可以通过消息中的cid匹配查找相应WKChildScrollView,并将原生组件挂载到该节点上作为其子View.

图片

5. 最后我们发现WKWebView中插入的原生组件是无法响应交互事件的,需要特殊处理.

这里我们需要处理两件事,一是屏蔽WKContentView手势拦截事件响应链的传递,让事件可以传递到原生组件中,命令如下:

@implementation LVTongCengWebView

- (void)_handleWKContentGestrues {
    UIScrollView *webViewScrollView = self.scrollView;
    if ([webViewScrollView isKindOfClass:NSClassFromString(@"WKScrollView")]) {
        UIView *_WKContentView = webViewScrollView.subviews.firstObject;
        if (![_WKContentView isKindOfClass:NSClassFromString(@"WKContentView")]) return;
        NSArray *gestrues = _WKContentView.gestureRecognizers;
        for (UIGestureRecognizer *gesture in gestrues) {
            gesture.cancelsTouchesInView = NO;
            gesture.delaysTouchesBegan = NO;
            gesture.delaysTouchesEnded = NO;
        }
    }
}

@end

二是重写iOS端原生组件容器LVContainerView协议检测方法-conformsToProtocol:,目的是绕过WKNativelyInteractible协议检测,从而在点击WKWebView的时候,容器LVContainerView及其子view(原生组件)可以正常进行事件响应。

@implementation LVContainerView

- (BOOL)conformsToProtocol:(Protocol *)aProtocol {
    if (aProtocol == NSProtocolFromString(@"WKNativelyInteractible")) {
        return YES;
    }
    return [super conformsToProtocol:aProtocol];
}

@end

到这里,经过前面这些步骤,我们就实现了iOS端WKWebView同层渲染,下面让我们来看看实现效果:

  1. 我们可以看到原生组件UITextFieldUITextView响应聚焦输入,UIButton可以点击变颜色,实现了正常交互;
  2. H5蒙层可以遮挡住原生组件,解决了WKWebView内嵌原生组件的层级限制问题,完美体现了同层的含义。

Talk is cheap. Show me the code.
DEMO地址: https://github.com/lionvoom/WeAppTongCeng

极客时间-每日一课
iOS小程序同层渲染到底怎么实现?