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

站长资源 2024/11/26 佚名

2 0 1

前言

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

看图说话：

下发模板消息效果图

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

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

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

用户必须与小程序发生了页面的交互行为，如支付、提交表单
支付会产生一个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效果图