Tabler Icons 免费 SVG 图标库完整上手指南:6184 个图标 3 步接入项目
【免费下载链接】tabler-iconsA set of over 6100 free MIT-licensed high-quality SVG icons for you to use in your web projects.项目地址: https://gitcode.com/GitHub_Trending/ta/tabler-icons
你只是想改个图标颜色,却要在 SVG 源码、CSS、JSX 三个文件之间来回翻。Tabler Icons 是免费 MIT 协议的 SVG 图标库——6184 个图标统一 24×24 网格、2px 描边,配 15 个框架包。拿到手,一条命令装进项目就能用。
先花 10 秒确认它适合你
- 你手上有跑起来的前端项目——图标包通过 npm 装进依赖,没项目就装没处装
- 你的框架在官方包列表里——packages/ 下按 React、Vue、Svelte、Angular、Astro、Preact、Solid、React Native 拆好了包,import 即用
- 没有构建环境也能接——SVG 本质是文本,一个编辑器就能往静态 HTML 里贴
三条全中往下看;有一条不中,就先从静态内联 SVG 的最低门槛方案开始。
装完之后的第一个动作
以 React 为例,一条命令搞定:
npm install @tabler/icons-react装完后浏览器里不会出现任何东西——但下一节 import 一行图标,箭头当场出现在页面上。
没有构建流程也一样:把icons/outline/home.svg的内容复制进 HTML 就行,它就是个文本文件。
从一行代码到一个完整组件
最小用法。命名规则是Icon+ 图标名首字母大写驼峰——home.svg对应IconHome:
import { IconArrowLeft } from '@tabler/icons-react'; <IconArrowLeft />页面左上角出现一个 24×24 的左箭头,它默认继承 currentColor,颜色跟你的正文文字走。
加两个属性。size 和 color 直接写在标签上:
<IconArrowLeft size={48} color="red" />刷新页面,图标当场变成 48px 的红色,不用改任何样式文件。
塞进你自己的组件。把它当普通 prop 传下去,路径和写法跟其他组件一致:
function Nav(props) { return <IconArrowLeft {...props} />; } <Nav color="white" size={32} />到这一步,图标已经长在你的组件树里了,深浅色模式只改 CSS 颜色值。
四个属性,管住全部图标
| 属性 | 控制什么 | 最短示例值 |
|---|---|---|
| size | 图标宽高 | size={48} |
| color | 描边颜色 | color="red" |
| strokeWidth | 线宽粗细 | strokeWidth="1.5" |
| currentColor 继承 | 默认跟随文字颜色 | 不传 color 即可 |
线宽调整的完整官方说明在 docs/icons/index.mdx,纯 SVG 写法看 docs/icons/svg.mdx。
三种工程化取舍
体积怎么省。组件包支持 tree-shaking,你 import 哪个图标,打包产物才带哪个。图标多到上百个时,换@tabler/icons-sprite让浏览器只请求一次精灵图,或用 webfont 方案当字体引用。
风格会不会打架。混用其他图标集,网格、线宽、线帽三样全对不上,页面立刻显得乱。这里 6184 个图标共用同一套 24 网格和 2px 圆头线帽,成套用天然一致,粗细不合场景再调 stroke-width 就行。
授权卡不卡商用。MIT 协议,商用、闭源项目都免费,没有任何隐藏收费。分发时唯一要做的是保留许可证声明。
它替你砍掉的是风格统一——线宽、网格、颜色一个属性全管住。剩下的 20% 只是查名字、写导入。现在就打开 docs/icons/,把你正在用的框架那一章完整过一遍。
【免费下载链接】tabler-iconsA set of over 6100 free MIT-licensed high-quality SVG icons for you to use in your web projects.项目地址: https://gitcode.com/GitHub_Trending/ta/tabler-icons
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考