area坐标必须基于img.naturalWidth/naturalHeight换算,因coords是原始像素绝对值;CSS缩放后需用offsetWidth/naturalWidth等计算缩放比,再动态重映射coords,且须在img.onload后读取natural尺寸以防为0。

naturalHeight 不能直接从 <area> 元素读取——它只属于 <img alt="HTML区域映射读取naturalHeight教程" > 实例。区域映射(<map></map> + <area>)本身没有尺寸属性,必须通过关联的 <img alt="HTML区域映射读取naturalHeight教程" > 获取原始像素尺寸,再按比例换算坐标。
area 坐标必须基于 naturalWidth / naturalHeight 换算
HTML <area> 的 coords 是绝对像素值,但这些值是针对图片原始分辨率定义的。如果 <img alt="HTML区域映射读取naturalHeight教程" > 被 CSS 缩放、object-fit 裁剪或设置了 width/height 属性,渲染尺寸 ≠ 原始尺寸,硬编码的 coords 就会错位。
正确做法是:先拿到 img.naturalWidth 和 img.naturalHeight,再用 img.offsetWidth / img.naturalWidth 算出横向缩放比,同理算纵向比,最后把 area.coords 中每个数值乘以对应方向的缩放比。
- 不要用
img.width或img.offsetWidth直接当分母——它们可能被样式覆盖或尚未计算完成 - 必须等
img.onload触发后读取naturalWidth/naturalHeight,否则返回0 - 若
<img alt="HTML区域映射读取naturalHeight教程" >使用了srcset或picture,应读取img.currentSrc对应的自然尺寸,而非初始src
监听 img onload 才能安全读取 naturalHeight
DOM 加载完成时,<img alt="HTML区域映射读取naturalHeight教程" > 往往还没解码完毕,naturalHeight 还是 0。强行读取会导致坐标计算全错,热区偏移甚至失效。
立即学习“前端免费学习笔记(深入)”;
必须绑定 onload 回调,在里面读取:
const img = document.querySelector('img[usemap]');
img.onload = () => {
const scaleW = img.offsetWidth / img.naturalWidth;
const scaleH = img.offsetHeight / img.naturalHeight;
const areas = document.querySelectorAll('map[name="' + img.useMap.slice(1) + '"] area');
areas.forEach(area => {
const [x1, y1, x2, y2] = area.coords.split(',').map(Number);
area.dataset.scaledCoords = [
Math.round(x1 * scaleW),
Math.round(y1 * scaleH),
Math.round(x2 * scaleW),
Math.round(y2 * scaleH)
].join(',');
});
};- 别在
DOMContentLoaded里直接读——大概率拿到0 - 如果图片是动态插入或
src后续变更,要重新监听onload,旧监听不会自动触发 - IE9+ 支持
naturalHeight,但 IE8 及更早需 fallback 到new Image()+onload方案
上传文件时校验 naturalHeight 需绕过 DOM img 元素
用户从本地选图上传时,<img alt="HTML区域映射读取naturalHeight教程" > 标签还没存在,没法挂 onload。这时得手动创建 Image 实例,用 URL.createObjectURL(file) 加载二进制数据。
关键点:
- 必须用
URL.createObjectURL(file),不能直接赋file给src(会报跨域或解析失败) -
onerror必须处理:损坏图、SVG(部分浏览器不支持 SVG 的natural*)、非图像文件都会触发,不处理会导致后续逻辑卡死 - 每次校验完立刻调用
URL.revokeObjectURL(),否则内存泄漏 - 不要复用同一个
Image实例做多次校验——状态会残留,比如上次的onload还挂着
示例:
function checkImageSize(file) {
return new Promise((resolve, reject) => {
const img = new Image();
img.onload = () => {
URL.revokeObjectURL(img.src);
resolve({ width: img.naturalWidth, height: img.naturalHeight });
};
img.onerror = () => {
URL.revokeObjectURL(img.src);
reject(new Error('Invalid image file'));
};
img.src = URL.createObjectURL(file);
});
}最易被忽略的是:naturalWidth/naturalHeight 不是“加载完成就能读”,而是“解码完成才能读”——有些大图或 WebP 图片即使触发了 onload,natural* 仍为 0,极少数情况下需加 setTimeout 重试;但更稳妥的做法是结合 decode() API(Chrome 54+、Firefox 68+ 支持),不过兼容性要求高时仍得 fallback 到轮询判断。



















