Skip to content

Latest commit

 

History

History
95 lines (67 loc) · 6.59 KB

README_CN.md

File metadata and controls

95 lines (67 loc) · 6.59 KB

logo

npm downloads spectrum donate

English | 简体中文

Remix Icon 是一套面向设计师和开发者的开源图标库。我们在设计之初将图标风格定义为中性风格,以便适用于各种用户群的项目。与拼凑混搭的图标库不同,Remix Icon 的每一枚图标都是由设计师按照统一规范精心绘制的,并确保每一枚图标在拥有完美像素对齐的基础上风格一致且简洁易读。图标以24x24网格为基准,分为“线性图标”和“面型图标”两种风格。所有的图标均可免费用于个人项目和商业项目,Enjoy it~

icon demo 前往官网查看整套图标库 remixicon.com.

使用说明

基本用法

直接在remixicon.com点击您想要的图标, 该图标将会以SVG矢量格式进行下载。

我们建议设计师小伙伴在需要使用某些图标的时候通过官网搜索下载使用,而不是将一整套图标全部下载放在本地文件夹中进行管理;官网的搜索栏可以帮助您快速定位您想要的图标,而且支持中文关键词搜索,这相比本地文件夹管理图标效率要高很多;最重要的是,官网的图标会持续更新。

SVG本身也是一种图片格式,所以您可以像使用其他格式(如JPG、PNG)的图片文件一样使用SVG文件,例如直接引入的方式:

<img height="32" width="32" src="img/admin-fill.svg" />

Webfont 用法

Note: Webfont支持npm安装引入、CDN引入或者手动下载的方式引入到项目当中,三选一即可。

安装引入

Note: 如果您打算通过CDN的方式使用 Remix Icon,可以跳过安装引入这一步。

npm install remixicon --save
import 'remixicon/fonts/remixicon.css'

入口文件引入CSS

CDN引入

如果不打算通过安装的方式使用,可以直接复制下面这行代码到您HTML文档的 <head> 标签中,这样就完成了CDN方式的图标引入,简单快捷,推荐方式。

<link href="https://cdn.remixicon.com/releases/v1.2.2/remixicon.css" rel="stylesheet">

手动下载引入

下载保存remixicon.css文件,添加到项目的<head> 标签中即可。

使用

引入Remix Icon图标库后,就可以在web项目中使用了,只要在使用图标的时候将图标名称作为类名就可以了。类名规则:remixicon-{name}-{style}

<i class="remixicon-admin-line"></i>
<i class="remixicon-admin-fill"></i>

Note: 您可以到官网 remixicon.com 查阅图标对应的名称,然后在名称后添加图标风格,-line 代表线性风格,-fill代表面型风格。

SVG Sprite用法

下载 remixicon.symbol.svg 并添加到您的项目目录中,通过 <use> 标签来引用图标,通过css可以自定义图标的大小和颜色等属性,例如:

<svg class='remix'>
  <use xlink:href="存放路径/remixicon.symbol.svg#remixicon-admin-fill"></use>
</svg>
.remix {
  width: 24px;
  height: 24px;
  fill: #333;
}

Note: 上面示例中 # 后面的remixicon-admin-fill可以替换为任何 Remix Icon 图标名称,您可以到官网 remixicon.com 查阅图标对应的名称,然后在名称后添加图标风格,-line 代表线性风格,-fill 代表面型风格。remixicon.symbol.svg文件默认是无法预览查看的,只能通过 <use> 使用之后查看。

协作共建

Note: 为了保证每一枚图标的质量,现阶段我们还不接受第三方小伙伴绘制的图标。如果您想要向 Remix Icon 贡献自己设计的图标,请创建一个issue来提交自己的图标设计,并在issue详情中附上自己图标的下载地址,我们会按照 Remix Icon图标风格规范进行审核,通过后将会添加到图标库中,并在更新日志中署上作者的ID。如果你对GitHub不是很熟悉,不清除issue和pull request是什么,也可以直接给我们发邮件 jimmy@remixdesign.cn,内容表述清楚即可。

图标申请

如果图标库中缺少某个适合您业务场景的图标,您可以通过创建issue的方式进行申请,issue标题格式为:“Icon request: <图标名称>”,并完善issue模板中的相应信息。感谢您提出图标申请,这也是帮助我们完善图标库的一种协作共建方式。

图标搜索关键词

目前我们的图标官网是通过tags.json文件来管理搜索关键词的,目前我们已经为所有图标添加了中文关键词,因此我们可以通过中文对图标进行搜索和定位;但是由于关键词不是很健全,所以用户还是经常无法通过某个特定关键词搜索到已有图标。而目前我们还没有一个很好的自动化策略来穷举每一个图标的关键词,只能通过人肉添加的方式来进行完善,希望用户可以通过提issue 或者pull request的方式来帮我们一块完善维护tags.json,让搜索功能变得更加好用。

相关项目

RemixIcon-Slides Remix Icon的PPT版本和Keynote版本。

协议许可

Remix Icon 使用的是 Apache License Version 2.0开源协议。请放心使用和分享本图标库,您可以查看协议详情来了解详细的开源策略。如果您能在您的产品介绍中署名 Remix Icon,我们将会非常感激,但这并不是必须的。唯一需要注意的是,您不能二次销售本图标库中的图标,否则我们会进行追究。