控件類
Control
此類是所有控件的基類，您可以通過此類來實(shí)現(xiàn)自定義控件。所有控件均包含Control類的屬性、方法和事件。通過Map.addControl()方法可將控件添加到地圖上。
構(gòu)造函數(shù) | 描述 |
Control() | 創(chuàng)建一個(gè)控件原型實(shí)例，通過該原型實(shí)例可創(chuàng)建自定義控件 |
屬性 | 類型 | 描述 |
defaultAnchor | 控件默認(rèn)的停靠位置。自定義控件時(shí)需要提供此屬性，作為控件的默認(rèn)停靠位置 | |
defaultOffset | 控件默認(rèn)的位置偏移值。自定義控件時(shí)需要提供此屬性，作為控件的默認(rèn)偏移位置 |
方法 | 返回值 | 描述 |
initialize(map:Map) | HTMLElement | 抽象方法。調(diào)用Map.addControl()方法添加控件時(shí)將調(diào)用此方法，從而實(shí)現(xiàn)該控件的初始化。自定義控件時(shí)需要實(shí)現(xiàn)此方法，并將元素的DOM元素在該方法中返回。DOM元素需要添加到地圖的容器中，使用map.getContainer()方法可獲得地圖容器元素 |
setAnchor(anchor:ControlAnchor) | none | 設(shè)置控件停靠的位置 |
getAnchor() | 返回控件停靠的位置 | |
setOffset(offset:Size) | none | 設(shè)置控件停靠的偏移量 |
getOffset() | 返回控件停靠的偏移量 | |
show() | none | 顯示控件 |
hide() | none | 隱藏控件 |
isVisible() | Boolean | 判斷控件的可見性 |
ControlAnchor
此常量表示控件的定位。
常量 | 描述 |
BMAP_ANCHOR_TOP_LEFT | 控件將定位到地圖的左上角 |
BMAP_ANCHOR_TOP_RIGHT | 控件將定位到地圖的右上角 |
BMAP_ANCHOR_BOTTOM_LEFT | 控件將定位到地圖的左下角 |
BMAP_ANCHOR_BOTTOM_RIGHT | 控件將定位到地圖的右下角 |
NavigationControl
此類表示地圖的平移縮放控件，可以對(duì)地圖進(jìn)行上下左右四個(gè)方向的平移和縮放操作。
構(gòu)造函數(shù) | 描述 |
NavigationControl(type: NavigationControlOptions) | 創(chuàng)建一個(gè)特定樣式的地圖平移縮放控件 |
方法 | 返回值 | 描述 |
getType() | 返回平移縮放控件的類型 | |
setType(type: NavigationControlType) | none | 設(shè)置平移縮放控件的類型 |
NavigationControlOptions
此類表示NavigationControl構(gòu)造函數(shù)的可選參數(shù)。它沒有構(gòu)造函數(shù)，但可通過對(duì)象字面量形式表示。
屬性 | 類型 | 描述 |
anchor | 控件的停靠位置 | |
offset | 控件的水平偏移值 | |
type | 平移縮放控件的類型 | |
showZoomInfo | Boolean | 是否顯示級(jí)別提示信息 |
enableGeolocation | Boolean | 控件是否集成定位功能，默認(rèn)為false |
NavigationControlType
此常量表示平移縮放控件的類型。
常量 | 描述 |
BMAP_NAVIGATION_CONTROL_LARGE | 標(biāo)準(zhǔn)的平移縮放控件（包括平移、縮放按鈕和滑塊） |
BMAP_NAVIGATION_CONTROL_SMALL | 僅包含平移和縮放按鈕 |
BMAP_NAVIGATION_CONTROL_PAN | 僅包含平移按鈕 |
BMAP_NAVIGATION_CONTROL_ZOOM | 僅包含縮放按鈕 |
GeolocationControl
此類是負(fù)責(zé)進(jìn)行地圖定位的控件，使用html5瀏覽器定位功能，此類繼承Control所有功能。
構(gòu)造函數(shù) | 描述 |
GeolocationControl(type: GeolocationControlOptions) | 創(chuàng)建一個(gè)特定樣式的地圖定位控件 |
方法 | 返回值 | 描述 |
location() | none | 開始進(jìn)行定位 |
getAddressComponent() | 返回當(dāng)前的定位信息。若當(dāng)前還未定位，則返回null |
事件 | 參數(shù) | 描述 |
locationSuccess | {point, AddressComponent} | 定位成功后觸發(fā)此事件 |
locationError | {StatusCode} | 定位失敗后觸發(fā)此事件 |
GeolocationControlOptions
此類表示GeolocationControl構(gòu)造函數(shù)的可選參數(shù)。它沒有構(gòu)造函數(shù)，但可通過對(duì)象字面量形式表示。
屬性 | 類型 | 描述 |
anchor | 控件的停靠位置，默認(rèn)定位到地圖的右下角 | |
offset | 控件的水平偏移值 | |
showAddressBar | Boolean | 是否顯示定位信息面板。默認(rèn)顯示定位信息面板 |
enableAutoLocation | Boolean | 添加控件時(shí)是否進(jìn)行定位。默認(rèn)添加控件時(shí)不進(jìn)行定位 |
locationIcon | 可自定義定位中心點(diǎn)的Icon樣式 |
OverviewMapControl
此類表示縮略地圖控件。
構(gòu)造函數(shù) | 描述 |
OverviewMapControl(opts: OverviewMapControlOptions) | 創(chuàng)建一個(gè)縮略地圖控件實(shí)例 |
方法 | 返回值 | 描述 |
changeView() | none | 切換縮略地圖控件的開合狀態(tài) |
setSize(size: Size) | none | 設(shè)置縮略地圖的大小 |
getSize() | 返回縮略地圖的大小 |
事件 | 參數(shù) | 描述 |
viewchanged | event{type, target, isOpen} | 縮略地圖開合狀態(tài)發(fā)生變化后觸發(fā)此事件 |
viewchanging | event{type, target} | 縮略地圖開合狀態(tài)發(fā)生變化過程中觸發(fā)此事件 |
OverviewMapControlOptions
此類表示OverviewMapControl構(gòu)造函數(shù)的可選參數(shù)。它沒有構(gòu)造函數(shù)，但可通過對(duì)象字面量形式表示。
屬性 | 類型 | 描述 |
anchor | 控件的停靠位置 | |
offset | 控件的偏移值 | |
size | 縮略地圖控件的大小 | |
isOpen | Boolean | 縮略地圖添加到地圖后的開合狀態(tài)，默認(rèn)為關(guān)閉 |
ScaleControl
此類表示比例尺控件。
構(gòu)造函數(shù) | 描述 |
ScaleControl(opts: ScaleControlOptions) | 創(chuàng)建一個(gè)比例尺控件 |
方法 | 返回值 | 描述 |
getUnit() | 返回比例尺單位制 | |
setUnit(unit: LengthUnit) | none | 設(shè)置比例尺單位制 |
ScaleControlOptions
此類表示ScaleControl構(gòu)造函數(shù)的可選參數(shù)。它沒有構(gòu)造函數(shù)，但可通過對(duì)象字面量形式表示。
屬性 | 類型 | 描述 |
anchor | 控件的停靠位置 | |
offset | 控件的偏移值 |