【微信小程序】项目实战—抽签应用

• 完成学习前面章节的微信小程序开发必备的基础知识，从本章开始就可以进入完整的应用开发了。很多大型的应用主要通过App来实现，微信小程序的定义则主要是工具类的应用，宗旨是做到即用即走。抽签应用完全符合这一特性，所以本章将实现一个抽签类型的小程序。

本章主要涉及的知识点有：

• UI组件的使用

• 表单的使用

• 本地存储

1.项目起步

本节开始设计抽签项目所需要包含的功能。在平时遇到难以决定的事情时，可以使用小程序进行抽签。该抽签应用包括以下功能。

• 增加抽签项及其内容项

• 删除抽签项及其内容项

• 抽签

• 本地存储

• 输入校验

• 用户交互提示

接下来新建一个项目draw作为本章的项目。导入UI框架iView，并在根目录新建文件夹images。项目中所需要用到的图片可以直接从示例代码中获取。目录如图所示。

将

app.js

清空，删除index和logs页面，新建

home、mine、edit-item、draw-view

页面，最后在

app.json、app.wxss

中输入以下代码：

// app.json
·..
"tabBar":{
"selectedColor":"#2C8BEF""list": [
{
"selectedIconPath":"images/home2.png","iconPath":"images/home.png","pagePath":"pages/home/home","text":"首页"}，{
"selectedIconPath":"images/mine2.png","iconPath":"images/mine.png","pagePath":"pages/mine/mine","text":"我的"
}]
}，
·..

// app.wxss page {
background-color: #EFEFEF;


运行效果如图所示。

【代码解析】一个带底部导航栏的首页已经完成。导航栏的内容主要是通过tabBar参数来实现的。

注意

:应把app.json中的v2删除，否则UI框架可能会运行出错。

2.项目开发

准备工作完成后，正式进入编码阶段。

2.1首页开发

打开home页面，输入以下代码：

// home.json

"navigationBarTitleText":"首页""usingComponents":
{
"i-button":"/dist/button/index",
"i-cell-group":"/dist/cell-group/i ndex","i-cell":"/dist/cell/index",
 "i-modal":"/dist/modal/index"

}

// home.wxml
<i-button type=&quot;primary&quot; bind:click=&quot;addItem&quot;>添加选项</i-button>

<i-cell-group><i-cell
wx:for=&quot;{{listData}}&quot; wx:for-item=&quot;item&quot; wx:key=&quot;item&quot;
data-item=&quot;{{item}}&quot; title=&quot;{{item}}&quot; bindtap=&quot;draw&quot;
bindlongpress=&quot;delete&quot; is-link></i-cell></i-cell-group>

<i-modal title=&quot;删除确认&quot; visible=&quot;{{ visible }}&quot; actions=&quot;{{ actions }}&quot; bind:click=&quot;realDelete&quot;>
<view>删除后无法恢复哦</view></i-modal>

