小程序教学五(表单组件)

本文介绍button、checkbox、form、input、textarea、radio、label

为什么一下介绍这么多呢,是因为他们的大部分和HTML里面的表单是一样
在.wxml里面写HTML标签
在.wxss里面写CSS样式
EventHandle 是触发事件类,需要写在.js里面

小程序所列出的属性,要写在.wxml标签里面,不能写在.wxss里面

button

和HTML中的button标签是一样的,都是一个可点击的按钮

使用 <button> 我是按钮 </button>

常用属性
属性名 类型 说明
type String 按钮的样式类型
plain Boolean 按钮是否镂空,背景色透明
disabled Boolean 是否禁用
form-type String 用于 <form/> 组件,点击分别会触发 <form/> 组件的 submit/reset 事件
type效果
type有效值:

primary
default
warn

form-type有效值:

submit 提交表单
reset 重置表单

input

和HTML中的input一样,只能单行输入数据

常用属性
属性名 类型 说明
value String 输入框的初始内容
type String input 的类型
password Boolean 是否是密码类型
placeholder String 输入框为空时占位符
placeholder-style String 指定 placeholder 的样式
placeholder-class String 指定 placeholder 的样式类
disabled Boolean 是否禁用
maxlength Number 最大输入长度,设置为 -1 的时候不限制最大长度
cursor-spacing Number 指定光标与键盘的距离,单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离
focus Boolean 获取焦点
confirm-type String 设置键盘右下角按钮的文字
confirm-hold Boolean 点击键盘右下角按钮时是否保持键盘不收起
bindinput EventHandle 当键盘输入时,触发input事件,event.detail = {value, cursor},处理函数可以直接 return 一个字符串,将替换输入框的内容。
bindfocus EventHandle 输入框聚焦时触发,event.detail = { value, height },height 为键盘高度
bindblur EventHandle 输入框失去焦点时触发,event.detail = {value: value}
bindconfirm EventHandle 点击完成按钮时触发,event.detail = {value: value}
type有效值:

text 文本输入键盘
number 数字输入键盘
idcard 身份证输入键盘
digit 带小数点的数字键盘

confirm-type有效值:

send 右下角按钮为“发送”
search 右下角按钮为“搜索”
next 右下角按钮为“下一个”
go 右下角按钮为“前往”
done 右下角按钮为“完成”

textarea

和HTML中的textarea一样,可以多行输入内容

使用
<textarea />

textarea中的属性与input的属性一样
多了一个auto-height属性,Boolean值,
效果:是否自动增高,设置auto-height时,style.height不生效

form

和HTML中的form一样,将组件内的用户输入的<switch/> <input/> <checkbox/> <slider/> <radio/> <picker/> 提交

常用属性
属性名 类型 说明
report-submit Boolean 是否返回 formId 用于发送模板消息
bindsubmit EventHandle 携带 form 中的数据触发 submit 事件,event.detail = {value : {'name': 'value'} , formId: ''}
bindreset EventHandle 表单重置时会触发 reset 事件

checkbox

和HTML中的checkbox标签是一样的,都是多选框,每个checkbox-group都可以放多个checkbox

使用
<checkbox-group>
<checkbox value="CHN" checked = "true" />中国
<checkbox value="USA" />美国
<checkbox value="ENG" />英国
</checkbox-group>

checkbox
常用属性
属性名 类型 说明
bindchange EventHandle <checkbox-group/>中选中项发生改变是触发 change 事件,detail = {value:[选中的checkbox的value的数组]}
value String <checkbox/>标识,选中时触发<checkbox-group/>的 change 事件,并携带 <checkbox/> 的 value
disabled Boolean 是否禁用
checked Boolean 当前是否选中,可用来设置默认选中

radio

与HTML中的radio一样,单选框,同一个radio-group中只能有一个radio被选中

使用
<radio-group>
<radio value="CHN">中国</radio>
<radio value="USA">美国</radio>
<radio value="ENG">英国</radio>
</radio-group>

radio
常用属性
属性名 类型 说明
value String <radio/> 标识。当该<radio/> 选中时,<radio-group/> 的 change 事件会携带<radio/>的value
checked Boolean 当前是否选中
disabled Boolean 是否禁用
color Color radio的颜色,同css的color

label

一般与选择框一起使用达到文字点击时也触发checked

常用属性
属性名 类型 说明
for String 绑定控件id

持续更新中...

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,907评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,987评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,298评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,586评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,633评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,488评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,275评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,176评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,619评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,819评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,932评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,655评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,265评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,871评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,994评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,095评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,884评论 2 354