DivBoderLabel

new mars3d.graphic.DivBoderLabel(options)

动态边框文本 DIV点

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

参数对象,包括以下:

参数名称 类型 默认值 描述信息
position LngLatPoint | Cesium.Cartesian3 | Cesium.PositionProperty | BaseGraphic.AjaxPosition | Array.<number> | string 可选

坐标位置

style DivBoderLabel.StyleOptions

样式信息

attr object | BaseGraphic.AjaxAttr 可选

附件的属性信息,可以任意附加属性,导出geojson或json时会自动处理导出。

hasEdit boolean true 可选

是否允许编辑

hasEditContextMenu boolean true 可选

编辑时,是否绑定右键编辑菜单

testPoint PointEntity.StyleOptions 可选

测试点 的对应样式 ,可以进行用于比较测试div的位置,方便调试CSS。

pointerEvents boolean 可选

DIV是否可以鼠标交互,为false时可以穿透操作及缩放地图,但无法进行鼠标交互及触发相关事件。

hasZIndex boolean false 可选

是否自动调整DIV的层级顺序。

zIndex number | string "auto" 可选

指定固定的zIndex层级属性(当hasZIndex为true时无效)

depthTest boolean true 可选

是否打开深度判断(true时判断是否在球背面)

hasCache boolean true 可选

是否启用缓存机制,如为true,在视角未变化时不重新渲染。

popup string | Array | function 可选

绑定的popup弹窗值,也可以bindPopup方法绑定

popupOptions Popup.StyleOptions 可选

popup弹窗时的配置参数,也支持如pointerEvents等Popup构造参数

tooltip string | Array | function 可选

绑定的tooltip弹窗值,也可以bindTooltip方法绑

tooltipOptions Tooltip.StyleOptions 可选

tooltip弹窗时的配置参数,也支持如pointerEvents等Tooltip构造参数

contextmenuItems object 可选

当矢量数据支持右键菜单时,也可以bindContextMenu方法绑定

id string | number createGuid() 可选

矢量数据id标识

name string '' 可选

矢量数据名称

show boolean true 可选

矢量数据是否显示

availability Cesium.TimeIntervalCollection | Cesium.TimeInterval | Array | object 可选

指定时间范围内显示该对象

eventParent BaseClass | boolean 可选

指定的事件冒泡对象,默认为所加入的图层对象,false时不冒泡事件

flyTo boolean 可选

加载完成数据后是否自动飞行定位到数据所在的区域。

flyToOptions object 可选

加载完成数据后是否自动飞行定位到数据所在的区域的对应 BaseGraphic#flyTo方法参数。

参考:

继承

成员(属性)

clampToGround : boolean

是否贴地

继承自:

readonly container : HTMLDivElement

对应的DOM元素

继承自:

readonly containerId : string

对应的DOM元素的id

继承自:

readonly coordinate : Array

位置坐标(数组对象),示例[113.123456,31.123456,30.1]

继承自:

depthTest : boolean

是否打开深度判断(true时判断是否在球背面)

继承自:

readonly EditClass : EditDivGraphic

编辑处理类

继承自:

html : string|HTMLDivElement

设置或获取当前对象对应的Html

继承自:

readonly isEditing : boolean

是否正在编辑状态

继承自:

readonly parentContainer : HTMLElement

父容器DOM对象

继承自:

readonly parentContainerId : string

父容器DOM对象的ID

继承自:

readonly point : LngLatPoint

位置坐标 (笛卡尔坐标)

继承自:

pointerEvents : boolean

DIV是否可以鼠标交互,为false时可以穿透操作及缩放地图,但无法进行鼠标交互及触发相关事件。

继承自:

position : Cesium.Cartesian3|LngLatPoint

位置坐标 (笛卡尔坐标), 赋值时可以传入LatLngPoint对象

继承自:

readonly positionShow : Cesium.Cartesian3

当前实时位置坐标(笛卡尔坐标)

继承自:

template : string

公共部分外框部分html内容,需要加2处: (1)用于填充html的地方写上{content}标识; (2)关闭按钮加class样式:closeButton。 传空字符串或false时,不用内置模版。

继承自:

testPoint : boolean

是否显示测试点,可以进行用于比较测试div的位置,方便调试CSS。

继承自:

方法

addClass(className, isParent)void

添加指定的className的calss样式

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

class样式名称

isParent boolean 可选

多个子节点时,是否在根节点添加

返回值:

继承自:

addDynamicPosition(point, currTime)DivGraphic

设置并添加动画轨迹位置,按“指定时间”运动到达“指定位置”。

参数名称 类型 描述信息
point LngLatPoint | Cesium.Cartesian3 | Array.<number>

指定位置坐标

currTime Cesium.JulianDate | Date | string | number 可选

指定时间, 默认为当前时间。当为String时,可以传入'2021-01-01 12:13:00'; 当为Number时,可以传入当前时间延迟的秒数。

返回值:

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

继承自:

autoSurfaceHeight(options)Promise.<object>

异步计算更新坐标高度进行贴地(或贴模型),内部自动调用PointUtil#getSurfaceHeight方法处理。

