Bootstrap Icons 中的 CC square 图标:创意共享许可图标的源码解析与使用指南

原创2026-10-03 16:46:381,424 阅读
文章标签:前端

Bootstrap Icons 中的 CC square 图标:创意共享许可图标的源码解析与使用指南

在 Bootstrap Icons 官方图标库中,cc-square 是一枚用于表示 Creative Commons(知识共享)许可标识的方形图标,归属于 Shapes(形状)分类。本文以该图标的文档页 docs/content/icons/cc-square.md 为线索,深入其 SVG 源码、字体码点与官方文档模板,讲解这枚图标的图形结构、四个相关变体以及在实际项目中的三种主流用法,帮助你准确理解并正确引用 bi-cc-square。

图标语义与文档定位

在 Bootstrap Icons 的文档体系中,每个图标对应 docs/content/icons/ 下的一篇 Markdown 文件,用于向 Hugo 静态站点生成器提供页面元数据。cc-square.md 的正文即为此类前置元数据(front matter):

title: CC square
categories:
  - Shapes
tags:
  - "creative commons"
  • title:图标显示名,即 “CC square”;
  • categories:图标分类为 Shapes(形状),与 cc-circle(圆形)等共同属于几何外形类图标;
  • tags:语义标签 “creative commons”,表明该图标的用途是表达知识共享许可(Creative Commons)标识。

从图标设计看,CC square 将知识共享标志性的“双 C”符号(两个相互嵌套的字母 C)置于方形外框之内,是 BSD 许可、CC 协议标注等场景中常见的版权声明图标。文档站点会在 docs/layouts/icons/single.html 模板中读取这些元数据,并动态渲染出大图预览、标签列表与下载面板。

SVG 源码逐层解析

图标本体位于 icons/cc-square.svg,是标准 16×16 的矢量图形:

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor"
     class="bi bi-cc-square" viewBox="0 0 16 16">
  <path fill-rule="evenodd" d="M15 2a1 1 0 0 0-1-1H2a1 1 0 0 0-1 1v12a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1zM0 2a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2zm5.408 3.89c-.83 0-1.318.64-1.318 1.753v.742c0 1.108.479 1.727 1.318 1.727.69 0 1.138-.435 1.187-1.05h1.147v.114c-.058 1.147-1.029 1.938-2.343 1.938-1.612 0-2.518-1.028-2.518-2.729v-.747c0-1.7.914-2.75 2.518-2.75 1.319 0 2.29.812 2.343 1.999v.11H6.595c-.049-.638-.506-1.108-1.187-1.108Zm5.404 0c-.831 0-1.319.64-1.319 1.753v.742c0 1.108.48 1.727 1.319 1.727.69 0 1.138-.435 1.186-1.05h1.147v.114c-.057 1.147-1.028 1.938-2.342 1.938-1.613 0-2.518-1.028-2.518-2.729v-.747c0-1.7.914-2.75 2.518-2.75 1.318 0 2.29.812 2.342 1.999v.11h-1.147c-.048-.638-.505-1.108-1.186-1.108Z"/>
  <path fill-rule="evenodd" d="M15 2a1 1 0 0 0-1-1H2a1 1 0 0 0-1 1v12a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1zM0 2a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2zm5.408 3.89c-.83 0-1.318.64-1.318 1.753v.742c0 1.108.479 1.727 1.318 1.727.69 0 1.138-.435 1.187-1.05h1.147v.114c-.058 1.147-1.029 1.938-2.343 1.938-1.612 0-2.518-1.028-2.518-2.729v-.747c0-1.7.914-2.75 2.518-2.75 1.319 0 2.29.812 2.343 1.999v.11H6.595c-.049-.638-.506-1.108-1.187-1.108Zm5.404 0c-.831 0-1.319.64-1.319 1.753v.742c0 1.108.48 1.727 1.319 1.727.69 0 1.138-.435 1.186-1.05h1.147v.114c-.057 1.147-1.028 1.938-2.342 1.938-1.613 0-2.518-1.028-2.518-2.729v-.747c0-1.7.914-2.75 2.518-2.75 1.318 0 2.29.812 2.342 1.999v.11h-1.147c-.048-.638-.505-1.108-1.186-1.108Z"/>
</svg>

关键结构说明:

  • 尺寸与坐标系:width="16" height="16" 定义了 16×16 的默认渲染尺寸,viewBox="0 0 16 16" 则是 SVG 的逻辑坐标系,二者配合保证图标在不同缩放下保持 1:1 的方形比例;
  • 着色方式:fill="currentColor" 意味着图标颜色继承父元素文本色,这正是 Bootstrap Icons 能通过 CSS 随意改变图标颜色的核心机制;
  • class 标识:class="bi bi-cc-square" 是图标在字体方案中的类名前缀,与 font/bootstrap-icons.css 中的字体类对应;
  • 路径图层:两个 fill-rule="evenodd" 的 path 分别绘制外层圆角方框(M15 2a1 1 0 0 0-1-1H2...)与内层“双 C”符号(M5.408 3.89... 与 M10.812 3.89...)。fill-rule="evenodd" 让重叠区域按奇偶规则镂空,从而呈现清晰的线框轮廓;
  • 双 C 形状:内层两段路径的坐标对称分布(左侧约在 x=5.4,右侧约在 x=10.8),构造成对出现的 “C” 形字母,即 Creative Commons 标志的核心视觉元素。

