<!DOCTYPE html><html lang="zh" data-theme="dark"><head><meta charset="utf-8"><meta name="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1"><title>入门编写 SVG · Cytrogen 的个人博客</title><meta name="description" content="这一切要从我决定重构 https://cytrogen.icu 开始（当你看到这篇文章时，访问该链接就能看到雏形了）。原本它是我的博客网站的地址，后来我想要一个更像是个人网络的设计，即根域名为个人主页，博客网站放在blog子域名上。"><link rel="icon" href="../favicon.png"><link rel="canonical" href="https://blog.cytrogen.icu/posts/a778.html"><link rel="webmention" href="https://webmention.io/blog.cytrogen.icu/webmention"><link rel="me" href="https://gts.cytrogen.icu/@Cytrogen"><link rel="me" href="mailto:blog@cytrogen.icu"><meta name="fediverse:creator" content="@Cytrogen@gts.cytrogen.icu"><link rel="preload" href="../fonts/opensans-regular-latin.woff2" as="font" type="font/woff2" crossorigin="anonymous"><style>@font-face {
font-family: 'Open Sans';
src: url('../fonts/opensans-regular-latin.woff2') format('woff2');
font-weight: 400;
font-style: normal;
font-display: swap;
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
size-adjust: 107%;
ascent-override: 97%;
descent-override: 25%;
line-gap-override: 0%;
}
</style><script>(function() {
try {
// 优先级：用户选择 > 系统偏好 > 默认浅色
const saved = localStorage.getItem('theme');
const theme = saved ||
(window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
document.documentElement.setAttribute('data-theme', theme);
document.documentElement.style.colorScheme = theme;
} catch (error) {
// 失败时使用默认主题，不阻塞渲染
document.documentElement.setAttribute('data-theme', 'light');
}
})();
</script><link rel="stylesheet" href="../css/ares.css"><script data-netlify-skip-bundle="true">(function() {
document.addEventListener('DOMContentLoaded', function() {
const theme = document.documentElement.getAttribute('data-theme');
const pageWrapper = document.getElementById('page-wrapper');
if (pageWrapper && theme) {
pageWrapper.setAttribute('data-theme', theme);
}
});
})();
</script><!-- hexo injector head_end start -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/katex.min.css">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/hexo-math@4.0.0/dist/style.css">
<!-- hexo injector head_end end --><meta name="generator" content="Hexo 8.1.1"><link rel="alternate" href="atom.xml" title="Cytrogen 的个人博客" type="application/atom+xml">
</head><body><div id="page-wrapper"><a class="skip-link" href="#main-content">跳到主要内容</a><div class="wrap"><header><a class="logo-link" href="../index.html"><img src="../favicon.png" alt="logo"></a><div class="h-card visually-hidden"><img class="u-photo" src="https://blog.cytrogen.icu/favicon.png" alt="Cytrogen"><a class="p-name u-url u-uid" href="https://blog.cytrogen.icu">Cytrogen</a><p class="p-note">Cytrogen 的个人博客，Cytrogen's Blog</p><a class="u-url" rel="me noopener" target="_blank" href="https://gts.cytrogen.icu/@Cytrogen">Mastodon</a></div><nav class="site-nav"><div class="nav-main"><div class="nav-primary"><ul class="nav-list hidden-mobile"><li class="nav-item"><a class="nav-link" href="../index.html">首页</a></li></ul><div class="nav-tools"><div class="language-menu"><button class="language-toggle" type="button"><svg class="icon icon-globe" width="16" height="16" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" focusable="false"><path d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8zm7.5-6.923c-.67.204-1.335.82-1.887 1.855A7.97 7.97 0 0 0 5.145 4H7.5V1.077zM4.09 4a9.267 9.267 0 0 1 .64-1.539 6.7 6.7 0 0 1 .597-.933A7.025 7.025 0 0 0 2.255 4H4.09zm-.582 3.5c.03-.877.138-1.718.312-2.5H1.674a6.958 6.958 0 0 0-.656 2.5h2.49zM4.847 5a12.5 12.5 0 0 0-.338 2.5H7.5V5H4.847zM8.5 5v2.5h2.99a12.495 12.495 0 0 0-.337-2.5H8.5zM4.51 8.5a12.5 12.5 0 0 0 .337 2.5H7.5V8.5H4.51zm3.99 0V11h2.653c.187-.765.306-1.608.338-2.5H8.5zM5.145 12c.138.386.295.744.468 1.068.552 1.035 1.218 1.65 1.887 1.855V12H5.145zm.182 2.472a6.696 6.696 0 0 1-.597-.933A9.268 9.268 0 0 1 4.09 12H2.255a7.024 7.024 0 0 0 3.072 2.472zM3.82 11a13.652 13.652 0 0 1-.312-2.5h-2.49c.062.89.291 1.733.656 2.5H3.82zm6.853 3.472A7.024 7.024 0 0 0 13.745 12H11.91a9.27 9.27 0 0 1-.64 1.539 6.688 6.688 0 0 1-.597.933zM8.5 12v2.923c.67-.204 1.335-.82 1.887-1.855A7.97 7.97 0 0 0 10.855 12H8.5zm3.68-1h2.146c.365-.767.594-1.61.656-2.5h-2.49a13.65 13.65 0 0 1-.312 2.5zm2.802-3.5a6.959 6.959 0 0 0-.656-2.5H12.18c.174.782.282 1.623.312 2.5h2.49zM11.27 2.461c.247.464.462.98.64 1.539h1.835a7.024 7.024 0 0 0-3.072-2.472c.218.284.418.598.597.933zM10.855 4a7.966 7.966 0 0 0-.468-1.068C9.835 1.897 9.17 1.282 8.5 1.077V4h2.355z"></path></svg><span>中文</span></button><div class="language-dropdown"></div></div></div><div class="nav-controls"><div class="more-menu hidden-mobile"><button class="more-toggle" type="button"><span>更多</span><svg class="icon icon-chevron-down" width="12" height="12" viewBox="0 0 12 12" fill="currentColor" aria-hidden="true" focusable="false"><path d="M6 8.825c-.2 0-.4-.1-.5-.2l-3.3-3.3c-.3-.3-.3-.8 0-1.1s.8-.3 1.1 0l2.7 2.7 2.7-2.7c.3-.3.8-.3 1.1 0s.3.8 0 1.1l-3.3 3.3c-.1.1-.3.2-.5.2z"></path></svg></button><div class="more-dropdown"><ul class="dropdown-list"><li class="dropdown-item"><a class="nav-link" href="../archives/index.html">归档</a></li><li class="dropdown-item"><a class="nav-link" href="../categories/index.html">分类</a></li><li class="dropdown-item"><a class="nav-link" href="../tags/index.html">标签</a></li><li class="dropdown-item"><a class="nav-link" href="../about/index.html">关于</a></li><li class="dropdown-item"><a class="nav-link" href="../sitemap/index.html">领地地图</a></li></ul></div></div><div class="theme-switcher"><button class="theme-toggle" type="button" role="switch" aria-pressed="false" aria-label="切换主题"><div class="theme-icon moon-icon"><svg class="icon icon-moon" width="16" height="16" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" focusable="false"><path d="M6 .278a.768.768 0 0 1 .08.858 7.208 7.208 0 0 0-.878 3.46c0 4.021 3.278 7.277 7.318 7.277.527 0 1.04-.055 1.533-.16a.787.787 0 0 1 .81.316.733.733 0 0 1-.031.893A8.349 8.349 0 0 1 8.344 16C3.734 16 0 12.286 0 7.71 0 4.266 2.114 1.312 5.124.06A.752.752 0 0 1 6 .278z"></path></svg></div><div class="theme-icon sun-icon"><svg class="icon icon-sun" width="16" height="16" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" focusable="false"><path d="M8 11a3 3 0 1 1 0-6 3 3 0 0 1 0 6zm0 1a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM8 0a.5.5 0 0 1 .5.5v2a.5.5 0 0 1-1 0v-2A.5.5 0 0 1 8 0zm0 13a.5.5 0 0 1 .5.5v2a.5.5 0 0 1-1 0v-2A.5.5 0 0 1 8 13zm8-5a.5.5 0 0 1-.5.5h-2a.5.5 0 0 1 0-1h2a.5.5 0 0 1 .5.5zM3 8a.5.5 0 0 1-.5.5h-2a.5.5 0 0 1 0-1h2A.5.5 0 0 1 3 8zm10.657-5.657a.5.5 0 0 1 0 .707l-1.414 1.415a.5.5 0 1 1-.707-.708l1.414-1.414a.5.5 0 0 1 .707 0zm-9.193 9.193a.5.5 0 0 1 0 .707L3.05 13.657a.5.5 0 0 1-.707-.707l1.414-1.414a.5.5 0 0 1 .707 0zm9.193 2.121a.5.5 0 0 1-.707 0l-1.414-1.414a.5.5 0 0 1 .707-.707l1.414 1.414a.5.5 0 0 1 0 .707zM4.464 4.465a.5.5 0 0 1-.707 0L2.343 3.05a.5.5 0 1 1 .707-.707l1.414 1.414a.5.5 0 0 1 0 .708z"></path></svg></div></button></div><details class="mobile-menu-details hidden-desktop"><summary class="hamburger-menu" aria-label="nav.menu"><svg class="icon icon-bars" width="16" height="16" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" focusable="false"><path d="M2.5 12a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5z"></path></svg><span class="menu-text">nav.menu</span></summary><div class="mobile-menu-dropdown"><ul class="mobile-nav-list"><li class="mobile-nav-item"><a class="mobile-nav-link" href="../index.html">首页</a></li><li class="mobile-nav-item"><a class="mobile-nav-link" href="../archives/index.html">归档</a></li><li class="mobile-nav-item"><a class="mobile-nav-link" href="../categories/index.html">分类</a></li><li class="mobile-nav-item"><a class="mobile-nav-link" href="../tags/index.html">标签</a></li><li class="mobile-nav-item"><a class="mobile-nav-link" href="../about/index.html">关于</a></li><li class="mobile-nav-item"><a class="mobile-nav-link" href="../sitemap/index.html">领地地图</a></li></ul></div></details></div></div></div></nav></header><main class="container" id="main-content" tabindex="-1"><div class="post"><article class="post-block h-entry"><div class="post-meta p-author h-card visually-hidden"><img class="author-avatar u-photo" src="../favicon.png" alt="Cytrogen"><span class="p-name">Cytrogen</span><a class="u-url" href="https://blog.cytrogen.icu">https://blog.cytrogen.icu</a></div><a class="post-permalink u-url u-uid visually-hidden" href="https://blog.cytrogen.icu/posts/a778.html">永久链接</a><div class="p-summary visually-hidden"><p>这一切要从我决定重构 <a target="_blank" rel="noopener" href="https://cytrogen.icu">https://cytrogen.icu</a> 开始（当你看到这篇文章时，访问该链接就能看到雏形了）。原本它是我的博客网站的地址，后来我想要一个更像是个人网络的设计，即根域名为个人主页，博客网站放在<code>blog</code>子域名上。</p></div><div class="visually-hidden"><a class="p-category" href="../categories/%E7%BC%96%E7%A8%8B%E7%AC%94%E8%AE%B0/">编程笔记</a><a class="p-category" href="../tags/SVG/">SVG</a></div><a class="u-syndication visually-hidden" target="_blank" rel="noopener" href="https://m.otter.homes/@Cytrogen/116213158025580840">https://m.otter.homes/@Cytrogen/116213158025580840</a><h1 class="post-title p-name">入门编写 SVG</h1><div class="post-info"><time class="post-date dt-published" datetime="2026-03-11T04:00:00.000Z">3/11/2026</time><time class="dt-updated visually-hidden" datetime="2026-03-11T23:34:26.946Z"></time></div><div class="post-content e-content"><html><head></head><body><p>这一切要从我决定重构 <a target="_blank" rel="noopener" href="https://cytrogen.icu">https://cytrogen.icu</a> 开始（当你看到这篇文章时，访问该链接就能看到雏形了）。原本它是我的博客网站的地址，后来我想要一个更像是个人网络的设计，即根域名为个人主页，博客网站放在 <code>blog</code> 子域名上。</p>
<span id="more"></span>
<p>个人主页、个人主页…… 怎么样的个人主页更能展示出我的「个性」呢？除了 <a href="/posts/c089.html#%E7%BA%AF%E6%96%87%E6%9C%AC%E7%BD%91%E7%AB%99%E7%9A%84%E5%B0%8F%E5%9E%8B%E5%90%88%E9%9B%86">先前</a> 介绍的 <code>ellesho.me</code> 外，我还看了 Hacker News 的这个 <a target="_blank" rel="noopener" href="https://news.ycombinator.com/item?id=46618714">帖子</a>，里面有许多设计非常有趣的个人主页，不过博客网站依然偏多。不是对博客网站有任何意见，只是我认为，我不需要另一个以文本为主的网络载体：我已经有了博客网站，还有了只能显示文字的胶囊。</p>
<p>这就需要说到 Web 最为特殊的东西了：HTML、CSS 和 JavaScript。既然是 Web 上搭建的站点，不玩玩这三剑客又怎么行呢？当然，这也不意味着我的个人主页就会充满了 JavaScript、把访问者的设备卡到无法动弹。我依然会遵循「极简 JavaScript」的原则，来完成它。</p>
<p>小时候游玩过的 Flash 小游戏，让我想要实现类似的内容。不知道读者们有没有玩过 <em> Reincarnation</em> 这款点击解密 Flash 游戏呢？4399 游戏平台将其翻译为《地狱使者》，不过我认为失去了原标题「轮回」的意味。总之它是一款原先发布在 <a target="_blank" rel="noopener" href="https://www.newgrounds.com/series/reincarnation">NEWGROUNDS 平台</a> 上的游戏，由 Chris Gianelloni 开发。故事讲的是地狱中逃出去了许多鬼魂，主角小恶魔受地狱之王撒旦指使，要去人间找到这些死人、定他们的罪，最后靠解密让他们「意外」身亡 —— 为什么小时候的我喜欢这种血腥的游戏啊？不过主角小恶魔我觉得很可爱，还是个被迫工作的打工人，经常光着身子撅着个腚走来走去。</p>
<p>当时的 Flash 游戏，这种玩法单纯依赖于鼠标点击的有很多，比方说各种类宝可梦的网游、《华纳史诗冒险系列》（<em>Steppenwolf: The X-Creatures Project</em>）都是如此。我也想一个类似的个人主页！</p>
<p>使用 Flash 技术肯定是不可能的了。我也不打算将个人主页做成一款网页游戏，不过一些游戏元素还是可以接受的…… 但这篇文章并不会涉及到这一方面，为什么呢，因为我还没有开始设计和编写。就像标题所说的，该文章的重点在于 <em> SVG</em> 这项技术。</p>
<h3 id="了解-svg"><a class="markdownIt-Anchor" href="#了解-svg"></a> 了解 SVG</h3>
<p>SVG 的全称叫作 <em> Scalable Vector Graphics</em>，即 <u>可缩放矢量图形</u>。它是基于 XML 格式的图像格式，用于描述 <u>二维矢量图形</u>。</p>
<p>说这么多术语以及模糊的概念，大家可能无法很好地明白，我就先来讲解一下计算机里、图形到底是什么吧。<strong>图形本质上是数据的可视化量现</strong>。为了在屏幕上准确呈现这些视觉信息，计算机需要依赖一套特定的编码规则或者说数据格式来解析信息，而这一切大致可以分为两个分支：位图与矢量。</p>
<p><u>位图图形</u>（bitmap），也被称为 <u>栅格图形</u>（raster graphics），核心结构是由像素点（pixel）排列而成的矩形网格，而像素是数字显示设备上能够被独立控制色彩与亮度的最小物理发光单元。大家熟知的 JPEG、PNG 等，都是位图图形的格式。当计算机系统渲染一张 JPEG 文件时，它读取的其实是二维数据表 —— 表会记录该特定尺寸网格中，每一个坐标位置上像素的具体色彩值。</p>
<p>不过位图有个大问题：依赖分辨率。因为图像的信息由固定数量的像素点强行绑定，一旦图像被放大、网格被拉伸，计算机就必须运行插值算法，根据原有相邻像素的颜色去推算并凭空生成新的像素来填补填充后的物理面积。作为一个例子，你可以打开任何一个位图编辑器，比方说 Windows 系统的 Paint 软件，在上面随便画点什么，接着将其选中、拉伸，你就能看到许多突然多出的锯齿状像素方块。</p>
<p>而 <u>矢量图</u>（vector）抛弃了像素网格的概念，转而使用数学公式和几何图元来描述图像。一组由起点坐标、终点坐标、线条粗细和颜色属性共同构成的数学指令，就能在矢量体系中画出一条直线。当矢量图被放大后，计算机会将新的缩放比例代入原有的数学公式中，重新计算并在屏幕上实时绘制出新的图像，从而让矢量图无论怎么放大，都能让边缘保持锐利。</p>
<p>在互联网普及之前，计算机图形学领域便已经存在成熟的矢量技术：用于打印排版的 PostScript、CAD 软件和 Adobe Illustrator 等专业绘图工具使用的专用格式…… 二十世纪九十年代末，万维网面临着严重的带宽限制和多样的终端显示器分辨率。位图格式在传输高质量大尺寸图像时，会导致文件体积急剧膨胀，且有着先前提到过的、极差的不同分辨率下的缩放表现。矢量图本应该是解决这一问题的完美方案，但是当时的矢量格式大多是编译后的二进制数据，且被各家商业公司作为技术壁垒严格封闭。</p>
<p>如果将早期 Macromedia Flash 或各类专有矢量文件直接嵌入网页，浏览器无法原生解析这些数据，用户必须下载并安装特定的第三方插件。这些二进制文件对于网页的底层结构而言，也有着许多问题：搜索引擎的爬虫无法读取其中的文本内容，网页开发者也无法使用 JavaScript 去捕获图形内部的元素并产生交互。</p>
<p>W3C（万维网联盟）认为，互联网需要一种属于自己的、非专有的、且与现有 Web 技术栈深度融合的矢量图形标准。业界纷纷向 W3C 提交关于 Web 矢量图形的提案，其中最具代表性的分别是 VML（Vector Markup Language）和 PGML（Precision Graphics Markup Language）。它们都试图建立基于 XML 的图形描述规范。</p>
<p>而 W3C…… 哪个都没选，反而成立专门的图形工作组，吸收了这两种方案的优势、想出了 SVG 规范。</p>
<p>因为 SVG 被设计为纯粹的 XML 文本，因此顺理成章成为了 DOM 树的一部分。网页浏览器不需要插件也能利用内置的渲染引擎对其进行解析，同时图形中的每一条路径、形状都成为了可被精确寻址的 DOM 节点。可喜可贺，可喜可贺。</p>
<h3 id="写-svg"><a class="markdownIt-Anchor" href="#写-svg"></a> 写 SVG</h3>
<p>在我的计划里，我的个人主页所会用到的矢量图形并不复杂。没有描边的大色块有着自己的魅力。</p>
<p>用 SVG 来写只需要知道这五个元素：</p>
<ul>
<li><code><rect></code></li>
<li><code><circle></code></li>
<li><code><polygon></code></li>
<li><code><path></code></li>
<li><code><text></code></li>
</ul>
<p>SVG 应用的是直角坐标系，原点 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo stretchy="false">(</mo><mn>0</mn><mo separator="true">,</mo><mn>0</mn><mo stretchy="false">)</mo></mrow><annotation encoding="application/x-tex">(0,0)</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mopen">(</span><span class="mord">0</span><span class="mpunct">,</span><span class="mspace" style="margin-right:0.16666666666666666em;"></span><span class="mord">0</span><span class="mclose">)</span></span></span></span> 位于画布的左上角，X 轴向右延伸，Y 轴向下延伸。所有的几何图元都基于这个网格定位与绘制。</p>
<p>对于矩形 <code><rect></code> 元素，核心属性分别是：</p>
<ul>
<li><code>x</code> 和 <code>y</code>，用于确定矩形左上角顶点的精确坐标</li>
<li><code>width</code> 和 <code>height</code>，分别定义矩形在水平方向和垂直方向上的标量跨度</li>
<li><code>rx</code> 和 <code>ry</code>，指定圆角的水平和垂直半径</li>
</ul>
<p>圆形 <code><circle></code> 元素的逻辑基于圆心的半径：</p>
<ul>
<li><code>cx</code> 和 <code>cy</code>，标记圆心在坐标系中的绝对位置</li>
<li><code>r</code>，设定原的半径长度</li>
</ul>
<p>多边形 <code><polygon></code> 元素用于绘制由直线段连接而成的闭合形状：</p>
<ul>
<li>核心 <code>points</code> 属性，在接收一系列坐标对，每个坐标对代表多边形的一个几何顶点。渲染引擎会按照坐标的书写顺序，依次用直线将这些点连接起来，并自动将最后一个点与第一个点连接以闭合图形</li>
</ul>
<p>作为一个例子：<code><polygon points="50,15 100,100 0,100" /></code> 画出的是三角形。</p>
<p>文本 <code><text></code> 元素将字符数据引入矢量画布。与常规 HTML 中的文本排版不同，SVG 文本需要严格的空间绝对定位：</p>
<ul>
<li><code>x</code> 和 <code>y</code> 属性并不代表文本块的左上角，而是文本基线的起点位置。字号、字体族等排版属性需要通过 CSS 或内联属性进行声明</li>
</ul>
<p><code><path></code> 元素很常用：</p>
<ul>
<li><code>d</code> 属性是一系列微型绘图指令的集合：
<ul>
<li><code>M x y</code> 指令负责抬起虚拟画笔并移动到指定的 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo stretchy="false">(</mo><mi>x</mi><mo separator="true">,</mo><mi>y</mi><mo stretchy="false">)</mo></mrow><annotation encoding="application/x-tex">(x,y)</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mopen">(</span><span class="mord mathnormal">x</span><span class="mpunct">,</span><span class="mspace" style="margin-right:0.16666666666666666em;"></span><span class="mord mathnormal" style="margin-right:0.03588em;">y</span><span class="mclose">)</span></span></span></span> 坐标，通常作为路径的初始起笔指令</li>
<li><code>L x y</code> 指令表示从当前画笔位置绘制一条绝对直线到新的 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo stretchy="false">(</mo><mi>x</mi><mo separator="true">,</mo><mi>y</mi><mo stretchy="false">)</mo></mrow><annotation encoding="application/x-tex">(x,y)</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mopen">(</span><span class="mord mathnormal">x</span><span class="mpunct">,</span><span class="mspace" style="margin-right:0.16666666666666666em;"></span><span class="mord mathnormal" style="margin-right:0.03588em;">y</span><span class="mclose">)</span></span></span></span> 坐标</li>
<li><code>Q x1 y1, x y</code> 指令绘制二次贝塞尔曲线。其中 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo stretchy="false">(</mo><msub><mi>x</mi><mn>1</mn></msub><mo separator="true">,</mo><msub><mi>y</mi><mn>1</mn></msub><mo stretchy="false">)</mo></mrow><annotation encoding="application/x-tex">(x_1, y_1)</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mopen">(</span><span class="mord"><span class="mord mathnormal">x</span><span class="msupsub"><span class="vlist-t vlist-t2"><span class="vlist-r"><span class="vlist" style="height:0.30110799999999993em;"><span style="top:-2.5500000000000003em;margin-left:0em;margin-right:0.05em;"><span class="pstrut" style="height:2.7em;"></span><span class="sizing reset-size6 size3 mtight"><span class="mord mtight">1</span></span></span></span><span class="vlist-s"></span></span><span class="vlist-r"><span class="vlist" style="height:0.15em;"><span></span></span></span></span></span></span><span class="mpunct">,</span><span class="mspace" style="margin-right:0.16666666666666666em;"></span><span class="mord"><span class="mord mathnormal" style="margin-right:0.03588em;">y</span><span class="msupsub"><span class="vlist-t vlist-t2"><span class="vlist-r"><span class="vlist" style="height:0.30110799999999993em;"><span style="top:-2.5500000000000003em;margin-left:-0.03588em;margin-right:0.05em;"><span class="pstrut" style="height:2.7em;"></span><span class="sizing reset-size6 size3 mtight"><span class="mord mtight">1</span></span></span></span><span class="vlist-s"></span></span><span class="vlist-r"><span class="vlist" style="height:0.15em;"><span></span></span></span></span></span></span><span class="mclose">)</span></span></span></span> 是控制点，<span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo stretchy="false">(</mo><mi>x</mi><mo separator="true">,</mo><mi>y</mi><mo stretchy="false">)</mo></mrow><annotation encoding="application/x-tex">(x,y)</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mopen">(</span><span class="mord mathnormal">x</span><span class="mpunct">,</span><span class="mspace" style="margin-right:0.16666666666666666em;"></span><span class="mord mathnormal" style="margin-right:0.03588em;">y</span><span class="mclose">)</span></span></span></span> 是整段曲线的最终物理端点</li>
<li><code>Z</code> 指令没有参数。当它出现在路径数据的末尾时，渲染引擎会自动从当前所在坐标绘制一条直线，径直连回当前子路径的起始点，即上一个 <code>M</code> 指令所在的坐标</li>
</ul>
</li>
</ul>
<p>知道了这些后，我便可以一步步绘制出，我的个人主页的内容了！</p>
<p>首先，我希望我的个人主页有一个开场动画：一面山羊头骨为中心的墙，短暂呈现一段时间后，从中间垂直地打开，展示后面的城堡。那么这个墙要怎么画呢？</p>
<p>先定义一下结构：</p>
<figure class="highlight css"><table><tbody><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line"><<span class="selector-tag">div</span> class="skull-<span class="attribute">overlay</span>" aria-hidden="true"></span><br><span class="line"> <<span class="selector-tag">svg</span> class="skull" viewBox="-<span class="number">200</span> -<span class="number">250</span> <span class="number">800</span> <span class="number">1000</span>" preserveAspectRatio="xMidYMidslice"></span><br><span class="line"> <<span class="selector-tag">g</span> class="skull-<span class="attribute">bottom</span>"></span><br><span class="line"> </<span class="selector-tag">g</span>></span><br><span class="line"> <<span class="selector-tag">g</span> class="skull-<span class="attribute">top</span>"></span><br><span class="line"> </<span class="selector-tag">g</span>></span><br><span class="line"> </<span class="selector-tag">svg</span>></span><br><span class="line"></<span class="selector-tag">div</span>></span><br></pre></td></tr></tbody></table></figure>
<p>在最外层的 <code><svg></code> 容器中（实际最外层的 <code>div</code> 仅作动画用，在写 SVG 的情况下并不需要管），视口属性 <code>viewBox="-200 -250 800 1000"</code> 意味着起始点在于 X 轴的 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo>−</mo><mn>200</mn></mrow><annotation encoding="application/x-tex">-200</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:0.72777em;vertical-align:-0.08333em;"></span><span class="mord">−</span><span class="mord">2</span><span class="mord">0</span><span class="mord">0</span></span></span></span> 和 Y 轴的 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo>−</mo><mn>250</mn></mrow><annotation encoding="application/x-tex">-250</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:0.72777em;vertical-align:-0.08333em;"></span><span class="mord">−</span><span class="mord">2</span><span class="mord">5</span><span class="mord">0</span></span></span></span>，整体的宽度设定为 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mn>800</mn></mrow><annotation encoding="application/x-tex">800</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:0.64444em;vertical-align:0em;"></span><span class="mord">8</span><span class="mord">0</span><span class="mord">0</span></span></span></span>，高度设定为 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mn>1000</mn></mrow><annotation encoding="application/x-tex">1000</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:0.64444em;vertical-align:0em;"></span><span class="mord">1</span><span class="mord">0</span><span class="mord">0</span><span class="mord">0</span></span></span></span>。</p>
<p><code>preserveAspectRatio="xMidYMidslice"</code> 属性是适配规则，强制 SVG 在容器尺寸变化时保持自身比例缩放，且会裁剪掉超出容器边缘的部分，以确保画面始终完全填满视口、不发生形变。</p>
<p>由于 SVG 遵循着从上到下的文档流渲染顺序，实际带有山羊头骨的上半部分墙需要在下半部分墙之后定义。现在让我们先完成下半部分墙的内容。</p>
<p><code><g></code> 是群组元素，可以在内部添加数个 SVG 元素来组合起来。对于下半部分墙，我们只需要一个 <code><rect></code> 元素，但为了统一性，还是放入群组内：</p>
<figure class="highlight css"><table><tbody><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><<span class="selector-tag">g</span> class="skull-buttom"></span><br><span class="line"> <<span class="selector-tag">rect</span> class="<span class="attribute">fill</span>-wall-dark" <span class="attribute">x</span>="-<span class="number">200</span>" <span class="attribute">y</span>="<span class="number">250</span>" <span class="attribute">width</span>="<span class="number">800</span>" <span class="attribute">height</span>="<span class="number">500</span>" /></span><br><span class="line"></<span class="selector-tag">g</span>></span><br></pre></td></tr></tbody></table></figure>
<p>除了高度外，其他内容都和视口属性相同，因为需要填满整个画面。高度则是视口高度的一半，毕竟是「下半部分」。</p>
<p>接下来让我们绘制上半部分墙。在我的构造里，这个墙在画面中心还会有一个山羊头骨，在绘制时需要先画墙、山羊头骨、头骨细节。先画墙：</p>
<figure class="highlight css"><table><tbody><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"><<span class="selector-tag">g</span> class="skull-<span class="attribute">top</span>"></span><br><span class="line"> <<span class="selector-tag">rect</span> class="<span class="attribute">fill</span>-wall-dark" <span class="attribute">x</span>="-<span class="number">200</span>" <span class="attribute">y</span>="-<span class="number">250</span>" <span class="attribute">width</span>="<span class="number">800</span>" <span class="attribute">height</span>="<span class="number">500</span>" /></span><br><span class="line"></<span class="selector-tag">g</span>></span><br></pre></td></tr></tbody></table></figure>
<p>接着绘制一个山羊头骨的剪影：</p>
<figure class="highlight css"><table><tbody><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line"><<span class="selector-tag">path</span> class="<span class="attribute">fill</span>-skull" d="</span><br><span class="line"> M175 <span class="number">380</span> L158 <span class="number">340</span> L138 <span class="number">290</span> L125 <span class="number">245</span></span><br><span class="line"> L130 <span class="number">200</span> L155 <span class="number">170</span> L200 <span class="number">158</span></span><br><span class="line"> L245 <span class="number">170</span> L270 <span class="number">200</span> L275 <span class="number">245</span></span><br><span class="line"> L262 <span class="number">290</span> L242 <span class="number">340</span> L225 <span class="number">380</span> Z</span><br><span class="line"> "></span><br></pre></td></tr></tbody></table></figure>
<p>起初点 <code>M175 380</code> 是头骨吻部的左侧底端，随后用 <code>L</code> 指令向上描绘头骨的左侧边缘：<code>L158 340 L138 290 L125 245 L130 200 L155 170</code>。可以观察出，它们的 X 坐标先减小后增大，因为我想先画出从吻部向外扩张到颧骨，再到头顶时向内收缩。而 Y 坐标一直在减少，因为我们是从左下角开始画、要画到头顶的。</p>
<p>跨过中心点 <code>L200 158</code> 后，再描绘头骨的右侧边缘：<code>L245 170 L270 200 L275 245 L262 290 L242 340 L225 380</code>。和画头骨左侧的路线相反，Y 坐标一直在变大，X 坐标则是先增大再减少，直至吻部的右侧底端（看 Y 坐标，和起始点的 Y 坐标一致）。最终用一个 <code>Z</code> 指令将它们两个点用一条直线相连。</p>
<p>想要填充头骨颜色的话，在 CSS 类 <code>.fill-skull</code> 里设置即可。</p>
<p>山羊头骨的大致形状写完后，我们还需要写两个眼洞和角。其中眼洞的写法和头骨剪影一致，都是用直线勾出形状，这里只说角的写法吧。</p>
<p>我想要这个角具有弧度，因此需要引入二次贝塞尔曲线。二次贝塞尔曲线需要三个关键点：</p>
<ol>
<li>起点</li>
<li>控制点</li>
<li>终点</li>
</ol>
<p>控制点本身不位于最终渲染的曲线上，但起到了类似于引力的作用，将起点到终点的连线向自身方向拉扯，从而形成特定的弧度。</p>
<p><img src="/posts/a778/curvequad.png" alt=""></p>
<p>图片来自 <a target="_blank" rel="noopener" href="https://svgpocketguide.com/">Pocket Guide to Writing SVG</a>。</p>
<p>用这张图片来看，会更直观些吧。</p>
<p>左侧角的绘制从 <code>M130 205</code> 开始，确立了角与颅骨左侧的连接基点。随后 <code>Q70 170 35 110</code> 勾勒角的外侧边缘。这里的曲线从坐标 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo stretchy="false">(</mo><mn>130</mn><mo separator="true">,</mo><mn>205</mn><mo stretchy="false">)</mo></mrow><annotation encoding="application/x-tex">(130,205)</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mopen">(</span><span class="mord">1</span><span class="mord">3</span><span class="mord">0</span><span class="mpunct">,</span><span class="mspace" style="margin-right:0.16666666666666666em;"></span><span class="mord">2</span><span class="mord">0</span><span class="mord">5</span><span class="mclose">)</span></span></span></span> 开始，向 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo stretchy="false">(</mo><mn>35</mn><mo separator="true">,</mo><mn>110</mn><mo stretchy="false">)</mo></mrow><annotation encoding="application/x-tex">(35,110)</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mopen">(</span><span class="mord">3</span><span class="mord">5</span><span class="mpunct">,</span><span class="mspace" style="margin-right:0.16666666666666666em;"></span><span class="mord">1</span><span class="mord">1</span><span class="mord">0</span><span class="mclose">)</span></span></span></span> 延伸，同时受到位于左上方的控制点 <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo stretchy="false">(</mo><mn>70</mn><mo separator="true">,</mo><mn>170</mn><mo stretchy="false">)</mo></mrow><annotation encoding="application/x-tex">(70,170)</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mopen">(</span><span class="mord">7</span><span class="mord">0</span><span class="mpunct">,</span><span class="mspace" style="margin-right:0.16666666666666666em;"></span><span class="mord">1</span><span class="mord">7</span><span class="mord">0</span><span class="mclose">)</span></span></span></span> 的牵引。结果便是曲线先向左侧外扩，随后向左上方收束。到达角尖最高点附近时，<code>L65 95</code> 封闭角的顶端，再用 <code>Q85 145 145 180</code> 画角的内侧边缘。右侧角就不用说了，是完全镜像的。</p>
<h3 id="更复杂的-svg"><a class="markdownIt-Anchor" href="#更复杂的-svg"></a> 更复杂的 SVG</h3>
<p>到这里，你或许会想，这样写 SVG 好累。我不否认。人类的大脑并不擅长于直观构建二维坐标系内的形状，尤其是过于复杂的形状。一个解决方案是使用更抽象的工具：可视化矢量图形编辑器。</p>
<p>我高中时学习了 Adobe Illustrator 的使用方式，或许其他的编辑器也是一样的。绘制路径时，往往都会有操作锚点、控制手柄等工具。底层图形引擎会实时计算这些交互动作对应的绝对，或相对的坐标，并能够精准地生成所需的二次，甚至是三次贝塞尔曲线指令。</p>
<p>不过 Adobe 的东西都很昂贵。Inkscape 是开源的替代品，可以尝试。据说 Figma 也能够绘画矢量图形。它们都可以将结果导出为标准的 SVG 代码。</p>
<p>如果想要画重复性高的 SVG 图形，也可以通过编写脚本来动态连接路径数据。比方说 <a target="_blank" rel="noopener" href="https://github.com/d3/d3">d3.js</a> 这个项目，就能实现一个很有意思的 <a target="_blank" rel="noopener" href="https://github.com/d3/d3">例子</a>。</p>
<p>再就是，在传统开发模式中，SVG 往往被视为等同于 PNG 或 JPEG 的静态外部资源。一旦在矢量编辑器中完成绘制并导出为 XML 代码，其内部的节点结构、填充颜色、描边参数以及路径坐标种种，都被硬编码锁定了。</p>
<p>怎么解决呢？现代前端开发体系，比如 React 和 Vue，引入了组件化封装与声明式抽象，本质上是将静态的 XML 标记解析为虚拟 DOM 树上的节点。这样的话，SVG 就被包装成了个能够接收外部参数的函数或类组件。</p>
</body></html></div></article></div></main><footer><div class="paginator"><a class="prev" href="7ae3.html">上一篇</a><a class="next" href="e3b9.html">下一篇</a></div><!-- Webmention 显示区域--><div class="webmention-section" data-page-url="posts/a778.html" data-full-url="https://blog.cytrogen.icu/posts/a778.html" data-syndication-url="https://m.otter.homes/@Cytrogen/116213158025580840" data-mode="static">
<script type="application/json" class="webmention-overrides-data">{"bySourceDomain":{"v1sta.xyz":{"name":"远景幻想 V1STA","url":"https://v1sta.xyz/","photo":"https://v1sta.xyz/wp-content/uploads/2026/03/V1sta-Orb-Output512-2.png"}}}</script>
<h3 class="webmention-title">Webmentions (<span class="webmention-count">2</span>)</h3><form class="webmention-form" action="https://webmention.io/blog.cytrogen.icu/webmention" method="POST">
<input type="hidden" name="target" value="https://blog.cytrogen.icu/posts/a778.html">
<label for="webmention-source">你的文章 URL</label>
<div class="webmention-form-row">
<input id="webmention-source" type="url" name="source" placeholder="https://example.com/your-post" required>
<button type="submit">发送 Webmention</button>
</div>
</form><div class="webmention-respond">
<a class="webmention-respond-btn" href="https://m.otter.homes/@Cytrogen/116213158025580840" target="_blank" rel="noopener syndication">在 Mastodon 上回应本文</a>
</div><div class="webmention-group webmention-group-likes"><div class="webmention-compact-list"><a class="webmention-compact-item" href="https://mstdn.feddit.social/@admin" target="_blank" rel="noopener ugc" title="KIP/JΛYCHØU ⁂ :neocat_cofe:"><img class="webmention-compact-photo" src="https://avatars.webmention.io/media.otter.homes/b3a5ebdc7764c92d0a28a39ee05451f98685bd5f10185dc981856443952aa13c.png" alt="KIP/JΛYCHØU ⁂ :neocat_cofe:" title="KIP/JΛYCHØU ⁂ :neocat_cofe:" loading="lazy"></a><span class="webmention-compact-label">(1) 喜欢了这篇文章</span></div></div><div class="webmention-group webmention-group-mentions"><h4 class="webmention-group-title">提及 (1)</h4><div class="webmention-list">
<div class="webmention-item" id="webmention-1988111" data-webmention-id="1988111">
<div class="webmention-author">
<img class="webmention-author-photo" src="https://v1sta.xyz/wp-content/uploads/2026/03/V1sta-Orb-Output512-2.png" alt="远景幻想 V1STA" loading="lazy">
<a class="webmention-author-name" href="https://v1sta.xyz/" target="_blank" rel="noopener ugc">远景幻想 V1STA</a>
<span class="webmention-date">2026/4/1</span>
</div>
<div class="webmention-content">
In reply to <a class="u-url p-name" href="https://blog.cytrogen.icu/posts/a778.html">入门编写 SVG · Cytrogen 的个人博客</a> . 很有意思的文章 https://blog.cytrogen.icu/posts/a778.html 和个人主页网站！仿佛让我有一种回到了2000年代的纯粹好奇的第一次接触小游戏的感觉，这有别于Frutiger Aero的美学风潮，我已经很久没有接触到让我大开眼界的新奇事物了。 我是一位密室逃脱类游戏爱好者，这令我想起当…
</div>
<div class="webmention-meta">
<a class="webmention-source" href="https://v1sta.xyz/life/%e5%9b%9e%e5%a4%8d%ef%bc%9a%e5%85%a5%e9%97%a8%e7%bc%96%e5%86%99-svg/" target="_blank" rel="noopener ugc">查看原文</a>
</div>
</div></div></div><p class="webmention-hint">本站支持 <a href="https://www.w3.org/TR/webmention/" target="_blank" rel="noopener">Webmention</a>。你可以在 Fediverse（如 Mastodon）上回应本文的联合链接，互动会自动出现在此处。<a href="/colophon/#webmention">详情见营造记</a>。</p></div><!-- 邮件评论--><div class="email-comment-section email-comment-loading" data-post-id="a778" data-blog-domain="blog.cytrogen.icu">
<h3 class="email-comment-title">邮件评论 (<span class="email-comment-count">0</span>)</h3>
<p class="email-comment-intro">通过邮件参与讨论：<a href="mailto:post-a778@blog.cytrogen.icu" aria-label="通过邮件发送评论">post-a778@blog.cytrogen.icu</a></p>
<p class="email-comment-empty">还没有邮件评论。</p>
<p class="email-comment-hint">发送邮件到上方地址即可评论。你的名字会公开显示，但邮箱地址不会。</p>
</div><script src="/js/email-comment.js" defer></script><div class="copyright"><p class="footer-links"><a href="../friends/index.html">友链</a><span class="footer-separator"> ·</span><a href="../links/index.html">邻邦</a><span class="footer-separator"> ·</span><a href="../contact/index.html">联络</a><span class="footer-separator"> ·</span><a href="../colophon/index.html">营造记</a><span class="footer-separator"> ·</span><a href="../atom.xml">RSS订阅</a></p><p>© 2025 - 2026 <a href="https://blog.cytrogen.icu">Cytrogen</a>, powered by <a href="https://hexo.io/" target="_blank">Hexo</a> and <a href="https://github.com/cytrogen/hexo-theme-ares" target="_blank">hexo-theme-ares</a>.</p><p><a href="https://blogscn.fun" target="_blank" rel="noopener">BLOGS·CN</a></p></div></footer></div></div><a class="back-to-top" href="#top" aria-label="返回顶部"><svg width="20" height="20" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true"><path d="M3.293 9.707a1 1 0 010-1.414L9.586 2a2 2 0 012.828 0l6.293 6.293a1 1 0 01-1.414 1.414L11 3.414V17a1 1 0 11-2 0V3.414L2.707 9.707a1 1 0 01-1.414 0z"></path></svg></a><script>document.addEventListener('DOMContentLoaded', function() {
const codeBlocks = document.querySelectorAll('figure.highlight');
codeBlocks.forEach(block => {
let caption = block.querySelector('figcaption');
if (!caption) {
caption = document.createElement('figcaption');
block.insertBefore(caption, block.firstChild);
}
const info = document.createElement('div');
info.className = 'info';
const filename = caption.querySelector('span');
if (filename) {
filename.className = 'filename';
info.appendChild(filename);
}
const lang = block.className.split(' ')[1];
if (lang) {
const langSpan = document.createElement('span');
langSpan.className = 'lang-name';
langSpan.textContent = lang;
info.appendChild(langSpan);
}
const sourceLink = caption.querySelector('a');
if (sourceLink) {
sourceLink.className = 'source-link';
info.appendChild(sourceLink);
}
const actions = document.createElement('div');
actions.className = 'actions';
const codeHeight = block.scrollHeight;
const threshold = 300;
if (codeHeight > threshold) {
block.classList.add('folded');
const toggleBtn = document.createElement('button');
toggleBtn.textContent = '展开';
toggleBtn.addEventListener('click', () => {
block.classList.toggle('folded');
toggleBtn.textContent = block.classList.contains('folded') ? '展开' : '折叠';
});
actions.appendChild(toggleBtn);
}
const copyBtn = document.createElement('button');
copyBtn.textContent = '复制';
copyBtn.addEventListener('click', async () => {
const codeLines = block.querySelectorAll('.code .line');
const code = Array.from(codeLines)
.map(line => line.textContent)
.join('\n')
.replace(/\n\n/g, '\n');
try {
await navigator.clipboard.writeText(code);
copyBtn.textContent = '已复制';
copyBtn.classList.add('copied');
setTimeout(() => {
copyBtn.textContent = '复制';
copyBtn.classList.remove('copied');
}, 3000);
} catch (err) {
console.error('复制失败:', err);
copyBtn.textContent = '复制失败';
setTimeout(() => {
copyBtn.textContent = '复制';
}, 3000);
}
});
actions.appendChild(copyBtn);
caption.innerHTML = '';
caption.appendChild(info);
caption.appendChild(actions);
const markedLines = block.getAttribute('data-marked-lines');
if (markedLines) {
const lines = markedLines.split(',');
lines.forEach(range => {
if (range.includes('-')) {
const [start, end] = range.split('-').map(Number);
for (let i = start; i <= end; i++) {
const line = block.querySelector(`.line-${i}`);
if (line) line.classList.add('marked');
}
} else {
const line = block.querySelector(`.line-${range}`);
if (line) line.classList.add('marked');
}
});
}
});
});</script><script async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js" id="MathJax-script"></script><script>(function() {
document.addEventListener('DOMContentLoaded', function() {
const themeToggle = document.querySelector('.theme-toggle');
if (!themeToggle) return;
const getCurrentTheme = () => {
return document.documentElement.getAttribute('data-theme') || 'light';
};
const updateUI = (theme) => {
const isDark = theme === 'dark';
themeToggle.setAttribute('aria-pressed', isDark.toString());
};
const setTheme = (theme) => {
document.documentElement.setAttribute('data-theme', theme);
document.documentElement.style.colorScheme = theme;
const pageWrapper = document.getElementById('page-wrapper');
if (pageWrapper) {
pageWrapper.setAttribute('data-theme', theme);
}
// Find and remove the temporary anti-flicker style tag if it exists.
// This ensures the main stylesheet takes full control after the initial load.
const antiFlickerStyle = document.getElementById('anti-flicker-style');
if (antiFlickerStyle) {
antiFlickerStyle.remove();
}
localStorage.setItem('theme', theme);
updateUI(theme);
};
const toggleTheme = () => {
const current = getCurrentTheme();
const newTheme = current === 'light' ? 'dark' : 'light';
setTheme(newTheme);
};
updateUI(getCurrentTheme());
themeToggle.addEventListener('click', toggleTheme);
if (window.matchMedia) {
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
mediaQuery.addEventListener('change', function(e) {
if (!localStorage.getItem('theme')) {
const theme = e.matches ? 'dark' : 'light';
setTheme(theme);
}
});
}
});
})();
</script><script src="../js/details-toggle.js" defer></script><script>(function() {
document.addEventListener('DOMContentLoaded', function() {
const backToTopBtn = document.querySelector('.back-to-top');
if (!backToTopBtn) return;
const toggleButtonVisibility = () => {
const scrollTop = window.pageYOffset || document.documentElement.scrollTop;
const shouldShow = scrollTop > 200;
if (shouldShow) {
backToTopBtn.classList.add('is-visible');
} else {
backToTopBtn.classList.remove('is-visible');
}
};
let ticking = false;
const handleScroll = () => {
if (!ticking) {
requestAnimationFrame(() => {
toggleButtonVisibility();
ticking = false;
});
ticking = true;
}
};
const scrollToTop = (event) => {
event.preventDefault();
window.scrollTo({
top: 0,
behavior: 'smooth'
});
};
window.addEventListener('scroll', handleScroll);
backToTopBtn.addEventListener('click', scrollToTop);
toggleButtonVisibility();
});
})();</script></body></html>