下载卡片带二维码:桌面扫码、手机直接拿

很多站点都会放一个下载入口:桌面用户点按钮直接下,手机用户扫码拿。想法很好,但这段代码有个一眼看不出来、用一次就露馅的问题——右边那个二维码是画出来的,扫不出任何东西。

这不是"样式不够精致"的问题,是功能根本不成立:读者拿手机对着它扫半天,什么也扫不出来,只会以为自己手机坏了。

下面每块都能点「预览效果」直接看。修复版里那个二维码是真的,你可以直接用手机扫一下试试。

原版 · 实际效果

HTML下载卡片 · 原版实际效果
<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。

也就是说:开了高对比的读者,看到的是一个空白方块。

修复版(二维码是真的,可以扫)

HTML下载卡片 · 修复版(二维码可扫)
<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 下二维码不再被挤扁

深色款

HTML下载卡片 · 深色款
<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,三处都远超标准。

有个细节值得注意:深色卡片里的二维码容器仍然是白底。这不是忘了改——二维码扫描依赖黑白高对比,把它印在深色底上会大幅降低识别率,有些扫码器直接认不出来。所以周边变深、二维码区保持纯白,是刻意这么做的。

用图片引二维码(更省事的做法)

HTML下载卡片 · 图片引二维码版
<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 都能直接用。

换你自己的二维码,两步:

  1. 找任意一个在线二维码生成工具,输入你的下载链接,导出 SVG
  2. 用文本编辑器打开 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

赞 (0)
文章过时提醒:告诉读者这篇写于多久前,并可一键关闭
上一篇 2026年10月30日 下午8:51
单文件下载条:为什么下载按钮应该用链接而不是按钮
下一篇 2026年10月30日 下午9:29

相关推荐

维 形 筑 网