Class: ThemeRange

ThemeRange

范围分段专题图。 范围分段专题图是按照指定的分段方法（如：等距离分段法）对字段的属性值进行分段，使用不同的颜色或符号（线型、填充）表示不同范围段落的属性值在整体上的分布情况，体现区域的差异。 在分段专题图中，专题值按照某种分段方式被分成多个范围段，要素根据各自的专题值被分配到其中一个范围段中，在同一个范围段中的要素使用相同的颜色，填充，符号等风格进行显示。 分段专题图所基于的专题变量必须为数值型，分段专题图一般用来反映连续分布现象的数量或程度特征，如降水量的分布，土壤侵蚀强度的分布等。

new ThemeRange(options)

Usage
import { ThemeRange } from '@supermapgis/iclient-leaflet';

new ThemeRange(options);
<script type="text/javascript" src="https://iclient.supermap.io/dist/leaflet/iclient-leaflet.js"></script>
<script>
  new L.supermap.ThemeRange({paramsNames});
  // 弃用的写法
  new SuperMap.ThemeRange(options);
</script>
common/iServer/ThemeRange.js, line 9
Name Type Description
options Object

参数。

Name Type Default Description
items Array.<ThemeRangeItem>

范围分段专题图子项数组。
rangeExpression string

分段字段表达式。
rangeParameter number

分段参数。
rangeMode RangeMode RangeMode.EQUALINTERVAL 可选

分段模式。
colorGradientType ColorGradientType ColorGradientType.YELLOW_RED 可选

渐变颜色枚举类。
memoryData ThemeMemoryData 可选

专题图内存数据。

API Relations

Returned by: ThemeRange.fromObj.

Extends

ThemeRange -> CommonTheme

Members

colorGradientTypeColorGradientType

渐变颜色枚举类。
渐变色是由起始色根据一定算法逐渐过渡到终止色的一种混合型颜色。 该类作为单值专题图参数类、分段专题图参数类的属性，负责设置单值专题图、分段专题图的配色方案，在默认情况下专题图所有子项会根据这个配色方案完成填充。但如果为某几个子项的风格进行单独设置后（设置了 ThemeUniqueItem 或 ThemeRangeItem 类中 Style 属性）， 该配色方案对于这几个子项将不起作用。

Default Value:
ColorGradientType.YELLOW_RED

itemsArray.<ThemeRangeItem>

分段专题图子项数组。
在分段专题图中，字段值按照某种分段模式被分成多个范围段，每个范围段即为一个子项，同一范围段的要素属于同一个分段专题图子项。 每个子项都有其分段起始值、终止值、名称和风格等。每个分段所表示的范围为 [start, end)。 如果设置了范围分段模式和分段数，则会自动计算每段的范围 [start, end)，故无需设置 [start, end)；当然可以设置，那么结果就会按照您设置的值对分段结果进行调整。

memoryDataThemeMemoryData

专题图内存数据。
用内存数据制作专题图的方式与表达式制作专题图的方式互斥，前者优先级较高。 第一个参数代表专题值，即数据集中用来做专题图的字段或表达式的值；第二个参数代表外部值。在制作专题图时，会用外部值代替专题值来制作相应的专题图。

precisionstring

精准度。

rangeExpressionstring

分段字段表达式。
由于范围分段专题图基于各种分段方法根据一定的距离进行分段，因而范围分段专题图所基于的字段值的数据类型必须为数值型。对于字段表达式，只能为数值型的字段间的运算。

rangeModeRangeMode

分段专题图的分段模式。
在分段专题图中，作为专题变量的字段或表达式的值按照某种分段方式被分成多个范围段。 目前 SuperMap 提供的分段方式包括：等距离分段法、平方根分段法、标准差分段法、对数分段法、等计数分段法和自定义距离法， 显然这些分段方法根据一定的距离进行分段，因而范围分段专题图所基于的专题变量必须为数值型。

Default Value:
RangeMode.EQUALINTERVAL

rangeParameternumber

分段参数。 当分段模式为等距离分段法，平方根分段，对数分段法，等计数分段法其中一种模式时，该参数用于设置分段个数；当分段模式为标准差分段法时， 该参数不起作用；当分段模式为自定义距离时，该参数用于设置自定义距离。

typestring

专题图类型。

Methods

static fromObj(obj){ThemeRange}

common/iServer/ThemeRange.js, line 109

从传入对象获取范围分段专题图类。

Name Type Description
obj Object

传入对象。
Returns:
Type Description
ThemeRange ThemeRange 对象。

inherited destroy()

common/iServer/ThemeRange.js, line 87

释放资源，将引用资源的属性置空。

inherited toServerJSONObject(){Object}

common/iServer/Theme.js, line 58

转换成对应的 JSON 格式对象。

Returns:
Type Description
Object 对应的 JSON 格式对象。