Class: LabelThemeLayer

Extends

• mapboxgl.supermap.GeoFeatureThemeLayer

Members

highlightStyleSuperMap.ThemeStyle

专题图图层高亮样式

isAllowFeatureStyleboolean

是否允许 feature 样式（style） 中的有效属性应用到专题图层。
默认值为： false，禁止对专题要素使用数据（feature）的 style。此属性可强制将数据 feature 的 style 中有效属性应用到专题要素上，且拥有比图层 style 和 styleGroups 更高的优先级，使专题要素 的样式脱离专题图层的控制。可以通过此方式实现对特殊数据（feature） 对应专题要素赋予独立 style。

isAvoidboolean

是否进行地图边缘的避让处理，如果设为true，将把与地图边缘相交的标签移到地图范围内，默认为 true，在地图边缘处做避让处理。

isClickAbleboolean

图形是否可点击，默认 true

isHoverAbleboolean

图形是否在 hover 时高亮 ，默认值：false。

isMultiHoverboolean

是否多图形同时高亮，用于高亮同一个数据对应的所有图形（如：多面），默认值：false。

isOverLayboolean

是否进行压盖处理，如果设为true，将隐藏被压盖的标签，默认为true。

mapmapboxgl.Map

map对象

namestring

专题图图层名称

nodesClipPixelnumber

节点抽稀像素距离，默认值 2。

opacityfloat

图层透明度

styleSuperMap.ThemeStyle

专题图图层全局样式

styleGroupsArray.<Object>

分组样式。 使用此属性需要设置 themeField 属性。
1.没有同时设置 themeField 和 styleGroups，则所有专题要素都使用本图层的 style 进行渲染；
2.同时设置 themeField 和 styleGroups，则按照 themeField 指定的字段名称获取用户数据（feature）attributes 中对应的属性值；
a.如果属性值等于 styleGroups 数组里某个元素定义的 value 值，则此专题要素取 styleGroups 数组中该元素定义的 style 进行渲染。
b.如果属性值不等于 styleGroups 数组里任何元素定义的 value 值，则此专题要素按照本图层的 style 进行渲染。
此数组每个元素对象必须有两个属性：value : 与字段 themeField 相对应的属性值；style：专题要素 style。

themeFieldstring

用于指定专题要素样式的属性字段名称。
此属性字段是要用户数据（feature） attributes 中包含的字段，且字段对应的值的类型必须是数值型。
使用标签分组显示还需要设置 styleGroups 属性。

Methods

inherited addFeatures(features)

mapboxgl/overlay/theme/GeoFeatureThemeLayer.js, line 75

添加要素

Name	Type	Description
features	Object	要素对象

inherited addTFEvents()

mapboxgl/overlay/theme/ThemeLayer.js, line 280

将图层添加到地图上之前用户要求添加的事件监听添加到图层。

calculateLabelBounds(feature, loc){Array.<Object>}

mapboxgl/overlay/LabelThemeLayer.js, line 459

获得标签要素的最终范围

Name	Type	Description
feature	SuperMap.Feature.Vector	需要计算bounds的标签要素数。
loc	mapboxgl.Point	标签位置

Returns:

Type	Description
Array.<Object>	四边形节点数组。例如：[{"x":1,"y":1},{"x":3,"y":1},{"x":6,"y":4},{"x":2,"y":10},{"x":1,"y":1}]。

calculateLabelBounds2(feature, loc){Array.<Object>}

mapboxgl/overlay/LabelThemeLayer.js, line 504

获得标签要素的最终范围的另一种算法（通过记录下的标签宽高），提高计算bounds的效率。

Name	Type	Description
feature	SuperMap.Feature.Vector	需要计算bounds的标签要素数。
loc	mapboxgl.Point	标签位置

Returns:

Type	Description
Array.<Object>	四边形节点数组。例如：[{"x":1,"y":1},{"x":3,"y":1},{"x":6,"y":4},{"x":2,"y":10},{"x":1,"y":1}]。

inherited clear()

mapboxgl/overlay/theme/GeoFeatureThemeLayer.js, line 226

清除的内容包括数据（features） 、专题要素、缓存。

