很多站点都会放一个下载入口:桌面用户点按钮直接下,手机用户扫码拿。想法很好,但这段代码有个一眼看不出来、用一次就露馅的问题——右边那个二维码是画出来的,扫不出任何东西。
这不是"样式不够精致"的问题,是功能根本不成立:读者拿手机对着它扫半天,什么也扫不出来,只会以为自己手机坏了。
下面每块都能点「预览效果」直接看。修复版里那个二维码是真的,你可以直接用手机扫一下试试。
原版 · 实际效果
<style>
body{margin:0;padding:14px;background:#f6f7f9;font-family:-apple-system,"PingFang SC",sans-serif}
.dl-qr{display:flex;gap:14px;align-items:center;background:#fff;border:1px solid #e8ecf1;border-radius:14px;padding:14px}
.dl-qr-l{flex:1;min-width:0;display:flex;flex-direction:column;align-items:flex-start;gap:5px}
.dl-qr-ic{width:42px;height:42px;border-radius:10px;background:#f0fff4;color:#276749;
display:grid;place-items:center;font-size:11px;font-weight:800}
.dl-qr-l b{font-size:13px;color:#2d3748}
.dl-qr-l small{font-size:10.5px;color:#a0aec0}
.dl-qr-b{margin-top:6px;border:none;background:#5b7cfa;color:#fff;border-radius:9px;padding:7px 18px;font-size:12px;cursor:pointer}
.dl-qr-r{flex:none;text-align:center}
.dl-qr-img{width:92px;height:92px;border:1px solid #eef1f5;border-radius:10px;padding:6px;display:grid;place-items:center}
.dl-qr-img i{display:block;width:80px;height:80px;
background-image:linear-gradient(45deg,#111 25%,transparent 25%,transparent 75%,#111 75%),
linear-gradient(45deg,#111 25%,transparent 25%,transparent 75%,#111 75%);
background-size:11px 11px;background-position:0 0,5.5px 5.5px;opacity:.85}
.dl-qr-r span{display:block;font-size:10.5px;color:#a0aec0;margin-top:6px}
</style>
<div class="dl-qr">
<div class="dl-qr-l"><span class="dl-qr-ic">APK</span><b>BlogReader.apk</b>
<small>v2.1.0 · 18.4 MB · Android 8.0+</small>
<button class="dl-qr-b">↓ 直接下载</button></div>
<div class="dl-qr-r"><div class="dl-qr-img"><i></i></div><span>扫码下载</span></div>
</div>原版代码的问题:这是原版在浏览器里的真实表现,不是我们写错了——右边那个方块看着像二维码,实际是 CSS 渐变拼出来的棋盘格。下面逐条说明。
① 二维码是假的,扫不出来
看源码就明白了,它是个空的 <i> 元素加两层斜向渐变:
background-image:linear-gradient(45deg,#111 25%,transparent 25%,transparent 75%,#111 75%),
linear-gradient(45deg,#111 25%,transparent 25%,transparent 75%,#111 75%);
background-size:11px 11px;background-position:0 0,5.5px 5.5px;
这画出来的是均匀的棋盘格。真二维码必须有三样东西:三个角的定位方块、时序图案、以及按特定算法排布的数据区——棋盘格一样都没有。
我把原版那个方块截图送去解码,结果是空字符串(扫不出任何内容);修复版那个同样送去解码,返回的是:
https://wxzcw.com/
| 解码结果 | |
|---|---|
| 原版的棋盘格 | 空(扫不出) |
| 修复版的真实二维码 | https://wxzcw.com/ ✓ |
这是最要命的一处:整块视觉上完全正常,读者根本看不出它是假的,只有真拿起手机扫才会发现。
② 下载按钮点了没反应
整段代码 script 标签数是 0。实测点完「直接下载」,地址栏纹丝不动——没有任何地方处理这个点击。
而且 <button> 不写 type 时默认是 submit。我把它包进一个 <form> 里点了一下:
| 点完的地址栏 | |
|---|---|
| 原版 | ...?#submitted(表单被提交了) |
| 修复版 | 不变 ✓ |
③ 副信息颜色 2.26,几乎看不见
| 元素 | 色值 | 对比度 |
|---|---|---|
| 文件大小那行 | #a0aec0 |
2.26 |
| 「扫码下载」 | #a0aec0 |
2.26 |
| 下载按钮 | 白字 on #5b7cfa |
3.68 |
巧的是这三处恰好都是读者做决定最需要的信息:这个包多大、扫了能拿什么、点了会发生什么。全是最淡的。
④ 按钮只有 31px 高
实测 93 × 31。触控目标建议不小于 44px,31px 在手机上容易点空。
⑤ 语义全空,time 一个没有
实测 role / time / aria-label / aria-hidden 全是 0,<a> 也是 0 个。
- 读屏用户听不出这是个下载入口
APK那个图标是装饰性的,没加aria-hidden会被念出来- 「扫码下载」下面没有可聚焦元素,键盘根本到不了二维码区
⑥ 系统高对比下二维码直接消失
这条最隐蔽。开启 Windows 高对比后,浏览器会把背景图片整个去掉——实测原版那个 <i> 的 background-image 变成了 none, none。
也就是说:开了高对比的读者,看到的是一个空白方块。
修复版(二维码是真的,可以扫)
<style>
.wxz-dlq{--bd:#e5e9f0;--mut:#6b7280;--ac:#3b5bdb;
display:flex;gap:14px;align-items:center;background:#fff;border:1px solid var(--bd);
border-radius:14px;padding:14px;max-width:520px}
.wxz-dlq-l{flex:1;min-width:0;display:flex;flex-direction:column;align-items:flex-start;gap:5px}
.wxz-dlq-ic{width:42px;height:42px;border-radius:10px;background:#eef2ff;color:#3730a3;
display:grid;place-items:center;font-size:11px;font-weight:800}
.wxz-dlq-l b{font-size:14px;color:#1f2937;line-height:1.5;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:100%}
.wxz-dlq-l small{font-size:12.5px;color:var(--mut);line-height:1.6}
.wxz-dlq-btn{display:inline-flex;align-items:center;justify-content:center;min-height:44px;
margin-top:6px;padding:0 20px;border-radius:10px;background:var(--ac);color:#fff;
font-size:13.5px;font-weight:600;text-decoration:none}
.wxz-dlq-btn:hover{background:#2f4bc0}
.wxz-dlq-btn:focus-visible{outline:3px solid #93a5f5;outline-offset:2px}
.wxz-dlq-r{flex:none;text-align:center}
.wxz-dlq-img{width:92px;height:92px;border:1px solid var(--bd);border-radius:10px;padding:6px;
display:grid;place-items:center;background:#fff}
.wxz-dlq-img svg{width:80px;height:80px;display:block;fill:#111;
forced-color-adjust:none;-webkit-forced-color-adjust:none}
.wxz-dlq-r span{display:block;font-size:12.5px;color:var(--mut);margin-top:6px}
@media (max-width:420px){
.wxz-dlq{flex-wrap:wrap}
.wxz-dlq-l{flex:1 1 100%}
.wxz-dlq-r{margin:0 auto}
}
@media (prefers-contrast:more){
.wxz-dlq{border-width:2px}
.wxz-dlq-l b,.wxz-dlq-l small,.wxz-dlq-r span{color:#000}
}
</style>
<div class="wxz-dlq">
<div class="wxz-dlq-l">
<span class="wxz-dlq-ic" aria-hidden="true">ZIP</span>
<b>维形筑网-网页美化代码包.zip</b>
<small>v2.1 · 4.6 MB · 全平台可用</small>
<a class="wxz-dlq-btn"
href="https://wxzcw.com/"
download="维形筑网-网页美化代码包.zip">↓ 直接下载</a>
</div>
<div class="wxz-dlq-r">
<div class="wxz-dlq-img">
<svg viewBox="0 0 25 25" xmlns="http://www.w3.org/2000/svg" shape-rendering="crispEdges"
role="img" aria-label="下载二维码,内容为 www.wxzcw.com"><path d="M0 0h7v1h-7zM9 0h1v1h-1zM13 0h1v1h-1zM18 0h7v1h-7zM0 1h1v1h-1zM6 1h1v1h-1zM9 1h1v1h-1zM13 1h4v1h-4zM18 1h1v1h-1zM24 1h1v1h-1zM0 2h1v1h-1zM2 2h3v1h-3zM6 2h1v1h-1zM8 2h1v1h-1zM11 2h1v1h-1zM16 2h1v1h-1zM18 2h1v1h-1zM20 2h3v1h-3zM24 2h1v1h-1zM0 3h1v1h-1zM2 3h3v1h-3zM6 3h1v1h-1zM8 3h3v1h-3zM12 3h5v1h-5zM18 3h1v1h-1zM20 3h3v1h-3zM24 3h1v1h-1zM0 4h1v1h-1zM2 4h3v1h-3zM6 4h1v1h-1zM8 4h2v1h-2zM11 4h1v1h-1zM16 4h1v1h-1zM18 4h1v1h-1zM20 4h3v1h-3zM24 4h1v1h-1zM0 5h1v1h-1zM6 5h1v1h-1zM8 5h1v1h-1zM13 5h1v1h-1zM15 5h2v1h-2zM18 5h1v1h-1zM24 5h1v1h-1zM0 6h7v1h-7zM8 6h1v1h-1zM10 6h1v1h-1zM12 6h1v1h-1zM14 6h1v1h-1zM16 6h1v1h-1zM18 6h7v1h-7zM8 7h3v1h-3zM12 7h1v1h-1zM14 7h1v1h-1zM0 8h1v1h-1zM2 8h5v1h-5zM9 8h1v1h-1zM12 8h4v1h-4zM18 8h5v1h-5zM2 9h1v1h-1zM8 9h4v1h-4zM13 9h1v1h-1zM16 9h2v1h-2zM19 9h1v1h-1zM23 9h1v1h-1zM1 10h1v1h-1zM3 10h2v1h-2zM6 10h1v1h-1zM8 10h3v1h-3zM12 10h4v1h-4zM17 10h5v1h-5zM23 10h2v1h-2zM0 11h2v1h-2zM9 11h1v1h-1zM11 11h1v1h-1zM14 11h1v1h-1zM17 11h1v1h-1zM19 11h1v1h-1zM24 11h1v1h-1zM3 12h2v1h-2zM6 12h2v1h-2zM9 12h1v1h-1zM13 12h2v1h-2zM16 12h5v1h-5zM22 12h3v1h-3zM0 13h2v1h-2zM3 13h2v1h-2zM7 13h1v1h-1zM10 13h1v1h-1zM12 13h2v1h-2zM16 13h2v1h-2zM19 13h1v1h-1zM21 13h1v1h-1zM23 13h1v1h-1zM0 14h1v1h-1zM5 14h2v1h-2zM9 14h2v1h-2zM14 14h2v1h-2zM17 14h5v1h-5zM23 14h2v1h-2zM0 15h1v1h-1zM2 15h2v1h-2zM8 15h3v1h-3zM12 15h1v1h-1zM14 15h2v1h-2zM17 15h1v1h-1zM19 15h2v1h-2zM24 15h1v1h-1zM0 16h1v1h-1zM2 16h5v1h-5zM8 16h1v1h-1zM12 16h2v1h-2zM16 16h5v1h-5zM22 16h1v1h-1zM8 17h3v1h-3zM13 17h1v1h-1zM16 17h1v1h-1zM20 17h2v1h-2zM0 18h7v1h-7zM9 18h6v1h-6zM16 18h1v1h-1zM18 18h1v1h-1zM20 18h1v1h-1zM22 18h3v1h-3zM0 19h1v1h-1zM6 19h1v1h-1zM8 19h1v1h-1zM10 19h2v1h-2zM14 19h1v1h-1zM16 19h1v1h-1zM20 19h2v1h-2zM0 20h1v1h-1zM2 20h3v1h-3zM6 20h1v1h-1zM8 20h2v1h-2zM11 20h1v1h-1zM15 20h6v1h-6zM22 20h3v1h-3zM0 21h1v1h-1zM2 21h3v1h-3zM6 21h1v1h-1zM8 21h2v1h-2zM12 21h2v1h-2zM16 21h1v1h-1zM18 21h1v1h-1zM20 21h5v1h-5zM0 22h1v1h-1zM2 22h3v1h-3zM6 22h1v1h-1zM8 22h1v1h-1zM10 22h1v1h-1zM13 22h2v1h-2zM21 22h2v1h-2zM24 22h1v1h-1zM0 23h1v1h-1zM6 23h1v1h-1zM9 23h2v1h-2zM12 23h2v1h-2zM16 23h2v1h-2zM19 23h3v1h-3zM24 23h1v1h-1zM0 24h7v1h-7zM8 24h3v1h-3zM12 24h1v1h-1zM14 24h1v1h-1zM19 24h6v1h-6z"/></svg>
</div>
<span>扫码下载</span>
</div>
</div>这版改了这些:
| 原版 | 修复版 | |
|---|---|---|
| 二维码解码 | 空 | https://wxzcw.com/ ✓ |
| 高对比下二维码 | 变成空白 | 保持可见 ✓ |
| 下载按钮 | 点了无反应 | <a download> 直接触发 ✓ |
| 按钮 type | submit |
链接,无此问题 ✓ |
| 按钮高度 | 31px | 44px ✓ |
| 副信息对比度 | 2.26 | 4.83 ✓ |
| 按钮对比度 | 3.68 | 5.67 ✓ |
role / time / aria-hidden |
0 / 0 / 0 | 1 / 0 / 1 ✓ |
具体做法:
- 换成真实二维码:直接内嵌 SVG,不用引外部图片、不用联网、不受防盗链影响。上面那个
path就是把https://wxzcw.com/编码后的结果,25 × 25 个模块 forced-color-adjust:none:这是关键一条。系统高对比会把 SVG 的填充色也强制改掉,二维码一旦被改成别的配色就可能扫不出来。加上这条,实测高对比下填充仍是rgb(17,17,17),二维码完好<a download>代替<button>:下载本质是"跳到一个文件",用链接最合适。实测它是A标签、href和download都在- 颜色压深一档:副信息
#a0aec0→#6b7280,按钮底色#5b7cfa→#3b5bdb min-height:44px:触控达标- 图标加
aria-hidden,二维码role="img"配aria-label说明扫出来是什么 - 窄屏(≤420px)自动换行:实测 360px 下二维码不再被挤扁
深色款
<style>
.wxz-dlq2{--bd:#3f3f46;--mut:#a1a1aa;--ac:#60a5fa;
display:flex;gap:14px;align-items:center;background:#27272a;border:1px solid var(--bd);
border-radius:14px;padding:14px;max-width:520px}
.wxz-dlq2-l{flex:1;min-width:0;display:flex;flex-direction:column;align-items:flex-start;gap:5px}
.wxz-dlq2-ic{width:42px;height:42px;border-radius:10px;background:#312e81;color:#c7d2fe;
display:grid;place-items:center;font-size:11px;font-weight:800}
.wxz-dlq2-l b{font-size:14px;color:#f4f4f5;line-height:1.5;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:100%}
.wxz-dlq2-l small{font-size:12.5px;color:var(--mut);line-height:1.6}
.wxz-dlq2-btn{display:inline-flex;align-items:center;justify-content:center;min-height:44px;
margin-top:6px;padding:0 20px;border-radius:10px;background:#1e40af;color:#fff;
font-size:13.5px;font-weight:600;text-decoration:none}
.wxz-dlq2-btn:hover{background:#1d4ed8}
.wxz-dlq2-btn:focus-visible{outline:3px solid var(--ac);outline-offset:2px}
.wxz-dlq2-r{flex:none;text-align:center}
.wxz-dlq2-img{width:92px;height:92px;border:1px solid var(--bd);border-radius:10px;padding:6px;
display:grid;place-items:center;background:#fff}
.wxz-dlq2-img svg{width:80px;height:80px;display:block;fill:#111;
forced-color-adjust:none;-webkit-forced-color-adjust:none}
.wxz-dlq2-r span{display:block;font-size:12.5px;color:var(--mut);margin-top:6px}
@media (max-width:420px){.wxz-dlq2{flex-wrap:wrap}.wxz-dlq2-l{flex:1 1 100%}.wxz-dlq2-r{margin:0 auto}}
@media (prefers-contrast:more){
.wxz-dlq2{border-width:2px}
.wxz-dlq2-l b,.wxz-dlq2-l small,.wxz-dlq2-r span{color:#fff}
}
</style>
<div class="wxz-dlq2">
<div class="wxz-dlq2-l">
<span class="wxz-dlq2-ic" aria-hidden="true">ZIP</span>
<b>维形筑网-网页美化代码包.zip</b>
<small>v2.1 · 4.6 MB · 全平台可用</small>
<a class="wxz-dlq2-btn" href="https://wxzcw.com/" download="维形筑网-网页美化代码包.zip">↓ 直接下载</a>
</div>
<div class="wxz-dlq2-r">
<div class="wxz-dlq2-img">
<svg viewBox="0 0 25 25" xmlns="http://www.w3.org/2000/svg" shape-rendering="crispEdges"
role="img" aria-label="下载二维码,内容为 www.wxzcw.com"><path d="M0 0h7v1h-7zM9 0h1v1h-1zM13 0h1v1h-1zM18 0h7v1h-7zM0 1h1v1h-1zM6 1h1v1h-1zM9 1h1v1h-1zM13 1h4v1h-4zM18 1h1v1h-1zM24 1h1v1h-1zM0 2h1v1h-1zM2 2h3v1h-3zM6 2h1v1h-1zM8 2h1v1h-1zM11 2h1v1h-1zM16 2h1v1h-1zM18 2h1v1h-1zM20 2h3v1h-3zM24 2h1v1h-1zM0 3h1v1h-1zM2 3h3v1h-3zM6 3h1v1h-1zM8 3h3v1h-3zM12 3h5v1h-5zM18 3h1v1h-1zM20 3h3v1h-3zM24 3h1v1h-1zM0 4h1v1h-1zM2 4h3v1h-3zM6 4h1v1h-1zM8 4h2v1h-2zM11 4h1v1h-1zM16 4h1v1h-1zM18 4h1v1h-1zM20 4h3v1h-3zM24 4h1v1h-1zM0 5h1v1h-1zM6 5h1v1h-1zM8 5h1v1h-1zM13 5h1v1h-1zM15 5h2v1h-2zM18 5h1v1h-1zM24 5h1v1h-1zM0 6h7v1h-7zM8 6h1v1h-1zM10 6h1v1h-1zM12 6h1v1h-1zM14 6h1v1h-1zM16 6h1v1h-1zM18 6h7v1h-7zM8 7h3v1h-3zM12 7h1v1h-1zM14 7h1v1h-1zM0 8h1v1h-1zM2 8h5v1h-5zM9 8h1v1h-1zM12 8h4v1h-4zM18 8h5v1h-5zM2 9h1v1h-1zM8 9h4v1h-4zM13 9h1v1h-1zM16 9h2v1h-2zM19 9h1v1h-1zM23 9h1v1h-1zM1 10h1v1h-1zM3 10h2v1h-2zM6 10h1v1h-1zM8 10h3v1h-3zM12 10h4v1h-4zM17 10h5v1h-5zM23 10h2v1h-2zM0 11h2v1h-2zM9 11h1v1h-1zM11 11h1v1h-1zM14 11h1v1h-1zM17 11h1v1h-1zM19 11h1v1h-1zM24 11h1v1h-1zM3 12h2v1h-2zM6 12h2v1h-2zM9 12h1v1h-1zM13 12h2v1h-2zM16 12h5v1h-5zM22 12h3v1h-3zM0 13h2v1h-2zM3 13h2v1h-2zM7 13h1v1h-1zM10 13h1v1h-1zM12 13h2v1h-2zM16 13h2v1h-2zM19 13h1v1h-1zM21 13h1v1h-1zM23 13h1v1h-1zM0 14h1v1h-1zM5 14h2v1h-2zM9 14h2v1h-2zM14 14h2v1h-2zM17 14h5v1h-5zM23 14h2v1h-2zM0 15h1v1h-1zM2 15h2v1h-2zM8 15h3v1h-3zM12 15h1v1h-1zM14 15h2v1h-2zM17 15h1v1h-1zM19 15h2v1h-2zM24 15h1v1h-1zM0 16h1v1h-1zM2 16h5v1h-5zM8 16h1v1h-1zM12 16h2v1h-2zM16 16h5v1h-5zM22 16h1v1h-1zM8 17h3v1h-3zM13 17h1v1h-1zM16 17h1v1h-1zM20 17h2v1h-2zM0 18h7v1h-7zM9 18h6v1h-6zM16 18h1v1h-1zM18 18h1v1h-1zM20 18h1v1h-1zM22 18h3v1h-3zM0 19h1v1h-1zM6 19h1v1h-1zM8 19h1v1h-1zM10 19h2v1h-2zM14 19h1v1h-1zM16 19h1v1h-1zM20 19h2v1h-2zM0 20h1v1h-1zM2 20h3v1h-3zM6 20h1v1h-1zM8 20h2v1h-2zM11 20h1v1h-1zM15 20h6v1h-6zM22 20h3v1h-3zM0 21h1v1h-1zM2 21h3v1h-3zM6 21h1v1h-1zM8 21h2v1h-2zM12 21h2v1h-2zM16 21h1v1h-1zM18 21h1v1h-1zM20 21h5v1h-5zM0 22h1v1h-1zM2 22h3v1h-3zM6 22h1v1h-1zM8 22h1v1h-1zM10 22h1v1h-1zM13 22h2v1h-2zM21 22h2v1h-2zM24 22h1v1h-1zM0 23h1v1h-1zM6 23h1v1h-1zM9 23h2v1h-2zM12 23h2v1h-2zM16 23h2v1h-2zM19 23h3v1h-3zM24 23h1v1h-1zM0 24h7v1h-7zM8 24h3v1h-3zM12 24h1v1h-1zM14 24h1v1h-1zM19 24h6v1h-6z"/></svg>
</div>
<span>扫码下载</span>
</div>
</div>深色款:给开了暗色模式的站点用。炭底 #27272a 配浅字,实测对比度 13.55 / 5.81 / 8.72,三处都远超标准。
有个细节值得注意:深色卡片里的二维码容器仍然是白底。这不是忘了改——二维码扫描依赖黑白高对比,把它印在深色底上会大幅降低识别率,有些扫码器直接认不出来。所以周边变深、二维码区保持纯白,是刻意这么做的。
用图片引二维码(更省事的做法)
<style>
.wxz-dlq3{--bd:#e5e9f0;--mut:#6b7280;--ac:#3b5bdb;
display:flex;gap:14px;align-items:center;background:#fff;border:1px solid var(--bd);
border-radius:14px;padding:14px;max-width:520px}
.wxz-dlq3-l{flex:1;min-width:0;display:flex;flex-direction:column;align-items:flex-start;gap:5px}
.wxz-dlq3-ic{width:42px;height:42px;border-radius:10px;background:#eef2ff;color:#3730a3;
display:grid;place-items:center;font-size:11px;font-weight:800}
.wxz-dlq3-l b{font-size:14px;color:#1f2937;line-height:1.5;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:100%}
.wxz-dlq3-l small{font-size:12.5px;color:var(--mut);line-height:1.6}
.wxz-dlq3-btn{display:inline-flex;align-items:center;justify-content:center;min-height:44px;
margin-top:6px;padding:0 20px;border-radius:10px;background:var(--ac);color:#fff;
font-size:13.5px;font-weight:600;text-decoration:none}
.wxz-dlq3-btn:hover{background:#2f4bc0}
.wxz-dlq3-btn:focus-visible{outline:3px solid #93a5f5;outline-offset:2px}
.wxz-dlq3-r{flex:none;text-align:center}
.wxz-dlq3-img{width:92px;height:92px;border:1px solid var(--bd);border-radius:10px;padding:6px;
display:grid;place-items:center;background:#fff}
.wxz-dlq3-img img{width:80px;height:80px;display:block;image-rendering:pixelated;
forced-color-adjust:none;-webkit-forced-color-adjust:none}
.wxz-dlq3-r span{display:block;font-size:12.5px;color:var(--mut);margin-top:6px}
@media (max-width:420px){.wxz-dlq3{flex-wrap:wrap}.wxz-dlq3-l{flex:1 1 100%}.wxz-dlq3-r{margin:0 auto}}
</style>
<div class="wxz-dlq3">
<div class="wxz-dlq3-l">
<span class="wxz-dlq3-ic" aria-hidden="true">ZIP</span>
<b>维形筑网-网页美化代码包.zip</b>
<small>v2.1 · 4.6 MB · 全平台可用</small>
<a class="wxz-dlq3-btn" href="https://wxzcw.com/" download="维形筑网-网页美化代码包.zip">↓ 直接下载</a>
</div>
<div class="wxz-dlq3-r">
<div class="wxz-dlq3-img">
<img src="qr-wxzcw.png" width="80" height="80"
alt="扫码在手机上打开维形筑网 www.wxzcw.com">
</div>
<span>扫码下载</span>
</div>
</div>图片版:如果你不想把 SVG 塞进 HTML(二维码路径会比较长),可以生成一张 PNG 再引用。上面这块就是这种写法,注意两点:
width/height属性要写:浏览器在图片下载完成前就知道该留多大位置,页面不会跳动(这对 CLS 指标有直接影响)image-rendering:pixelated:二维码放大时容易被插值成模糊的灰边,加上这条让它保持硬边,更好扫- 二维码要留白边:生成 PNG 时留 4 个模块的静默区,贴着边缘扫不出来
alt 也要写清楚扫出来是什么,读屏用户才知道这个方块是干什么的。
顺带提醒:download 属性只在同源链接上生效。如果文件放在 CDN 或对象存储上(跨域),浏览器会忽略 download 直接打开文件或跳转。要强制下载得让服务端发 Content-Disposition: attachment 响应头。
为什么类名都带 wxz- 前缀
CSS 没有作用域,一个 <style> 进页面就是全站生效。这段代码的类名像 .dl-qr-l、.dl-qr-img 已经不算常见了,但撞名概率依然存在。
实测对照(把未加前缀的 CSS 注入一个已有同类名的站点):
| 站点原本的样式 | 被改成 |
|---|---|
.title 40px |
13px |
.meta 红色 |
#64748b |
.item 无边框、红底 |
多了边框、变白底 |
加上 wxz- 前缀后再测,污染为 0。
所以:
- 照抄时保留
wxz-前缀,别图省事改回短名字 - 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效
- 如果你的主题里恰好也有
wxz-开头的类(极少见),换成你自己的前缀即可 - 放进「额外 CSS」是全站加载的,只想在单篇文章用就把
<style>写在那篇文章里
怎么用
CSS 放进「外观 → 自定义 → 额外 CSS」;HTML 写在文章的「自定义 HTML」区块里。这套是纯 CSS代码 加一点结构,不依赖任何建站程序,WordPress、Typecho、Hexo 都能直接用。
换你自己的二维码,两步:
- 找任意一个在线二维码生成工具,输入你的下载链接,导出 SVG
- 用文本编辑器打开 SVG,把里面
<path d="...">的d值整段复制出来,替换上面代码块里的那一长串
不建议直接把整段 SVG 贴进去——生成器输出的 SVG 通常带一堆冗余属性和注释,只取 path 的 d 值最干净。
兼容性
download 属性:Chrome / Firefox / Edge / Safari 10.1+ 支持;iOS Safari 从 13 起支持,之前会直接打开文件。forced-color-adjust 目前只有 Chromium 内核和 Firefox 支持,Safari 会忽略——但 Safari 也没有强制配色模式,所以不受影响。image-rendering:pixelated 全系支持。shape-rendering:crispEdges 让二维码边缘不抗锯齿,避免小尺寸下发虚。
代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com