Input

输入框。扫码体验:

img.jpg

属性名类型默认值描述最低版本
valueString初始内容
nameString组件名字,用于表单提交获取数据
typeStringtextinput 的类型,有效值:textnumberidcarddigitnumberpaddigitpadidcardpadnumberpaddigitpadidcardpad1.13.0,类型客户端10.1.50开始支持,可通过my.canIUse('input.type.numberpad')来检测。
passwordBooleanfalse是否是密码类型
placeholderString占位符
placeholder-styleString指定 placeholder 的样式1.6.0
placeholder-classString指定 placeholder 的样式类1.6.0
disabledBooleanfalse是否禁用
maxlengthNumber140最大长度
focusBooleanfalse获取焦点
confirm-typeStringdone设置键盘右下角按钮的文字,有效值:done(显示“完成”)、go(显示“前往”)、next(显示“下一个”)、search(显示“搜索”)、send(显示“发送”),平台不同显示的文字略有差异.注意只有在 type=text 时有效1.7.0
confirm-holdBooleanfalse点击键盘右下角按钮时是否保持键盘不收起状态1.7.0
cursorNumber指定focus时的光标位置
selection-startNumber-1获取光标时,选中文本对应的焦点光标起始位置,需要和selection-end配合使用1.7.0
selection-endNumber-1获取光标时,选中文本对应的焦点光标结束位置,需要和selection-start配合使用1.7.0
randomNumberBooleanfalse当type为number、digit、idcard数字键盘是否随机排列1.9.0
controlledBooleanfalse是否为受控组件。为 true时,value内容会完全受setData控制1.8.0
onInputEventHandle键盘输入时触发input事件,event.detail = {value: value}
onConfirmEventHandle点击键盘完成时触发,event.detail = {value: value}
onFocusEventHandle聚焦时触发,event.detail = {value: value}
onBlurEventHandle失去焦点时触发,event.detail = {value: value}

Screenshot

image

示例代码

  1. <input placeholder="此处只有在点击下方按钮时才聚焦" focus="{{focus}}" />
  2. <input maxlength="10" placeholder="最大输入长度10" />
  3. <input onInput="bindKeyInput" placeholder="输入同步到view中"/>
  4. <input type="number" placeholder="这是一个数字输入框" />
  5. <input password type="text" placeholder="这是一个密码输入框" />
  6. <input type="digit" placeholder="带小数点的数字键盘"/>
  7. <input type="idcard" placeholder="身份证输入键盘" />
  1. Page({
  2. data: {
  3. focus: false,
  4. inputValue: '',
  5. },
  6. bindButtonTap() {
  7. this.setData({
  8. focus: true,
  9. });
  10. },
  11. bindKeyInput(e) {
  12. this.setData({
  13. inputValue: e.detail.value,
  14. });
  15. },
  16. });

原文: https://docs.alipay.com/mini/component/input