1.0.2 • Published 1 month ago

@tanzhenxing/zx-combox v1.0.2

Weekly downloads
-
License
MIT
Repository
-
Last release
1 month ago

zx-combox 组合框组件

组合框组件,用于既可以选择也可以输入的场景,类似于下拉选择框与输入框的结合。

介绍

zx-combox 是一个组合框组件,在用户需要从预设选项中进行选择,但也需要支持自由输入的场景下使用。组件支持搜索过滤、键盘输入、鼠标选择等多种操作方式。

安装方式

将组件引入项目中即可使用。

基本用法

<template>
  <view>
    <zx-combox
      label="所在城市"
      :candidates="candidates"
      placeholder="请选择所在城市"
      v-model="city"
    ></zx-combox>
  </view>
</template>

<script setup>
import { ref } from 'vue';

const city = ref('');
const candidates = ref(['北京', '上海', '广州', '深圳', '杭州', '南京', '武汉', '成都', '西安']);
</script>

无边框用法

<zx-combox
  :border="false"
  label="所在城市"
  :candidates="candidates"
  placeholder="请选择所在城市"
  v-model="city"
></zx-combox>

API

Props

属性名类型默认值说明
labelString''标签文字
labelWidthString'auto'标签宽度,如:'100px'
placeholderString''输入框占位符
candidatesArray[]候选项列表
emptyTipsString'无匹配项'无匹配项时的提示语
modelValueString/Number''组合框的值(支持v-model)
borderBooleantrue是否显示边框

事件

事件名说明返回值
update:modelValue组合框输入或选择事件,支持v-model当前输入值
input组合框输入事件(兼容Vue2)当前输入值

注意事项

  1. 搜索过滤不区分大小写
  2. 点击组件以外区域会自动关闭下拉选项
  3. 该组件不支持nvue页面
1.0.2

1 month ago

1.0.1

2 months ago

1.0.0

11 months ago