扩展组件(uni-ui)之uni-easyinput

2,641 阅读1分钟

uni-easyinput 是 uni-app 的 uni-ui 组件库中的一个组件,用于创建输入框。它基于标准的 <input><textarea> 标签进行了扩展,提供了更加丰富的功能和样式定制选项。

基本用法

在使用 uni-easyinput 之前,你需要确保已经正确安装了 uni-ui 库,并在页面中引入了 uni-easyinput 组件。

引入组件

<template>
    <uni-easyinput type="text" v-model="value" placeholder="请输入内容"></uni-easyinput>
</template>

<script>
    import uniEasyinput from '@dcloudio/uni-ui/lib/uni-easyinput/uni-easyinput.vue'
    export default {
        components: { uniEasyinput },
        data() {
            return {
                value: '' // 绑定输入框的值
            }
        }
    }
</script>

属性

uni-easyinput 组件提供了多种属性,包括但不限于:

  • type:输入框的类型,如 textnumberpassword 等。
  • v-model:使用 v-model 指令绑定输入框的值。
  • placeholder:输入框为空时显示的占位符。
  • clearable:是否显示清除按钮。
  • input-align:文本的对齐方式,如 leftcenterright
  • maxlength:允许输入的最大字符数。
  • disabled:是否禁用输入框。

事件

uni-easyinput 组件提供了多种事件,包括:

  • @input:输入内容时触发。
  • @focus:输入框获得焦点时触发。
  • @blur:输入框失去焦点时触发。
  • @confirm:点击完成按钮时触发(在键盘上点击“完成”或“回车”)。

示例

<uni-easyinput type="text" v-model="value" placeholder="请输入内容" clearable></uni-easyinput>

在这个示例中,创建了一个带有清除按钮的文本输入框。

注意事项

  • uni-easyinput 是一个增强版的输入框组件,支持 <input> 标签的大部分原生属性和事件。
  • 你可以通过设置不同的属性来定制输入框的外观和行为。

更多关于 uni-easyinput 组件的使用细节,可以查阅 uni-ui 官方文档 或 uni-ui 库的相关文档。