有两类问题几乎每个前端都遇到过。第一类:本地打开写好的页面,点链接全跳 404,可文件明明就在隔壁。第二类:商品列表页的图片没写宽高,网速慢的时候图片一张张加载出来,下面的内容被不断往下推,用户正要点「立即购买」,手指落下去时按钮已经挪走了,点到了旁边的「取消」。这两个问题都和本篇的内容直接相关,一个是路径,一个是图片占位。

这篇讲什么:链接怎么写才不会断、target 和 rel 是干什么的、图片的 alt 和宽高为什么必须写、srcset 解决什么问题,以及音视频标签的基础用法。读完你能做到:独立完成一个带图片列表、跳转链接和视频区块的页面,并且知道哪些写法会在慢网络或手机上出问题。

链接:页面之间靠它连起来

链接用 a 标签,地址写在 href 属性里。a 是行内元素,默认带下划线、颜色偏蓝,这些都能用 CSS 改。没有 href 的 a 仍然会被渲染成一个链接的样子,但点不动、也拿不到焦点,属于常见的无效写法。如果只是想做一个按钮样子的东西,用 button;如果要做跳转,就必须有 href。

这个区别在键盘操作时会放大:有 href 的链接能被 Tab 选中,按回车打开;没有 href 的 a 不进入 Tab 序列,键盘用户根本到不了。有些人为让链接不跳转,删掉 href 再挂点击事件,结果鼠标能用、键盘废了。要么用 button,要么保留 href 并阻止默认行为。

路径:绝对还是相对,看你要死守哪个位置

路径分三种,混用是 404 的主要来源:

写法含义适用场景
href="https://docs.czgrzx.cn/articles/"完整地址,带协议和域名跳到别的站点,或邮件、文档里需要可点击
href="/articles/"从域名根开始找站内跳转首选,页面挪目录也不会断
href="../css/css-flex.html"从当前文件所在目录开始找文件之间相对位置稳定的项目

一个真实的坑:开发时页面放在项目根目录,写 href="articles/html/html-forms.html" 能点开;部署到服务器后,文章实际地址是 /articles/frontend/basics/html/,同一个相对路径就指到别处去了。站内链接用以 / 开头的根路径最稳,代价是站点如果部署在子目录(比如 /docs/),所有链接都要跟着改。这个站部署在域名根目录,所以统一用 /articles/...。

还有一种情况是单页应用的前端路由。用 history 模式时,刷新深层路径要靠服务器把请求回退到入口文件,否则用户刷新一下就是 404。这属于部署配置,不是 href 写错,但现象很像,排查时要先分清。

直接双击 HTML 文件用 file:// 打开时,以 / 开头的路径会指到磁盘根目录,链接和样式基本都会失效。本地调试请起一个静态服务,这个站的开发地址是 http://localhost:9445。

target 与 rel:新窗口不是默认选项

target="_blank" 让链接在新标签页打开。很多站点给所有外链都加上它,理由是「别让用户离开本站」。这个做法有代价:用户会突然多出一个标签页,手机端则是在浏览器里再叠一层窗口,返回路径变得混乱。我的判断是,只有「用户大概率要保留当前页面」的场景才用新窗口,比如打开一篇外部参考资料、下载文件。站内导航一律当前页跳转。

用 target="_blank" 时建议同时写 rel="noopener"。老浏览器里,新页面可以通过 window.opener 反过来操作原页面,是个安全隐患。新版浏览器对 target="_blank" 已经默认做了隔离,具体从哪个版本开始各浏览器不完全一致,这里不列版本号;写上 rel="noopener" 不增加成本,兼容老客户端更稳妥。如果还不想让对方知道来源,可以加 noreferrer。

<a href="https://example.com/spec" target="_blank" rel="noopener noreferrer">
  查看规范原文
</a>

链接文字要能单独看懂

读屏软件有一套「链接列表」功能,会把页面上所有链接单独列出来。如果一堆链接都叫「点击这里」「了解更多」,用户听完也不知道每个通向哪里。写法上把目的地写进文字里:「查看 Flex 布局教程」比「点击查看」有用得多。图片链接则要靠图片的 alt 提供文字,这个下面会讲。

