小程序跳转到宿主页面

优质

小牛编辑

126浏览

2023-12-01

产品简介

京东小程序支持跳转到宿主app原生页面、H5页面。以实现更好的用户体验

备注：不支持跳转到宿主外部和打开外部APP。

使用场景

当小程序需要与京东原生页面（如商品详情页，购物车等）产生交互时，可以跳转至指定页面。

开放标准

对所有入驻小程序的企业开放。

jd.navigateToNative(OBJECT)

OBJECT 参数说明：

参数名	类型	必填	说明
dataParam	String/Object	是	跳转的参数(基础库1.10.1开始支持Object类型)
success	Function	否	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

dataParam 如下

格式一：

'{"url":"openapp.jdmobile://virtual?params=%7B%22category%22%3A%22jump%22%2C%22des%22%3A%22jdmpCenter%22%7D"}'

格式二：

{
    url: 'openapp.jdmobile://virtual',
    params: {
        category:"jump",
        des:"jdmpCenter",
        param:{}
    }
}

其中，url 是目标页面的openapp协议地址，目前仅支持openapp协议和route协议 params中的param，是携带的自定义参数，key value 格式。

调用示例

jd.navigateToNative({
        dataParam:'{"url":"openapp.jdmobile://virtual?params=%7B%22category%22%3A%22jump%22%2C%22des%22%3A%22jdmpCenter%22%7D"}',
   });

jd.navigateToNative({
      dataParam: {
        url:"openapp.jdmobile://virtual",
        params: {
            category:"jump",
            des:"jdmpCenter",
            param:{}
        }
    }
  });

值得注意的是，需要提前知道要跳转到的目标页面的openapp协议或route协议地址。

另外可通过系统的返回按钮返回或通过openapp协议，再次唤起源小程序返回到指定页面（会触发小程序的 onShow 回调）。