ScaleControl

此类表示比例尺控件。 anchor属性为整体停靠位置。 控件宽度不固定。 默认位置为百度地图logo右侧（如果放在左下角，尽量不要设置offset）。

构造函数

  • 创建比例尺控件

    参数类型说明
    opts 可选ScaleControlOptions可选参数
    属性类型说明
    anchorControlAnchor控件的停靠位置
    offsetSize控件的偏移值，桌面端默认值为 new BMap.Size(81, 18)，移动端默认值为 new BMap.Size(75, 10)

    返回值 ScaleControl

    示例代码1

    const scaleControl = new BMap.ScaleControl({
      anchor: BMAP_ANCHOR_BOTTOM_LEFT,
    });
    map.addControl(scaleControl);

属性

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

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

方法

  • 隐藏控件

    返回值 void

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

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

    参数类型说明
    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));

  • 设置比例尺的单位制

    参数类型说明
    unitLengthUnit单位制

    返回值 void

    示例代码1

    scaleControl.setUnit(BMAP_UNIT_METRIC);

    示例代码2：英制单位

    scaleControl.setUnit(BMAP_UNIT_IMPERIAL);

  • 显示控件

    返回值 void