整卡可点也是类似问题:链接包住价格、标题等所有文字,读屏用户会听到一长串重复内容。让链接只包住最关键的文字更稳。

图片:不只是把图放上去

图片用 img,地址写在 src。img 是空元素,没有结束标签,内容由属性提供。看起来简单,但真正决定页面体验的是两个属性:alt 和宽高。

alt:写什么取决于这张图承担什么

alt 是图片的文字替代。图片加载失败时它显示出来,读屏软件念的也是它。写法分三种情况:

  • 图片承载信息:比如商品图、插图、图表。写清它表达的内容。「红色连帽卫衣,正面图」比「商品图片」有用。
  • 图片是链接或按钮:写清点下去会发生什么,比如「返回首页」。
  • 图片纯装饰:比如分隔线、纯背景花纹。写 alt="",明确告诉读屏软件「跳过它」。注意是空字符串,不是省略 alt。省略 alt 时,读屏软件可能会念出文件名,反而更吵。

另一个常见误区是把关键词堆进 alt,指望 SEO。图片搜索确实会参考 alt,但堆砌关键词的收益很低,反而让真实用户听到一串莫名其妙的词。按「这张图在说什么」来写就够了。

复杂图表是例外。折线图里有五六条趋势线,alt 写一段话说不清,要么在旁边配结论,要么提供数据表。判断标准是:把图拿掉,读者能不能从文字里获得同样的信息。

宽高:不写就会推着页面跳

只写 src 不写宽高,浏览器在图片下载完成前不知道它多大,只能先按 0 高度占位。图片陆续到达,下面的内容就被一次次往下推。这个现象有个专门的名字叫布局偏移,英文缩写 CLS,是衡量页面体验的指标之一。用户正在阅读或点击时页面突然跳动,体验很差,点错按钮就是这么来的。

解决办法是给 img 写上原始的 width 和 height 属性。这两个值不是最终显示尺寸,浏览器会拿它们的比例先算出占位高度;最终显示多大仍然由 CSS 控制。只要比例对,图片到达前后就不会跳。

<img src="/media/cover.webp" alt="秋季新品卫衣正面图"
     width="800" height="600">

<!-- CSS 里控制实际显示尺寸,比例保持不变 -->
<style>
  .card img { width: 100%; height: auto; }
</style>
如果只写 CSS 的 width: 100% 而不写 HTML 宽高属性,浏览器依然拿不到原始比例,该跳还是会跳。两个都要写,别只写一个。反过来,写了 HTML 宽高、CSS 里却只设宽度不设 height: auto,图片会被拉变形,这是另一个常见事故。

srcset、picture 与懒加载

同一张商品图,手机只需要 400 像素宽,桌面大屏可能要 1200 像素。只给一张大图,手机白白下载了几倍的流量;只给小图,大屏上糊成一片。srcset 就是让浏览器自己挑:你提供几个尺寸的候选,浏览器结合屏幕像素密度和当前布局宽度选一个。

<img src="/media/cover-800.webp"
     srcset="/media/cover-400.webp 400w,
             /media/cover-800.webp 800w,
             /media/cover-1600.webp 1600w"
     sizes="(max-width: 600px) 100vw, 800px"
     alt="秋季新品卫衣正面图" width="800" height="600">

这里的 w 表示图片本身有多少像素宽,sizes 告诉浏览器「在不同屏幕宽度下,这块区域大概占多宽」。浏览器据此算出需要多少像素,再挑最接近的候选。srcset 的完整规则比较绕,刚开始可以只记住「提供多档尺寸,让浏览器选」,具体选哪个由浏览器决定,不用自己写脚本判断。

如果还需要按格式切换(比如优先 AVIF,不支持时退回 WebP 或 JPEG),用 picture 包住 source 和 img。img 必须留在最后作为兜底,不能省。格式支持和压缩效果随浏览器版本变化,这里不写具体版本,上线前用目标浏览器实测。

