为 Legend 微件提供逻辑,该微件显示用于解释 Renderer 的标签和符号地图中的每一层。此类可用于创建自定义的交互式 Legend 微件。
const legend = new Legend({
view: view,
viewModel: new LegendViewModel({
view: view
})
});
view.ui.add(legend, "bottom-left");
构造函数
属性列表
属性 | 类型 | 描述 | 类 | |
---|---|---|---|---|
Collection<ActiveLayerInfo> | 更多信息 图例视图用于在图例中显示数据的 ActiveLayerInfo 对象的集合。 | 更多信息 | LegendViewModel | |
Boolean | 更多信息 指示是否在图例中显示 Basemap 图层。 | 更多信息 | LegendViewModel | |
String | 更多信息 类名。 | 更多信息 | Accessor | |
Boolean | 更多信息 当 | 更多信息 | LegendViewModel | |
Object[] | 更多信息 指定地图中要显示在图例中的图层子集。 | 更多信息 | LegendViewModel | |
Boolean | 更多信息 确定是否尊重地图中控制图例可见性的图层属性( | 更多信息 | LegendViewModel | |
String | 更多信息 视图模型的状态。 | 更多信息 | LegendViewModel | |
MapView|SceneView | 更多信息 微件将从中操作的视图。 | 更多信息 | LegendViewModel |
属性详细说明
-
activeLayerInfos Collection<ActiveLayerInfo>autocast
-
图例视图用于在图例中显示数据的 ActiveLayerInfo 对象的集合。当 ActiveLayerInfo 从该集合中删除或添加到该集合时,使用此属性隐藏或显示图例中的图层符号。
-
basemapLegendVisible Boolean
-
指示是否在图例中显示 Basemap 图层。
- 默认值:filterBasemaps
示例代码:legend.viewModel.basemapLegendVisible = true;
-
类名。类的名称声明格式为
geoscene.folder.className
。
-
hideLayersNotInCurrentView Boolean起始版本: GeoScene API for JavaScript 4.22
-
当
true
时,只有在视图范围内可见的图层才会显示在图例中。当图层中的数据在视图中不可见时,图层的图例信息将被隐藏。要从图例中完全隐藏图层,您应该将图层的
legendEnabled
属性设置为false
。- 默认值:false
- 示例:
示例代码:// layers not displayed in the view // will not be shown in the legend legend.viewModel.hideLayersNotInCurrentView = true;
-
指定地图中要显示在图例中的图层子集。如果未设置此属性,则地图中的所有业务图层都将显示在图例中。此属性可用于控制图例中的图层显示顺序。此数组中的对象使用下面列出的属性定义。
-
respectLayerVisibility Boolean起始版本: GeoScene API for JavaScript 4.22
-
确定是否尊重地图中控制图例可见性的图层属性(
minScale
、maxScale
、legendEnabled
)。默认情况下,在以下条件下,图层的图例元素不会在图例中呈现:- 图层的 legendEnabled 属性设置为
false
。 - 如果视图的比例超出层的 minScale 和 maxScale 属性。
当图例的
respectLayerVisibility
属性设置为false
时,地图中每个图层的图例元素将始终显示,从而忽略minScale
、maxScale
和legendEnabled
属性用于地图中的每个图层。- 默认值:true
- 示例:
示例代码:// Always displays legend elements for the map's layers // regardless of their minScale, maxScale, and legendEnabled properties legend.respectLayerVisibility = false;
- 图层的 legendEnabled 属性设置为
-
state Stringreadonly
-
视图模型的状态。
可选值:"ready"|"disabled"
- 默认值:disabled
-
微件将从中操作的视图。