HTML代码中svg使用use元素引入图标

P粉328763957

P粉328763957

2026-08-03

808人浏览

原创

use元素必须指向同文档内已解析的symbol,不能直接引用外部svg文件id;需确保symbol在use前定义、含viewbox、id严格匹配且唯一。

html代码中svg使用use元素引入图标

use 元素必须指向同一文档或内联的 <svg></svg> 定义

直接用 <use href="icon.svg#star"></use> 在多数现代浏览器里会失败——不是 bug,是规范限制。<use></use> 只能引用当前 HTML 文档中已定义的 <symbol></symbol><defs></defs><svg></svg> 内部元素,不能跨文件解析外部 SVG 的 ID。

常见错误现象:Failed to execute 'use' on 'SVGSVGElement': The provided value is not a valid URL 或图标空白无渲染。

  • 正确做法:把图标定义(如 <symbol id="star">...</symbol>)放在当前 HTML 的 <svg></svg> 内(通常藏在页面底部、 末尾),再用 <use href="#star"></use>
  • 如果图标来自外部文件,得先用 fetch + DOMParser 加载并注入 DOM,或改用 <img src="icon.svg"> / <iframe></iframe> / CSS background
  • href 值必须以 # 开头,且 ID 必须存在且唯一;大小写敏感,#Star#star

内联 SVG symbol 模板必须设 viewBox,否则缩放失真

<symbol></symbol> 本身不渲染,只作模板;但它的 viewBox 决定了 <use></use> 实例的坐标系和缩放基准。漏掉 viewBox 会导致图标被裁切、比例错乱、甚至完全不可见。

使用场景:统一管理图标尺寸,让所有 <use></use> 实例通过 width/height 控制大小,而不依赖原始路径的绝对坐标。

  • <symbol id="home" viewbox="0 0 24 24"><path d="M10 20v-6h4v6h5v-8h-3V7c0-1.7.8-2.7 2.5-2.7 1.1 0 2.1.5 2.5 1.5v1.5c-.5-.5-1.2-.8-2-.8-2.2 0-3.6 1.2-3.6 3.6v2.5h-3v8h5v-8h-1z"></path></symbol>
  • 不要写成 <symbol id="home"></symbol>(无 viewBox)——即使原始 SVG 有 width/height<use></use> 也不会继承这些属性
  • viewBox 数值应与图标实际路径范围一致;可用工具导出时勾选“精简 + 保留 viewBox”

<use></use> 的样式继承行为容易误判

<use></use> 克隆的是结构,不是样式计算结果。它默认继承父容器的 fill/stroke 颜色,但不会继承通过 CSS 类名或复杂选择器设置的样式——除非该样式作用于 <use></use> 自身或其祖先,且未被内联 fill 覆盖。

使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件
使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件

如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Andr​​oid友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Andr​​oid应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更

下载

常见错误:给 <symbol></symbol> 内的 <path></path> 设了 fill="currentColor",但父容器没设 color,结果图标变黑或透明。

  • 推荐写法:<path fill="currentColor" ...></path> + 父元素设 color: #333color: var(--icon-color)
  • 避免在 <symbol></symbol> 里写死 fill="#000",否则 <use></use> 无法通过 CSS 覆盖
  • <use></use> 上加 class 是有效的,但 class 规则需匹配 use > * use path 才能生效(因克隆节点在 shadow DOM-like 机制下生成)

IE11 及更旧浏览器不支持 href 属性,要用 xlink:href

IE11 认可 xlink:href,但不识别标准 href;而 Chrome/Firefox/Safari 已弃用 xlink:href(HTML5 中非必需)。混用会导致验证警告或未来兼容风险。

解决方案不是二选一,而是双写:

<use href="#star" xlink:href="#star"></use>

现代浏览器读 href,IE11 回退读 xlink:href。注意:xlink: 命名空间在 HTML 文档中无需声明,但 XML/SVG 文件中需保留 xmlns:xlink

  • 构建工具(如 webpack + svg-sprite-loader)通常自动处理双写,手动维护时别漏掉
  • Vue/React 等框架中动态绑定 href 时,记得同时绑定 xlink:href(如 Vue 中 :xlink:href="'#' + iconId
  • 不建议用 JS 动态 setAttribute("xlink:href", ...) —— 在 IE11 中可能触发解析异常

真正麻烦的不是语法,是图标系统一旦嵌套多层、带动画或 filter,<use></use> 的实例间会共享引用状态,调试时容易误以为样式没生效,其实是底层 SVG 渲染树复用导致的。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

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

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2574

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

1678

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

1417

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

1365

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

3687

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

1392

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

1151

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

1080

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

1011

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
后盾网smaryt模板引擎视频教程
后盾网smaryt模板引擎视频教程

共14课时 | 2.9万人学习

Smarty模板引擎(布尔教育)
Smarty模板引擎(布尔教育)

共12课时 | 2.5万人学习

Smarty视频教程(传智播客)
Smarty视频教程(传智播客)

共23课时 | 5.6万人学习