NavigationControl

此类表示地图的平移缩放控件。 anchor 属性表示控件的整体停靠位置。 typeBMAP_NAVIGATION_CONTROL_LARGE 时,包含平移按钮、缩放按钮和缩放层级滑块; 为 BMAP_NAVIGATION_CONTROL_SMALL 时,包含平移按钮和缩放按钮; 为 BMAP_NAVIGATION_CONTROL_PAN 时,仅包含平移按钮; 为 BMAP_NAVIGATION_CONTROL_ZOOM 时,仅包含缩放按钮。 enableGeolocationtrue 时可显示定位按钮。

构造函数

  • 创建平移缩放控件

    参数类型说明
    opts 可选NavigationControlOptions可选参数
    属性类型说明
    anchorControlAnchor控件的停靠位置,默认值为 BMAP_ANCHOR_TOP_LEFT
    enableGeolocationboolean控件是否集成定位功能,桌面端和移动端均生效
    offsetSize控件相对于停靠位置的偏移量,默认值为 new BMap.Size(30, 10)
    showZoomInfoboolean是否显示级别提示信息
    typeNavigationControlType平移缩放控件的类型

    返回值 NavigationControl

    示例代码1

    const navigationControl = new BMap.NavigationControl({
    anchor: BMAP_ANCHOR_TOP_LEFT,
    type: BMAP_NAVIGATION_CONTROL_LARGE,
    showZoomInfo: true,
    });
    map.addControl(navigationControl);

属性

控件默认停靠位置,自定义控件时需提供此属性

控件默认偏移量,自定义控件时需提供此属性

方法

  • 隐藏控件

    返回值 void

  • 抽象生命周期方法,用于初始化控件,当调用 map.addControl() 时内部将调用此方法。

    仅在自定义控件时需要实现此方法,并返回控件的 DOM 元素,DOM 元素需通过 map.getContainer() 添加到地图容器中。 内置控件(ZoomControlScaleControl 等)已在内部实现,用户无需调用也无需重写。

    参数类型说明
    mapMap地图实例

    返回值 HTMLElement

    示例代码1

    class MyControl extends BMap.Control {
    initialize(map: BMap.Map) {
    const div = document.createElement('div');
    div.textContent = '自定义控件';
    map.getContainer().appendChild(div);
    return div;
    }
    }
  • 返回控件的可见状态

    返回值 boolean

  • 设置控件停靠位置

    参数类型说明
    anchorControlAnchor停靠位置

    返回值 void

    示例代码2

    control.setAnchor(BMAP_ANCHOR_TOP_LEFT);
    
  • 设置控件停靠偏移量

    参数类型说明
    offsetSize偏移量

    返回值 void

    示例代码3

    control.setOffset(new BMap.Size(20, 20));
    
  • 设置平移缩放控件的类型

    参数类型说明
    typeNavigationControlType控件类型

    返回值 void

    示例代码1

    navigationControl.setType(BMAP_NAVIGATION_CONTROL_SMALL);
    
  • 显示控件

    返回值 void