Skip to content

Icon 图标 ​

Icon 用字体图标展示常用操作和状态。以下图标来自当前项目的 components/fui-icon 目录,点击图标名称可以复制。

支持平台 ​

以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。

App-vueApp-nvue微信小程序支付宝小程序百度小程序字节小程序QQ小程序H5PC快手小程序钉钉小程序
✓✓✓✓✓✓✓✓✓✓✓

图标列表 ​

基础用法 ​

通过 name 指定图标名称;可使用 size、unit 和 color 调整图标外观。

vue
<!-- 首页图标 -->
<fui-icon name="home"></fui-icon>

<!-- 自定义尺寸和颜色 -->
<fui-icon name="search" :size="48" unit="rpx" color="#465CFF"></fui-icon>

若项目未使用 easycom 自动注册,可以在页面中引入组件;路径以项目实际目录为准。

js
import FuiIcon from '@/components/fui-icon/fui-icon.vue';

export default {
  components: {
    // 图标组件
    FuiIcon
  }
};

属性 ​

属性类型说明官网默认值
nameString图标名称空字符串
sizeNumber、String图标尺寸;未传入时读取全局配置,回退为 6464
unitString尺寸单位;未传入时读取全局配置,回退为 rpxrpx
colorString图标颜色;未传入时使用全局配置或样式默认色#333333
fontWeightNumber、String字体粗细normal
disabledBoolean是否禁用点击事件false
paramsNumber、String点击事件中返回的自定义值0
customPrefixString自定义字体图标类名空字符串
primaryBoolean本地源码中的内部属性,控制主色显示;官网参数表未列出false

事件 ​

事件说明回调参数
click点击图标时触发;disabled 为 true 时不触发{ params }
vue
<template>
  <!-- 携带自定义参数的图标 -->
  <fui-icon name="home" :params="1" @click="handleIconClick"></fui-icon>
</template>

<script>
export default {
  methods: {
    /** 处理图标点击 */
    handleIconClick({ params }) {
      uni.showToast({ title: `参数:${params}`, icon: 'none' });
    }
  }
};
</script>

平台说明 ​

在字节跳动小程序中,组件源码提示需要在使用页面引入字体。nvue 的字体注册和自定义图标处理方式与普通 Vue 页面不同,使用时请结合 fui-icon.vue 的条件编译代码核对。

插槽 ​

插槽说明
—官网未列出该组件的插槽