查看 API 鉴权示例
同页锚点 #api-auth
未应用检查：点「应用修复」看读屏读什么。
把「查看 API 鉴权示例」做成入口
链接说「去哪」，按钮说「做什么」。同一个目的地，做成链接还是按钮，读屏读法、访问记忆、目标提示和键盘行为都不一样——在面板里亲手对照。
场景：部署文档里要把「查看 API 鉴权示例」做成可点入口。先选入口类型与目的地，点「应用修复」跑一次可访问性检查，再看读屏怎么报、入口本身发生了什么变化。
入口类型
目的地
对照：先选入口类型与目的地，点「应用修复」看读屏怎么报、物件本身怎么变。
面板已经教会你的五件事
把刚才在面板里看到的变化命名出来；以后写任何可点入口都能用这五条检查。
- 链接导航，按钮操作切「做成链接/按钮」时，读屏读法（链接 vs 按钮）、元素形状、访问记忆都跟着变。去别处用链接，当前页改数据/提交用按钮。
- 文字本身就是路标「查看 API 鉴权示例」点之前就能预判目的地；「点击这里」「更多」要靠上下文猜，读屏列举时无从分辨。
- 外链要提示并加 rel目的地切成「外部 MDN」时，链接自动出现「外部·新标签」徽章和 rel=noreferrer——让用户预期离开当前站点，并切断来源信息泄露。
- 访问过的链接要可辨认点链接后入口出现「已访问」徽章并换色；按钮点完不留记忆。访问态帮用户区分「去过/没去过」。
- 键盘可达，焦点可见Tab 能落到链接上，焦点环清楚；读屏报告「链接」角色和名称。可点 div 加 onClick 会丢掉这两件事。
什么时候用链接
从「点了要去哪」判断：目的是换地址，就用链接。
- 去站内另一个页面或站外参考
- 同页跳到某章节（锚点 #xxx）
- 下载文件（href 指向资源，文案写明类型）
- 打开邮箱、电话（mailto:/tel:）
- 当前页改数据、提交、保存 → 按钮
- 触发校验、计算、开关面板 → 按钮
- 只在客户端切状态、不换地址 → 按钮
怎么写好一条链接
从文案到属性的最短路径：让用户和辅助技术都能在点之前知道目的地。
- 1文字先说目的地：用「查看环境变量配置示例」，不要「点击这里」「更多」。
- 2用真
<a href>，不要用onclick加可点 div 模拟。 - 3外链
target="_blank"时加rel="noreferrer"，并在文字或上下文提示将打开新窗口。 - 4保留可辨认的
:hover/:focus-visible/:visited样式，颜色不是唯一线索。 - 5下载在文案里写明文件类型与大小（如「部署清单 PDF，120 KB」）。
同一目的地：正例与反例
都要把读者带去「API 鉴权示例」。差别只在：用链接，还是用按钮假装。
读屏报「链接，查看 API 鉴权示例」；Tab 能到；访问后可辨认；中键能新开。导航语义完整，用户点之前就知道去哪。
读屏只报「按钮」，没有 href、无访问记忆、中键不能新开，键盘用户拿不到导航语义。应改成链接，文案对准目的地。
快速自测
部署文档里要带读者去另一页看「发布检查清单」，该用哪种入口，为什么？
继续查证
术语的技术定义和行为以这些一手或权威资料为准。
下一步学
和本知识点经常一起出现的概念。