ActiveLayerInfo

属性概述

属性详细信息

children Collection<ActiveLayerInfo>

子 activeLayerInfos 的集合。这仅适用于子图层的渲染器或 GroupLayers 的子级。

declaredClass Stringreadonly inherited

类的名称。声明的类名格式为 geoscene.folder.className。

hideLayersNotInCurrentView Boolean

起始版本：GeoScene API for JavaScript 4.21

当 true 时，仅当图层在视图的扩展范围内可见时，这些图层才会显示在图例中。当图层中的数据在视图中不可见时，图层的图例信息将被隐藏。

要从图例中完全隐藏图层，应将图层的 legendEnabled 属性设置为 false。

默认值：false

另请参阅：

• respectLayerVisibility

示例：

// layers not displayed in the view
// will not be shown in the legend
legend.hideLayersNotInCurrentView = true;

isScaleDriven Boolean

指示图层渲染器的图例显示是否由视图的比例驱动。对于 esri/layers/support/ISublayer 渲染器、任何使用 valueExpression（Arcade 表达式）、DotDensityRenderer 的渲染器以及启用了聚类分析的图层，都是如此。

layer Layer

由 ActiveLayerInfo 对象表示的图层。

layerView LayerView

由 ActiveLayerInfo 对象的图层表示的 layerView 。

legendElements LegendElement[]

legendElements 是使用图层渲染器构造的。它反映了图例的实际结构。

opacity Numberreadonly

起始版本：GeoScene API for JavaScript 4.17

图层或父元素的不透明度。

parent ActiveLayerInfo

父 esri/layers/support/ISublayer 或 GroupLayer 的 ActiveLayerInfo。

ready Boolean

指示 activeLayerInfo 是否已准备就绪。它被设置为 true 计算其所有 legendElements 的时间。它设置为 false 当图层渲染器更改时，以便可以重新计算 legendElements。

respectLayerVisibility Boolean

起始版本：GeoScene API for JavaScript 4.13

确定是否遵循地图中控制图例可见性的图层的属性 （minScale、maxScale、legendEnabled）。默认情况下，在满足以下条件的情况下，图层的图例元素将不会渲染在图例中：

• 图层的 legendEnabled 属性设置为 false。
• 如果视图的比例超出图层的 minScale 和 maxScale 属性定义的可见性范围。

当图例的 respectLayerVisibility 属性设置为 false 时，地图中每个图层的图例元素将始终显示，因此忽略地图中每个图层的 minScale、maxScale 和 legendEnabled 属性。

默认值：true

另请参阅：

• hideLayersNotInCurrentView

示例：

// Always displays legend elements for the map's layers
// regardless of their minScale, maxScale, and legendEnabled properties
legend.respectLayerVisibility = false;

scale Number

在其中渲染图例的视图实例的比例。

sublayerIds Number[]

起始版本：GeoScene API for JavaScript 4.23

仅当图层是 MapImageLayer 时才适用。要显示其图例信息的 MapImageLayer 子图层 ID 的数组。例如，如果 MapImageLayer 包含 100 个子图层，但您希望显示两个子图层的图例，则指定两个子图层的 ID 将允许图例仅显示这些子图层的图例信息。

示例：

// Only displays legend items for sublayers 1 and 2
activeLayerInfo.sublayerIds = [1, 2];

title String

表示图例标题的文本字符串。此值是从图例中相应图层的 layerInfo 读取的。如果未提供，则此值来自图层的标题。

version Number

ActiveLayerInfo 的版本。只要 ActiveLayerInfo 的 ready 属性发生更改，它就会增加 1 。该属性应在视图中监视 ActiveLayerInfo 的更改，并相应地更新 DOM。

view View

在其中渲染图例的视图。

类型定义

ColorRampElement

描述用作 legendElement 的 ColorRampElement 的架构。有关此对象中属性的更多详细信息，请参阅下表。

属性：

type String 此元素的类型始终为 color-ramp。

title String|RampTitle 图例中显示的色带的标题。

infos ColorRampStop[] 图例中渲染的单个色标，对应于渲染器中的颜色可视变量。

ColorRampStop

描述 ColorRampStop 元素的架构。每个 ColorRampStop 表示渲染器中引用的 ColorVariable 的单个停靠点。

