input
输入框。
原生组件,使用时请注意相关限制。
Props
参数 | 类型 | 默认值 | 必填 | 说明 | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
value | string | 是 | 输入框的初始内容(支持 v-model:value) | ||||||||||||||
type | string | text | 否 | 键盘类型 | |||||||||||||
| |||||||||||||||||
password | boolean | false | 否 | 是否是密码输入 | |||||||||||||
placeholder | string | 否 | 输入框为空时占位符 | ||||||||||||||
placeholder-class | string | 否 | 指定 placeholder 的样式类 | ||||||||||||||
placeholder-style | string | 否 | 指定 placeholder 的样式 | ||||||||||||||
disabled | boolean | false | 否 | 是否禁用输入框 | |||||||||||||
maxlength | number | 140 | 否 | 最大输入长度,设置为 <= 0 的时候不限制最大长度 | |||||||||||||
cursor-spacing | number | 0 | 否 | 指定光标与键盘的距离,取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离 | |||||||||||||
focus | boolean | false | 否 | 获取焦点 | |||||||||||||
confirm-type | 'send' | 'search' | 'next' | 'go' | 'done' | done | 否 | 设置键盘右下角按钮的文字,仅在type='text'时生效 | |||||||||||||
| |||||||||||||||||
confirm-hold | boolean | false | 否 | 点击键盘右下角按钮时是否保持键盘不收起 | |||||||||||||
cursor | number | false | 否 | 指定 focus 时的光标位置 | |||||||||||||
selection-start | number | -1 | 否 | 光标起始位置,自动聚集时有效,需与 selection-end 搭配使用 | |||||||||||||
selection-end | number | -1 | 否 | 光标结束位置,自动聚集时有效,需与 selection-start 搭配使用 | |||||||||||||
adjust-position | boolean | true | 否 | 键盘弹起时,如果输入框被键盘遮盖,是否自动上推页面 | |||||||||||||
hold-keyboard | boolean | true | 否 | focus时,点击页面的时候不收起键盘 |
Events
事件名 | 说明 | 回调参数 |
---|---|---|
input | 输入的值发生变化时触发 | { value: string } |
focus | 输入框成为焦点时触发 | { value: string } |
blur | 输入框失去焦点时触发 | { value: string } |
confirm | 点击完成按钮时触发 | { value: string } |
keyboard-height-change | 键盘高度发生变化的时候触发 | { height: number, duration: number } |
Example
vue
<template>
<input v-model:value="text" placeholder="请输入账号" focus />
</template>
<script setup lang="ts">
import { ref } from 'vue'
const text = ref('Evoker')
</script>