参数名称 类型 默认值 描述信息
options object {} 可选

参数对象:

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

是否在3dtiles模型上分析(模型分析较慢,按需开启),默认内部根据点的位置自动判断(但可能不准)

objectsToExclude Array.<object> 可选

贴模型分析时,排除的不进行贴模型计算的模型对象,可以是: primitives, entities, 或 3D Tiles features

返回值:

异步计算完成的Promise

继承自:

closeHighlight()void

清除已选中的高亮,原有style的配置项需要与highlightStyle配置有一一对应关系,否则无法清除

返回值:

继承自:

enableControl(value)void

启用或禁用popup、tooltip、contextmenu内部控件, 主要用于标绘时来关闭避免交互冲突。

参数名称 类型 描述信息
value boolean

是否启用

返回值:

继承自:

endDraw()void

完成绘制和编辑,如有未完成的绘制会自动完成。 在移动端需要调用此方法来类似PC端双击结束。

返回值:

继承自:

getCoordinate(noAlt)Array

位置坐标(数组对象),示例[113.123456,31.123456,30.1]

参数名称 类型 描述信息
noAlt boolean

true时不导出高度值

返回值:

位置坐标(数组对象)

继承自:

getRectangle(options)Cesium.Rectangle|object

获取数据的矩形边界

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

控制参数

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

是否格式化,格式化时示例: { xmin: 73.16895, xmax: 134.86816, ymin: 12.2023, ymax: 54.11485 }

返回值:

isFormat:true时,返回格式化对象,isFormat:false时返回Cesium.Rectangle对象

继承自:

hide()void

隐藏当前对象

返回值:

继承自:

openHighlight(highlightStyle, closeLast)void

高亮对象。

参数名称 类型 默认值 描述信息
highlightStyle object 可选

高亮的样式,具体见各GraphicType矢量数据的style参数。

closeLast boolean true 可选

是否清除地图上上一次的高亮对象

返回值:

继承自:

redraw()void

重新渲染对象

返回值:

继承自:

removeClass(className, isParent)void

移除指定的className的calss样式

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

class样式名称

isParent boolean 可选

多个子节点时,是否在根节点移除

返回值:

继承自:

setOpacity(value)void

设置透明度

参数名称 类型 描述信息
value number

透明度

返回值:

继承自:

startDraw(layer)void

开始绘制创建矢量数据,绘制的数据会加载在layer图层。

参数名称 类型 描述信息
layer GraphicLayer

图层

返回值:

继承自:

startEditing()void

开始编辑对象

返回值:

继承自:

stopDraw()void

停止绘制,如有未完成的绘制会自动删除

返回值:

继承自:

stopEditing()void

停止编辑,释放正在编辑的对象。

返回值:

继承自:

updateDivPosition()DivGraphic

更新刷新下DIV的位置,可以外部主动驱动来更新。

返回值:

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

继承自:

定义的类型

mars3d.graphic.DivBoderLabel.StyleOptions

动态边框文本 支持的样式信息

属性:
属性名称 类型 可选 默认值 描述信息
text string

文本内容

font_size number <可选>
15

字体大小

font_family string <可选>
"楷体"

字体 ,可选项:微软雅黑,宋体,楷体,隶书,黑体 等

color string <可选>
"#ccc"

文本CSS颜色

boderColor string <可选>
"rgb(21, 209, 242)"

边框CSS颜色

width number <可选>

面板宽度(px像素值),默认根据文本内容和字体大小自动计算

height number <可选>

面板高度(px像素值),默认根据文本内容和字体大小自动计算

horizontalOrigin Cesium.HorizontalOrigin <可选>

横向方向的定位

verticalOrigin Cesium.VerticalOrigin <可选>

垂直方向的定位

offsetX number <可选>

用于非规则div时,横向偏移的px像素值

offsetY number <可选>

用于非规则div时,垂直方向偏移的px像素值

scaleByDistance boolean <可选>
false

是否按视距缩放

scaleByDistance_far number <可选>
1000000

上限

scaleByDistance_farValue number <可选>
0.1

比例值

scaleByDistance_near number <可选>
1000

下限

scaleByDistance_nearValue number <可选>
1

比例值

distanceDisplayCondition boolean <可选>
false

是否按视距显示

distanceDisplayCondition_far number <可选>
Number.MAX_VALUE

最大距离

distanceDisplayCondition_near number <可选>
0

最小距离

clampToGround boolean <可选>
false

是否贴地

heightReference Cesium.HeightReference <可选>
Cesium.HeightReference.NONE

指定高度相对于什么的属性。

css_transform_origin string <可选>
'left bottom 0'

DIV的 transform-origin css值

timeRender boolean <可选>

是否实时刷新全部HTML,此时需要绑定html需传入回调方法。

setHeight number | string <可选>

指定坐标高度值(对编辑时无效,仅初始化传入有效,常用于图层中配置),也支持字符串模版配置

addHeight number | string <可选>

在现有坐标基础上增加的高度值(对编辑时无效,仅初始化传入有效,常用于图层中配置),也支持字符串模版配置

templateEmptyStr string <可选>
""

当text存在模版字符串配置时,空值时显示的内容