属性：

label String 图例中描述具有给定 color 和 value 的要素的标注。

value Number 颜色可视变量停靠点的值。

color Color 可视变量停靠点的颜色。

offset Number 描述标注在色带上的位置 0 和 1 之间的数字。例如，在具有三个色带的色带中，第一个色带的偏移量为 0、 第二个 0.5 和三个 1。对于色带中任意给定数量的标注，这些偏移的间距相等。每个偏移值的间隔等于 1 除以停靠点数减去 1。

HeatmapRampElement

描述用作 legendElement 的 HeatmapRampElement 的架构。有关此对象中属性的更多详细信息，请参阅下表。

属性：

type String 此元素的类型始终为 heatmap-ramp。

title String|RampTitle optional 图例中显示的热点图渐变的标题。

infos HeatmapRampStop[] 图例中渲染的单个色标，对应于渲染器中的颜色可热点图 colorStops 。

HeatmapRampStop

描述 HeatmapRampStop 元素的架构。每个 HeatmapRampStop 表示渲染器中引用的热点图颜色停靠点的单个 colorStop 。

属性：

label String 图例中显示的颜色停靠点的标注。通常只有第一个和最后一个停靠点有标注。

ratio Number 像素的强度值与渲染器的 minPixelIntensity 的比率。每个像素的比率与相应的颜色匹配。

color Color 对应于相应像素 ratio 的像素的颜色。此值通常介于 0 和 1 之间。

offset Number 描述标注在斜坡上的位置 0 和 1 之间的数字。例如，在具有三个停靠点的斜坡中，第一个停靠点的偏移量为 0、 第二个 0.5 和第三个 1。对于渐变中任意给定数量的标注，这些偏移值的间距相等。每个偏移值的间隔等于 1 除以停靠点数减去 1。

ImageSymbolTableElementInfo

定义每个 ImageSymbolTableElementInfo 的方案的属性。这仅适用于 ImageryLayer 渲染器。

属性：

label String optional 与给定图像对应的类别的标注。

src String 表示渲染器中彩色像素的图像的数据 URI。

opacity Number 图像的不透明度 （0 到 1）。

width Number optional 图像的宽度（以像素为单位）。

height Number optional 图像的高度（以像素为单位）。

LegendElement SymbolTableElement|ColorRampElement|OpacityRampElement|SizeRampElement|HeatmapRampElement|RelationshipRampElement

定义每个受支持的 legendElements 的方案的属性。

OpacityRampElement

描述用作 legendElement 的 OpacityRampElement 的架构。有关此对象中属性的更多详细信息，请参阅下表。

属性：

type String 此元素的类型始终为 opacity-ramp。

title String|RampTitle optional 图例中显示的不透明度渐变的标题。

infos OpacityRampStop[] 图例中渲染的单个不透明度停靠点，对应于渲染器中的不透明度可视变量。

OpacityRampStop

描述 OpacityRampStop 元素的架构。每个 OpacityRampStop 表示渲染器中引用的 OpacityVariable 的单个停靠点。每个停靠点的不透明度值在 color 对象的 alpha 属性中指示。

属性：

label String 图例中描述具有给定 color 和 value 的要素的标注。

value Number 不透明度可视变量停靠点的值。

color Color 可视变量停靠点的颜色。与给定 value 对应的不透明度在颜色对象的 alpha 属性中指示。

offset Number 描述标注在斜坡上的位置 0 和 1 之间的数字。例如，在具有三个停靠点的斜坡中，第一个停靠点的偏移量为 0、 第二个 0.5 和第三个 1。对于渐变中任意给定数量的标注，这些偏移的间距相等。每个偏移值的间隔等于 1 除以停靠点数减去 1。

RampTitle

描述 RampTitle 元素的架构。

属性：

field String 渲染器的可视变量中使用的字段名称。这用于图例中相应渐变的生成标题。

normField String 如果提供，则在渲染器的可视变量中使用的规范化字段名称。这用于图例中相应渐变的生成标题。

ratio Boolean 如果 true，图例的格式为将字段与规范化字段显示为比率。

ratioPercent Boolean 如果为 true，图例的格式为将字段和规范化字段显示为百分比。

ratioPercentTotal Boolean 如果 true,，图例的格式将字段和规范化字段显示为总计的百分比。

