Map areas 集合

HTML DOM Map 对象

定义和用法

area 集合返回图像映射中所有 <area> 元素 的集合。

注释：集合中的元素按照它们在源代码中出现的顺序进行排序。

提示：如需返回所有已规定 href 属性的 <area> 元素 的集合，请使用 links 集合。

实例

例子 1

查明指定的图像映射中有多少 <area> 元素：

var x = document.getElementById("planetmap").areas.length;

亲自试一试

x 的结果是：

3

页面下方有更多 TIY 实例。

语法

mapObject.areas

属性

值 描述
length

返回集合中 <area> 元素的数量。

注释：此属性是只读的

方法

方法 描述
[index]

返回集合中有指定索引的 <area> 元素（从 0 开始）。

注释：如果索引号超出范围，则返回 null。
item(index)

返回集合中有指定索引的 <area> 元素（从 0 开始）。

注释：如果索引号超出范围，则返回 null。
namedItem(id)

返回集合中有指定 id 的 <area> 元素。

注释：如果 id 不存在则返回 null。

技术细节

DOM 版本： Core Level 2 Document Object
返回值：

HTMLCollection 对象，表示文档中图像映射中的所有 <area> 元素。

集合中的元素按照它们在源代码中出现的顺序进行排序。

浏览器支持

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
支持 支持 支持 支持 支持

更多实例

例子 2：[index]

获取图像映射中第一个 <area> 元素的 URL：

var x = document.getElementById("planetmap").areas[0].href;

亲自试一试

x 的结果将是：

https://www.w3school.com.cn/jsref/sun.html

例子 3：item(index)

获取图像映射中第一个 <area> 元素的 URL：

var x = document.getElementById("planetmap").areas.item(0).href;

亲自试一试

x 的结果将是：

https://www.w3school.com.cn/jsref/sun.html

例子 4：namedItem(id)

获取图像映射中 id="myArea" 的 <area> 元素的 URL：

var x = document.getElementById("planetmap").areas.namedItem("myArea").href;

亲自试一试

x 的结果将是：

https://www.w3school.com.cn/jsref/mercur.html

例子 5

遍历图像映射中的所有 <area> 元素并输出每个区域的形状：

var x = document.getElementById("planetmap");
var txt = "";
var i;
for (i = 0; i < x.areas.length; i++) {
  txt = txt + x.areas[i].shape + "<br>";
}

亲自试一试

x 的结果将是：

rect
circle
circle

HTML DOM Map 对象