真正可访问的拓扑图需用语义化HTML重构，而非仅依赖<img>+alt：通过<figure>+<details>+<dl>拆解结构说明、节点清单与连接关系表，并同步更新DOM以反映动态状态。
复杂拓扑图（如网络架构、微服务依赖、云资源关系图）本身是高度视觉化的，纯靠 <img> 的 alt 文本无法传达节点关系、层级、状态或交互逻辑。真正可访问的描述不是“加一段文字”，而是用语义化 HTML 重构信息结构，让屏幕阅读器能按逻辑路径逐层理解。
拓扑图不能只用 <img> + alt
常见错误是把整张 SVG 或 Canvas 渲染图塞进一个 <img src="topo.svg" alt="系统拓扑图">。这等于告诉屏幕阅读器：“这儿有张图，叫‘系统拓扑图’”——用户完全不知道哪些是入口服务、哪些已下线、哪条边代表调用失败率 >5%。
-
alt只适合简短、单焦点图像（如图标、logo），拓扑图的信息密度远超其承载能力； - 即使写成长文本
alt="API网关→认证服务→用户中心，其中认证服务标红表示异常"，屏幕阅读器仍无法支持跳转、展开、筛选等操作； - 动态更新（如节点状态实时变色）时，
alt不可更新，变成过期描述。
用 <figure> + <details> + <dl> 拆解拓扑逻辑
把拓扑图的语义拆成三类可导航块：整体结构说明、节点清单、连接关系表。不依赖视觉位置，而靠 HTML 层级表达归属与流向。
- 用
<figure>包裹整个拓扑区块，<figcaption>写宏观定位，例如<figcaption>生产环境微服务拓扑：按区域分组，含健康状态与关键依赖</figcaption>； - 每个节点（服务/组件）用
<details><summary>折叠展示，<summary>是服务名 + 状态徽标（用aria-label表达，如aria-label="订单服务 — 运行中，延迟 12ms"）； - 节点内部用
<dl>列出属性：<dt>类型</dt><dd>Java Spring Boot</dd>、<dt>部署集群</dt><dd>prod-east-1</dd>； - 连接关系不靠箭头，而用独立
<table>，列头为源节点、目标节点、协议、SLA，每行一条调用链，scope="row"和scope="col"保证行列关联清晰。
动态状态必须同步更新 DOM，而非仅改 SVG 属性
拓扑图常随监控数据实时变色或闪烁。如果只改 SVG 元素的 fill 或加 CSS class，屏幕阅读器完全无感。必须让状态变化反映在语义化文本中。
立即学习“前端免费学习笔记（深入）”；
- 节点异常时，不只是给 SVG
<circle>加class="error"，还要同步更新对应<summary>的aria-label，例如从"订单服务 — 运行中"改为"订单服务 — 异常：CPU 使用率 98%，持续 3 分钟"； - 连接中断时，在关系表对应行插入
<tr class="disrupted">，并在<td>里用aria-live="polite"包裹新状态文本，确保读屏及时播报； - 避免用
aria-hidden="true"隐藏“正常”状态文本再显示“异常”文本——这会导致焦点丢失和重复播报，直接替换文本内容更可靠。
真正的难点不在写多少 HTML 标签，而在于把运维人员看图说话的隐含逻辑（比如“虚线箭头=异步消息”“红色边框=超时熔断”）全部显式落地为可解析、可跳转、可更新的文本结构。一旦漏掉某类关系的语义映射，对屏幕阅读器用户来说，那部分拓扑就彻底“不存在”。
