单文件下载条:为什么下载按钮应该用链接而不是按钮

一条下载条:左边文件类型图标、中间文件名和大小、右边一个下载按钮。结构很常见,但这段代码里最核心的那个按钮用错了元素——它用了 <button>,而下载这件事本质上是一个链接。

这个区别不是"语义洁癖"。换成 <a> 之后,读者能右键另存为、能 Ctrl+点击在新标签打开、能中键后台下载;用 <button> 的话这些全都没有,而且必须额外写 JS 才能工作。

下面每块都能点「预览效果」直接看。

原版 · 实际效果

HTML下载条 · 原版实际效果
<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 里看不出来,上了站才发现。

修复版

HTML下载条 · 修复版
<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

多文件列表版

HTML下载条 · 多文件列表版
<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:纯装饰,不念出来更清爽

深色款

HTML下载条 · 深色款
<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

赞 (0)
下载卡片带二维码:桌面扫码、手机直接拿
上一篇 2026年10月30日 下午9:28
双列时间轴:为什么圆点没落在中轴线上
下一篇 2026年10月30日 下午11:18

相关推荐

维 形 筑 网