Class: ThemeLayer

ThemeLayer

专题图基类。

new ThemeLayer(name, options)

Usage
// 浏览器
<script type="text/javascript" src="https://iclient.supermap.io/dist/mapboxgl/iclient-mapboxgl.js"></script>
<script>
  new mapboxgl.supermap.ThemeLayer(name, options);
  
</script>

// ES6 Import
import { ThemeLayer } from '@supermap/iclient-mapboxgl';

new ThemeLayer(name, options);
mapboxgl/overlay/theme/ThemeLayer.js, line 16
Name Type Description
name string

专题图图层名。
options Object

可选参数。

Name Type Default Description
map mapboxgl.Map

MapBoxGL Map 对象，将在下个版本弃用，请用 map.addLayer()方法添加图层。
id string 可选

专题图层 ID。默认使用 CommonUtil.createUniqueID("themeLayer_") 创建专题图层 ID。
loadWhileAnimating boolean true 可选

是否实时重绘。
visibility boolean true 可选

图层是否可见。
opacity number 1 可选

图层不透明度。
Fires

Members

idstring

专题图图层 ID。

loadWhileAnimatingboolean

是否实时重绘。(当绘制大数据量要素的情况下会出现卡顿，建议把该参数设为 false)。

Default Value:
true

mapmapboxgl.Map

MapBoxGL Map 对象。

namestring

专题图图层名称。

opacitynumber

图层不透明度。

Default Value:
1

visibilityboolean

图层是否可见。

Default Value:
true

Events

changelayer

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

图层属性改变之后触发。

Properties:
Name Type Description
layer Object

图层。
property string

被改变的属性。

featuresremoved

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

要素删除之后触发。

Properties:
Name Type Description
features Array.<FeatureVector>

未被成功删除的要素。
succeed boolean

删除成功与否。

Methods

addFeatures(features)

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

向专题图图层中添加数据

Name Type Description
features ThemeFeature | ServerFeature | GeoJSONObject

待添加要素。

destroyFeatures(features)

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

销毁要素。

Name Type Description
features Array.<FeatureVector> | FeatureVector

将被销毁的要素。

display(display)

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

隐藏或者显示图层。（通过对 CSS 控制产生即时效果，重新渲染失效。）

Name Type Description
display boolean 可选

是否显示图层。

getFeatureBy(property, value){FeatureVector}

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

在专题图的要素中，获取第一个feature[property] === value的矢量要素。

Name Type Description
property string

属性名称。
value string

属性值。
Returns:
Type Description
FeatureVector 矢量要素。

getFeatureById(featureId){FeatureVector}

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

获取指定featureId的矢量要素。

Name Type Description
featureId string

矢量要素的属性 ID。
Returns:
Type Description
FeatureVector 对应featureId的矢量要素，不存在则返回 null。

getFeatures(filter){Array.<FeatureVector>}

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

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

Name Type Description
filter function 可选

根据条件过滤要素的回调函数。
Returns:
Type Description
Array.<FeatureVector> 用户加入图层的有效数据。

getFeaturesByAttribute(attrName, attrValue){Array.<FeatureVector>}

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

通过属性的 key 值和 value 值，获取匹配的要素数组。

Name Type Description
attrName string

属性的 key。
attrValue string

属性的 value。
Returns:
Type Description
Array.<FeatureVector> 要素数组。

getLocalXY(coordinate){Array}

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

地理坐标转为像素坐标。

Name Type Description
coordinate Object 可选

坐标位置。
Returns:
Type Description
Array 像素坐标数组。

moveTo(layerID, before)

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

将图层移动到某个图层之前。

Name Type Default Description
layerID string

待插入的图层 ID。
before boolean true 可选

是否将本图层插入到图层 ID 为 layerID 的图层之前。

off(event, callback, context)

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

移除专题要素事件监听。

Name Type Description
event Event

监听事件。
callback function

回调函数。
context string

信息。

on(event, callback, context)

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

添加专题要素事件监听。

Name Type Description
event Event

监听事件。
callback function

回调函数。
context string

信息。

onAdd()

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

添加该图层。

redrawThematicFeatures(extent)

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

重绘专题要素。

Name Type Description
extent mapboxgl.LngLatBounds

重绘的范围。

refresh()

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

强制刷新当前热点显示，在图层热点数组发生变化后调用，更新显示。

removeAllFeatures()

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

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

removeFeatures(features)

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

删除专题图中的features。 参数中的 features 数组中的每一项，必须是已经添加到当前图层中的 feature， 如果要删除的 features 数组中的元素过多，推荐使用 removeAllFeatures删除所有 feature后，再重新添加。这样效率会更高。

Name Type Description
features Array.<FeatureVector> | FeatureVector | function

待删除 feature 的数组或用来过滤的回调函数。

removeFromMap()

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

移除图层。

setOpacity(opacity)

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

设置图层的不透明度。

Name Type Description
opacity number 可选

不透明度，取值[0-1]之间。

setVisibility(visibility)

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

设置图层可见性。

Name Type Description
visibility boolean 可选

是否显示图层（当前地图的 resolution 在最大最小 resolution 之间）。

deprecated toFeature(features){FeatureVector}

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

转为 iClient 要素，该方法将被弃用，由 ThemeLayer#toiClientFeature 代替。

Name Type Description
features Array.<ServerFeature> | Array.<ThemeFeature> | Array.<GeoJSONObject> | ServerFeature | ThemeFeature | GeoJSONObject

待转要素。
Returns:
Type Description
FeatureVector 转换后的 iClient 要素。

toiClientFeature(features){Array.<FeatureVector>}

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

转为 iClient 要素。

Name Type Description
features Array.<ServerFeature> | Array.<ThemeFeature> | Array.<GeoJSONObject> | ServerFeature | ThemeFeature | GeoJSONObject

待转要素。
Returns:
Type Description
Array.<FeatureVector> 转换后的 iClient 要素。