Skip to content
On this page

input

输入框。

原生组件,使用时请注意相关限制。

Props

参数类型默认值必填说明
valuestring输入框的初始内容(支持 v-model:value)
typestringtext键盘类型
合法值说明
text文本输入键盘
number数字输入键盘
digit带小数点的数字键盘
passwordbooleanfalse是否是密码输入
placeholderstring输入框为空时占位符
placeholder-classstring指定 placeholder 的样式类
placeholder-stylestring指定 placeholder 的样式
disabledbooleanfalse是否禁用输入框
maxlengthnumber140最大输入长度,设置为 <= 0 的时候不限制最大长度
cursor-spacingnumber0指定光标与键盘的距离,取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离
focusbooleanfalse获取焦点
confirm-type'send' | 'search' | 'next' | 'go' | 'done'done设置键盘右下角按钮的文字,仅在type='text'时生效
合法值说明
send发送
search搜索
next下一个
go前往
done完成
confirm-holdbooleanfalse点击键盘右下角按钮时是否保持键盘不收起
cursornumberfalse指定 focus 时的光标位置
selection-startnumber-1光标起始位置,自动聚集时有效,需与 selection-end 搭配使用
selection-endnumber-1光标结束位置,自动聚集时有效,需与 selection-start 搭配使用
adjust-positionbooleantrue键盘弹起时,如果输入框被键盘遮盖,是否自动上推页面
hold-keyboardbooleantruefocus时,点击页面的时候不收起键盘

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>