长页面里的图片可以加 loading="lazy",让浏览器等图片快进入视野时再下载。首屏的 Logo、主图不要加,加了反而更慢,因为它要等布局计算后才知道该下载。图片多的列表页收益明显,两三张图的小页面意义不大。懒加载也有副作用:脚本动态插入、需要立即测量的图片可能还没加载,遇到这类情况先去掉再测。

音视频:能播只是第一步

video:controls、poster 和自动播放

视频用 video,加 controls 就会出现浏览器自带的播放条。不加的话,用户看不到播放按钮,只能靠脚本自己画一套控件。实际项目里,如果你要自定义皮肤,确实会去掉 controls,但那样就得自己补键盘操作和可访问性,工作量不小。

<video controls width="640" height="360"
       poster="/media/lesson-cover.webp"
       preload="metadata" playsinline>
  <source src="/media/lesson.mp4" type="video/mp4">
  <source src="/media/lesson.webm" type="video/webm">
  你的浏览器不支持 video 标签。
</video>

几个属性值得留意:poster 是视频加载前显示的封面图,不写就是一片黑;preload="metadata" 只预取时长、尺寸等元信息,比 auto 省流量;playsinline 在手机上让视频在页面内播放,而不是强制全屏。还有自动播放:带声音的自动播放在大多数移动浏览器里会被拦截,这是浏览器的策略,不是代码写错。真需要自动播放,通常配合 muted,并且要有暂停按钮,否则用户没法关掉声音。

写 width 和 height 在这里同样重要。视频在元信息加载前也不知道尺寸,没有占位,下面的内容会跟着跳。和图片不同的是,video 的默认宽高比可能来自文件本身,但加载前仍然需要你先给一个占位。

audio 与字幕

audio 和 video 的用法几乎一样,加 controls 就有播放条。区别是它没有画面,更需要文字说明,告诉用户这段音频是什么、多长。播客页面通常还会配文字稿,既方便搜索,也方便听障用户。

视频字幕用 track,格式是 WebVTT(.vtt 文件):

<video controls width="640" height="360">
  <source src="/media/lesson.mp4" type="video/mp4">
  <track kind="captions" src="/media/lesson.zh.vtt"
         srclang="zh" label="中文字幕" default>
</video>

字幕不是「锦上添花」。在地铁、办公室这类不能外放的环境里,字幕是很多人看视频的唯一方式。只写 kind="captions" 还不够,srclang 和 label 让用户能在多语言字幕之间选择。

场景走查:一个促销页的三次修改

做过一个促销活动页,上半部分是商品列表,每张卡有图、名称、价格和一个「查看详情」链接。开发和本地测试都顺利:图片能显示,链接能跳。上线当天下午,运营在群里发来两个截图。

第一个是点进详情页后 404。我们本地把活动页放在项目根目录,链接写的是 href="detail.html" 这种相对路径;活动页实际部署在 /promo/2024/ 子目录下,详情页在另一个目录,相对位置变了。第一次修改,我把所有链接改成以 / 开头的绝对路径,本地又打不开了,因为用 file:// 打开时 / 指向磁盘根目录。最后统一改成「相对当前页面的完整相对路径」,并且把活动页和详情页的目录结构固定下来,构建时不再随手挪文件。代价是以后新增页面必须遵守这套目录约定。

第二个是手机上图片加载时页面跳动。我们只写了 src,没写宽高。网速慢时,图片一张张撑开,下面的卡片被不断往下推,运营说自己点「查看详情」点到了旁边那张卡。第二次修改,我给每张图补了原始的 width 和 height,但 CSS 里仍然是 width: 100%,没有 height: auto,结果图片被拉变形。第三次才把这两边配对,比例恢复正常,加载时也不再跳。

三次修改之后页面才稳定。这些问题都不是「不会写标签」,而是本地和线上环境不一致,以及只写了「看起来够用」的属性。基础内容出问题,往往不在语法,而在环境假设。

错误现象对照