inherited clearCache()

mapboxgl/overlay/theme/GeoFeatureThemeLayer.js, line 217

清除缓存。

inherited destroyFeatures(features)

mapboxgl/overlay/theme/ThemeLayer.js, line 70

销毁某个要素

Name	Type	Description
features	Object	将被销毁的要素

getAvoidInfo(bounds, quadrilateral){Object}

mapboxgl/overlay/LabelThemeLayer.js, line 744

获取避让的信息。

Name	Type	Description
bounds	SuperMap.Bounds	地图像素范围。
quadrilateral	Array.<Object>	四边形节点数组。例如：[{"x":1,"y":1},{"x":3,"y":1},{"x":6,"y":4},{"x":2,"y":10},{"x":1,"y":1}]。

Returns:

Type	Description
Object	避让的信息

inherited getCacheCount(){number}

mapboxgl/overlay/theme/GeoFeatureThemeLayer.js, line 237

获取当前缓存数量。

Returns:

Type	Description
number	当前缓存数量。

getDrawnLabels(labelFeatures){Array.<SuperMap.Feature.Vector>}

mapboxgl/overlay/LabelThemeLayer.js, line 141

获取经（压盖）处理后将要绘制在图层上的标签要素

Name	Type	Description
labelFeatures	Array.<SuperMap.Feature.Vector>	所有标签要素的数组。

Returns:

Type	Description
Array.<SuperMap.Feature.Vector>	最终要绘制的标签要素数组。

inherited getFeatureBy(property, value){SuperMap.Feature.Vector}

mapboxgl/overlay/theme/ThemeLayer.js, line 189

在专题图的要素数组 features 里面遍历每一个 feature，当 feature[property] === value 时， 返回此 feature（并且只返回第一个）。

Name	Type	Description
property	string	feature 的某个属性名称。
value	string	property 所对应的值。

Returns:

Type	Description
SuperMap.Feature.Vector	第一个匹配属性和值的矢量要素。

inherited getFeatureById(featureId){SuperMap.Feature.Vector}

mapboxgl/overlay/theme/ThemeLayer.js, line 208

通过给定一个 id，返回对应的矢量要素。

Name	Type	Description
featureId	string	矢量要素的属性 id。

Returns:

Type	Description
SuperMap.Feature.Vector	对应id的 feature，如果不存在则返回 null。

inherited getFeatures(){SuperMap.Feature.Vector}

mapboxgl/overlay/theme/ThemeLayer.js, line 175

查看当前图层中的有效数据。

Returns:

Type	Description
SuperMap.Feature.Vector	用户加入图层的有效数据。

inherited getFeaturesByAttribute(attrName, attrValue){Array.<SuperMap.Feature.Vector>}

mapboxgl/overlay/theme/ThemeLayer.js, line 218

通过给定一个属性的 key 值和 value 值，返回所有匹配的要素数组。

Name	Type	Description
attrName	string	属性的 key。
attrValue	string	矢量要素的属性 id。

Returns:

Type	Description
Array.<SuperMap.Feature.Vector>	一个匹配的 feature 数组。

getLabelInfo(){Object}

mapboxgl/overlay/LabelThemeLayer.js, line 586

根据当前位置获取绘制后的标签信息，包括标签的宽，高和行数等

Returns:

Type	Description
Object	绘制后的标签信息

getLabelPxLocation(feature){mapboxgl.Point}

mapboxgl/overlay/LabelThemeLayer.js, line 432

获取标签要素的像素坐标

Name	Type	Description
feature	SuperMap.Feature.Vector	标签要素。

Returns:

Type	Description
mapboxgl.Point	标签位置

inherited getLocalXY(coordinate)

mapboxgl/overlay/theme/ThemeLayer.js, line 293

地理坐标转为像素坐标

Name	Type	Description
coordinate	Object	坐标位置。

getRotatedLocation(x, y, rx, ry, angle){Object}

mapboxgl/overlay/LabelThemeLayer.js, line 717

获取一个点绕旋转中心顺时针旋转后的位置。（此方法用于屏幕坐标）

