@mas.io/url-opener
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.5 • Public • Published

    小程序链接跳转大全

    🐸 如青蛙灵活跃动

    支持从支付宝小程序跳转到其他应用(H5 离线包应用、其他小程序或 http(s) 链接),或小程序内不同页面之间跳转。

    How

    小程序内跳转用 my.navigateTo,外跳使用 my.call('startApp', { /* ... */ })

    不建议使用 pushWindow,参见 jsapi 文档 pushWindow

    注意:openUrl 仅负责跳转,参数拼接请使用对应工具方法。具体见 Use 部分。

    工具方法

    1. getOfflineH5AppSchemaUrl 离线 H5 应用链接拼装
    2. getMiniProgramSchemaUrl 小程序链接拼装
    3. addQuery 普通 http(s) 链接拼装

    Use

    1. 打开 H5 离线包应用(充值中心)

      import { openUrl } from '@alipay/url-opener';
       
      openUrl('alipays://platformapi/startapp?appId=20000987');
       
      // 将拼接链接并打开: alipays://platformapi/startapp?appId=20000987
    2. 自动拼接链接并打开 H5 离线包应用(充值中心)

      import { openUrl, getOfflineH5AppSchemaUrl } from '@alipay/url-opener';
       
      openUrl(getOfflineH5AppSchemaUrl('20000987');
       
      // 将拼接链接并打开: alipays://platformapi/startapp?appId=20000987&url=%2Fwww%2Findex.html
    3. 打开 H5 离线包应用特定页面(充值中心结果页并带入参数)

      openUrl(getOfflineH5AppSchemaUrl('20000987', '/www/result', { mobile: '18812345678' });
       
      // 将拼接链接并打开: alipays://platformapi/startapp?appId=20000987&url=%2Fwww%2Fresult.html%3Fmobile%3D18812345678
    4. 打开其他小程序(特惠充)

      openUrl('alipays://platformapi/startapp?appId=2019092967924466&page=pages/index/index&query=mobile%3D18812345678');
    5. 自动拼接链接打开其他小程序

      import { openUrl, getMiniProgramSchemaUrl } from '@alipay/url-opener';
       
      openUrl(getMiniProgramSchemaUrl('2019092967924466', '/index/index', { mobile: '18812345678' }));
       
      // 将拼接链接并打开: alipays://platformapi/startapp?appId=2019092967924466&page=pages/index/index&query=mobile%3D18812345678
    6. 打开其他小程序并设置非透明头部

      openUrl(
        getMiniProgramSchemaUrl('2019092967924466', '/index/index', { mobile: '18812345678' }),
        { transparentTitle: 'none' },
      );
       
      // 将拼接链接并打开: alipays://platformapi/startapp?appId=2019092967924466&page=pages/index/index&query=mobile%3D18812345678
    7. 打开 https 链接

      import { openUrl, addQuery } from '@alipay/url-opener';
       
      openUrl(addQuery('https://www.alipay.com?name=my', { mobile: '18812345678' }));
       
      // 将拼接链接并打开 https://www.alipay.com?name=my&mobile=18812345678
    8. 打开当前小程序内页面并带入参数

      openUrl(addQuery('/pages/index/index', { mobile: '18812345678' }));
       
      // 将拼接链接并用 my.navigate 打开 `/pages/index/index?mobile=18812345678`

    Test

    npm test

    Todo

    • 增加 typings

    Install

    npm i @mas.io/url-opener

    DownloadsWeekly Downloads

    9

    Version

    1.0.5

    License

    ISC

    Unpacked Size

    24.4 kB

    Total Files

    8

    Last publish

    Collaborators

    • bingjian.guo