usemap 与 map name 必须逐字节一致(含#、大小写、符号)才能绑定成功;动态插入 area 需完整设置 shape、coords、href、alt 四属性;响应式下 coords 需按缩放比重算;绑定 click 须 preventDefault 并注意移动端 touch 事件。

usemap 和 map name 必须逐字节一致才能绑定成功
动态新增 area 前,必须确保 <img alt="HTML区域映射动态新增热点教程" > 的 usemap 属性值(含 #)和对应 <map name="xxx"></map> 的 name 完全相同——大小写、连字符、空格、符号,一个都不能差。浏览器不报错,但不匹配就等于没写。
常见失效场景:
-
usemap="product-map"❌(漏掉#)→ 应为usemap="#product-map" -
<map name="ProductMap"></map>与usemap="#productmap"❌(大小写/连字符不一致) - 复制粘贴时带了不可见 Unicode 字符(如零宽空格),用开发者工具选中后按 Delete 键清空再重输更稳妥
动态插入 area 标签必须满足 shape + coords + href + alt 四要素
用 document.createElement('area') 或 innerHTML 插入时,area 元素若缺任一关键属性,多数浏览器会静默忽略该热区(尤其 Safari 和旧版 Edge)。
必须显式设置:
立即学习“前端免费学习笔记(深入)”;
-
shape:只能是"rect"、"circle"或"poly",不能省略或拼错 -
coords:格式严格对应shape:"0,0,100,100"(rect)、"50,50,30"(circle)、"10,20,30,40,50,60"(poly,偶数个值) -
href:即使只想用 JS 监听点击,也建议设为href="#"并event.preventDefault(),否则部分读屏器可能跳过该区域 -
alt:无障碍强制要求,缺失会导致 Lighthouse 检测失败,且某些浏览器直接禁用点击
响应式缩放下 coords 必须重算,不能硬编码
原始图尺寸是 1200×800,你用 img { width: 100%; max-width: 400px; } 显示,那所有 coords 就得按比例缩放。浏览器不会自动帮你换算,动态插入的 area 若沿用原始坐标,热区必然偏移甚至不可点。
安全做法:
- 在
img加载完成(load)和窗口调整(resize)后,重新计算缩放比:scaleX = img.offsetWidth / img.naturalWidth - 遍历所有
area,按规则重写coords:
–rect:四个值分别乘scaleX和scaleY
–circle:前两个坐标乘对应缩放比,半径乘Math.min(scaleX, scaleY)
–poly:所有偶数位(x)乘scaleX,奇数位(y)乘scaleY - 别依赖
getBoundingClientRect()反推,它受 transform、border、padding 干扰,误差大
area 动态绑定 click 事件要防冒泡和默认跳转
如果不用 href 跳转,而是想执行 JS 逻辑(比如弹窗、埋点),直接给 area 绑定 click 是可行的,但有坑:
- 必须加
event.preventDefault(),否则href="#"会触发页面滚动到顶部 -
area不支持:hover或:focus伪类,视觉反馈得靠 JS 切 class + CSS 配合 - 移动端 touch 事件需额外监听
touchstart,并加event.preventDefault()防止双击缩放干扰 - 避免在
map上绑事件代理——area是替换元素,事件不会冒泡到map,只能单独绑定每个area
真正麻烦的不是插入 area,而是维护坐标与图片缩放、DPR、加载时机的同步关系。哪怕只改一行 CSS,都可能让刚调好的热区全部失效。动手前先确认:这张图是否真的必须用 map?复杂交互不如直接上 SVG;纯视觉反馈不如用绝对定位 + pointer-events: none 叠层。



















