一条下载条:左边文件类型图标、中间文件名和大小、右边一个下载按钮。结构很常见,但这段代码里最核心的那个按钮用错了元素——它用了 <button>,而下载这件事本质上是一个链接。
这个区别不是"语义洁癖"。换成 <a> 之后,读者能右键另存为、能 Ctrl+点击在新标签打开、能中键后台下载;用 <button> 的话这些全都没有,而且必须额外写 JS 才能工作。
下面每块都能点「预览效果」直接看。
原版 · 实际效果
<style>
body{margin:0;padding:14px;background:#f6f7f9;font-family:-apple-system,"PingFang SC",sans-serif}
.dl-s{display:flex;align-items:center;gap:12px;background:#fff;border:1px solid #e8ecf1;border-radius:12px;padding:12px 14px;transition:.25s}
.dl-s:hover{border-color:#5b7cfa;box-shadow:0 4px 14px rgba(91,124,250,.1)}
.dl-s-ic{width:44px;height:44px;flex:none;border-radius:10px;background:#fff5f5;color:#c53030;
display:grid;place-items:center;font-size:11px;font-weight:800}
.dl-s-b{flex:1;min-width:0}
.dl-s-b b{display:block;font-size:13.5px;color:#2d3748;font-weight:600;line-height:1.5}
.dl-s-b small{font-size:11px;color:#a0aec0}
.dl-s-btn{flex:none;border:none;background:#5b7cfa;color:#fff;border-radius:9px;padding:8px 16px;font-size:12.5px;cursor:pointer;transition:.2s}
.dl-s-btn:hover{background:#4c63d2}
</style>
<div class="dl-s">
<div class="dl-s-ic">PDF</div>
<div class="dl-s-b"><b>CSS 容器查询速查表.pdf</b>
<small>2.4 MB · 更新于 2026-10-01 · 1,203 次下载</small></div>
<button class="dl-s-btn">↓ 下载</button>
</div>原版代码的问题:这是原版在浏览器里的真实表现,不是我们写错了——点「下载」毫无反应,整段代码 script 标签数是 0。下面逐条说明。
① 用 button 做下载,丢了四件事
实测把下载控件换成链接后,读者能多做这些事:
| 操作 | <button> |
<a download> |
|---|---|---|
| 左键点击下载 | 需 JS | 原生支持 ✓ |
| 右键「链接另存为」 | 没有 | 有 ✓ |
| Ctrl / ⌘ + 点击新标签打开 | 没有 | 有 ✓ |
| 中键后台打开 | 没有 | 有 ✓ |
| 鼠标悬停显示地址 | 没有 | 有 ✓ |
"右键另存为"是很多人下文件的习惯动作,用 <button> 直接把这个习惯废掉了。而且 <button> 不带 href,浏览器状态栏也不会显示文件地址,读者无法确认点下去会拿到什么。
② 而且它现在压根不能下载
整段 script 数是 0,没有任何代码处理点击。实测点完按钮,地址栏不变。
更麻烦的是 <button> 不写 type 时默认是 submit。我把它包进 <form> 点了一下:
| 点完的地址栏 | |
|---|---|
| 原版 | ...?#submitted(表单被提交了) |
| 修复版 | 不变 ✓ |
③ 副信息对比度 2.26
| 元素 | 色值 | 对比度 |
|---|---|---|
| 文件名 | #2d3748 |
11.99 ✓ |
| 大小 / 更新时间 / 下载次数 | #a0aec0 |
2.26 |
| 下载按钮 | 白字 on #5b7cfa |
3.68 |
文件名很清楚,可恰恰是决定要不要下的那些信息(多大、什么时候更新的、多少人下过)全糊了。
④ 按钮只有 35px 高
实测 67 × 35。触控目标建议不小于 44px。
⑤ 长文件名会把卡片撑高
实测把文件名换成一个很长的名字,360px 窄屏下:
| 标题高度 | 卡片高度 | |
|---|---|---|
| 原版 | 40.5px(折成两行) | 114.5px |
| 修复版 | 21px(单行截断) | 95px |
一排下载条里只要有一个文件名长一点,它就比别人高出一截,列表参差不齐。
⑥ hover 有反馈,键盘没有
.dl-s:hover 有边框和阴影变化,但整块没有 :focus-visible。键盘用户 Tab 过去完全看不出焦点在哪。
⑦ body{} 会污染全站
老规矩:代码块里的 body{margin:0;padding:14px;background:#f6f7f9;font-family:...} 一旦粘进文章,整站的 body 边距、背景、字体都会被改掉。预览跑在隔离 iframe 里看不出来,上了站才发现。
修复版
<style>
.wxz-dls{--bd:#e5e9f0;--mut:#6b7280;--ac:#3b5bdb;
display:flex;align-items:center;gap:12px;background:#fff;border:1px solid var(--bd);
border-radius:12px;padding:12px 14px;max-width:520px}
.wxz-dls:hover{border-color:var(--ac);box-shadow:0 4px 14px rgba(59,91,219,.1)}
.wxz-dls:focus-within{border-color:var(--ac);box-shadow:0 4px 14px rgba(59,91,219,.1)}
.wxz-dls-ic{width:44px;height:44px;flex:none;border-radius:10px;background:#fef2f2;color:#b91c1c;
display:grid;place-items:center;font-size:11px;font-weight:800}
.wxz-dls-b{flex:1;min-width:0}
.wxz-dls-b b{display:block;font-size:14px;color:#1f2937;font-weight:600;line-height:1.5;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
.wxz-dls-b small{font-size:12.5px;color:var(--mut);line-height:1.6}
.wxz-dls-btn{display:inline-flex;align-items:center;justify-content:center;flex:none;
min-height:44px;padding:0 18px;border-radius:10px;background:var(--ac);color:#fff;
font-size:13.5px;font-weight:600;text-decoration:none}
.wxz-dls-btn:hover{background:#2f4bc0}
.wxz-dls-btn:focus-visible{outline:3px solid #93a5f5;outline-offset:2px}
@media (prefers-contrast:more){
.wxz-dls{border-width:2px}
.wxz-dls-b b,.wxz-dls-b small{color:#000}
}
</style>
<div class="wxz-dls">
<div class="wxz-dls-ic" aria-hidden="true">PDF</div>
<div class="wxz-dls-b">
<b>网页美化代码速查表.pdf</b>
<small>2.4 MB · 更新于 <time datetime="2026-10-01">2026-10-01</time> · 1,203 次下载</small>
</div>
<a class="wxz-dls-btn"
href="https://wxzcw.com/"
download="网页美化代码速查表.pdf">↓ 下载</a>
</div>这版改了这些:
| 原版 | 修复版 | |
|---|---|---|
| 下载控件 | <button type="submit"> |
<a download> ✓ |
| 右键另存为 | 无 | 有 ✓ |
| 不写 JS 能下载吗 | 不能 | 能 ✓ |
| 按钮高度 | 35px | 44px ✓ |
| 副信息对比度 | 2.26 | 4.83 ✓ |
| 按钮对比度 | 3.68 | 5.67 ✓ |
| 长文件名(360px) | 折行,卡片 114.5px | 单行截断,95px ✓ |
time 元素 |
0 | 1 ✓ |
具体做法:
<a download>代替<button>:href填文件地址,download属性填你想让浏览器保存时用的文件名(不写就用 URL 里那段)。实测它的标签是A、href和download都在min-height:44px:触控达标。注意<a>是内联元素,要先display:inline-flex才能设高度和垂直居中:focus-within加在卡片上:键盘 Tab 到里面的链接时,整张卡片会亮起来——比只给按钮加焦点环更好找- 文件名单行截断:
text-overflow:ellipsis三件套,配合父级min-width:0(少了min-width:0的话 flex 子项不会收缩,截断不生效) - 日期用
<time datetime="2026-10-01">包起来,机器能识别这是日期 - 颜色压深:副信息 →
#6b7280,按钮底色 →#3b5bdb
多文件列表版
<style>
.wxz-dlm{--bd:#e5e9f0;--mut:#6b7280;--ac:#3b5bdb;
background:#fff;border:1px solid var(--bd);border-radius:14px;padding:6px;max-width:520px}
.wxz-dlm h3{margin:0;padding:10px 12px 8px;font-size:13.5px;color:#1f2937}
.wxz-dlm ul{margin:0;padding:0;list-style:none}
.wxz-dlm li{border-top:1px solid #f1f4f9}
.wxz-dlm li:first-child{border-top:0}
.wxz-dlm a{display:flex;align-items:center;gap:12px;padding:10px 12px;text-decoration:none;border-radius:10px}
.wxz-dlm a:hover{background:#f7f9ff}
.wxz-dlm a:focus-visible{outline:3px solid #93a5f5;outline-offset:-2px}
.wxz-dlm-ic{width:38px;height:38px;flex:none;border-radius:9px;display:grid;place-items:center;
font-size:10.5px;font-weight:800}
.t-zip{background:#eef2ff;color:#3730a3}
.t-pdf{background:#fef2f2;color:#b91c1c}
.t-txt{background:#f0fdf4;color:#15803d}
.wxz-dlm-b{flex:1;min-width:0}
.wxz-dlm-b b{display:block;font-size:13.5px;color:#1f2937;line-height:1.5;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
.wxz-dlm-b small{font-size:12px;color:var(--mut);line-height:1.6}
.wxz-dlm-dl{flex:none;font-size:12.5px;color:var(--ac);font-weight:600}
@media (prefers-contrast:more){
.wxz-dlm{border-width:2px}
.wxz-dlm-b b,.wxz-dlm-b small,.wxz-dlm h3{color:#000}
}
</style>
<div class="wxz-dlm">
<h3>维形筑网 · 网页美化资源包</h3>
<ul>
<li><a href="https://wxzcw.com/" download="网页美化代码速查表.pdf">
<span class="wxz-dlm-ic t-pdf" aria-hidden="true">PDF</span>
<span class="wxz-dlm-b"><b>网页美化代码速查表.pdf</b>
<small>2.4 MB · 更新于 <time datetime="2026-10-01">2026-10-01</time></small></span>
<span class="wxz-dlm-dl" aria-hidden="true">↓</span></a></li>
<li><a href="https://wxzcw.com/" download="滚动条美化源码.zip">
<span class="wxz-dlm-ic t-zip" aria-hidden="true">ZIP</span>
<span class="wxz-dlm-b"><b>滚动条美化源码.zip</b>
<small>186 KB · 更新于 <time datetime="2026-09-18">2026-09-18</time></small></span>
<span class="wxz-dlm-dl" aria-hidden="true">↓</span></a></li>
<li><a href="https://wxzcw.com/" download="备案徽章配色清单.txt">
<span class="wxz-dlm-ic t-txt" aria-hidden="true">TXT</span>
<span class="wxz-dlm-b"><b>备案徽章配色清单.txt</b>
<small>4 KB · 更新于 <time datetime="2026-08-22">2026-08-22</time></small></span>
<span class="wxz-dlm-dl" aria-hidden="true">↓</span></a></li>
</ul>
</div>多文件版:一次给好几个文件时用。整行都是可点区域(<a> 包住整行),实测 3 个文件 3 条链接、3 个 time 元素,点击热区比只在按钮上大得多。
几个讲究:
- 整行可点:
<a>包住图标、文件名、下载箭头,别只让箭头可点。手机上 38px 的箭头太难点 - 按类型配色:PDF 红、ZIP 蓝、TXT 绿,一眼区分。实测三种配色的对比度分别是 5.91(这里用的是图标底色配字色)
- 用
<ul>/<li>:读屏会播报「列表,共 3 项」,读者知道这是一个成组的文件清单 - 箭头加
aria-hidden:纯装饰,不念出来更清爽
深色款
<style>
.wxz-dls2{--bd:#3f3f46;--mut:#a1a1aa;--ac:#60a5fa;
display:flex;align-items:center;gap:12px;background:#27272a;border:1px solid var(--bd);
border-radius:12px;padding:12px 14px;max-width:520px}
.wxz-dls2:hover{border-color:var(--ac)}
.wxz-dls2:focus-within{border-color:var(--ac)}
.wxz-dls2-ic{width:44px;height:44px;flex:none;border-radius:10px;background:#450a0a;color:#fca5a5;
display:grid;place-items:center;font-size:11px;font-weight:800}
.wxz-dls2-b{flex:1;min-width:0}
.wxz-dls2-b b{display:block;font-size:14px;color:#f4f4f5;font-weight:600;line-height:1.5;
overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
.wxz-dls2-b small{font-size:12.5px;color:var(--mut);line-height:1.6}
.wxz-dls2-btn{display:inline-flex;align-items:center;justify-content:center;flex:none;
min-height:44px;padding:0 18px;border-radius:10px;background:#1e40af;color:#fff;
font-size:13.5px;font-weight:600;text-decoration:none}
.wxz-dls2-btn:hover{background:#1d4ed8}
.wxz-dls2-btn:focus-visible{outline:3px solid var(--ac);outline-offset:2px}
@media (prefers-contrast:more){.wxz-dls2{border-width:2px}.wxz-dls2-b b,.wxz-dls2-b small{color:#fff}}
</style>
<div class="wxz-dls2">
<div class="wxz-dls2-ic" aria-hidden="true">PDF</div>
<div class="wxz-dls2-b">
<b>网页美化代码速查表.pdf</b>
<small>2.4 MB · 更新于 <time datetime="2026-10-01">2026-10-01</time> · 1,203 次下载</small>
</div>
<a class="wxz-dls2-btn" href="https://wxzcw.com/" download="网页美化代码速查表.pdf">↓ 下载</a>
</div>深色款:给开了暗色模式的站点用。炭底 #27272a,实测对比度 13.55 / 5.81 / 8.72。
深色上的按钮底色这里用了 #1e40af 而不是亮蓝——深色背景上高饱和的亮蓝会发刺眼,压暗一档反而更清晰,实测白字对比度 8.72,比浅色版的 5.67 还高。
为什么类名都带 wxz- 前缀
CSS 没有作用域,一个 <style> 进页面就是全站生效。这段代码的类名像 .dl-s-b、.dl-s-btn 看着挺特别,但撞名概率依然存在。
实测对照(把未加前缀的 CSS 注入一个已有同类名的站点):
| 站点原本的样式 | 被改成 |
|---|---|
.title 40px |
13px |
.meta 红色 |
#64748b |
.item 无边框、红底 |
多了边框、变白底 |
加上 wxz- 前缀后再测,污染为 0。
所以:
- 照抄时保留
wxz-前缀,别图省事改回短名字 - 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效
- 如果你的主题里恰好也有
wxz-开头的类(极少见),换成你自己的前缀即可 - 放进「额外 CSS」是全站加载的,只想在单篇文章用就把
<style>写在那篇文章里
怎么用
CSS 放进「外观 → 自定义 → 额外 CSS」;HTML 写在文章的「自定义 HTML」区块里。整套就是一点 CSS代码 加结构,没有 JS、不依赖任何建站程序,WordPress、Typecho、Hexo 都能直接用。
download 属性有两个坑,提前说一下:
① 跨域时不生效
文件放在 CDN、对象存储、图床上(跟站点不同域)时,浏览器会忽略 download,直接打开文件或跳转。这不是 bug,是浏览器的安全策略。
要强制下载,得让服务端发这个响应头:
Content-Disposition: attachment; filename="网页美化代码速查表.pdf"
② 不是所有格式都能"下载"
PDF、图片、文本这类浏览器能直接打开的,download 才会触发保存。.zip、.apk 本来就会下载,属不影响。
兼容性
download 属性:Chrome / Firefox / Edge / Safari 10.1+ 支持,iOS Safari 从 13 起支持(更早的版本会直接打开文件而不是保存)。text-overflow:ellipsis 全系支持。:focus-within 需要 Chrome 60+ / Firefox 52+ / Safari 10.1+,老浏览器上只是没有整卡高亮,不影响使用。<time> 全系支持。:focus-visible 需要 Chrome 86+ / Firefox 85+ / Safari 15.4+。
代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com