@bradleyhodges/sfsymbols

中文文档
8.1.3发布于 2026/09/08TypeScriptESM + CJS近 30 天下载 1.2万

苹果公司的SF符号图标用于苹果平台的React应用.

中文使用文档
文档目录8 节
  1. 苹果公司的SF符号图标用于在苹果平台上构建React/Typescript应用程序.
  2. 本图书馆的特点
  3. 版本
  4. 可用图标
  5. 开始
  6. 安装软件包
  7. 使用量
  8. 大楼
SF Symbols 8

SF 符号 8

苹果公司的SF符号图标用于在苹果平台上构建React/Typescript应用程序.

NPM Downloads by package author npmjs package GitHub repo
Version: 8.1.3 Platforms: Next.js – React.js – React Nav License: MIT

SF符号是一个由超过7000个符号组成的库,设计上与旧金山无缝地融合,是苹果平台的系统字体.

特征 二. 支助 版本 二. 支助 可用图标 二. 支助 开始 二. 支助 安装 二. 支助 使用量 二. 支助 大楼 二. 支助 问题 二. 支助 调取请求

本图书馆的特点

  • 8,111个符号 - 包含整个SF符号 8 (β)图标库,外加609个补充品牌图标
  • 可树动 - 每个图标都可以作为独立组件(每个小于1 KB)或捆绑导入导入
  • 类型安全 - 使用 IDE 自动完成的完整类型脚本支持
  • 轻巧 - 只有导入的图标才会在你的捆绑中
  • 反应18/19 - 与最新版本的React合作

版本

此软件包已使用来自 8.0 (135)号版本 - SF 字体版本 22.0d4e4。 。 。 .

可用图标

本套装包含8,111个图标,其中包括609个补充品牌图标. 所有7 502个 Regular 重量图标 旧金山字体 包含。 其他的权重不包含在这个包中,但图标权重可以通过对向量路径进行中风而更重.

简而言之, 我为这个软件包创建了一个基本的图标浏览器,你可以在这里访问: bradleyhodges - sfsyms.vercel.app (原始内容存档于2017-03-28) Screenshot of a comment on a GitHub issue showing an image, added in the Markdown, of an Octocat smiling and raising a tentacle.

开始

此套件具有SF符号8的实际图标和图标数据的特点. 要在 React 应用程序中使用这些图标, 您可以使用 sfsymbols-react 配套软件包,它暴露了SF符号8图标的方便易用回放组件.

安装软件包

您需要安装以下软件包来使用您的工程中的图标 :

使用量

[叹息] SF符号由苹果公司许可,仅用于苹果平台. 此软件包或其他任何 @ bradleyhodges/ sfsymbols- * 软件包, 在苹果平台外使用是不允许的 . 更多信息 : Xcode 和 Apple SDKs 协议

pnpm add @bradleyhodges/sfsymbols@latest @bradleyhodges/sfsymbols-react@latest @bradleyhodges/sfsymbols-types@latest

然后可以这样导入项目中的图标 :

import { SFIcon } from '@bradleyhodges/sfsymbols-react';
import { sfArrowUpCircleFill } from '@bradleyhodges/sfsymbols';

...

<SFIcon icon={sfArrowUpCircleFill} />

[TIP] 见 sfsymbols-反应 软件包,用于详细了解 SFIcon 组件可接受,并如何使用辅助组件自定义React应用程序中的图标外观.

对于更快的模块分辨率,也可以直接导入单个图标. 这是可选的;现有的根进口仍然得到支持,无害环境管理中的树摇.

import { sfArrowUpCircleFill } from '@bradleyhodges/sfsymbols/sfArrowUpCircleFill';

普通JS 消费者可以使用相同的每相机路径 require()。这可以使捆绑集中在选定的图标上。 Root CommunityJS在访问其出口时导入加载图标定义,但捆绑者可能仍然包括整个目录.

大楼

  • pnpm build-icons 从本地提供的 SVG 归档中生成类型脚本定义.
  • pnpm build-package 编译生成 src 纳入经验证的无害环境管理、共同JS和申报产出.
  • pnpm build-package --from-dist 重建一个没有 SVG 存档的现有发行。 它验证两种格式都同意,保存了SVG数据和元数据,并恢复了被整理的搜索别名. 重复运行不会累积别名.
  • pnpm build 保留交互式存档/版本工作流程,并使用相同的软件包发送器.
  • pnpm test 运行构建回归测试; pnpm typecheck 检查生成源和运出声明,包括免费的归档取出.

包排放阶段和在替换前验证所有产出 dist。失败的替换可以恢复先前的分布;如果恢复被阻断,则错误会识别保留的备份目录。 原始的 SVG 生成仍然需要您自己的源归档 .

全数 pnpm build 工作流程将未打开的 SVG 保存在 build/src 并生成类型脚本 src 通过版本更新、汇编、微缩和输出验证。 清理工作只有在这些步骤成功后才能进行,最后删除了原始的SVG输入. 软件包版本文件使用临时文件替换为Windows锁定的有边框的回放;在所请求的版本中已经保存的文件未被更改.

[注] 此寄存器包含构建图标及其各自反应组件所需的脚本. 然而,由于苹果的许可条款,我还没有将实际的图标存档纳入到这个寄存器中,我也不会应要求提供. 这是为了尊重苹果的许可条款,防止任何未经授权使用图标,并避免任何法律问题.

版本与发布记录

@bradleyhodges/sfsymbols 共发布 7 个版本,首次发布于 2025/09/23;过去 12 个月发布了 6 个版本。

版本发布日期距今
8.1.3latest2026/09/082 个月前
8.1.12026/09/072 个月前
8.1.1-rc.0rc2026/09/072 个月前
8.0.42026/09/062 个月前
8.0.32026/09/062 个月前
8.0.22026/09/062 个月前

关于 @bradleyhodges/sfsymbols 的常见问题

@bradleyhodges/sfsymbols 是什么?

苹果公司的SF符号图标用于苹果平台的React应用.

如何安装 @bradleyhodges/sfsymbols?

在项目目录运行 npm install @bradleyhodges/sfsymbols,或使用 pnpm add / yarn add / bun add。

@bradleyhodges/sfsymbols 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bradleyhodges/sfsymbols 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@bradleyhodges/sfsymbols 可以商用吗?

@bradleyhodges/sfsymbols 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@bradleyhodges/sfsymbols 的下载量有多少?

根据 npm 官方下载统计,@bradleyhodges/sfsymbols 在 2026/10/09 – 2026/11/07 这 30 天内被下载 12,265 次,日均约 409 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bradleyhodges/sfsymbols 还在维护吗?

最新版本 8.1.3 发布于 2026/09/08(2 个月前);至今共发布 7 个版本,其中过去 12 个月发布了 6 个;首次发布于 2025/09/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。