第1行: | 第1行: | ||
{{jspopularLiteV1-sidebar}} | {{jspopularLiteV1-sidebar}} | ||
− | <div class="bluetitle"><div class=" | + | <div class="bluetitle"><div class="serve-explain-text"><div class="service-page-anchor"><span>简介</span></div></div></div><div class="serve-explain-text">百度地图上负责与地图交互的UI元素称为控件。百度地图Lite API中提供了比较简单常用的控件,您还可以通过Control类来实现自定义控件。<br/><span style="color:#FF0000;">请参考文档最后扫描二维码体验~</span><br/></div><!--jsapi-demo模板--><div class="jsapidemo_template"><!--展示地图区域--><div class="demo_area"><!--注释:默认展示效果(填写第一个按钮连接),避免延时--><div dir="https://lbsyun.baidu.com/cms/jsapi/demo/jsapiLite/lite_1_0.html"></div></div><!--按钮区域--><div class="demo_control"><div class="demo_btn" style="width:50%;">[//lbsyun.baidu.com/cms/jsapi/demo/jsapiLite/lite_1_0.html 普通控件]</div><div class="demo_btn" style="width:485px;">[//lbsyun.baidu.com/cms/jsapi/demo/jsapiLite/lite_1_2.html 自定义控件]</div></div><!--右上角蓝色标签--可选--><div class="jsapi-demo-link">[http://lbsyun.baidu.com/jsdemo.htm#lite_1_0 DEMO详情]</div></div><div class="bluetitle"><div class="services-title-text">提供的控件</div></div><div class="serve-explain-text">详情可见[http://lbsyun.baidu.com/cms/jsapi/reference/lite.html#a2b0 类参考]。</div> |
{| width="507" border="1" | {| width="507" border="1" | ||
|- | |- | ||
第19行: | 第19行: | ||
| 显示当前地图的比例关系 | | 显示当前地图的比例关系 | ||
|} | |} | ||
− | <div class="bluetitle"><div class=" | + | <div class="bluetitle"><div class="serve-explain-text"><div class="service-page-anchor"><span>向地图添加控件</span></div></div></div><div class="serve-explain-text">可以使用Map.addConmtrol()方法向地图添加控件。</div><div class="devguide"><div class="leftborderbg" style="height:180px;"></div><div class="devguideorder"><span>1</span>地图初始化</div><div class="devguidecenter">添加控件前,地图需要进行初始化。<pre class="prettyprint codestyle">var map = new BMap.Map("container"); |
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11); | map.centerAndZoom(new BMap.Point(116.404, 39.915), 11); | ||
</pre> | </pre> | ||
第28行: | 第28行: | ||
map.addControl(scaleCtrl); | map.addControl(scaleCtrl); | ||
</pre> | </pre> | ||
− | </div></div><div class="bluetitle"><div class=" | + | </div></div><div class="bluetitle"><div class="serve-explain-text"><div class="service-page-anchor"><span>控制控件位置</span></div></div></div><div class="serve-explain-text">初始化控件时,可提供一个可选参数,其中的anchor和offset属性共同控制控件在地图上的位置。 anchor表示控件的停靠位置,即控件停靠在地图的哪个角。当地图尺寸发生变化时,控件会根据停靠位置的不同来调整自己的位置。</div> |
{| width="359" border="1" | {| width="359" border="1" | ||
|- | |- | ||
第46行: | 第46行: | ||
| 表示控件定位于地图的右下角 | | 表示控件定位于地图的右下角 | ||
|} | |} | ||
− | <div class="bluetitle"><div class=" | + | <div class="bluetitle"><div class="serve-explain-text"><div class="service-page-anchor"><span>控件位置偏移</span></div></div></div><div class="serve-explain-text"> |
除了指定停靠位置外,还可以通过偏移量来指示控件距离地图边界有多少像素。如果两个控件的停靠位置相同,那么控件可能会重叠在一起,这时就可以通过偏移值使二者分开显示。 | 除了指定停靠位置外,还可以通过偏移量来指示控件距离地图边界有多少像素。如果两个控件的停靠位置相同,那么控件可能会重叠在一起,这时就可以通过偏移值使二者分开显示。 | ||
如下示例为:将比例尺放置在地图的左下角,由于API默认会有版权信息,因此需要添加一些偏移值以防止控件重叠。</div><pre class="prettyprint codestyle">var opts = {offset: new BMap.Size(150, 5)} | 如下示例为:将比例尺放置在地图的左下角,由于API默认会有版权信息,因此需要添加一些偏移值以防止控件重叠。</div><pre class="prettyprint codestyle">var opts = {offset: new BMap.Size(150, 5)} | ||
map.addControl(new BMap.ScaleControl(opts)); | map.addControl(new BMap.ScaleControl(opts)); | ||
</pre> | </pre> | ||
− | <div class="bluetitle"><div class=" | + | <div class="bluetitle"><div class="serve-explain-text"><div class="service-page-anchor"><span>自定义控件</span></div></div></div><div class="serve-explain-text">百度地图JavaScript Lite API 允许您通过集成Control类来创建自定义地图控件。</div><div class="devguide"><div class="leftborderbg" style="height:500px;"></div><div class="devguideorder"><span>1</span>定义一个自定义控件的构造函数并集成Control</div><div class="devguidecenter">您需要定义自定义控件的构造函数,并在构造函数中提供defaultAnchor和defaultOffset两个属性,以便API正确定位控件位置,接着让其继承于Control。在下面的示例中我们定义一个名为BigZoomControl的控件,每一次点击将地图放大两个级别。<pre class="prettyprint codestyle">// 定义一个控件类,即function |
function BigZoomControl() { | function BigZoomControl() { | ||
// 设置默认停靠位置和偏移量 | // 设置默认停靠位置和偏移量 |
2022年8月19日 (五) 15:01的最后版本
简介
百度地图上负责与地图交互的UI元素称为控件。百度地图Lite API中提供了比较简单常用的控件,您还可以通过Control类来实现自定义控件。
请参考文档最后扫描二维码体验~
请参考文档最后扫描二维码体验~
提供的控件
详情可见类参考。
控件 | 类名 | 简介 |
抽象基类 | 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);
扫描二维码体验: