Input 输入框

最近更新时间:2025-12-30 17:25:52

我的收藏

组件功能

单行文本输入组件,支持多种输入类型、验证规则和样式配置。

基础用法

通过 name 与表单字段关联,placeholder 设置占位提示文本。
Template 示例:
<Input name="username" placeholder="请输入用户名" />
效果展示如下:




属性说明

属性名
类型
描述
默认值
name
string
表单字段名称
-
inputType
"number" | "email" | "text" | "password" | "tel" | "url"
输入类型
"text"
defaultValue
string
默认值
-
required
boolean
是否必填
false
pattern
string
验证正则表达式
-
placeholder
string
占位符文本
-
allowAutofillExtensions
boolean
允许自动填充扩展
false
autoSelect
boolean
自动选中文本
false
autoFocus
boolean
自动聚焦
false
disabled
boolean
是否禁用
false
variant
"soft" | "outline"
输入框样式变体
"outline"
size
"3xs" | "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl"
输入框尺寸
"md"
gutterSize
"2xs" | "xs" | "sm" | "md" | "lg" | "xl"
内边距尺寸
-
pill
boolean
是否为胶囊形状
false
注意:
★ 标记为必填属性。