小程序 web-view 实践

技术栈：vue-cli 3 + typescript + weixin-js-sdk

一、jssdk 引入

1.1 jssdk 版本

webview 文档

小程序官方文档中指定要求 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 页面

小程序.jpg

详细过程：从 小程序页面 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 就是用来表示这是一个组件，如果省略了这个修饰符，就无法识别出是一个组件。