小程序表单 -2

form

表单。将组件内的用户输入的 switch、 input 、checkbox 、slider、 radio 、picker 提交。

当点击 form 表单中 form-type 为 submit 的 button 组件时，会将表单组件中的 value 值进行提交，需要在表单组件中加上 name 来作为 key。

属性说明

• report-submit   是否返回 formId 用于发送模板消息

• report-submit-timeout   等待一段时间（毫秒数）以确认 formId 是否生效。如果未指定这个参数，formId 有很小的概率是无效的（如遇到网络失败的情况）。指定这个参数将可以检测 formId 是否有效，以这个参数的时间作为这项检测的超时时间。如果失败，将返回 requestFormId:fail 开头的 formId

• bindsubmit    携带 form 中的数据触发 submit event.detail = {value : {'name': 'value'} , formId: ''}  

• bindreset   表单重置时会触发 reset 事件

input

输入框。该组件是原生组件，使用时请注意相关限制

属性说明

• value   输入框的初始内容

• type  input 的类型

• type 的值：

•     text  文本输入键盘  

•     number  数字输入键盘  

•     idcard  身份证输入键盘 

•     digit 带小数点的数字键盘 

• safe-password 密码安全输入键盘 指引 

• nickname  昵称输入键盘  

• password    是否是密码类型

keyboard-accessory

设置 input / textarea 聚焦时键盘上方 cover-view / cover-image 工具栏视图

label

用来改进表单组件的可用性。

使用 for 属性找到对应的 id，或者将控件放在该标签下，当点击时，就会触发对应的控件。 for 优先级高于内部控件，内部有多个控件的时候默认触发第一个控件。 目前可以绑定的控件有：button, checkbox, radio, switch, input。

属性说明

for 绑定控件的 id

picker

从底部弹起的滚动选择器

属性说明

• header-text   选择器的标题，仅安卓可用  

• mode    选择器类型 

• mode 可选值

•  selector  普通选择器

•  multiSelector 多列选择器

• time  时间选择器

• date  日期选择器

• region  省市区选择器

• disabled    是否禁用

• bindcancel    取消选择时触发

picker-view

嵌入页面的滚动选择器。其中只可放置 picker-view-column 组件，其它节点不会显示

属性说明·

• value   数组中的数字依次表示 picker-view 内的 picker-view-column 选择的第几项（下标从 0 开始），数字大于 picker-view-column 可选项长度时，选择最后一项。

• indicator-style   设置选择器中间选中框的样式 

• indicator-class   设置选择器中间选中框的类名 

• mask-style    设置蒙层的样式

• mask-class    设置蒙层的类名 

• immediate-change    是否在手指松开时立即触发 change 事件。若不开启则会在滚动动画结束后触发 change 事件。

• bindchange    滚动选择时触发 change 事件，event.detail = {value}；value 为数组，表示 picker-view 内的 picker-view-column 当前选择的是第几项（下标从 0 开始）

• bindpickstart   当滚动选择开始时候触发事件 

• bindpickend   当滚动选择结束时候触发事件 

picker-view-column

滚动选择器子项。仅可放置于 picker-view 中，其孩子节点的高度会自动设置成与 picker-view 的选中框的高度一致