Skip to content

FaInput 输入框

基础输入框组件,支持密码显示切换、清空按钮和前后缀插槽。

使用场景

  • 表单输入字段
  • 搜索框
  • 密码输入
  • 带单位的数值输入
  • 带前缀的账号输入(如 +86)

Props

属性类型默认值说明
type'text' | 'password''text'输入类型
align'inline' | 'block''inline'前后缀对齐方式
disabledbooleanfalse是否禁用
clearablebooleanfalse是否显示清空按钮
classHTMLAttributes['class']-组件外层 CSS 类
inputClassHTMLAttributes['class']-输入框 CSS 类
startClassHTMLAttributes['class']-前缀区域 CSS 类
endClassHTMLAttributes['class']-后缀区域 CSS 类

Slots

名称说明
start输入框前缀内容(图标、文字等)
end输入框后缀内容(图标、按钮等)

Events

事件名说明
clear点击清空按钮时触发

Exposed Methods

方法名说明
ref获取原生 input 元素引用

注意事项

  1. v-model 绑定:使用 v-model 实现双向数据绑定
  2. 密码切换type="password" 时自动显示眼睛图标切换明文/密文
  3. 清空按钮clearable 模式下,仅当输入框有值且获得焦点或悬停时显示清空按钮
  4. 原生属性:支持所有原生 input 属性(placeholder、autocomplete 等)
  5. 对齐方式align="inline" 时前后缀与输入内容同行,align="block" 时上下排列