热区坐标必须基于图片原始像素计算,通过naturalWidth/naturalHeight获取缩放比后换算coords,并监听load和resize事件动态更新;usemap与map name须严格一致(含#、大小写、符号),area须嵌套于map内且具备href或onclick。

area热区坐标必须基于原始图片像素,不能直接套用CSS缩放后尺寸
浏览器解析coords时,永远以图片原始宽高(naturalWidth/naturalHeight)为基准,和你写的width、height或max-width无关。比如一张1200×800的图,你用img { width: 300px; height: 200px; }显示,那coords="0,0,100,100"实际只覆盖屏幕约25×25px——远低于移动端推荐的44×44px触控最小尺寸。
常见错误是拿设计稿标注的“居中坐标”或Figma导出的CSS像素值直接填进coords,结果热区漂移、点击失灵。必须回退到原图尺寸做换算。
- 先读取图片
naturalWidth和naturalHeight(可用img.naturalWidth在load事件中获取) - 计算缩放比:
scaleX = img.offsetWidth / img.naturalWidth,scaleY = img.offsetHeight / img.naturalHeight - 对每个
area.coords字符串里的数值,按方向分别乘以对应缩放比(rect的x1/x2用scaleX,y1/y2用scaleY) - 更新后赋值给
area.coords,注意保留整数,避免小数导致Safari静默忽略
响应式热区必须监听resize和img load,不能只靠CSS
仅靠media query或vw/vh单位无法动态修正coords,因为浏览器不重新解析area标签。必须用JS主动重算。
关键触发时机只有两个:window.addEventListener('resize', updateCoords) 和 img.addEventListener('load', updateCoords)。漏掉load会导致首次渲染时热区错位;漏掉resize则横竖屏切换后失效。
立即学习“前端免费学习笔记(深入)”;
-
updateCoords()函数里要遍历所有document.querySelectorAll('area'),不能只处理当前map下的 - 每次更新前先检查
img.naturalWidth > 0,防止未加载完成就读取为0 - 避免高频触发:用
requestAnimationFrame或简单节流(如setTimeout防抖)包裹重算逻辑 - 若页面有多个
img[usemap],需为每个绑定独立load事件,不能共用一个handler
usemap与map name必须逐字匹配,大小写/符号/井号都不能错
这是90%热区“写了但没反应”的原因。浏览器不报错,只是静默跳过整个map块。
usemap属性值必须带#前缀,且后面字符串要和<map name="xxx"></map>中的name**完全一致**——包括大小写、连字符、下划线、空格。复制粘贴比对最可靠。
-
usemap="#product-map"✅ 匹配<map name="product-map"></map> -
usemap="product-map"❌ 漏掉#,无效 -
usemap="#Product-Map"❌ 大小写不一致,断连 -
usemap="#product_map"❌ 下划线 vs 连字符,不匹配
调试时别只看HTML源码,要在Chrome DevTools里选中img元素,展开Computed面板,确认usemap值是否被正确解析为#xxx格式。
area必须嵌套在map内,且href或onclick至少有一个有效
area不是独立可交互元素,它只在map上下文中生效。把它丢到div或section里,浏览器直接忽略。
热区要有行为,必须提供导航能力(href)或交互能力(onclick)。纯视觉标记(如只设alt)不会响应点击。
- 优先保留
href:哪怕只是href="javascript:void(0)",也比纯onclick语义强、键盘可访问(回车键触发) - 若用
onclick接管逻辑,务必加event.preventDefault(),否则可能跳转空地址或闪动 -
alt属性不可省略,否则影响无障碍阅读器识别区域功能 - 不要给
area设display: none或visibility: hidden,这会让热区彻底消失
真正难调的不是坐标算不准,而是map和img之间那条看不见的匹配链——少一个#,错一位大小写,或area多了一层父容器,整张热区图就哑火。



















