react-icons 是 React 中非常流行的图标库,可以直接把图标当作 React 组件使用,不需要自己编写 SVG,也不需要单独引入图标字体。
它整合了 Font Awesome、Bootstrap Icons、Material Design、Lucide 等多种图标库。
GitHub+1
1. 安装 react-icons
在项目根目录执行:
npm install react-icons
2. 引入图标
例如,使用 Font Awesome 图标:
import { FaHome, FaUser, FaSearch } from "react-icons/fa";
function App() {
return (
<div>
<FaHome />
<FaUser />
<FaSearch />
</div>
);
}
这里有几个需要理解的地方:
react-icons:图标库的 npm 包名称。fa:Font Awesome 图标集合。FaHome:具体的图标组件。
注意:图标名称采用大驼峰命名法。
3. 常见图标库及导入方式
react-icons 支持很多图标集合。
| 图标库 | 导入路径 | 图标前缀 |
|---|
| Font Awesome | react-icons/fa | Fa |
| Font Awesome 6 | react-icons/fa6 | Fa |
| Bootstrap Icons | react-icons/bs | Bs |
| Material Design | react-icons/md | Md |
| Ionicons 5 | react-icons/io5 | Io |
| Lucide | react-icons/lu | Lu |
| Remix Icon | react-icons/ri | Ri |
| Tabler Icons | react-icons/tb | Tb |
例如:
import { FaHome } from "react-icons/fa";
import { MdSettings } from "react-icons/md";
import { BsGithub } from "react-icons/bs";
import { LuUser } from "react-icons/lu";
function App() {
return (
<div>
<FaHome />
<MdSettings />
<BsGithub />
<LuUser />
</div>
);
}
4. 设置图标大小和颜色
图标组件支持 size、color 等属性。
import { FaHome } from "react-icons/fa";
function App() {
return (
<div>
<FaHome size={16} color="red" />
<FaHome size={24} color="blue" />
<FaHome size={32} color="green" />
</div>
);
}
也可以使用 CSS:
<FaHome className="text-2xl text-blue-500" />
如果项目使用 Tailwind CSS,这种方式非常方便。
5. 图标可以绑定点击事件
因为图标本身就是 React 组件,所以可以正常使用 React 的事件处理机制。
import { FaHeart } from "react-icons/fa";
function App() {
return (
<FaHeart
size={24}
color="red"
onClick={() => alert("点击了爱心")}
/>
);
}
实际项目中,更推荐把图标放在 button 内部,方便键盘操作和无障碍访问:
<button onClick={() => alert("收藏成功")}>
<FaHeart size={20} />
收藏
</button>
6. IconContext:统一设置图标样式
如果一个页面有很多图标,每个图标都单独设置 size 和 color 比较麻烦。
可以使用 IconContext.Provider:
import { IconContext } from "react-icons";
import { FaHome, FaUser, FaCog } from "react-icons/fa";
function App() {
return (
<IconContext.Provider
value={{
color: "blue",
size: "24px",
className: "my-icon"
}}
>
<FaHome />
<FaUser />
<FaCog />
</IconContext.Provider>
);
}
这样 Provider 内部的图标就会使用统一的默认样式。
GitHub
7. 到哪里查找图标?
GitHub - react-icons/react-icons: svg react icons of popular icon packs · GitHub
React Icons 官方图标库
可以按图标名称、图标集合查找
打开 React Icons 图标搜索网站
8. 一个完整的 React + TypeScript + Tailwind 示例
import { FaHome, FaUser, FaCog } from "react-icons/fa";
function Sidebar() {
return (
<div className="w-60 p-4 space-y-4">
<div className="flex items-center gap-3">
<FaHome size={20} />
<span>首页</span>
</div>
<div className="flex items-center gap-3">
<FaUser size={20} />
<span>用户</span>
</div>
<div className="flex items-center gap-3">
<FaCog size={20} />
<span>设置</span>
</div>
</div>
);
}
export default Sidebar;
特别注意一个概念:
<FaHome /> 看起来像 HTML 标签,但它实际上是一个 React 组件。
这和你之前学习的自定义组件 <MyComponent /> 是一样的原理,只不过 FaHome 是 react-icons 库提供的组件。
官方文档:React Icons GitHub。