告别图标字体?ng-icons 可变图标字体与 ng-glyph 组件上手教程

原创2026-11-16 21:01:581,435 阅读

告别图标字体?ng-icons 可变图标字体与 ng-glyph 组件上手教程

还在为 Angular 项目里图标字体"又重又难控"而头疼吗?ng-icons 是面向 Angular 的终极图标库,一个组件统一管理 40+ 图标集、11 万+ 图标。它新推出的可变图标字体能力,通过 ng-glyph 组件让你像控制文字一样控制图标:粗细、填充、光学生效尺寸都能像"变量"一样随意调节。本教程带你从零上手这套 Material Symbols 可变字体玩法,只需三步就能在模板里渲染出任意图标。

ng-icons Angular 图标库:一个组件统一管理全部图标集

🤔 为什么要告别传统图标字体?

传统图标字体(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,
    }),
  ],
});

⚠️ 注意事项与常见问题

  1. 这是实验性特性:可变图标字体目前仅支持 Material Symbols 图标集,且不跟随 ng-icons 主版本号发布,API 可能随时调整。建议在生产项目中留意官方文档 variable-icon-fonts.md 的更新说明。
  2. 忘了加载字体样式表? 图标会显示为空白文字——ng-glyph 只是渲染字形,字体文件必须由你负责引入。
  3. glyphset 名字写错? 组件会抛出 The glyphset "xxx" does not exist. 错误,见 glyph.provider.ts 中的注入逻辑。
  4. 与静态 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" /> 开始体验。

登录后查看全文
ng-icons