You need to enable JavaScript to run this app. WKWebView中调用Swift拦截网页按钮跳转展示原生Storyboard的方法
优惠活动
大模型
产品
解决方案
定价
更多

WKWebView中调用Swift拦截网页按钮跳转展示原生Storyboard的方法

WKWebView拦截按钮点击跳转、唤起原生Storyboard的完整实现

你当前已经完成了WKWebView基础配置、JS消息通道注册的前置工作,补全以下三个环节即可实现目标:

1. 实现JS消息接收的协议方法

你已经注册了名为performClick的消息接收通道,但当前类需要遵守WKScriptMessageHandler协议,实现对应的回调方法才能接收到JS侧发来的触发信号:

extension YourWebViewController: WKScriptMessageHandler {
    func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {
        // 匹配注册的通道名,确认是目标按钮触发的回调
        guard message.name == "performClick" else { return }
        // 触发原生Storyboard页面的展示逻辑
        showTargetStoryboardPage()
    }
}

2. 注入JS绑定按钮事件,拦截默认跳转

网页按钮的默认跳转行为,需要在网页加载完成后通过注入JS拦截,避免页面跳转到外部地址:
依赖之前已经设置的navigationDelegate,在网页加载完成的回调里执行JS注入,给目标按钮绑定点击事件,同时阻止默认跳转行为

extension YourWebViewController: WKNavigationDelegate {
    func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
        // 按需替换JS选择器,匹配网页里实际的目标按钮DOM节点
        let bindScript = """
        const jumpBtn = document.querySelector('#native-jump-btn');
        if (jumpBtn) {
            jumpBtn.onclick = (event) => {
                // 阻止a标签、按钮的默认跳转行为
                event.preventDefault();
                // 调用原生注册的消息通道,触发Swift侧回调
                window.webkit.messageHandlers.performClick.postMessage(null);
            }
        }
        """
        webView.evaluateJavaScript(bindScript, completionHandler: nil)
    }
}

3. 实现Storyboard页面的加载与展示

封装独立方法处理Storyboard控制器的实例化与展示,替换成你项目里实际的Storyboard名称、控制器标识即可:

private func showTargetStoryboardPage() {
    // 替换为项目内实际的Storyboard名称、对应控制器的Storyboard ID
    let mainStoryboard = UIStoryboard(name: "Main", bundle: nil)
    guard let targetVC = mainStoryboard.instantiateViewController(withIdentifier: "OrderDetailVC") as? OrderDetailViewController else {
        return
    }
    // 按你的页面导航结构选择是push还是modal展示
    targetVC.modalPresentationStyle = .fullScreen
    present(targetVC, animated: true)
}

常见踩坑提示

  • 内存泄漏防护:页面销毁时需要手动移除注册的JS消息通道,避免循环引用:userContentController.removeScriptMessageHandler(forName: "performClick")
  • 兜底拦截逻辑:如果网页内按钮是通过JS直接修改window.location实现跳转,仅靠按钮绑定拦截可能因为注入时机晚于用户点击失效,可在webView(_:decidePolicyFor:decisionHandler:)代理方法里做兜底:检测到目标跳转链接时,直接禁止导航动作,同时触发Storyboard页面展示。
  • JS选择器匹配:注入的按钮选择器必须和网页DOM结构完全匹配,否则会出现绑定失败、点击无响应的问题。

内容的提问来源于stack exchange,提问作者Tinjzz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 01:54:04