Skip to content

Input 输入框

input 输入框,用于接收用户的文本输入。

基本用法

在基本用法中,你可以使用 ZInput 组件来创建一个简单的输入框。

html
<z-input v-model="value" placeholder="请输入内容"></z-input>

<script setup>
  import { ref } from 'vue';
  const value = ref('');
</script>

禁用状态

你可以通过设置 disabled 属性来禁用输入框。

html
<z-input v-model="value" placeholder="请输入内容" disabled></z-input>

只读状态

你可以通过设置 readonly 属性来使输入框变为只读状态。

html
<z-input v-model="value" placeholder="请输入内容" readonly></z-input>

尺寸

你可以通过设置 size 属性来控制输入框的尺寸。

html
<z-input v-model="value" placeholder="请输入内容" size="large"></z-input>
<z-input v-model="value" placeholder="请输入内容" size="small"></z-input>
<z-input v-model="value" placeholder="请输入内容" size="mini"></z-input>

前缀和后缀

你可以通过设置 prefixsuffix 属性来在输入框前后添加图标或文本。

🔍
@
html
<z-input v-model="value" placeholder="请输入内容" prefix="🔍"></z-input>
<z-input v-model="value" placeholder="请输入内容" suffix="@"></z-input>

可以设置 prefixsuffix 插槽来自定义前缀和后缀内容。

html
<z-input v-model="value" placeholder="请输入内容">
  <template #prefix>
    <z-icon name="search"></z-icon>
  </template>
  <template #suffix>
    <z-icon name="search"></z-icon>
  </template>
</z-input>

可清除

你可以通过设置 clearable 属性来在输入框中添加一个清除按钮。

html
<z-input v-model="value" placeholder="请输入内容" clearable></z-input>

密码

你可以通过设置 type 属性为 "password" 来创建一个密码输入框。设置 show-eye 属性可以显示/隐藏密码。

html
<z-input
  v-model="value"
  placeholder="请输入内容"
  type="password"
  show-eye></z-input>

前置/后置标签

你可以通过设置 prependappend 属性来在输入框前后添加文本标签。

http://
.com
html
<z-input v-model="value" placeholder="请输入内容" prepend="http://"></z-input>
<z-input v-model="value" placeholder="请输入内容" append=".com"></z-input>

可以设置 prependappend 插槽来自定义前置和后置内容。

https://
.com
html
<z-input v-model="value" placeholder="请输入内容">
  <template #prepend> https:// </template>
  <template #append> .com </template>
</z-input>

文本域

你可以通过设置 type 属性为 "textarea" 来创建一个文本域。

html
<z-input v-model="value" placeholder="请输入内容" type="textarea"></z-input>

设置 rows 属性可以控制文本域的行数。

html
<z-input
  v-model="value"
  placeholder="请输入内容"
  type="textarea"
  rows="3"></z-input>

显示字数统计

你可以通过设置 show-countmaxlength 属性来显示字数统计。

0 /50
html
<z-input
  v-model="value"
  placeholder="请输入内容"
  type="textarea"
  show-count
  maxlength="50"></z-input>
0 /50
html
<z-input
  v-model="value"
  placeholder="请输入内容"
  type="text"
  show-count
  maxlength="50"></z-input>

事件

可以通过 change 事件监听输入框内容变化。

html
<z-input
  v-model="value"
  placeholder="请输入内容"
  @change="handleChange"></z-input>
js
const handleChange = (val) => {
  console.log(val);
};

支持 focus 和 blur 事件。通过 ref 调用 focus 和 blur 方法。

Released under the MIT License.