简介

百度地图上负责与地图交互的UI元素称为控件。百度地图Lite API中提供了比较简单常用的控件，您还可以通过Control类来实现自定义控件。
请参考文档最后扫描二维码体验～

普通控件

自定义控件

DEMO详情

提供的控件

详情可见类参考。

控件	类名	简介
抽象基类	Control	所有控件
缩放控件	ZoomControl	提供缩放地图的功能
比例尺控件	ScaleControl	显示当前地图的比例关系

向地图添加控件

可以使用Map.addConmtrol()方法向地图添加控件。

1地图初始化

添加控件前，地图需要进行初始化。

var map = new BMap.Map("container"); 
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11); 

2初始化控件

通过声明一个控件对象来初始化控件，下面分别初始化缩放控件和比例尺控件。

var zoomCtrl = new BMap.ZoomControl();
var scaleCtrl = new BMap.ScaleControl();   

3添加控件

分别把第2步中初始化的两个控件添加到地图中。

map.addControl(zoomCtrl);
map.addControl(scaleCtrl);

控制控件位置

初始化控件时，可提供一个可选参数，其中的anchor和offset属性共同控制控件在地图上的位置。 anchor表示控件的停靠位置，即控件停靠在地图的哪个角。当地图尺寸发生变化时，控件会根据停靠位置的不同来调整自己的位置。

anchor值	位置说明
BMAP_ANCHOR_TOP_LEFT	表示控件定位于地图的左上角
BMAP_ANCHOR_TOP_RIGHT	表示控件定位于地图的右上角
BMAP_ANCHOR_BOTTOM_LEFT	表示控件定位于地图的左下角
BMAP_ANCHOR_BOTTOM_RIGHT	表示控件定位于地图的右下角

控件位置偏移

除了指定停靠位置外，还可以通过偏移量来指示控件距离地图边界有多少像素。如果两个控件的停靠位置相同，那么控件可能会重叠在一起，这时就可以通过偏移值使二者分开显示。

如下示例为：将比例尺放置在地图的左下角，由于API默认会有版权信息，因此需要添加一些偏移值以防止控件重叠。

var opts = {offset: new BMap.Size(150, 5)}
map.addControl(new BMap.ScaleControl(opts));

自定义控件

百度地图JavaScript Lite API 允许您通过集成Control类来创建自定义地图控件。

1定义一个自定义控件的构造函数并集成Control

您需要定义自定义控件的构造函数，并在构造函数中提供defaultAnchor和defaultOffset两个属性，以便API正确定位控件位置，接着让其继承于Control。在下面的示例中我们定义一个名为BigZoomControl的控件，每一次点击将地图放大两个级别。

// 定义一个控件类，即function 
 function BigZoomControl() { 
// 设置默认停靠位置和偏移量
  this.defaultAnchor = BMAP_ANCHOR_TOP_LEFT;
  this.defaultOffset = new BMap.Size(10, 10);
 

 }
// 通过JavaScript的prototype属性继承于BMap.Control
 
  BigZoomControl.prototype = new BMap.Control();

2初始化自定义控件

设置自定义控件构造函数的prototype属性为Control的实例，以便继承控件基类。

当调用map.addControl()方法添加自定义控件时，API会调用该对象的initialize()方法用来初始化控件，您需要实现此方法并在其中创建控件所需的DOM元素，并添加DOM事件。所有自定义控件中的DOM元素最终都应该添加到地图容器（即地图所在的DOM元素）中去，地图容器可以通过map.getContainer()方法获得。最后initialize()方法需要返回控件容器的DOM元素。

// 自定义控件必须实现自己的initialize方法,并且将控件的DOM元素返回
// 在本方法中创建个div元素作为控件的容器,并将其添加到地图容器中
BigZoomControl.prototype.initialize = function(map){
// 创建一个DOM元素
var div = document.createElement("div");
// 添加文字说明
div.appendChild(document.createTextNode("放大2级"));
// 设置样式
div.style.cursor = "pointer";
div.style.border = "1px solid gray";
div.style.backgroundColor = "white";
// 绑定事件,点击一次放大两级
div.onclick = function(e){
map.setZoom(map.getZoom() + 2);
}
// 添加DOM元素到地图中
map.getContainer().appendChild(div);
// 将DOM元素返回
return div;
}

3添加自定义控件

添加自定义控件与添加其他控件方法一致，调用map.addControl()方法即可。

// 创建控件
var myZoomCtrl = new BigZoomControl();
// 添加到地图当中
map.addControl(myZoomCtrl);

扫描二维码体验：