下面这些现象,多数要在「慢网络、手机、部署之后」才暴露。排查时先看 Network 面板里实际请求了什么,再回头改代码。

现象真实原因第一步查什么
本地能打开,部署后全部 404路径写法与部署目录不一致,相对路径的基准变了看 Network 面板里实际请求的完整 URL
图片加载后页面往下跳,按钮点错没有写宽高,浏览器预先不知道占位比例查 img 有没有成对的 width、height
图片被压扁或拉长写了 HTML 宽高,CSS 只设宽度,没有 height: auto查计算后的实际宽高比例
手机端图片糊,桌面端又太大只提供了一档尺寸,没有 srcset 候选看当前屏幕下实际选中的图片文件大小
视频自动播放没有声音,或者干脆不动浏览器拦截有声自动播放,或缺少静音与用户交互查是否加了 muted,以及是否在用户操作后播放
图片坏了只显示一个小方块,用户不知道这里是什么src 路径错,且 alt 为空或缺失看 alt 文本与 Network 里的 404

边界与代价

先说路径。根路径在「部署在域名根目录」的前提下最省心,一旦部署到子目录就全部失效,必须换写法或靠构建工具注入前缀。相对路径在哪都能用,但要求目录结构稳定,页面一挪就可能断。单页应用还有路由回退问题,需要服务器配置配合。没有一种写法在所有环境都成立,先确认部署方式再选。

图片的边界在数量和维护成本上。几张图手写宽高和 srcset 没问题;图片上了几十上百张,每张都要裁剪多档尺寸、命名、维护,手写就成了负担,得交给图片服务或构建流程。到那个规模,格式转换、缓存和版权也都不是 HTML 能解决的。

alt 也有覆盖不了的内容。信息图、复杂图表、带文字的截图,一段替代文字说不清楚,需要额外配文字说明或数据表。装饰图和内容图的判断也带主观性,团队最好约定一个标准,不然同一种图有人写描述、有人留空。

音视频的边界更明显。原生 video 适合几段短片段、课程预览这类内容;长视频、需要自适应码率和版权保护的业务,通常要上专门的播放器或流媒体方案,靠一个 video 标签撑不住。自动播放策略各浏览器、各版本的行为不完全一致,具体规则待确认,上线前必须在目标机型上实测。字幕则要额外的制作成本,没有字幕文件,标签写得再对也没内容可显示。

还有几个副作用:给所有外链都加 target="_blank",标签页越来越多,用户返回时找不到原页面;懒加载放在首屏图片上,会让首屏变慢;写死宽高但 CSS 忘了自适应,图片会变形。改一个属性之前,先想清楚连锁反应。

小结与练习

这一篇的可用结论:站内链接按部署方式选路径,外链慎用新窗口;alt 按图片的实际作用写,装饰图写空字符串;图片一定写原始宽高,尺寸交给 CSS 并保留 height: auto;多尺寸图用 srcset,别用脚本判断;视频记得封面、内联播放和字幕。这几条都是花几分钟就能做到、但漏掉会在真实网络环境里暴露的问题。

当天可以自己验证的几件事:

  • 打开开发者工具的 Network 面板,刷新一个带图的页面,找一找有没有 404,以及每张图实际请求的是哪一档尺寸。
  • 给页面里三张图补上 width 和 height,用开发者工具限速到慢速网络,观察加载过程中内容是否还会跳。
  • 缩窄浏览器窗口,再看 Network 里 srcset 选中的文件有没有变化,理解浏览器是怎么挑的。
  • 故意把一张图的 src 改错,看页面上显示的是 alt 文字还是空白,判断这张图的替代信息够不够。
  • 只用 Tab 键走一遍页面,检查每个链接都能获得焦点、焦点样式可见,并且链接文字单独拿出来也能看懂。

链接和图片让页面「有内容」,表单让页面「能收内容」。下一篇 表单 讲 label 绑定、name 与提交、浏览器自带校验,以及为什么自定义按钮很容易把键盘用户挡在门外。那篇的很多坑和本篇同源:都是「能点、能看」和「所有人都能点、都能看」之间的差距。