# new ThemeLayer(name, options)
参数:
| 名称 | 类型 | 属性 | 默认值 | 描述 |
|---|---|---|---|---|
name |
string | 专题图图层名。 |
||
options |
Object | 可选参数。 |
||
map |
mapboxgl.Map | 当前 mapboxgl map 对象，将在下个版本弃用，请用 map.addLayer()方法添加图层。 |
||
id |
string |
<optional> |
专题图层 ID |
|
loadWhileAnimating |
boolean |
<optional> |
true | 是否实时重绘。 |
visibility |
boolean |
<optional> |
true | 图层是否可见。 |
opacity |
number |
<optional> |
1 | 图层透明度。 |
成员变量
方法
# display(displayopt)
临时隐藏或者显示图层。通过对 CSS 控制产生即时效果，重新渲染失效。一般用 setVisibility 方法来动态控制图层的显示和隐藏。
参数:
| 名称 | 类型 | 属性 | 描述 |
|---|---|---|---|
display |
boolean |
<optional> |
是否显示图层。 |
# getFeatureBy(property, value) → {Zondy.Feature.Vector}
在专题图的要素数组 features 里面遍历每一个 feature，当 feature[property] === value 时， 返回此 feature（并且只返回第一个）。
参数:
| 名称 | 类型 | 描述 |
|---|---|---|
property |
string | feature 的某个属性名称。 |
value |
string | property 所对应的值。 |
第一个匹配属性和值的矢量要素。
# getFeatureById(featureId) → {Zondy.Feature.Vector}
通过给定一个 id，返回对应的矢量要素。
参数:
| 名称 | 类型 | 描述 |
|---|---|---|
featureId |
string | 矢量要素的属性 id。 |
对应 id 的 feature，如果不存在则返回 null。
# getFeaturesByAttribute(attrName, attrValue) → {Array.<Zondy.Feature.Vector>}
通过给定一个属性的 key 值和 value 值，返回所有匹配的要素数组。
参数:
| 名称 | 类型 | 描述 |
|---|---|---|
attrName |
string | 属性的 key。 |
attrValue |
string | 矢量要素的属性 id。 |
一个匹配的 feature 数组。
# moveTo(layerID, beforeopt)
将图层移动到某个图层之前。
参数:
| 名称 | 类型 | 属性 | 默认值 | 描述 |
|---|---|---|---|---|
layerID |
string | 待插入的图层 ID。 |
||
before |
boolean |
<optional> |
true | 是否将本图层插入到图层 id 为 layerID 的图层之前(如果为 false 则将本图层插入到图层 id 为 layerID 的图层之后)。 |
# off(event, callback, context)
移除专题要素事件监听。
参数:
| 名称 | 类型 | 描述 |
|---|---|---|
event |
Event | 监听事件。 |
callback |
function | 回调函数。 |
context |
string | 信息。 |
# on(event, callback, context)
添加专题要素事件监听。添加专题要素事件监听。
参数:
| 名称 | 类型 | 描述 |
|---|---|---|
event |
Event | 监听事件。 |
callback |
function | 回调函数。 |
context |
string | 信息。 |
# redrawThematicFeatures(extent)
抽象方法，可实例化子类必须实现此方法。重绘专题要素。
参数:
| 名称 | 类型 | 描述 |
|---|---|---|
extent |
mapboxgl.LngLatBounds | 重绘的范围。 |
# removeFeatures(features)
从专题图中删除 feature。这个函数删除所有传递进来的矢量要素。 参数中的 features 数组中的每一项，必须是已经添加到当前图层中的 feature， 如果无法确定 feature 数组，则可以调用 removeAllFeatures 来删除所有 feature。 如果要删除的 feature 数组中的元素特别多，推荐使用 removeAllFeatures， 删除所有 feature 后再重新添加。这样效率会更高。
参数:
| 名称 | 类型 | 描述 |
|---|---|---|
features |
Array.<Zondy.Feature.Vector> | 要删除 feature 的数组。 |
# setVisibility(visibilityopt)
设置图层可见性，设置图层的隐藏，显示，重绘的相应的可见标记。
参数:
| 名称 | 类型 | 属性 | 描述 |
|---|---|---|---|
visibility |
boolean |
<optional> |
是否显示图层（当前地图的 resolution 在最大最小 resolution 之间）。 |