当前位置: 首页 > 文档资料 > Feui 中文文档 >

input 输入框

优质
小牛编辑
130浏览
2023-12-01
import { Input } from 'feui';
components: {
  [Input.name]: Input
}

代码演示

基础用法

<fe-group>
  <fe-input title='value' v-model="value" placeholder="我是占位符"></fe-input>
</fe-group>

不可用状态

<fe-group title="不可用状态">
  <fe-input title='value' disabled v-model="disabledValue"></fe-input>
</fe-group>

设置最大值最小值

<fe-group title="set min=2 and max=5">
  <fe-input title="2-5个字符" placeholder="" :min="2" :max="5"></fe-input>
</fe-group>

设置is-type属性

<fe-group title="请输入姓名">
  <fe-input title="姓名" name="username" placeholder="请输入姓名" 
    is-type="china-name">
  </fe-input>
</fe-group>
<fe-group title="设置 keyboard=number,is-type=china-mobile">
  <fe-input title="手机号码" name="mobile" placeholder="请输入手机号码" 
    keyboard="number" is-type="china-mobile">
  </fe-input>
</fe-group>
<fe-group title="set is-type=email">
  <fe-input title="邮箱" name="email" placeholder="请输入邮箱地址" 
    is-type="email">
  </fe-input>
</fe-group>
<fe-group title="is-type传入function">
  <fe-input title="输入验证" :is-type="be2333" placeholder="必须输入2333"></fe-input>
</fe-group>

不显示清除按钮

<fe-group title="不显示清除按钮">
  <fe-input title="message" required placeholder="我是可爱的占位符" 
    :show-clear="false" autocapitalize="characters">
  </fe-input>
</fe-group>

使用icon代替title

<fe-group title="使用icon代替title">
  <fe-input title="必须输入2333" :is-type="be2333" placeholder="必须输入2333">
    <img slot="label" style="padding-right:10px;display:block;" 
    src="http://temp.im/42x42/34AADC/fff" width="24" height="24">
  </fe-input>
</fe-group>

输入格式化

<fe-group title="mask">
  <fe-input title="手机号码格式化" mask="999 9999 9999" 
    v-model="maskValue" :max="13" is-type="china-mobile">
  </fe-input>
  <fe-cell title="value" :value="maskValue"></fe-cell>
  <fe-input title="(99) 9-999" mask="(99) 9-999"  v-model="maskValue2" 
    :max="10" placeholder="76幢1单元305">
  </fe-input>
</fe-group>

API

参数说明类型默认值可选值
titlelabel文字String--
placeholder站位提示String--
value表单值,使用v-model绑定String--
disabled是否禁用填写Booleanfalsefalse,true
typeinput的type属性,目前支持 text,number,email,password,telStringtext-
is-type内置验证器,支持email,china-name,china-mobile,
同样也支持直接传函数, 需要同步返回一个对象{valid:true}
或者{valid:false, msg:错误信息}
String,Function--
required是否必值,如果不禁用验证,当没有填写时会在右侧显示错误iconBooleanfalsefalse,true
show-clear是否显示清除iconBooleanfalsefalse,true
min最小输入字符限制Number--
max最大输入字符限制,等同于maxlengthNumber--
debouncedebounce用以限制on-change事件触发。如果你需要根据用户输
入做ajax请求,建议开启以节省无效请求和服务器资源,单位为毫秒
Number--
placeholder-alignplaceholder对其方式Stringleftleft,right,center
text-align值对齐方式Stringleftleft,right,center
label-widthlabel 宽度,权重比 group 的 labelWidth 高String--
mask值格式化,依赖于 vanilla-masker,其中 9 表示数字,A 表示大写字母,S 表示数字或者字母String--
should-toast-error是否在点击错误图标时用 toast 的形式显示错误Booleantruefalse,true
-----

Slots

Slot名说明备注
label用于自定义label(即 title)部分内容,比如使用icon-
restricted-label用于自定义label部分,和slot=label不同的是,该slot宽度受到父组件group的限制-
right用以在输入框右边显示内容,比如验证码图片,单位,切换密码显示方式等-
---

Events

事件名参数说明备注
on-focusvalue, $eventinput的focus事件-
on-blurvalue, $eventinput的blur事件-
on-entervalue, $eventinput输入完成后点击enter(确认)事件-
on-changevalue输入值变化时触发。如果你使用了debounce,那么触发将不会是实时的。-
on-click-error-iconerror点击错误图标时触发-
----

Methods

方法名参数说明备注
focus-手动设置input获得焦点-
blur-手动设置input失去焦点-
resetvalue = ''重置输入框值,清除错误信息-
----