1. 动作表单(ActionSheet)
iOS程序员一定对ActionSheet非常熟悉,这是Cocoa Touch很常用的UI组件。使用ActionSheet会从当前窗口底部往上弹出一个窗口,可以在该窗口放置任何组件,例如,如图1所示的一排按钮。
图1 ActionSheet的效果
图1是小程序ActionSheet的效果,与iOS ActionSheet的效果类似。在小程序中使用ActionSheet要使用<action-sheet>标签,该标签中可以包含任意的组件,因此,可以在ActionSheet上放置任何小程序支持的UI元素。例如,下面的布局代码放置了4个普通按钮和一个“取消”按钮,效果就是图1所示的样式。
<view style="margin:30px">
<button type="default" bindtap="actionSheetTap">弹出action sheet</button>
<action-sheet hidden="{{actionSheetHidden}}" bindchange="actionSheetChange">
<block wx:for-items="{{actionSheetItems}}">
<action-sheet-item bindtap="bindItem{{index+1}}">{{item}}</action-sheet-item>
</block>
<action-sheet-cancel>取消</action-sheet-cancel>
</action-sheet>
</view>
在这段代码中,使用<block wx:for-items…>动态生成了4个<action-sheet-item>标签,这4个标签分别通过bindtap属性指定了4个用于响应item点击事件的函数(bindItem1、bindItem2、bindItem3和bindItem4)。在循环的外面使用<action-sheet-cancel>标签添加了一个“取消”按钮,点击“取消”按钮,无需加任何JavaScript代码就会关闭ActionSheet。
通过<action-sheet>标签的hidden属性可以控制ActionSheet的显示和隐藏,该属性值为true,表示隐藏ActionSheet,为false,表示显示ActionSheet。通过bindchange属性指定一个事件函数,当点击“取消”按钮或ActionSheet外部区域,会调用该函数,通常在该函数中隐藏ActionSheet。
下面是完整的JavaScript实现代码。
var items = ['item1', 'item2', 'item3', 'item4']
var pageObject = {
data: {
actionSheetHidden: true,
actionSheetItems: items
},
// 用于显示和隐藏ActionSheet
actionSheetTap: function (e) {
this.setData({
actionSheetHidden: !this.data.actionSheetHidden
})
},
// 点击“取消”按钮或ActionSheet的外部区域,会调用该函数
actionSheetChange: function (e) {
console.log('actionSheetChange')
this.setData({
actionSheetHidden: !this.data.actionSheetHidden
})
},
bindItem1: function (e) {
console.log("单击了item1");
this.setData({
actionSheetHidden: !this.data.actionSheetHidden
})
},
bindItem2: function (e) {
console.log("单击了item2");
this.setData({
actionSheetHidden: !this.data.actionSheetHidden
})
},
bindItem3: function (e) {
console.log("单击了item3");
this.setData({
actionSheetHidden: !this.data.actionSheetHidden
})
},
bindItem4: function (e) {
console.log("单击了item4");
this.setData({
actionSheetHidden: !this.data.actionSheetHidden
})
}
}
Page(pageObject)
显示ActionSheet后,当点击“取消”按钮或ActionSheet外部区域,会在Console中输出如图2所示的日志信息。然后ActionSheet会隐藏(因为actionSheetHidden变量被设为true)。
图2 点击“取消”按钮输出的日志信息
在<action-sheet>标签中可以放置任何组件,例如,下面的布局代码除了前面的5个按钮外,还放置了一个<image>标签。
<view style="margin:30px">
… …
<image src="http://geekori.cn/img/weixin_code.png"
style="height:300px;width:300px"/>
</action-sheet>
</view>
显示ActionSheet的效果如图3所示。
图3 带图像的ActionSheet
2 对话框
在小程序中,对话框需要使用<modal>标签。与Android、iOS不同的是,这些对话框需要实现摆放在布局文件中,默认是隐藏状态。例如,下面的布局代码放置了两个<modal>标签,并通过点击相应的按钮显示其中一个对话框。
<view>
<modal title="标题" confirm-text="确定" cancel-text="取消" hidden="{{modalHidden}}" bindconfirm="modalChange" bindcancel="modalChange">
这是对话框的内容。</modal>
<modal hidden="{{modalHidden2}}" no-cancel bindconfirm="modalChange2"
bindcancel="modalChange2">
<view> 没有标题没有取消的对话框 </view>
<view> 内容可以插入节点 </view>
</modal>
<view class="btn-area">
<button type="default" bindtap="modalTap">点击弹出modal</button>
<button type="default" bindtap="modalTap2">点击弹出modal2</button>
</view>
</view>
<modal>标签通过title属性指定标题,通过confire-text属性指定确定按钮的文本,通过cancel-text属性指定取消按钮的文本,通过hidden属性控制对话框的隐藏和显示,通过bindconfirm属性指定点击确定按钮要指定的函数,通过bindcancel属性指定点击取消按钮要执行的函数。如果指定了no-cancel属性,不会显示取消按钮。
现在分别点击第一个按钮和第二个按钮,会显示如图4和图5所示的对话框。
图4 带“确定”和“取消”按钮的对话框
图5 不带“取消”按钮的对话框
点击“确定”或“取消”按钮,会关闭对话框。实际上,这里指的关闭,就是隐藏<modal>标签,实现的代码如下:
Page({
data: {
modalHidden: true,
modalHidden2: true
},
modalTap: function(e) {
this.setData({
modalHidden: false
})
},
modalChange: function(e) {
this.setData({
modalHidden: true
})
},
modalTap2: function(e) {
this.setData({
modalHidden2: false
})
},
modalChange2: function(e) {
this.setData({
modalHidden2: true
})
},
})