@mas.io/url-opener

小程序链接跳转大全

🐸 如青蛙灵活跃动

支持从支付宝小程序跳转到其他应用（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

• [x] 增加 typings