Skip to content

QuiIcon 图标组件

基于 Iconify 的图标封装组件,支持动态加载海量图标。

基础用法

vue
<template>
  <QuiIcon icon="carbon:user" />
  <QuiIcon icon="mdi:home" size="24" color="red" />
</template>

API

Props

参数说明类型默认值
iconIconify 图标名称,格式为 collection:name,如 carbon:addstring-
size图标大小,支持数字或带单位的字符串string | number-
color图标颜色string-

IconPicker 图标选择器

基于 Iconify 的图标选择组件,支持搜索、集合筛选和无限滚动加载。

基础用法

vue
<template>
  <QuiIconPicker v-model="icon" />
</template>

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

const icon = ref('carbon:user')
</script>

Props

参数说明类型默认值
modelValue / v-model选中的图标名称,格式为 collection:namestring-
pageSize每次滚动加载的图标数量number200

Events

事件名说明回调参数
update:modelValue选中图标时触发(value: string) => void
select选中图标时触发(value: string) => void

默认配置

QuiIconPicker 默认值(来自内部逻辑):

参数默认值说明
pageSize200未传入时使用 200
selectedCollection'mdi'首选集合,若不存在则回退为第一个集合

图标查询

推荐使用 Icones 查找图标名称。

Released under the MIT License.