Skip to content

CondorSelect

CondorSelect 是一个远程搜索下拉选择器组件,支持分页加载、多选、本地缓存已选项。适用于选项数据量大的场景。

组件 Props

参数名类型默认值说明
valueany-绑定的值(v-model)
urlstring-必需 远程数据接口 URL
multiplebooleanfalse是否多选
checkablebooleantrue是否显示清空按钮
labelFieldstring'name'显示名称字段
keyFieldstring'id'选项值字段
isPaginationbooleantrue是否启用分页
maxTagCountnumber10多选时最多显示的 tag 数量
i18nkeybooleanfalselabel 是否为国际化对象
paramany{}附加的请求参数

组件事件

事件名说明参数
update:value选中值变化时触发选中的值

基本用法

1. 单选分页选择器

vue
<template>
  <CondorSelect
    v-model:value="userId"
    url="/core/user/index"
    label-field="username"
    key-field="id"
  />
</template>

<script setup lang="ts">
import { ref } from 'vue';

const userId = ref(null);
</script>

2. 多选模式

vue
<template>
  <CondorSelect
    v-model:value="userIds"
    url="/core/user/index"
    :multiple="true"
    :max-tag-count="5"
  />
</template>

<script setup lang="ts">
import { ref } from 'vue';

const userIds = ref([]);
</script>

3. 带附加参数

vue
<template>
  <CondorSelect
    v-model:value="roleId"
    url="/core/role/index"
    :param="{ status: 1 }"
  />
</template>