告别图标字体?ng-icons 可变图标字体与 ng-glyph 组件上手教程
告别图标字体?ng-icons 可变图标字体与 ng-glyph 组件上手教程
还在为 Angular 项目里图标字体"又重又难控"而头疼吗?ng-icons 是面向 Angular 的终极图标库,一个组件统一管理 40+ 图标集、11 万+ 图标。它新推出的可变图标字体能力,通过 ng-glyph 组件让你像控制文字一样控制图标:粗细、填充、光学生效尺寸都能像"变量"一样随意调节。本教程带你从零上手这套 Material Symbols 可变字体玩法,只需三步就能在模板里渲染出任意图标。
🤔 为什么要告别传统图标字体?
传统图标字体(Icon Font)有几个老毛病:
- 一个图标一个字体文件:想要粗体、描边、填充不同版本,就得引入多套字体,包体积直线上升;
- 样式控制僵硬:想让某个图标"变粗一点",只能整站换一套字体;
- 与文本不协调:图标无法像文字一样随 font-size 自然缩放对齐。
而**可变字体(Variable Font)**的思路是:一个字体文件里内置了多个"轴"(axes),通过 CSS 变量动态取值。ng-icons 用 ng-glyph 组件把这套能力封装成了 Angular 声明式 API,目前支持 Material Symbols 图标集(实验性特性)。
📦 第一步:安装 ng-icons 核心包
可变图标字体基于 ng-icons 的核心包,先装核心包和 Material Symbols 图标集包:
npm i @ng-icons/core @ng-icons/material-symbols
或者用 Angular CLI 一键添加(会交互式提示你选择图标集):
ng add @ng-icons/core
⚠️ 特别注意:与 SVG 静态图标不同,ng-icons 不会打包图标字体文件本身。你需要自行安装并加载 Material Symbols 的字体及其 material-symbols 样式表(例如在项目的字体资源中引入该字体 CSS)。这是使用 ng-glyph 的前置条件。
安装细节可参考官方文档:installation.md
🚀 第二步:注册可变字体(glyphset)
字体文件加载好后,在应用启动时调用 provideNgGlyphs 注册你想使用的字形集(glyphset)。第一个注册的会自动成为默认字形集:
import { provideNgGlyphs } from '@ng-icons/core';
import {
withMaterialSymbolsOutlined,
withMaterialSymbolsRounded,
} from '@ng-icons/material-symbols';
bootstrapApplication(App, {
providers: [
provideNgGlyphs(
withMaterialSymbolsOutlined(), // 默认字形集
withMaterialSymbolsRounded(), // 备选:圆角风格
),
],
});
@ng-icons/material-symbols 包一共提供了三种风格,源码见 material-symbols/src/index.ts:
| 注册函数 | 风格 |
|---|---|
withMaterialSymbolsOutlined() |
描边(outlines) |
withMaterialSymbolsRounded() |
圆角(rounded) |
withMaterialSymbolsSharp() |
锐利(sharp) |
✨ 第三步:一行模板代码渲染图标
注册完成后,模板里只需一个标签:
<!-- 默认字形集,渲染 "settings" 图标 -->
<ng-glyph name="settings" />
<!-- 指定字形集 + 粗细 + 填充 + 颜色 -->
<ng-glyph name="settings" glyphset="material-symbols-rounded"
weight="700" fill color="#e91e63" size="32px" />
这就是 ng-glyph 的全部魅力:图标变成了"可变变量"。它在内部把参数映射成字体的 font-variation-settings(wght 字重、GRAD 等级、FILL 填充、opsz 光学生效尺寸),核心实现见 glyph.component.ts。
🎛️ ng-glyph 参数速查表
| 参数 | 类型 | 说明 | 默认值 |
|---|---|---|---|
name |
string |
图标名称(必填) | — |
glyphset |
string |
使用的字形集 | 第一个注册的 |
size |
string | number |
尺寸(px 值或 CSS 值) | 跟随当前文字大小 |
opticalSize |
number |
光学生效尺寸(px) | 20 |
weight |
number |
字重(粗细轴) | 400 |
grade |
number |
等级轴 | 0 |
fill |
boolean |
是否填充 | false |
color |
string |
图标颜色 | 当前文字颜色 |
🌐 全局默认配置:一次设置,处处生效
不想每个 ng-glyph 都写一遍默认值?用 provideNgGlyphsConfig 在应用级统一设置,配置项见 glyph-config.provider.ts:
import { provideNgGlyphsConfig } from '@ng-icons/core';
bootstrapApplication(App, {
providers: [
provideNgGlyphsConfig({
size: 24,
weight: 400,
grade: 0,
fill: false,
}),
],
});
⚠️ 注意事项与常见问题
- 这是实验性特性:可变图标字体目前仅支持 Material Symbols 图标集,且不跟随 ng-icons 主版本号发布,API 可能随时调整。建议在生产项目中留意官方文档 variable-icon-fonts.md 的更新说明。
- 忘了加载字体样式表? 图标会显示为空白文字——
ng-glyph只是渲染字形,字体文件必须由你负责引入。 - glyphset 名字写错? 组件会抛出
The glyphset "xxx" does not exist.错误,见 glyph.provider.ts 中的注入逻辑。 - 与静态 SVG 图标可以共存:同一应用里
ng-icon(SVG 图标)和ng-glyph(可变字体)互不干扰,按需选择即可。
📝 小结
- ng-icons 用
ng-glyph组件 + 可变图标字体,让 Angular 里的图标终于拥有了"可变性":粗细、填充、尺寸全部参数化; - 上手只需三步:装包 →
provideNgGlyphs注册字形集 → 模板写<ng-glyph name="..." />; - 配合
provideNgGlyphsConfig做全局默认值,几行配置就能让整站图标风格统一; - 特性目前是实验状态且限定 Material Symbols,但方向明确——这正是"告别笨重图标字体"的第一步。
现在就去你的 Angular 项目里试试吧,从一张表格里的 <ng-glyph name="check_circle" fill weight="700" /> 开始体验。