HTML热区映射需严格匹配usemap与map name(含#前缀、大小写、符号),coords须按shape类型精确填写且响应式下需JS动态缩放,area必须嵌套于map内并含href和alt属性。

HTML 的 <map></map> + <area> 不是“入门就能跑通”的功能,而是错一个字符就完全失效的精密匹配系统——浏览器不报错,只静默跳过整个热区。
usemap 和 map name 必须逐字节一致
这是 90% 热区点击无反应的根源。浏览器对大小写、符号、空格极其敏感,且要求 usemap 值必须带 # 前缀,与 <map name="xxx"></map> 的 name 属性严格相等。
-
usemap="#product-map"✅ 对应<map name="product-map"></map> -
usemap="product-map"❌ 漏掉#,整个<map></map>被忽略 -
usemap="#Product-Map"❌ 大小写不一致,断连 -
<map name="product_map"></map>❌ 下划线 vs 连字符,不匹配
调试时别靠眼睛扫,直接在开发者工具里复制 usemap 值,再复制 <map></map> 的 name,用文本比对工具确认是否完全一致。
coords 坐标必须按 shape 类型精确填写
coords 不是“随便填的像素值”,它由 shape 决定解析逻辑;填错一位,热区可能缩成点、偏移到画布外,甚至覆盖整张图。
立即学习“前端免费学习笔记(深入)”;
-
shape="rect"→coords="x1,y1,x2,y2":左上角 + 右下角,且必须满足x1 且 <code>y1 -
shape="circle"→coords="cx,cy,r":圆心坐标 + 半径,r必须为正整数(不能是0或小数) -
shape="poly"→coords="x1,y1,x2,y2,x3,y3,...":顶点坐标成对出现,总数必须是偶数;首尾不自动闭合,手动重复第一个点更稳(如"10,20,30,40,10,20")
常见错误:把设计稿里“居中坐标”直接当 coords 填;或导出 poly 坐标时带了空格/换行,导致 Safari 静默跳过该区域。
响应式页面里 coords 会立即失准
只要图片用了 width/height CSS 缩放、max-width: 100% 或在高 DPR 屏幕上渲染,coords 就立刻失效——这不是 bug,是原生机制限制。
- 原始图是
1200×800,你用img { width: 375px; height: auto; }显示,那coords="0,0,100,100"实际只占屏幕约31×21px - 解决办法只有 JS 动态缩放:监听窗口 resize,按比例重算所有
coords值并更新<area>的coords属性 - CSS
object-fit、background-image替代方案无法配合<map></map>,别试
很多人卡在这里,不是不会写 <area>,而是没意识到:静态 coords 在现代网页里根本不能直接用。
area 标签必须嵌套在 map 内,且 href/alt 不可省略
<area> 是 void 元素,不能自闭合,也不能脱离 <map></map> 存在;href 和 alt 是必需属性(W3C 规范强制),省略会导致部分浏览器(尤其是旧版 Edge)静默丢弃该区域。
- ✅ 正确写法:
<area shape="rect" coords="0,0,100,100" href="/product" alt="产品入口"> - ❌ 错误写法:
<area shape="rect" coords="0,0,100,100">(自闭合)、<area ...>(非法闭合)、<area ...>放在<map></map>外 -
href="#"可以,但需搭配onclick或 JS 阻止默认行为,否则页面跳到顶部
最容易被忽略的是 alt:它不只是无障碍需求,更是浏览器校验 <area> 合法性的关键字段——没它,区域大概率不注册进映射表。



















