abstract layer~Layer(options)

该类是图层的顶级抽象类,可以被继承,但不能直接实例化,通过其子类实例化一个具体的图层对象。
图层是由渲染系统、地理元素及一些特定的计算行为组成的数据表达机制,若干图层按顺序组合、叠加到地图容器中,把地球表面系统中的自然或人文特征概括性地表达出来。
当图层被创建但未叠加到地图容器中时,是处于游离态的,图层中的地理元素可以参与逻辑运算,但不会被渲染;一旦叠加到地图上,图层的重绘行为即被触发,地理元素将被渲染到浏览器中。
注意:图层坐标系与地图保持一致,是正确添加到地图上的必要条件;继承自本类的图层类必须重写redraw与setMap方法;不能在图层基类中注册图层事件。

Summary

Methods:
destroy

销毁图层。

getLayerType

获取图层类型

getLayerZIndex

返回图层的zIndex值。

getMap

获取当前图层所在的地图。

getName

获取图层名称。

getOpacity

获取图层透明度。

getVisibility

获取图层的可见性。

offMap

解除图层与地图的关联,即从图层去掉与地图对象有关的信息,同时在地图对象去掉与该图层有关的信息。关联解除后,图层依然存在,但与地图不再有关系。
如果图层本身并未加载到地图上,那么该方法没有任何效果。

redraw

重新绘制图层

setLayerZIndex

设置图层在图层容器中的顺序。

setName

设置图层名称。

setOpacity

设置图层透明度。0表示完全透明,1表示完全不透明。

setVisibility

设置图层的可见性。仅设置该图层是否可见,而图层本身依然存在。

Constructor

new abstract Layer(options)

Parameters:
Name Type Description
options Object

可选项。包括属性:

Name Type Description
enableHashCode Boolean

是否启用Hash编码,如果想对要素进行拾取操作就必须启用。默认为false。

opacity Number

设置图层透明度,介于0~1之间,0表示完全透明,1表示完全不透明。默认为1.0,完全不透明。

visibility Boolean

表示该图层的可见性。默认值为true,即图层可见。

Throws:
Error -

当直接实例化Layer类时,抛出异常“the Layer is abstract class and can not be instantiated!”。

Methods

destroy()

销毁图层。

getLayerType() → {String}

获取图层类型

Returns:
String -

图层类型

getLayerZIndex() → {Number}

返回图层的zIndex值。

Returns:
Number -

图层的zIndex

getMap() → {module:Map}

获取当前图层所在的地图。

Returns:
module:Map -

图层所属的地图对象

getName() → {String}

获取图层名称。

Returns:
String -

图层名称

getOpacity() → {Number}

获取图层透明度。

Returns:
Number -

透明度

getVisibility() → {Boolean}

获取图层的可见性。

Returns:
Boolean -

true表示可见,false表示不可见。

offMap()

解除图层与地图的关联,即从图层去掉与地图对象有关的信息,同时在地图对象去掉与该图层有关的信息。关联解除后,图层依然存在,但与地图不再有关系。
如果图层本身并未加载到地图上,那么该方法没有任何效果。

redraw(type)

重新绘制图层

Parameters:
Name Type Default Description
type Number 1

取值为0或1,0表示map调用redraw,1表示layer调用redraw,默认为1。

setLayerZIndex(zIndex)

设置图层在图层容器中的顺序。

Parameters:
Name Type Description
zIndex Number

图层的zIndex,值越大,图层越靠近上方。但是该值改变不了图层容器的上下顺序。

setName(name)

设置图层名称。

Parameters:
Name Type Description
name String

图层名称

Throws:
Error -

当name不是String类型时抛出异常。

setOpacity(opacity)

设置图层透明度。0表示完全透明,1表示完全不透明。

Parameters:
Name Type Default Description
opacity Number 1

图层透明度,介于0-1之间。

Throws:
TypeError -

当图层的透明度值不是一个0-1之间的数字时,抛出异常。

setVisibility(visible)

设置图层的可见性。仅设置该图层是否可见,而图层本身依然存在。

Parameters:
Name Type Default Description
visible Boolean true

是否可见,默认为true,可见。

Throws:
TypeError -

当参数不是布尔类型时,抛出异常。