该组件一般用于验证用户短信验证码的场景,也可以结合mView的键盘组件使用
平台差异说明
App(vue) | App(nvue) | H5 | 小程序 |
---|
√ | × | √ | √ |
基本使用
- 通过
mode
参数模式,可取如下值: box
(默认)-输入位置位一个方框line
-底部显示一条横线
<m-code-input v-model="value" />
横线模式
<m-code-input mode="line" v-model="value" />
设置长度
<m-code-input maxlength="4" v-model="value" />
用"●"替代输入内容
<m-code-input dot v-model="value" />
API
Props
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|
adjustPosition | 键盘弹起时,是否自动上推页面 | Boolean | true | false |
maxlength | 输入字符个数 | Number | String | 6 | - |
dot | 是否用圆点填充 | Boolean | false | true |
mode | 模式选择,见上方"基本使用"说明 | String | box | line |
hairline | 是否细边框 | Boolean | true | false |
space | 字符间的距离 | Number | String | 10 | - |
focus | 是否自动获取焦点 | Boolean | false | true |
bold | 字体和输入横线是否加粗 | Boolean | false | true |
color | 字体颜色 | String | color['m-content-color'] | - |
fontSize | 字体大小,单位px ,注意:dot模式无效。 | Number | String | 18 | - |
size | 输入框的大小,宽等于高 | Number | String | 35 | - |
disabledKeyboard | 禁止点击输入框唤起系统键盘 | Boolean | false | true |
borderColor | 边框和线条颜色 | String | #c9cacc | - |
disabledDot | 是否禁止输入"."符号 | Boolean | true | false |
Event
事件名 | 说明 | 回调参数 |
---|
change | 输入内容发生改变时触发 | value:当前输入的值 |
finish | 输入字符个数达maxlength 值时触发 | value:当前输入的值 |