// home.js
// pages/home/home.js
Page({ data:{
listData:[],
currentItem:'' actions: [{
name:'取消'}，

name:'删除'，
color:'#ed3f14', loading:false}
]，
visible:false}，
onShow: function () { 
this.setData({
listData:wx.getStorageSync('homeList')})}，
//加选项 addItem() {
wx.navigateTo({
url:'../edit-item/edit-item',

}，
//进入抽签页 draw(e){
wx.navigateTo({
url:'../draw-view/draw-view?item='+ e.currentTarget.dataset.item

}，
//删除子选项弹窗 delete(e){
console.log(e) this.setData({
visible: true,
currentItem: e.currentTarget.dataset.item});

// 删除子选项
realDelete({detail}){
if (detail.index=== 1) {
var newArray=[];
for (const item of this.data.listData){
if (item!=this.data.currentItem){ newArray.push(item);
}
}
this.setData({
listData: newArray
1
wx.setStorageSync('homeList',this.data.listData)
wx.removeStoraqeSync(this.data.currentItem) wx.showToast({
title:'删除成功'，
1)
 this.setData({
visible: false
!({
})


【代码解析】首先在home.json中导入需要用到的UI组件。在页面结构上，顶部是一个添加选项按钮，并通过wxfor来显示选项，最后的i-modal是弹窗组件，通过visible控制。在页面跳转方面，edit-item是添加选项页，draw-view是抽签页。删除功能通过覆盖homeList的选项来实现，删除成功后，要循环删除子选项。

2.2新增页面开发

由于还没有开发添加选项页，因此放效果图之前需要先开发一个添加选项页面。在edit-item页面中输入以下代码：

// edit-item.json{
"navigationBarTitleText":"选项"，"usingComponents":{
"i-panel":"/dist/panel/index","i-input":"/dist/input/index","i-button":"/dist/button/index"
/
// edit-item.wxml
<i-panel title=&quot;{{title}}&quot;>
<i-input
value=&quot;{{itemName}!&quot;
placeholder=&quot;请输入选项&quot;
bind:change=&quot;changeItem&quot;/></i-panel>

<i-button bind:click=&quot;submit&quot; type=&quot;primary&quot;>提交</i-button>

// edit-item.js
// pages/edit-item/edit-item.js Page({
data:{
title:'添加选项'，
saveKey:'homeList', itemName:''
 }，
onLoad:function (options){ if (options.item){ this.setData({
title:'添加&quot;'+options.item+'&quot;的子选项'， saveKey:options.item})}
}，
changeItem(e){ this.setData({
itemName: e.detail.detail.value})
}，
// 提交
submit() {
if (this.data.itemName.length===0) { wx.showToast({
title:'内容过短'， icon:'none'})
} else if (this.data.itemName.length >10){ wx.showToast({
title:'内容过长'， icon:'none'})
}else {
var items;
var key= this.data.saveKey; if (wx.getStorageSync(key)) {
items=wx.getstorageSync(key); for (const key of items) {
if (key== this.data.itemName){ wx.showToast({ title:'已存在'， icon:'none'})
returni

}
}else {
items = [];
items.push(this.data.itemName);
wx.setStorageSync(key,items); wx.showToast({
title:'保存成功'，})
setTimeout(() => {
wx.navigateBack()}，1000)

}})


添加选项页的运行效果如图一所示。

【代码解析】新增选项页面之后需要与新增子选项复用，所以我们编写代码的时候要兼顾两者。同样先在JSON文件中导入用到的UI组件。表单上只有一个input需要输入，提交的时候判断是否为空、是否过长即可。如果是首页选项，就保存在homeList中，子选项则以首页选项的名字为key保存。添加完成后，首页如下下图所示。

【添加选项页】

【首页效果】

2.3　抽签页面开发

现在首页已经有了选项，并且可以通过新增页来增加。此时可以开发抽签页，列出子选项，用于抽签。打开draw-view页面，输入以下代码：

// draw-view.json

"navigationBarTitleText":"抽签"，"usingComponents":{
"i-button":"/dist/button/index"
"i-cell-group":"/dist/cell-group/index","i-cell":"/dist/cell/index","i-modal":"/dist/modal/index"

// draw-view.wxml
<i-button type=&quot;primary&quot; bind:click=&quot;addItem&quot;>添加子选项</i-button><i-button type=&quot;success&quot; bind:click=&quot;draw&quot;>抽签</i-button>

<i-cell-group><i-cell
wx:for=&quot;{{listData}}&quot; wx:for-item=&quot;item&quot; wx:key=&quot;item&quot;
data-item=&quot;{{item}}&quot; title=&quot;{{item}}&quot;
bindlongpress=&quot;delete&quot;></i-cell></i-cell-group>

<i-modal title=&quot;删除确认&quot;visible=&quot;{{ visible }}&quot; actions=&quot;{{ actions }}&quot;
bind:click=&quot;realDelete&quot;>
<view>删除后无法恢复哦</view></i-modal>

// draw-view.js
//pages/draw-view/draw-view.js Page({
data:{
listData:[]， lastItem:''
currentItem:'', actions:[{
name:'取消'}，
name:'删除'，
color:'#ed3f14', loading:false}
]，
visible:false}，
onLoad:function(options){
this.setData({
lastItem: options.item

wx.setNavigationBarTitle({
title: options.item,})}，
onShow:function() {
this.setData({
listData:wx.getStorageSync(this.data.lastItem)})}，
//添加子选项 addItem() {
wx.navigateTo({
url:'../edit-item/edit-item?item='+ this.data.lastitem
})}，
// 抽签 draw(){
if (this.data.listData.length == 0) { wx.showToast({
title:'没有数据'， icon:'none'})
} else {
const randomNumber=this.getRandomNumber(0,
this.data.listData.length);
wx.showToast({
title:this.data.listData[randomNumber]})

}，
// 获取随机数
getRandomNumber(begin,end){
return Math.floor(Math.random() * (end-begin))+ beging}，
// 删除子选项弹窗 delete(e){
this.setData({
visible: true,
currentItem: e.currentTarget.dataset.item
});
}，
// 删除子选项
realDelete({detail}) {
if (detail.index=== 1) {
var newArray=[];
for (const item of this.data.listData){
if (item!= this.data.currentItem){
newArray.push(item);
)}
this.setData({
listData: newArray})
wx.setStorageSync(this.data.lastItem,this.data.listData); wx.showToast({
title:'删除成功'，})}
this.setData({
visible:false});}
})


添加子选项后，点击“抽签”按钮，运行效果如图所示。

【代码解析】进入页面后，会根据上一个页面传入的选项名来获取存储的子选项数据。点击“抽签”按钮，会通过随机数从现有子选项中抽取一个进行弹窗显示。添加、删除子选项功能与首页的基本相同。

2.4　我的页面开发

通过前面3个页面的开发，主要的抽签流程已经走通了。为了完善这个应用，补充“我的”页面，增加清空、微信登录功能。打开mine页面，输入以下代码：

// mine.json{
"navigationBarTitleText":"我的"，
"usingComponents":{
"i-card":"/dist/card/index"
"i-button":"/dist/button/index"
"i-cell-group":"/dist/cell-group/index""i-cell":"/dist/cell/index","i-modal":"/dist/modal/index"

// mine.wxml
<view class=&quot;view-margin&quot;>
<i-card
title=&quot;{{userInfo.nickName}}&quot;
extra=&quot;{{userInfo.country}}&quot;
thumb=&quot;{{userInfo.avatarUrl}}&quot;>
<!-- <view slot=&quot;content&quot;>用户名:张三</view> --></i-card>
</view>

<view class=&quot;view-margin&quot;><i-cell-group><i-cell
title=&quot;清空数据&quot;
bindtap=&quot;clearData&quot; is-link></i-cell><i-cell
title=&quot;意见反馈&quot;
bindtap=&quot;callBack&quot; is-link></i-cell></i-cell-group></view>

<i-button
wx:if=&quot;{{userInfo.nickName=='未登录'}}&quot; type=&quot;primary&quot;
open-type=&quot;getUserInfo&quot;
bind:getuserinfo=&quot;login&quot;>登录</i-button>

<i-button
wx:if=&quot;{{userInfo.nickName!='未登录'}}&quot; type=&quot;error&quot;
bind:click=&quot;logout&quot;>退出登录</i-button>

<i-modal
title=&quot;清空确认&quot;
visible=&quot;{{ visible }}&quot; bind:ok=&quot;delete&quot;
bind:cancel=&quot;cancel&quot;>
<view>清空后无法恢复哦</view></i-modal>

// mine.wxss.view-margin{
margin-top:16px;}

// mine.js Page({
data:{
userInfo:{
nickName:'未登录'， country:'-',
avatarUrl:'https://i.loli.net/2017/08/21/599a521472424.jpg

visible:false

onLoad(options){
if (wx.getStorageSync('userInfo')){ this.setData({
userInfo: wx.getStorageSync('userInfo')
})
}，
clearData(){
this.setData({ visible:true

}，
delete() {
const array=wx.getstorageSync('homeList') for (const item of array) {
wx.removeStorageSync(item)}
wx.removeStorageSync('homeList') this.setData({ visible:false

cancel() {
this.setData({ visible:false})}，
login(e){
if (e.detail.userInfo){
this.setData({
userInfo: e.detail.userInfo})
wx.setStorageSync('userInfo',e.detail.userInfo)} else {
wx.showToast({
title:'登录失败'， icon:'none'})
}
}，
logout() {
wx.removeStorageSync('userInfo'y this.setData({
userInfo:{
nickName:'未登录'， country: '-',
avatarUrl:&quot;https://i.loli.net/2017/08/21/599a521472424.ipq
}
})}})


在“我的”页面点击“登录”按钮，会弹出权限申请框，点击允许授予权限后即可登录，运行效果如图所示。

【代码解析】清空数据通过循环homeList里的数据把所有数据移除掉。登录功能在用户，点击允许按钮后，从e.detail.userInfo取出用户的头像、昵称等信息进行展示，并通过wxif控制“显示登录”或“退出登录”按钮。如果需要测试，可以点击微信开发工具中的“清缓存→清除登录状态”，如图所示。

3.小结

本章综合运用前面学到的知识创建了一个易用的工具类应用。虽然该程序的基本功能已经齐全，但是仍有较大的改进空间。建议读者自行添加编辑选项、改变排序等功能来作为练习。为了将各种知识分类展示，本章的内容仅使用了本地存储，没有设计网络请求。下一章我们将做一个带网络请求的完整应用。