基于Taro的微信小程序模板消息-获取formId功能模块封装实践

更新时间：2020-09-04 06:42:01 作者：startmvc

前言在微信小程序中，小程序提供了一种能力-模板消息，官方文档是这样描述的：“基于

前言

在微信小程序中，小程序提供了一种能力-模板消息，官方文档是这样描述的：“基于微信的通知渠道，我们为开发者提供了可以高效触达用户的模板消息能力，以便实现服务的闭环并提供更佳的体验。”

看图说话：

下发模板消息效果图

这无疑又给小程序提供了与用户进行通知、反馈的新能力，但是小程序为了防止模板消息对用户造成信息轰炸，影响用户体验，也设置了一些规矩：

模板推送位置：服务通知
模板下发条件：用户本人在微信体系内与页面有交互行为后触发
模板跳转能力：点击查看详情仅能跳转下发模板的该帐号的各个页面

那我们想通过小程序给用户发送模板消息需要怎么做呢？

用户必须与小程序发生了页面的交互行为，如支付、提交表单
支付会产生一个prepay_id的标记，提交表单会产生一个formId的标记
服务端根据prepay_id或formId来发送模板消息

无论是prepay_id还是formId都只有7天的有效期

那么问题来了？

如果用户在使用小程序的过程中，没有在7天内进行一些信息提交操作，或者是支付操作，那么我们就无法获取prepay_id，formId了，但是实际的业务上却需要给用户发送一些模板消息，已达到某些推广或通知的效果。prepay_id必须是支付的时候才能产生，这个无需多言。今天胡哥就给大家来介绍下，如何在小程序中尽可能的获取formId，以达到让服务端有尽可能多的formId来发送模板消息。

获取formId的原理

必须是form组件，并且需声明属性report-submit="，表示需要发送模板消息，同时监听bindsubmit事件；
必须在该form组件中，有button组件，同时该button组件需声明属性form-type="submit"。

上代码 --- 小程序原生代码演示


<form report-submit="true" bindSubmit="submitEvent">
 <button open-type="submit">提交</button> 
</form>

获取formId模块的封装

基于小程序获取formId的原理，我们可以变相考虑：

只要用户触发了符合特定条件的包含button组件的form组件的bindSubmit事件，就可以获取到formID；
同时借助CSS样式，我们可以将form组件和button组件设置成隐形的，不可见但确真实存在；
将隐形的button组件覆盖在真实的组件上，当点击真实组件时，实际上就触发了button的点击，同时用户是无感知的。

这里是重点，圈起来，一定会考的！

基于Taro的获取formId功能模块封装实践

设计独立的功能模块，以便供其他模块方便调用，项目目录结构


src/
 components/
 formId/
 index.js
 index.scss

src/components/formId/index.js


/**
 * 封装FormId组件，以提供向服务端发送formId的功能
 */
import Taro, { Component } from '@tarojs/taro'
import { View, Form } from '@tarojs/components'
import './index.scss'

export default class FormId extends Component {
 constructor (props) {
 super(props)
 }
 /**
 * formSubmit()
 * @description 提交formId到后端服务器
 * @param {*} e event对象
 */
 formSubmit (e) {
 // 打印在控制台
 console.log('formId:', e.detail.formId)
 // 模态框展示
 Taro.showModal({
 title: 'formId',
 content: e.detail.formId,
 showCancel: false
 })
 /**
 * 注意： 
 * 实际封装中，直接将获取的formId发送到后端服务器即可，无需弹框提示、控制台打印，此处只是为了给小伙伴展示效果
 */ 
 }
 render () {
 let { children } = this.props
 return (
 <Form className="form" reportSubmit="true" onSubmit={this.formSubmit}>
 { children }
 <Button className="form-btn" formType="submit"></Button>
 </Form>
 )
 }
}

src/components/formId/index.scss

非常重要的问题：就是隐藏样式，让用户不可见、无感知，但实际确实存在的。


.form {
 position: relative;
 display: flex;
 .form-btn {
 position: absolute;
 left: 0;
 top: 0;
 width: 100%;
 height: 100%;
 background: transparent;
 outline: none;
 padding: 0;
 box-sizing: border-box;
 &::after {
 content: "";
 border: none;
 }
 }
}

src/pages/index/index.js 调用formId模块

在任意想使用formId的其他模块中引入，调用即可


import Taro, { Component } from '@tarojs/taro'
import { View, Button } from '@tarojs/components'
import FormId from '../../components/formId'

export default class Index extends Component {
 render () {
 return (
 <View className="index">
 {/* 调用FormId组件 */}
 <FormId>
 {/* 页面中任意元素 */}
 <Button>其他元素</Button>
 </FormId>
 </View>
 )
 }
}

效果图

获取formId效果图