如何高效在HTML中嵌入和使用SVG符号图标

霞舞

发布时间：2025-09-13 12:24:10

344人浏览过

来源于php中文网

原创

如何高效在HTML中嵌入和使用SVG符号图标

本教程详细介绍了如何在HTML中高效使用SVG symbol 元素创建可复用、易于样式化的图标系统。通过构建一个隐藏的SVG精灵图谱，并结合元素引用特定符号，您可以实现高度灵活且性能优异的矢量图标管理。文章还提供了CSS样式示例，并解释了这种方法相较于直接通过如何高效在HTML中嵌入和使用SVG符号图标

标签引用SVG符号的优势。

理解SVG symbol 与元素

svg（可缩放矢量图形）提供了一种强大的方式来创建和管理图形。其中，symbol 元素扮演着“模板”的角色，它允许您定义一个可复用的图形片段，而无需在每次使用时重复其所有内容。symbol 元素本身不会被直接渲染，它只是一种定义。

要实际显示和使用 symbol 定义的图形，我们需要借助元素。元素通过其 href（或 xlink:href，尽管现代浏览器更推荐 href）属性指向一个 symbol 的 id，从而在文档中创建一个该 symbol 的实例。这个实例可以独立于原始 symbol 进行定位、缩放和样式化，极大地提高了图标的可维护性和灵活性。

优点

可复用性: 只需定义一次，即可在页面上多次使用。
可访问性: symbol 内部可以包含 title 和 desc 等元素，增强语义。
易于样式化: 通过CSS可以轻松控制 use 元素的颜色、大小等属性。
性能优化: 减少了HTTP请求（如果所有符号都在一个文件中），并简化了DOM结构。

构建SVG精灵图谱并使用符号

在HTML中高效使用SVG符号的推荐方法是创建一个“SVG精灵图谱”（SVG Sprite）。这通常涉及将所有 symbol 定义放置在一个隐藏的SVG容器中，然后在页面上通过元素引用它们。

1. 定义SVG符号精灵图谱

首先，在您的HTML文档中（通常放在

的开头或

附近，或者在中但确保 display: none），创建一个包含所有 symbol 定义的SVG容器。这个容器需要设置 display: none; 来确保 symbol 定义本身不会在页面上显示出来。

解释:

千图设计室AI海报

千图网旗下的智能海报在线设计平台

下载

立即学习“前端免费学习笔记（深入）”；

xmlns="http://www.w3.org/2000/svg": 声明这是SVG命名空间。
style="display: none;": 确保这个SVG容器及其内部的 symbol 定义在页面加载时不可见。
id="icon-checkmark": 为符号指定一个唯一的ID，这是我们稍后通过元素引用它的关键。
viewBox="0 0 16 13": 定义了符号的视口，这对于确保图标在不同尺寸下正确缩放至关重要。

2. 在HTML中引用并使用符号

一旦符号被定义，您就可以在HTML文档的任何位置使用

任务已完成！

解释:

立即学习“前端免费学习笔记（深入）”；

: 这是引用 symbol 的核心。href="#icon-checkmark" 指向了我们之前定义的具有 id="icon-checkmark" 的符号。

3. 为图标添加样式

使用CSS可以非常方便地控制 use 元素实例的样式，例如颜色、大小和对齐方式。由于 use 元素会继承其父

/* 定义通用图标样式 */
.icon {
    /* 移除默认的描边，使图标看起来更简洁 */
    stroke: unset;
    stroke-width: 0px;
    /* 使用当前文本颜色填充图标，便于与文本颜色保持一致 */
    fill: currentColor;
    /* 将图标作为行内块级元素显示 */
    display: inline-block;
    /* 设置图标的默认宽度和高度，这里使用em单位，使其与字体大小相关 */
    width: 1em;
    height: 1em;
    /* 微调图标的垂直对齐，使其更好地与文本基线对齐 */
    vertical-align: -0.15em;
}

/* 可以根据需要定义特定图标或尺寸的样式 */
.icon-checkmark-style {
    color: green; /* 设置图标颜色为绿色 */
    font-size: 1.5em; /* 调整图标大小 */
}

.icon-small {
    font-size: 0.8em; /* 较小的图标 */
    color: #333;
}

解释:

立即学习“前端免费学习笔记（深入）”；

stroke: unset; stroke-width: 0px;: 确保图标没有描边，通常图标只使用填充色。
fill: currentColor;: 这是一个非常有用的属性，它会使SVG图标的填充色与其父元素的文本颜色保持一致。这意味着您只需改变文本颜色，图标颜色也会随之改变。
display: inline-block;: 允许图标像文本一样排列，但可以设置宽度和高度。
width: 1em; height: 1em;: 将图标尺寸设置为当前字体大小的1倍，这使得图标能够根据文本大小自动缩放。
vertical-align: -0.15em;: 微调图标的垂直位置，使其在文本流中看起来更协调。