四个 CC 图标变体

仓库中共有 4 枚知识共享相关图标,文档分别位于 docs/content/icons/cc-square.md、docs/content/icons/cc-square-fill.md、docs/content/icons/cc-circle.md 与 docs/content/icons/cc-circle-fill.md,它们共享相同的 “双 C + 外框” 设计语言:

图标名 外形 视觉特点 SVG 源文件
cc-square 方形线框 双 C 居中,外框为圆角方框 icons/cc-square.svg
cc-square-fill 方形实心 背景实心填充,双 C 以镂空呈现 icons/cc-square-fill.svg
cc-circle 圆形线框 双 C 居中,外框为圆形 icons/cc-circle.svg
cc-circle-fill 圆形实心 背景实心填充,双 C 镂空 icons/cc-circle-fill.svg

以 icons/cc-square-fill.svg 为例,它的路径从 M2 0a2 2 0 0 0-2 2v12... 开始,直接用闭合路径勾勒实心圆角方形,随后才是双 C 镂空细节——这就是 “fill(实心)” 变体与线框变体在实现上的本质区别。选择建议:在浅色背景、需弱化图标存在感的场景用线框版;在按钮、标签等需要强视觉锚点的场景用实心版。

字体码点:从 JSON 到 Unicode / CSS / JS / HTML

Bootstrap Icons 除提供 SVG 文件外,还内置了 Web 字体方案。所有图标的码点定义在 font/bootstrap-icons.json 中,其中与本主题相关的条目为:

"cc-circle-fill": 63462,
"cc-circle": 63463,
"cc-square-fill": 63464,
"cc-square": 63465

cc-square 的十进制码点为 63465,换算为十六进制即 0xF7E9(字体区段 U+F700 起分配)。文档模板 docs/layouts/icons/single.html 展示了同一码点在四种宿主语法中的写法:

  • Unicode 表示:U+F7E9
  • CSS 表示:\F7E9(配合 font-family: 'bootstrap-icons' 使用)
  • JS 表示:\uF7E9(可用于 JavaScript 字符串拼接)
  • HTML 表示:&#xF7E9;(可直接写在 HTML 实体中)

在项目中的三种实际用法

参照 docs/layouts/icons/single.html 的渲染逻辑,cc-square 在项目中可通过三种方式引用:

1. 图标字体(Icon font)

最简洁的用法,引入 font/bootstrap-icons.css 后直接使用类名:

<i class="bi bi-cc-square"></i>

字体方案下图标继承当前文本字号与颜色,随 font-size 缩放,适合与文字混排。

2. 内联 SVG

将 icons/cc-square.svg 的内容直接复制进 HTML。由于 SVG 使用 fill="currentColor",你可以用 CSS 的 color 属性为其着色,且不受字体文件加载影响:

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor"
     class="bi bi-cc-square" viewBox="0 0 16 16">
  <!-- 两个 path 路径数据见 icons/cc-square.svg -->
</svg>

3. 单独下载 SVG 文件

文档页为每个图标提供 “Download SVG” 按钮,可直接下载 icons/cc-square.svg 到本地,用矢量编辑器打开、修改后作为静态资源引入,适合需要自定义细节(如改描边粗细、加文字)的场景。

在 Bootstrap 5 的典型应用里,cc-square 常被用作授权声明、署名标签、页脚版权信息旁的图标,与文本按钮、卡片徽章等组件组合使用;若同时需要圆形形态,可切换到 cc-circle 保持视觉一致性。

从源码看文档页的生成机制

值得说明的是,cc-square.md 本身只含元数据,并不写死任何内容——真正“画出”图标的 SVG 由 Hugo 模板在构建时读取。在 docs/layouts/icons/single.html 中,模板通过 readFile "/icons/cc-square.svg" 读取对应 SVG 注入页面,并从 font/bootstrap-icons.json 动态算出码点,再拼接出 Icon font、Code point、Copy HTML 等面板。这意味着:只要新增一个 icons/xxx.svg 文件与配套的 xxx.md 元数据,文档站即可自动生成完整的图标页面。理解这一机制,有助于你快速定位其他图标的源码、码点与文档入口。

小结

cc-square 是 Bootstrap Icons 中语义明确、实现精巧的一枚形状类图标:它以 16×16 的 currentColor 矢量呈现 Creative Commons 的“双 C”标识,并提供 square / circle × line / fill 四种变体供不同场景选用。通过本文的源码路径与码点对照,你可以自由选择字体、内联 SVG 或文件下载三种方式将其集成到自己的项目中,并随时在 font/bootstrap-icons.json 与 docs/layouts/icons/single.html 中回溯它的定义与生成原理。

登录后查看全文
icons