微信小程序开发实战(12):滑杆组件(slider)和form组件

2020-07-23 19:30:00 浏览数 (1)

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

0 人点赞