ksw-vue-icon

介绍

图标自动化是一个可以帮助你将 SVG 转换为 VUE 组件代码，并上传至 NPM 以便开发直接使用命令行安装和更新。设计师可以通过此插件快速交付图标文件，它能省去很多不必要的中间环节，从而达到让设计师轻轻一点就更新，开发一条命令就下载的效果，整个过程中两人都不用离开座位多说一句话。

NPM包

请访问 https://www.npmjs.com/package/ksw-vue-icon

ICON 展示页面

请访问 KSW-vue-icon

• 复制Vue图标组件
• 查看ICON

入门

安装 NPM 包

npm install ksw-vue-icon --save-dev
yarn add ksw-vue-icon -D

引入样式

导入图标样式（整个项目只需1次）:

import "ksw-vue-icon/styles/icon.css";

按需引用图标

从组件顶部的 ksw-vue-icon 导入一个图标，然后在模板标签中使用它：

// 引用
import { IconName } from 'ksw-vue-icon'

// 使用
<IconName :size="24" color="#333" />

全局注册图标

我们建议按需加载图标，因为这样可以大大减少编译代码量。但是在一些类似远程加载菜单的场景下，直接引用所有图标可以减少开发成本。

import { KswIcon } from "ksw-vue-icon";
Vue.use(KswIcon);

基本用法

从组件顶部的 ksw-vue-icon 导入一个图标，然后在模板标签中使用它，也可以通过设置 spin 属性来实现动画旋转效果。

<IconSearch />
<IconSettingFill color="#3491FA" />
<IconArrowTop />
<IconRefresh :spin="true" />
<IconArrowTop :rotate="180" />
<IconLoading />

项目用法

你可以在 Vue.ues 方法传入项目名称来使用项目图标库扩充基本图标库。项目图标的优先级大于基本图标。

例如下方的示例使用广发 (Guangfa) 来扩充基本图标库

Vue.use(KswIcon, { projectName: "Guangfa" });

按需引用项目图标只需要在 ksw-vue-icon 后添加上 projectName，例如:

import { IconName } from 'ksw-vue-icon/Guangfa'

projectName	介绍
Base	基本图标库
Guangfa	广发图标库
KingAutometa	新RPA

展示页配置

安装依赖

yarn install

编译和热重新加载用于开发

yarn dev

编译和缩小以供生产

yarn build

编译 NPM 包

yarn build-packages

Lints and fixes files

yarn lint

部署方法

1. 将 svg 图标放入 src/svg 文件夹中

2. 更改 package.json 中的 version

3. 推送到 github 仓库

图标规范

确保图标基础尺寸是 24×24

如果是彩色图标可以在命名中包含 color 例如 social-color

图标命名请使用英文（不可以含 /）和 -，例如 dewu-logo-original

图标一般有描边 stroke 和填充 fill 两种样式，一个图标只能采用一种形式，不可以混合，默认 fill。想要转为 fill 样式，你可以使用 Outline Stroke（Shift+Command+O） 将图标转换为填充形状。

通过图标命名我们对 svg 处理成单色（去掉原始颜色设置 fill="currentColor"）、彩色（保留原始颜色）。

属性

属性名称	介绍	类型	默认值	注释
size	图标的大小，宽高相同	number | string	'1em'
color	图标的颜色，默认为当前颜色	string | string[]	'currentColor'
rotate	图标旋转角度（IE9 无效）	number	-
spin	给图标加旋转动画	boolean	false
grayscale	灰度	boolean	false

项目更新指令

使用 upv 命令, commit信息 自定义, 示例如下:

npm run upv commit信息