RelationshipLabels

描述 RelationshipLabels 元素的架构。这些标注渲染在正方形的角中，这些角表示图例中的关系渲染器。

属性：

top String 如果焦点设置为 HH，则与图例的顶角对应的标注。这描述了在字段 1 和字段 2 （HH） 中都被视为较高的值。

bottom String 如果焦点设置为 HH，则与图例的底角对应的标注。这描述了在字段 1 和字段 2 （HH） 中都被视为较低的值。

left String 与图例左上角对应的标注（如果焦点设置为 HH）。这描述了字段 1 的值较高且字段 2 的值较低 （HL） 的要素。

right String 与图例右上角对应的标注（如果焦点设置为 HH）。这描述了字段 2 的值较高且字段 1 的值较低 （LH） 的要素。

RelationshipRampElement

描述用作 legendElement 的 RelationshipRampElement 的架构。有关此对象中属性的更多详细信息，请参阅下表。

属性：

type String 此元素的类型始终为 relationship-ramp。

numClasses Number 组成渲染器的每个字段的类数。可以是 2、3 或 4。

focus String 确定图例的方向。值可以是 HH、HL、LH、LL。

colors Color[][] 图例格网中显示的二维颜色数组。

labels RelationshipLabels 图例中每个角的标注。

rotation Number 图例的旋转（以度为单位）（0-360）。0 度将图例显示为正方形，LL 像元位于图例的左下角，HH 像元位于右上角。

title String optional 图例中显示的渲染器的标题。

infos Object[] optional 与关系渲染器关联的信息对象。

RendererTitle

描述 RendererTitle 元素的架构。

属性：

title String optional 图例中显示的渲染器的标题。

field String 要在渲染器中使用的字段名。这将用于图例中渲染器的生成标题中。

normField String 如果向渲染器提供了规范化字段，则此字段也将用于图例中渲染器生成的标题中。

normByPct Boolean 指示在渲染器的规范化中是否使用了百分比。这用于为该方案创建更具可读性的图例。

SizeRampElement

描述用作 legendElement 的 SizeRampElement 的架构。有关此对象中属性的更多详细信息，请参阅下表。

属性：

type String 此元素的类型始终为 size-ramp。

title String|RampTitle optional 图例中显示的大小渐变的标题。

infos SizeRampStop[] 图例中渲染的单个大小停靠点，对应于渲染器中的大小可视变量。

SizeRampStop

描述 SizeRampStop 元素的架构。每个 SizeRampStop 表示渲染器中引用的 SizeVariable 的单个停靠点。

属性：

label String 图例中描述具有给定 symbol 和 value 的要素的标注。

value * optional 大小可视变量停靠点的值。

symbol Symbol 对应于渲染器中停靠点值的符号。

size Number optional 可视变量停靠点的大小以磅为单位。

outlineSize Number optional 轮廓的宽度（以磅为单位）。

preview HTMLElement optional 图例中呈现的 HTML 元素，表示具有给定值的要素。

SymbolTableElement

描述用作 legendElement 的 SymbolTableElement 的架构。此图例元素用于 UniqueValueRenderer 和 ClassBreaksRenderer。有关此对象中属性的更多详细信息，请参阅下表。

属性：

type String 此元素的类型始终为 symbol-table。

title String|RendererTitle optional 图例中显示的渲染器的标题。

legendType String optional 仅用于设置为 ImageryLayers 的渲染器。指示图层上设置的渲染器类型（例如 stretched 或 Unique Values）。

infos SymbolTableElementType[] 为符号表渲染的每个符号/类别/间断的数组。例如，这可能是 ClassBreaksRenderer 的单个间断，也可能是 UniqueValueRenderer 的唯一值。

SymbolTableElementInfo

定义 SymbolTableElementInfo 方案的属性。

属性：

label String|RampTitle 图例中显示的渲染器的标题。

value * optional 与图例中给定的 symbol 值对应的值。

symbol Symbol 图例中对应 value 的符号。

size Number optional 符号的大小（以磅为单位）。

preview HTMLElement optional 图例中显示的符号元素的预览。

SymbolTableElementType ImageSymbolTableElementInfo|SymbolTableElementInfo

定义每个 SymbolTableElementType 的方案的属性。