Name	Type	Description
x	number	旋转点横坐标。
y	number	旋转点纵坐标。
rx	number	旋转中心点横坐标。
ry	number	旋转中心点纵坐标。
angle	number	旋转角度

Returns:

Type	Description
Object	旋转后的坐标位置对象，该对象含有属性x(横坐标)，属性y(纵坐标)。

getStyleByData(feat){Array.<SuperMap.ThemeStyle>}

mapboxgl/overlay/LabelThemeLayer.js, line 305

根据用户数据（feature）设置专题要素的 Style

Name	Type	Description
feat	SuperMap.Feature.Vector	矢量要素对象

Returns:

Type	Description
Array.<SuperMap.ThemeStyle>	专题要素的 Style

isPointInPoly(pt, poly){boolean}

mapboxgl/overlay/LabelThemeLayer.js, line 888

判断一个点是否在多边形里面。(射线法)

Name	Type	Description
pt	Object	需要判定的点对象，该对象含有属性x(横坐标)，属性y(纵坐标)。
poly	Array.<Object>	多边形节点数组。例如一个四边形：[{"x":1,"y":1},{"x":3,"y":1},{"x":6,"y":4},{"x":2,"y":10},{"x":1,"y":1}]

Returns:

Type	Description
boolean	点是否在多边形内

isQuadrilateralOverLap(quadrilateral, quadrilateral2){boolean}

mapboxgl/overlay/LabelThemeLayer.js, line 841

判断两个四边形是否有压盖

Name	Type	Description
quadrilateral	Array.<Object>	四边形节点数组。例如：[{"x":1,"y":1},{"x":3,"y":1},{"x":6,"y":4},{"x":2,"y":10},{"x":1,"y":1}]。
quadrilateral2	Array.<Object>	第二个四边形节点数组。

Returns:

Type	Description
boolean	是否压盖，true表示压盖

inherited removeAllFeatures()

mapboxgl/overlay/theme/GeoFeatureThemeLayer.js, line 110

清除当前图层所有的矢量要素。

inherited removeFeatures(features)

mapboxgl/overlay/theme/GeoFeatureThemeLayer.js, line 100

从专题图中删除 feature。这个函数删除所有传递进来的矢量要素。

Name	Type	Description
features	Object	要删除的要素对象

rotationBounds(bounds, rotationCenterPoi, angle){Array.<Object>}

mapboxgl/overlay/LabelThemeLayer.js, line 684

旋转bounds。

Name	Type	Description
bounds	SuperMap.Bounds	要旋转的bounds。
rotationCenterPoi	Object	旋转中心点对象，此对象含有属性x(横坐标)，属性y(纵坐标)。
angle	number	旋转角度（顺时针）。

Returns:

Type	Description
Array.<Object>	bounds旋转后形成的多边形节点数组。是一个四边形，形如：[{"x":1,"y":1},{"x":3,"y":1},{"x":6,"y":4},{"x":2,"y":10},{"x":1,"y":1}]

inherited scale(feature)

mapboxgl/overlay/theme/ThemeLayer.js, line 311

转为 iClient 要素

Name	Type	Description
feature		待转要素

setLabelsStyle(labelFeatures){Array.<SuperMap.Feature.Vector>}

mapboxgl/overlay/LabelThemeLayer.js, line 354

设置标签要素的Style

Name	Type	Description
labelFeatures	Array.<SuperMap.Feature.Vector>	需要设置 Style 的标签要素数组。

Returns:

Type	Description
Array.<SuperMap.Feature.Vector>	赋予 Style 后的标签要素数组。

inherited setMaxCacheCount(cacheCount)

mapboxgl/overlay/theme/GeoFeatureThemeLayer.js, line 246

设置最大缓存条数。

Name	Type	Description
cacheCount	number	缓存总数

inherited setOpacity(opacity)

mapboxgl/overlay/theme/ThemeLayer.js, line 88

设置图层的不透明度,取值[0-1]之间。

Name	Type	Description
opacity	number	不透明度

setStyle(feat)

mapboxgl/overlay/LabelThemeLayer.js, line 382

设置标签要素的Style

Name	Type	Description
feat	SuperMap.Feature.Vector	需要赋予 style 的要素。