技术栈:vue-cli 3
+ typescript
+ weixin-js-sdk
一、jssdk 引入
1.1 jssdk 版本
小程序官方文档中指定要求 jssdk 版本为 1.3.2
。
1.2 引入依赖的方式
目前的前端开发基本提倡工程化,采用 CommonJS
模块规范来引入第三方依赖,就没必要通过 <script>
标签来引用 jssdk 了。
npm jssdk 地址:weixin-js-sdk v1.3.2
1.3 jssdk 声明文件
官方目前没有提供 ts 版本的 jssdk, 所以这里需要为 jssdk 写声明文件。
新建 wechat.d.ts
文件(xxx.d.ts 格式,前面的xxx 可以随意命名):
declare module 'weixin-js-sdk'; // 定义一个全局模块
declare var wx:any; // 定义一个全局变量
详细可参考 深入理解 TypeScript:第三方代码,在此希望读者能够举一反三,不要仅仅学怎么给 jssdk 写声明文件,而应该掌握给任何没有提供声明文件的第三方依赖进行声明。
二、小程序 webview 路由跳转
在此梳理以下几种跳转情况:
2.1 从小程序页面跳转到 web-view 中的 SPA 页面
详细过程:从 小程序页面 A
跳转到小程序页面 B
,此时小程序页面 B
导航的左上角将会显示返回按钮,页面内部的 web-view
加载 SPA 的 a
页面, 从 a 页面依次跳转到 b > d > c
页面,点击物理返回键/导航左上角的返回按钮,将会按照如下顺序返回 c > d > b > a > 小程序 A
2.2 分享出去的页面,首页就是 web-view
如果首页就是上图中的小程序页面 B ,那么此时导航的左上角显示的是一个小房子的图标,如果直接从 a > b
, 左上角不会出现返回按钮,此时只能通过物理返回键返回到 a ,这是不好的体验。此时有两种解决方案:
- 用两个小程序页面,每个页面中分别使用 web-view 组件,a 在第一个页面的 web-view 中, b、c、d 在另一个页面的 web-view 中。
- 增加一个过渡页
导致可以从正式页面返回到过渡页,需要在过渡页处理,一直返回到过渡页时的逻辑
2.3 从 web-view 中的页面跳转到 小程序页面
如果 a > b > d > c > 小程序 C
,那么点击返回,将返回到 c
。
参考:
虚拟试衣小程序项目总结
小程序webview跳转页面后没有返回按钮完美解决方案
三、vue-property-decorator 关于 @Component 的说明
github 地址:vue-property-decorator
划重点:如果是单文件组件,那么 @Component
一定要写,如果不写会导致页面显示不正常,而且不一定有明显的报错。
原因分析:vue-property-decorator
采用装饰器
语法, 其中 @Component
就是用来表示这是一个组件,如果省略了这个修饰符,就无法识别出是一个组件。