DivBoderLabel
查阅Cesium API

new mars3d.graphic.DivBoderLabel(options)
graphic/div/DivBoderLabel.js 53

动态边框文本 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 可选

编辑时，是否绑定右键编辑菜单
hasEditRevoke 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
graphic/div/DivGraphic.js 321

是否贴地

继承自:

readonly container : HTMLDivElement
graphic/div/DivGraphic.js 356

对应的DOM元素

继承自:

readonly containerId : string
graphic/div/DivGraphic.js 365

对应的DOM元素的id

继承自:

readonly coordinate : Array
graphic/div/DivGraphic.js 183

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

继承自:

depthTest : boolean
graphic/div/DivGraphic.js 308

是否打开深度判断（true时判断是否在球背面）

继承自:

readonly EditClass : EditDivGraphic
graphic/div/DivGraphic.js 300

编辑处理类

继承自:

html : string|HTMLDivElement
graphic/div/DivGraphic.js 395

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

继承自:

readonly isEditing : boolean
graphic/div/DivGraphic.js 291

是否正在编辑状态

继承自:

readonly parentContainer : HTMLElement
graphic/div/DivGraphic.js 335

父容器DOM对象

继承自:

readonly parentContainerId : string
graphic/div/DivGraphic.js 347

父容器DOM对象的ID

继承自:

readonly point : LngLatPoint
graphic/div/DivGraphic.js 174

位置坐标 （笛卡尔坐标）

继承自:

pointerEvents : boolean
graphic/div/DivGraphic.js 277

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

继承自:

position : Cesium.Cartesian3|LngLatPoint
graphic/div/DivGraphic.js 126

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

继承自:

readonly positionShow : Cesium.Cartesian3
graphic/div/DivGraphic.js 197

当前实时位置坐标（笛卡尔坐标）

继承自:

template : string
graphic/div/DivGraphic.js 376

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

继承自:

testPoint : boolean
graphic/div/DivGraphic.js 241

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

继承自:

方法

addClass(className, isParent) → void
graphic/div/DivGraphic.js 1301

添加指定的className的calss样式

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

class样式名称
isParent boolean 可选

多个子节点时，是否在根节点添加
返回值:

无

继承自:

addDynamicPosition(point, currTime) → DivGraphic
graphic/div/DivGraphic.js 1045

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

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

指定位置坐标
currTime Cesium.JulianDate | Date | string | number 可选

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

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

继承自:

autoSurfaceHeight(options) → Promise.<object>
graphic/div/DivGraphic.js 1266

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

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

参数对象:

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

是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
objectsToExclude Array.<object> 可选

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

异步计算完成的Promise

继承自:

closeHighlight() → void
graphic/div/DivGraphic.js 1157

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

返回值:

无

继承自:

enableControl(value) → void
graphic/div/DivGraphic.js 1466

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

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

是否启用
返回值:

无

继承自:

endDraw() → void
graphic/div/DivGraphic.js 1445

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

返回值:

无

继承自:

getCoordinate(noAlt) → Array
graphic/div/DivGraphic.js 1123

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

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

true时不导出高度值
返回值:

位置坐标(数组对象)

继承自:

getRectangle(options) → Cesium.Rectangle|object
graphic/div/DivGraphic.js 1285

获取数据的矩形边界

参数名称 类型 描述信息
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
graphic/div/DivGraphic.js 1029

隐藏当前对象

返回值:

无

继承自:

openHighlight(highlightStyle, closeLast) → void
graphic/div/DivGraphic.js 1137

高亮对象。

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

高亮的样式，具体见各GraphicType矢量数据的style参数。
closeLast boolean true 可选

是否清除地图上上一次的高亮对象
返回值:

无

继承自:

redraw() → void
graphic/div/DivGraphic.js 675

重新渲染对象

返回值:

无

继承自:

removeClass(className, isParent) → void
graphic/div/DivGraphic.js 1318

移除指定的className的calss样式

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

class样式名称
isParent boolean 可选

多个子节点时，是否在根节点移除
返回值:

无

继承自:

setOpacity(value) → void
graphic/div/DivGraphic.js 528

设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。 对象本身透明度请用 graphic.setStyle({ opacity: value })

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

透明度
返回值:

无

继承自:

startDraw(layer) → void
graphic/div/DivGraphic.js 1337

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

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

图层
返回值:

无

继承自:

startEditing() → void
graphic/div/DivGraphic.js 1481

开始编辑对象

返回值:

无

继承自:

stopDraw() → void
graphic/div/DivGraphic.js 1362

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

返回值:

无

继承自:

stopEditing() → void
graphic/div/DivGraphic.js 1508

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

返回值:

无

继承自:

updateDivPosition() → DivGraphic
graphic/div/DivGraphic.js 758

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

返回值:

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

继承自:

定义的类型

mars3d.graphic.DivBoderLabel.StyleOptions
graphic/div/DivBoderLabel.js 6

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

属性:
属性名称 类型 可选 默认值 描述信息
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存在模版字符串配置时，空值时显示的内容