HTML图像映射()极易因字符、单位或加载时机错误而静默失效;usemap与map的name必须逐字节一致(含#、大小写、连字符);coords基于图片原始尺寸,缩放需手动重算;area必须嵌套于map内且含href和alt属性。

不难,但极其容易因一个字符、一个单位或一个加载时机出错而完全失效。 它不是“写完就能点”,而是“错一点就静默罢工”——浏览器既不报错,也不提示,只让热区彻底消失。
usemap 和 map name 必须逐字节一致
这是 90% 新手卡住的地方。浏览器对引用匹配极其严格:
-
usemap值必须以#开头,比如usemap="#product-map" -
<map></map>的name属性值必须**完全相同**:不能多空格、不能大小写混用、不能用下划线代替连字符 - 旧版 Safari 或 IE 兼容模式还要求同时设置
id和name,否则忽略整个<map></map> - 调试时别靠眼睛扫,直接复制
usemap的值,去掉#后去查document.querySelector('map[name="..."]')是否能取到
coords 是原始像素值,不是 CSS 渲染后尺寸
所有 coords 都基于图片的 naturalWidth / naturalHeight,和你用 width: 100% 或 max-width 缩放无关。一旦图片被缩放,热区就必然偏移。
-
shape="rect"要求coords="x1,y1,x2,y2",且必须满足x1 且 <code>y1 ,反序会导致热区不可见 -
shape="circle"的半径r必须是正整数,r=0或小数(如29.5)会让 Safari 直接跳过该<area> -
shape="poly"的坐标总数必须为偶数;导出工具带的换行/空格会破坏解析,建议用.split(',').map(Number)清洗
area 标签缺属性就等于没写
<area> 不是“可选配置”,而是语义与功能双刚需:
立即学习“前端免费学习笔记(深入)”;
- 必须有
href,否则点击无任何行为(不是“跳首页”,是彻底没反应) - 必须有
alt,否则屏幕阅读器无法播报,旧版 Safari 也会忽略该区域 -
title虽非强制,但缺了用户悬停时看不到提示,等于埋了个黑盒按钮 -
<area>必须嵌套在<map></map>内部,写在<map></map>外面会被浏览器直接丢弃
响应式场景下原生 map 几乎不可靠
没有自动缩放机制,coords 是死的,图片尺寸是活的——这就是根本矛盾。
- 监听
img.addEventListener('load', updateCoords)和window.addEventListener('resize', updateCoords)是底线操作 - 计算缩放比要用
img.offsetWidth / img.naturalWidth,不能用getBoundingClientRect(),后者含边框/内边距 - 多边形热区要逐对缩放每组
x,y,矩形要重算全部四个值,圆形要同步缩放圆心和半径 - 如果项目需要悬停、动画、焦点管理或无障碍支持,直接用 SVG 替代更省心——它天然响应式,坐标系随容器缩放,还能绑定
aria-label和focus事件
真正难的不是语法,而是把“静态坐标”和“动态布局”之间的断层补上。哪怕只做一张 PC 端静态图,也要先确认设计稿尺寸是否和 img.naturalWidth 一致;一旦加了 max-width 或媒体查询,就别指望 <map></map> 自己跟上节奏。



