注意事项与最佳实践

关于外部SVG文件引用

原始问题中提到尝试使用如何高效在HTML中嵌入和使用SVG符号图标标签引用外部SVG文件中的 symbol，例如 https://github.com/rajamunuma/test/blame/main/test.svg#icon-checkmark。这种方法对于 symbol 元素并不适用。

标签的限制: 标签主要用于显示整个SVG文件，或者通过URL片段（如#svgView(viewBox(0,0,16,13))）引用SVG文件中的特定视图。它无法直接引用 symbol 元素并让其继承宿主HTML文档的CSS样式，也无法像元素那样提供灵活的DOM操作。
跨域问题: 如果SVG文件位于不同的域或子域，直接通过引用可能会遇到跨域安全策略（CORS）问题，导致图标无法加载。将SVG精灵图谱直接嵌入HTML文档可以避免此问题。
JavaScript加载: 对于确实需要从外部文件加载SVG精灵的情况，更健壮的方法是使用JavaScript（例如通过 fetch API）获取SVG文件内容，然后将其注入到HTML文档中（通常是隐藏的SVG容器），之后再通过元素引用。

总结

通过在HTML中定义一个隐藏的SVG精灵图谱，并使用的模式，您可以构建一个强大、灵活且易于维护的图标系统。这种方法不仅提供了优秀的性能和可访问性，还允许您通过简单的CSS规则控制图标的外观，使其完美融入您的网页设计。避免使用如何高效在HTML中嵌入和使用SVG符号图标标签来引用 symbol 元素，因为它无法提供相同的样式和交互能力。

html5源代码发行后怎么加动画_简单动画实现方法与代码【操作】

HTML5打空格会影响爬虫抓取吗_空格对爬虫的影响分析【技巧】

HTML5空格显示为小方块咋回事_乱码空格的解决方法【指南】

html5怎么定义class_html5用class属性给元素定义类名方便CSS选择【定义】

html5怎么又悬浮_HTML5用CSS position:fixed或absolute设悬浮效果【悬浮】

HTML速学教程(入门课程)

HTML怎么学习？HTML怎么入门？HTML在哪学？HTML怎么学才快？不用担心，这里为大家提供了HTML速学教程(入门课程)，有需要的小伙伴保存下载就能学习啦！

下载

相关专题

js获取数组长度的方法

在js中，可以利用array对象的length属性来获取数组长度，该属性可设置或返回数组中元素的数目，只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值，也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容，供大家免费下载使用。

543

2023.06.20

js刷新当前页面

js刷新当前页面的方法：1、reload方法，该方法强迫浏览器刷新当前页面，语法为“location.reload([bForceGet]) ”；2、replace方法，该方法通过指定URL替换当前缓存在历史里（客户端）的项目，因此当使用replace方法之后，不能通过“前进”和“后退”来访问已经被替换的URL，语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

372

2023.07.04

js四舍五入

js四舍五入的方法：1、tofixed方法，可把 Number 四舍五入为指定小数位数的数字；2、round() 方法，可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

727

2023.07.04

js删除节点的方法

js删除节点的方法有：1、removeChild()方法，用于从父节点中移除指定的子节点，它需要两个参数，第一个参数是要删除的子节点，第二个参数是父节点；2、parentNode.removeChild()方法，可以直接通过父节点调用来删除子节点；3、remove()方法，可以直接删除节点，而无需指定父节点；4、innerHTML属性，用于删除节点的内容。

470

2023.09.01

JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号，可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容，供大家免费下载体验。

392

2023.09.04

js生成随机数的方法

js生成随机数的方法有：1、使用random函数生成0-1之间的随机数；2、使用random函数和特定范围来生成随机整数；3、使用random函数和round函数生成0-99之间的随机整数；4、使用random函数和其他函数生成更复杂的随机数；5、使用random函数和其他函数生成范围内的随机小数；6、使用random函数和其他函数生成范围内的随机整数或小数。

990

2023.09.04

如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍：1、内联脚本是将JavaScript代码直接嵌入到HTML标签中；2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中；3、外部脚本是将JavaScript代码放置在一个独立的文件；4、外部脚本是将JavaScript代码放置在一个独立的文件。

654

2023.09.12

Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型，用于表示独一无二的值。Symbol的特点：1、独一无二，每个Symbol值都是唯一的，不会与其他任何值相等；2、不可变性，Symbol值一旦创建，就不能修改或者重新赋值；3、隐藏性，Symbol值不会被隐式转换为其他类型；4、无法枚举，Symbol值作为对象的属性名时，默认是不可枚举的。

544

2023.09.20