Skip to content

Input 输入框

基本使用

template
<c-input v-model:value="value" clearable />
<c-input input-align="center" />
<c-input input-align="right" />

搜索输入框

template
<c-input right-icon="search-line" border @click:right-icon="onSearch" @confirm="onSearch" />

<c-input icon="search-line" border>
  <template #suffix>
    <c-button color="primary" text="搜索" size="xs" />
  </template>
</c-input>

<c-input icon="user-5-line" right-icon="search-line" border>
  <template #prefix>
    <c-text color="secondary" :c-style="[{ marginLeft: '10rpx' }]">用户</c-text>
  </template>
</c-input>

<c-row align="stretch">
  <c-input icon="search-line" border />
  <c-button color="primary" text="搜索" :c-style="{ marginLeft: '10rpx' }" />
</c-row>

网址输入框

template
<c-input placeholder="www.baidu" border>
  <template #prefix>
    <c-text color="secondary">https://</c-text>
  </template>
  <template #suffix>
    <c-text color="secondary">.com</c-text>
  </template>
</c-input>

API

Input Props

名称类型默认值版本说明
cstringdefault配置名。使用说明
propsInputPropsundefined全部 props 。 使用说明
c-classHTMLAttributes['class']undefined自定义类名
c-styleHTMLAttributes['style']undefined自定义样式
input-classHTMLAttributes['class']undefinedinput 的自定义类名
input-styleHTMLAttributes['style']undefinedinput 的自定义样式
valuestringundefined输入框的内容
type'text' | 'number' | 'idcard' | 'digit' | 'tel' | 'safe-password' | 'nickname'textinput 的类型。H5 暂未支持动态切换,详见下方 Tips,请使用 v-if 进行整体切换
sizestring | numberm字体大小。 使用说明
placeholderstringundefined输入框为空时占位符
input-alignCSSProperties['textAlign']undefined输入框内容对齐方式。MDN Web Docs
bg-colorstringundefined背景颜色。使用说明
iconstringundefined左边的图标
icon-propsIconPropsundefinedIconProps
right-iconstringundefined右边的图标
right-icon-propsIconPropsundefinedIconProps
passwordbooleanundefined是否是密码类型
disabledbooleanundefined是否禁用
readonlybooleanundefined是否只读
clearablebooleanundefined是否显示清除控件
clear-icon-propsIconPropsundefinedIconProps
maxlengthnumber140最大输入长度,设置为 -1 的时候不限制最大长度
show-countbooleanundefined是否显示输入字数统计
count-propsTextPropsundefinedTextProps
borderbooleanundefined是否显示边框
border-bottombooleanundefined是否显示下边框
radiusstring | numberundefined圆角值。 使用说明
roundbooleanundefined是否显示为圆角
pathstringundefinedCForm value 对象的属性名,用于校验
no-feedbackbooleanundefined是否不展示校验反馈
focusbooleanundefined获取焦点。在 H5 平台能否聚焦以及软键盘是否跟随弹出,取决于当前浏览器本身的实现。nvue 页面不支持,需使用组件的 focus()、blur() 方法控制焦点

Input Slots

名称参数说明
prefix()左边的内容
count()自定义统计内容
suffix({ errMsg: string | undefined })右边的内容

Input Methods

名称类型说明
focus() => void获取焦点

Input Events

名称参数说明
update:value(value: string) => voidvalue change 时触发
input(event: any) => void说明
focus(event: any) => void说明
blur(event: any) => void说明
confirm(event: any) => void说明
keyboardheightchange(event: any) => void说明
clear() => void清空时触发
click:input(event: any) => void点击 input 时触发
click:icon(event: any) => void点击左边 icon 时触发
click:rightIcon(event: any) => void点击右边 icon 时触发