1. 滑杆组件(slider)
slider组件用于通过滑杆改变数值,该组件有如下几个属性。
min:Number类型,默认值是0,表示滑杆能滑动的 最小值
max:Number 类型,默认值是100,表示滑杆能滑动的最大值
step:Number类型,默认值是1,表示滑杆滑动的步长,取值必须大于0,并且可被max - min整除
disabled:Boolean类型,默认值是false,表示slider组件是否禁用
value:Number类型,默认值是0,slider组件当前的值
show-value:Boolean类型,默认值是false,表示是否显示当前的值(在slider组件的右侧显示)
bindchange:EventHandle类型, 完成一次拖动后触发的事件(假设event是事件触发的函数的参数),event.detail.value可获取当前的值
下面的布局代码放置了3个slider组件,第一个slider组件设置了step属性值为5,并没有指定show-value属性,所以第一个slider组件不会在右侧显示当前的值。后两个slider组件都设置了show-value属性,所以这两个slider组件可以在右侧显示当前的值。
代码语言:javascript复制<view style="margin:20px"> <view style="margin:20px"> <text style="margin:15px">设置step</text> <slider value="60" bindchange="slider1change" step="5" /> </view> <view style="margin:20px"> <text style="margin:15px">显示当前value</text> <slider value="50" bindchange="slider2change" show-value/> </view> <view style="margin:20px"> <text style="margin:15px">设置最小/最大值</text> <slider value="100" bindchange="slider3change" min="50" max="200" show-value/> </view></view>
布局的效果如图1所示。
图1 slider组件
完整的JavaScript实现代码如下:
代码语言:javascript复制var pageData = {}for(var i = 1; i < 4; i) { (function (index) { pageData[`slider${index}change`] = function(e) { console.log(`slider${index}发生change事件,携带值为`, e.detail.value) } })(i);}Page(pageData)
这段代码通过循环,动态生成了3个事件函数(slider1change、slider2change和slider3change),当滑动slider组件的滑杆时,会在Console中输出如图2所示的日志信息。
图2 滑动slider滑杆时在Console的输出结果
2. form组件
form组件用于提交用户的输入的内容(通过switch、input、checkbox、slider等组件输入),待提交的组件必须在form组件内部。这里的提交,实际上是当点击formType属性为submit的button组件时,将录入的信息提交给一个函数,通过该函数的参数可以获取用户提交的内容,每一部分内容需要用待提交组件的name属性值作为key。form组件还可以通过点击formType属性值为reset的button组件将录入的内容重置。
form组件有如下几个属性。
- report-submit:Boolean类型,是否返回formId用于发送模板消息
- bindsubmit:EventHandle类型,指定提交触发的函数名称,通过event.detail.value可获得提交的内容
- bindreset:EventHandle类型,指定重置触发的函数名,该函数的参数不能通过event.detail.value获取提交的内容(value未定义),只能通过event.detail获取form组件本身
下面的布局文件演示了form组件的使用方法。
代码语言:javascript复制<view style="margin:30px"> <form catchsubmit="formSubmit" catchreset="formReset"> <switch name="switch" checked="true" /> <slider style="margin-top:20px" name="slider" show-value></slider> <input style="margin-top:20px" name="input" placeholder="please input here" /> <radio-group style="margin-top:20px" name="radio-group"> <label> <radio value="radio1" />radio1</label> <label> <radio value="radio2" />radio2</label> </radio-group> <view style="margin-top:20px"> <checkbox-group name="checkbox"> <label> <checkbox value="checkbox1" />checkbox1</label> <label> <checkbox value="checkbox2" />checkbox2</label> </checkbox-group> </view> <view style="margin-top:20px"> <button formType="submit">Submit</button> <button formType="reset" style="margin-top:20px">Reset</button> </view> </form></view>
装载该布局文件后,将窗口的组件设置一定的值,如图3所示。
图3 form的显示效果
要注意的是,如果要用form提交,checkbox组件必须包含在checkbox-group组件中,而且checkbox-group必须指定name属性,否则无法通过submit事件的参数获得checkbox提交的值。
完整的JavaScript实现代码如下:
代码语言:javascript复制Page({ formSubmit: function(e) { console.log('form发生了submit事件,携带数据为:', e.detail.value) }, formReset: function(e) { console.log('form发生了reset事件,携带数据为:', e.detail) }})
现在点击Submit按钮,然后点击Reset按钮,会看到Console中输出如图4所示的日志信息。其中checkbox组件返回了一个数组,本例只选中一个checkbox组件,所以数组长度为1,数组元素值为checkbox1(value属性的值)。
图4 提交和重置后输出的日志信息