LocationBar

new mars3d.control.LocationBar(options)

信息状态栏, 一般在页面下侧区域,包括鼠标经纬度等信息

参数名称 类型 描述信息
options object 可选

参数对象,包括以下:

参数名称 类型 默认值 描述信息
template string | Array.<string> 可选

展示的内容格式化字符串, 为数组时按多语言顺序定义,如[中文、繁体、英文] 支持以下模版配置: 【鼠标所在位置】 经度:{lng}, 纬度:{lat}, 海拔:{alt}米, 横{crsx} 纵{crsy} 【相机的】 方向角度:{heading}, 俯仰角度:{pitch}, 视高:{cameraHeight}米, 【地图的】 层级:{level} 【效率】 每秒帧率:{fps} (越高越流畅),延迟:{ms} 毫秒 (越小越流畅)

latDecimal number LngLatPoint.FormatLength 可选

保留的{lat}和{lng}的小数位

crs string | CRS | boolean 可选

按指定坐标系显示坐标值,true时取值CRS.CGCS2000_GK_Zone_3,配置后template可以加模板:【鼠标所在位置对应的crs坐标系】 X或经度值:{crsx}, Y或纬度值:{crsy}

crsDecimal number 1 可选

保留的{crsx}和{crsy}的小数位

style object 可选

可以CSS样式,如:

参数名称 类型 描述信息
top string 可选

css定位top位置, 如 top: '10px'

bottom string 可选

css定位bottom位置

left string 可选

css定位left位置

right string 可选

css定位right位置

cacheTime number 50 可选

鼠标移动的缓存时间

id string | number createGuid() 可选

对象的id标识

enabled boolean true 可选

对象的启用状态

parentContainer HTMLElement 可选

控件加入的父容器,默认为map所在的DOM map.container

insertIndex number 可选

可以自定义插入到父容器中的index顺序,默认是插入到最后面。

insertBefore HTMLElement | string 可选

可以自定义插入到指定兄弟容器的前面,与insertIndex二选一。

参考:

继承

成员(属性)

readonly container : HTMLElement

当前控件的DOM对象

继承自:

enabled : boolean

设置对象的启用和禁用状态。

继承自:

enabledEvent : boolean

设置事件的启用和禁用状态

继承自:

readonly id : string|number

对象的id标识

继承自:

readonly isAdded : boolean

是否已添加到地图

继承自:

readonly isDestroy : boolean

是否已经销毁了

继承自:

readonly locationData : object

显示的数据

readonly options : object

当前类的构造参数

继承自:

readonly parentContainer : HTMLElement

父容器DOM对象

继承自:

readonly parentContainerId : string

父容器DOM对象的ID

继承自:

show : boolean

设置DOM容器的显示隐藏

继承自:

readonly state : State

当前对象的状态

继承自:

readonly type : string

控件类型

继承自:

方法

addEventParent(obj)BaseClass

添加抛出事件到父类,它将接收传播的事件

参数名称 类型 描述信息
obj object

父类对象

返回值:

当前对象本身,可以链式调用

继承自:

addTo(map)BaseControl

添加到地图上,同 map.addControl

参数名称 类型 描述信息
map Map

地图对象

返回值:

当前对象本身,可以链式调用

继承自:

destroy(noDel)void

销毁当前对象

参数名称 类型 默认值 描述信息
noDel boolean false 可选

false:会自动delete释放所有属性,true:不delete绑定的变量

返回值:

继承自:

fire(type, data, propagate)BaseClass

触发指定类型的事件。

参数名称 类型 描述信息
type EventType | string

事件类型

data object 可选

传输的数据或对象,可在事件回调方法中event对象中获取进行使用

propagate BaseClass 可选

将事件传播给父类 (用addEventParent设置)

返回值:

当前对象本身,可以链式调用

继承自:

getLangText(key)string

获取当前key对应语言的文本内容。

参数名称 类型 描述信息
key string

文本key

返回值:

lang参数指定的对应文本内容

继承自:

hasEventParent(obj)boolean

是否绑定了抛出事件到指定父类

参数名称 类型 描述信息
obj object

父类对象

返回值:

是否绑定了抛出事件

继承自:

listens(type, propagate)boolean

是否有绑定指定的事件

参数名称 类型 描述信息
type EventType | string

事件类型

propagate BaseClass 可选

是否判断指定的父类 (用addEventParent设置的)

返回值:

是否存在

继承自:

off(types, fn, context)BaseClass

解除绑定指定类型事件监听器

参数名称 类型 描述信息
types EventType | string | Array.<EventType> 可选

事件类型,未传值时解绑所有事件

fn function 可选

绑定的监听器回调方法,未传值时解绑所有指定类型对应事件,特殊说明:map.on监听的Cesium相关原生事件时必须传入该参数

context object 可选

侦听器的上下文(this关键字将指向的对象)。

返回值:

当前对象本身,可以链式调用

继承自:

on(types, fn, context)BaseClass

绑定指定类型事件监听器, 支持在监听中调用 event.stopPropagation(); 阻止事件冒泡

参数名称 类型 描述信息
types EventType | string | Array.<EventType> | Array.<string> | object

事件类型

fn function

绑定的监听器回调方法

context object 可选

侦听器的上下文(this关键字将指向的对象)。

返回值:

当前对象本身,可以链式调用

继承自:

once(types, fn, context)BaseClass

绑定一次性执行的指定类型事件监听器 与on类似,监听器只会被触发一次,然后被删除。

参数名称 类型 描述信息
types EventType | string | Array.<EventType>

事件类型

fn function

绑定的监听器回调方法

context object 可选

侦听器的上下文(this关键字将指向的对象)。

返回值:

当前对象本身,可以链式调用

继承自:

reload()void

重新加载

返回值:

继承自:

remove(destroy)void

从地图上移除,同map.removeControl

参数名称 类型 描述信息
destroy boolean 可选

是否调用destroy释放

返回值:

继承自:

removeEventParent(obj)BaseClass

移除抛出事件到父类

参数名称 类型 描述信息
obj object

父类对象

返回值:

当前对象本身,可以链式调用

继承自:

setOptions(options)BaseThing|BaseControl|object

更新图层参数

参数名称 类型 描述信息
options object

与类的构造方法参数相同

返回值:

当前对象本身,可以链式调用

继承自:

setStyle(style)void

设置新的css样式信息

参数名称 类型 描述信息
style object

css样式

返回值:

继承自:

toJSON()object

将对象转为Json简单对象,用于存储后再传参加载

返回值:

Json简单对象

继承自:

定义的类型

mars3d.control.LocationBar.EventType

当前类支持的EventType事件类型

属性:
属性名称 类型 描述信息
change string

数据变化了

使用示例:
//绑定监听事件
thing.on(mars3d.EventType.change, function (event) {
  console.log('数据变化了', event)
})
参考: