coords 坐标始终基于 naturalWidth/naturalHeight 计算,CSS 缩放不影响 area 坐标解析;需动态监听 load/resize,用缩放比重算各 shape 坐标,并确保 href、alt 存在且规范。

coords 坐标永远基于 naturalWidth / naturalHeight
你用 CSS 缩放图片,area 的 coords 依然按原始像素计算——这不是 bug,是 HTML 规范行为。例如原图 1600×900,CSS 显示为 400×225(缩放比 0.25),那么 coords="0,0,200,150" 看起来像左上角四分之一区域,实际点击位置仍按 1600×900 计算,结果点不到。
常见错误现象:
- 热区在桌面端对得准,移动端一缩放就全偏了
- 用 image-map.net 导出的坐标直接贴进代码,但图片被
max-width: 100%拉伸后热区失效 - 开发者工具里截图选区显示热区“应该”在那儿,但鼠标悬停没反应
实操建议:
- 用 PS 或在线工具取点时,务必确认导出的是原始尺寸下的坐标(不是设计稿上标注的「缩放后坐标」)
- 临时加
border: 1px solid red到<img alt="HTML区域映射如何处理图片缩放" >,再用浏览器「截图选区」功能比对热区是否真对齐 - 设计稿给的是缩放后坐标?必须反向换算:
原始x = 设计稿x × (naturalWidth / renderedWidth)
监听 img.load 和 window.resize 重算 coords
原生 <map></map> 没有响应式能力,不能靠 CSS 自适应。移动端几乎必错位,除非你手动更新所有 <area> 的 coords。
立即学习“前端免费学习笔记(深入)”;
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
关键步骤:
- 记录原始宽高:
const naturalW = img.naturalWidth; const naturalH = img.naturalHeight; - 计算缩放比:
const scaleX = img.offsetWidth / naturalW; const scaleY = img.offsetHeight / naturalH; - 遍历所有
<area>,按shape类型分别处理坐标:
—rect:缩放全部 4 个值(x1,y1,x2,y2)
—circle:缩放圆心x,y和半径r
—poly:逐对缩放每组x,y - 绑定事件:
img.addEventListener('load', updateCoords)和window.addEventListener('resize', updateCoords)
<area> 必须含 href 或 onclick,且不能缺 alt
缺 href,点击无跳转行为;缺 alt,不仅屏幕阅读器无法读出功能,旧版 Safari 会直接忽略该热区。
即使只用 JS 绑定交互,也建议:
- 保留
href="#"并在 handler 里e.preventDefault(),避免部分触屏设备意外跳转或滚动 -
alt必须描述功能,如alt="点击进入放射科详情",不可为空或仅写 “科室”
移动端和高 DPR 屏幕下容易忽略的细节
很多开发者只测了 desktop Chrome,却忘了:
- iOS Safari 对
usemap的解析更严格,<map></map>的name必须与<img alt="HTML区域映射如何处理图片缩放" >的usemap值(带 #)完全一致,大小写敏感 - 高 DPR 屏幕(如 iPhone 15 Pro)下,
img.offsetWidth返回的是 CSS 像素,而naturalWidth是物理像素,缩放比计算必须用getBoundingClientRect()获取真实渲染尺寸才可靠 - 如果图片是异步加载(比如懒加载或 base64 动态插入),
load事件可能已触发过,要检查img.complete状态再决定是否立即调用updateCoords
最常被跳过的一步:没在 updateCoords 函数开头加 if (!img.naturalWidth) return; —— 图片还没加载完成就去读 naturalWidth,得到 0,整个缩放比崩掉。


















