微信小程序开发实战（12）：滑杆组件（slider）和form组件

-----------支持作者请转发本文-----------

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组件可以在右侧显示当前的值。

  
    设置step
    
  
  
    显示当前value
    
  
  
    设置最小/最大值
    
  

布局的效果如图1所示。

图1  slider组件

完整的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组件的使用方法。

  

    
    
    
    
      
        radio1
      
        radio2
    
    
      
        
          checkbox1
        
          checkbox2
      
    
    
      Submit
      Reset
    
  

装载该布局文件后，将窗口的组件设置一定的值，如图3所示。

图3  form的显示效果

要注意的是，如果要用form提交，checkbox组件必须包含在checkbox-group组件中，而且checkbox-group必须指定name属性，否则无法通过submit事件的参数获得checkbox提交的值。

完整的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  提交和重置后输出的日志信息

对本文感兴趣，可以加李宁老师微信公众号（unitymarvel）：

关注  极客起源  公众号，获得更多免费技术视频和文章。