小程序开发文档及项目实战小记
1. 数据绑定
注意: 花括号和引号之间如果有空格,将最终被解析成为字符串。
<view wx:for="{{[1,2,3]}} "> {{item}}</view>
// 以上等同于以下
<view wx:for="{{[1,2,3] + ' '}}"> {{item}}</view>
复制代码
2. 列表渲染wx:key
如果列表中项目的位置会动态改变或者有新的项目添加到列表中,并且希望列表中的项目保持自己的特征和状态(如 input 中的输入内容,switch 的选中状态),需要使用 wx:key 来指定列表中项目的唯一的标识符。
wx:key 的值以两种形式提供
- 字符串,代表在 for 循环的 array 中 item 的某个 property,该 property 的值需要是列表中唯一的字符串或数字,且不能动态改变。
- 保留关键字 *this 代表在 for 循环中的 item 本身,这种表示需要 item 本身是一个唯一的字符串或者数字。
当数据改变触发渲染层重新渲染的时候,会校正带有 key 的组件,框架会确保他们被重新排序,而不是重新创建,以确保使组件保持自身的状态,并且提高列表渲染时的效率。
注意: 如不提供** ****wx:key ,会报一个 ****warning **, 如果明确知道该列表是静态,或者不必关注其顺序,可以选择忽略。
developers.weixin.qq.com/miniprogram…
<switch wx:for="{{objectArray}}" wx:key="unique" style="display: block;"> {{item.id}} </switch>
<button bindtap="switch"> Switch </button>
<button bindtap="addToFront"> Add to the front </button>
<switch wx:for="{{numberArray}}" wx:key="*this" style="display: block;"> {{item}} </switch>
<button bindtap="addNumberToFront"> Add to the front </button>
<switch wx:for="{{numberArray}}" style="display: block;"> {{item}} </switch>
<button bindtap="addNumberToFront"> Add to the front </button>
复制代码
3. 使用WXS函数响应事件
- 在组件中绑定和注册事件处理的WXS函数(注意:绑定的WXS函数必须用{{}}括起来)
<wxs module="wxs" src="./test.wxs"></wxs>
<view id="tapTest" data-hi="Weixin" bindtap="{{wxs.tapName}}"> Click me! </view>
**注:绑定的WXS函数必须用{{}}括起来**
复制代码
4. dataset
data-element-type
,最终会呈为event.currentTarget.dataset.elementType
;data-elementType
,最终会呈现为event.currentTarget.dataset.elementtype
。
项目实战
技术:
mobx-miniprogram/mobx-miniprogram-bindings + @vant/weapp + WePY1 + iView Weapp
插件与SDK:
腾讯位置服务-小程序JSSDK:qqmap-wx-jssdk
二维码:weapp-qrcode
小程序ECharts: ec-canvas
业务:
- 原有小程序项目迁移
- 过渡页
- 路由分发页面跳转
- 扫描二维码
- 门禁扫码开门
- 扫码进入特定页面
- 扫码控制设备
- 公众号推送消息等跳转
- 进入特定页面
- 链接跳转
- 进入特定页面
支持以上功能流程如下:
相关链接:
使用 MobX 来管理小程序的跨页面数据
weapp-qrcode使用教程及踩过的坑
[开盖即食]小程序图表插件 ECharts 实战
小程序登录登录流程时序
自定义 tabBar