Skip to content

Icon 图标

介绍

基于 IconFont 字体的图标集,可以通过 Icon 组件使用。

基础用法

Iconname 属性支持传入图标名称或图片链接。

html
<template>
  <nut-icon name="dongdong"></nut-icon>
  <nut-icon name="JD"></nut-icon>
  <nut-icon size="40"  name="https://img11.360buyimg.com/imagetools/jfs/t1/137646/13/7132/1648/5f4c748bE43da8ddd/a3f06d51dcae7b60.png"></nut-icon>
</template>

图标颜色

Iconcolor 属性用来设置图标的颜色。

html
<template>
  <nut-icon name="dongdong" custom-color="#fa2c19"></nut-icon>
  <nut-icon name="dongdong" custom-color="#64b578"></nut-icon>
  <nut-icon name="JD" custom-color="#fa2c19"></nut-icon>
</template>

图标大小

Iconsize 属性用来设置图标的尺寸大小,默认单位为 px

html
<template>
  <nut-icon name="dongdong"></nut-icon>
  <nut-icon name="dongdong" size="24"></nut-icon>
  <nut-icon name="dongdong" size="16"></nut-icon>
</template>

通用动态图标

添加指定的 class 类就可以实现图片动态效果,默认是播放1次,添加 nut-icon-am-infinite 类即可实现循环播放。通过设置 css 可实现动画启动前的延迟间隔、动画在多久时间内完成

html
<template>
  <nut-icon name="dou-arrow-up" class="nut-icon-am-jump nut-icon-am-infinite"></nut-icon>
  <nut-icon name="star-fill-n" class="nut-icon-am-blink nut-icon-am-infinite"></nut-icon>
  <nut-icon name="refresh2" class="nut-icon-am-rotate nut-icon-am-infinite"></nut-icon>
  <nut-icon name="heart-fill" class="nut-icon-am-breathe nut-icon-am-infinite"></nut-icon>
  <nut-icon name="microphone" class="nut-icon-am-flash nut-icon-am-infinite"></nut-icon>
  <nut-icon name="download" class="nut-icon-am-bounce nut-icon-am-infinite"></nut-icon>
  <nut-icon name="message" class="nut-icon-am-shake nut-icon-am-infinite"></nut-icon>
</template>

<style>
  .nut-icon{
    --animate-duration: 1s ;
    --animate-delay: 0s;
  }
</style>

自定义图标

如果需要在现有 Icon 的基础上使用更多图标,可以引入第三方 iconfont 对应的字体文件和 CSS 文件,之后就可以在 Icon 组件中直接使用。

方案一 引入 iconfont 推荐此方案

第一步:首先在 iconfont 生成你自定义的Icon文件下载存放至本地项目 详细使用说明

bash
/assets/font/demo.css
/assets/font/demo_index.html
/assets/font/iconfont.css
/assets/font/iconfont.js
/assets/font/iconfont.json
/assets/font/iconfont.ttf
/assets/font/iconfont.woff
/assets/font/iconfont.woff2

第二步:项目入口文件 main.js 引用 iconfont.css

javascript
import './assets/font/iconfont.css'

第三步:

html
<!--
  font-class-name 指定类名为默认 iconfont
  class-prefix 指定默认 icon
  name 值根据 iconfont.css 中值对应填写
-->
<nut-icon font-class-name="iconfont" class-prefix="icon" name="close" />

方案二 第三方自定义字体库

css
/* 引入第三方或自定义的字体图标样式 */
@font-face {
  font-family: 'my-icon';
  src: url('./my-icon.ttf') format('truetype');
}

.my-icon {
  font-family: 'my-icon';
}

.my-icon-extra::before {
  content: '\e626';
}
html
<!--
  font-class-name 指定类名为默认 my-icon
  class-prefix 指定默认 my-icon
-->
<nut-icon font-class-name="my-icon" class-prefix="my-icon" name="extra" />

自定义 iconfont Demo示例

API

Props

参数说明类型默认值
name图标名称或图片链接String-
custom-color图标颜色String-
size图标大小,如 20px 2em 2remString or Number-
font-class-name自定义 icon 字体基础类名Stringnutui-iconfont
class-prefix自定义 icon 类名前缀,用于使用自定义图标Stringnut-icon

Events

事件名说明回调参数
click点击图标时触发event: Event

MIT Licensed