ColorSizeSlider

ColorSizeSlider 微件用于创作和探索可使用 ColorVariable 和 SizeVariable 渲染的任何图层中的数据驱动可视化效果。应使用这两个可视变量来可视化同一数据变量。

此滑块和可视化样式专为 3D 主题可视化而设计，其中大小和颜色都用于可视化相同的数据变量，以最大程度地减少由于感知失真而导致的混淆。例如，如果两个大小相似的要素（因此数据值）彼此相距甚远，则拉伸点的可视化可能难以理解;离 Camera 最远的要素将显示为小于靠近摄像机的要素。颜色变量可以帮助用户了解这两个要素具有相似的值。

ColorSizeSlider with perspective

至少必须设置微件的 min, max, 和 stops 属性。停靠点用于在滑块的轨道上呈现颜色渐变。

有关此滑块上可用的可配置选项的摘要，请参见下图。

ColorSizeSlider with annotations

fromRendererResult 方法可用于方便地从 createContinuousRenderer 方法创建结果对象。

const params = {
  layer: layer,
  basemap: map.basemap,
  valueExpression: "( $feature.POP_POVERTY / $feature.TOTPOP_CY ) * 100",
  view: view
};

let rendererResult = null;

univariateColorSizeRendererCreator
  .createContinuousRenderer(params)
  .then(function(response) {
    rendererResult = response;
    layer.renderer = response.renderer;

    return histogram({
      layer: layer,
      valueExpression: colorParams.valueExpression,
      view: view,
      numBins: 70
    });
  })
   .then(function(histogramResult) {
     const slider = ColorSizeSlider.fromRendererResult(rendererResult, histogramResult);
     slider.container = "slider";
   })
   .catch(function(error) {
     console.log("there was an error: ", error);
   });

此滑块应用于更新图层渲染器中匹配的 color 和 size 可视变量。应用开发人员负责在此滑块上设置事件侦听器，以在相应的呈现器中更新这些变量。

// when the user slides the handle(s), update the renderer
// with the updated color stops

slider.on(["thumb-change", "thumb-drag"], function() {
  const renderer = layer.renderer.clone();
  renderer.visualVariables = slider.updateVisualVariables( renderer.visualVariables );
  layer.renderer = renderer;
});

有关获得对widget样式的完全控制的信息，请参阅样式主题。

示例:

构造函数

new ColorSizeSlider(properties)

参数:

properties Object

optional

所有可传入构造函数的属性，请参见属性列表。

示例代码:

const slider = new ColorSizeSlider({
  min: 0,
  max: 100,
  stops: [
    { value: 25, color: "white", size: 1000 },
    { value: 75, color: "dodgerblue", size: 100000 }
  ]
});

属性列表

可以设置、检索或监听的属性。参见使用属性。

展示继承属性

隐藏继承属性

类型	描述	类
String\|HTMLElement	更多信息包含widget的DOM元素的ID或者节点	更多信息	Widget
String	更多信息类名。	更多信息	Accessor
Boolean	更多信息仅适用于三个缩略图	更多信息	ColorSizeSlider
HistogramConfig	更多信息与滑块上表示的数据关联的Histogram	更多信息	SmartMappingSliderBase
String	更多信息创建部件时分配给部件的唯一ID。	更多信息	Widget
LabelFormatter	更多信息用于设置用户输入格式的函数。	更多信息	SmartMappingSliderBase
InputParser	更多信息用于分析由inputFormatFunction格式化的滑块输入的函数。	更多信息	SmartMappingSliderBase
String	更多信息 widget 默认的label	更多信息	ColorSizeSlider
LabelFormatter	更多信息 Slider.labelFormatFunction的修改版本，它是一个自定义函数，用于设置缩略图、最小值、最大值和平均值上的标签的格式。	更多信息	SmartMappingSliderBase
Number	更多信息滑块的最大值或上限。	更多信息	SmartMappingSliderBase
Number	更多信息滑块的最小值或下限。	更多信息	SmartMappingSliderBase
Boolean	更多信息仅适用于三个缩略图	更多信息	ColorSizeSlider
Number	更多信息定义滑块缩略图值的舍入方式。	更多信息	SmartMappingSliderBase
Boolean	更多信息 When `true`, the slider will render a third handle between the two handles already provided by default.	更多信息	ColorSizeSlider
String	更多信息视图模型的状态。	更多信息	SmartMappingSliderBase
ColorSizeStop []	更多信息与滑块关联的渲染器的ColorVariable and SizeVariable 中的数据值对应的颜色和大小。	更多信息	ColorSizeSlider
Boolean	更多信息当为`true`, 则当用户拖动任何段时，所有段都将同步更新thumb值。	更多信息	SmartMappingSliderBase
ColorSizeSliderViewModel	更多信息 "颜色大小滑块"微件的视图模型	更多信息	ColorSizeSlider
Boolean	更多信息是否显示widget	更多信息	Widget
Object	更多信息小部件中显示的可见元素。	更多信息	SmartMappingSliderBase
Object	更多信息将滑块轨道缩放到此属性中提供的边界。	更多信息	SmartMappingSliderBase

属性详细说明

container String|HTMLElement inherited

包含widget的DOM元素的ID或者节点。此属性只能设置一次。以下示例都是使用小部件时的有效用例。

示例代码:

// 在运行时创建HTML div元素，并将其设置为小部件的容器
const basemapGallery = new BasemapGallery({
  view: view,
  container: document.createElement("div")
});

// 添加widget 在 view的右上角
view.ui.add(basemapGallery, {
  position: "top-right"
});

// 创建 HTML div 元素 并且设置为widget的容器

const basemapGallery = new BasemapGallery({
  view: view,
  container: basemapGalleryDiv
});

// 添加widget 在 view的右上角
view.ui.add(basemapGallery, {
  position: "top-right"
});

// HTML 标签
<body>
  <div id="viewDiv"></div>
  <div id="basemapGalleryDiv"></div>
</body>

// 在添加到视图的UI时指定widget
const basemapGallery = new BasemapGallery({
  view: view
});

// 添加widget 在 view的右上角
view.ui.add(basemapGallery, {
  position: "top-right"
});

declaredClass Stringreadonly inherited

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

handlesSyncedToPrimary Boolean 起始版本: GeoScene API for JavaScript 4.22

仅当在滑块上设置了三个缩略图（即句柄）时才适用（即当 primaryHandleEnabled 是true时). 此属性指示外部句柄的位置是与中间还是主句柄同步，处理。启用后，如果移动主句柄，则会更新外部句柄位置同时保持与主句柄的固定距离。

默认值:true

示例:

primaryHandleEnabled

示例代码:

// enables the primary handles and syncs it with the others
slider.primaryHandleEnabled = true;
slider.handlesSyncedToPrimary = true;
slider.persistSizeRangeEnabled = true;

histogramConfig HistogramConfig inherited

与滑块上表示的数据关联的Histogram 。柱状常使用 esri/smartMapping/统计数据/直方图统计数据函数生成。

示例:

geoscene/smartMapping/statistics/histogram
Histogram

示例代码:

histogram({
  layer: featureLayer,
  field: "fieldName",
  numBins: 30
}).then(function(histogramResult){
  // set the histogram to the slider
  slider.histogramConfig = {
    bins: histogramResult.bins
  };
});

id String inherited

创建部件时分配给部件的唯一ID。如果不是由开发人员设置的，它将默认为容器ID 或者如果没有容器ID，那么它将自动生成

inputFormatFunction LabelFormatter inherited 起始版本: GeoScene API for JavaScript 4.22

用于设置用户输入格式的函数。与设置拇指标签格式的 labelFormatFunction, 相反，当用户开始编辑输入元素中的缩略图值时，它们会设置这些值的格式inputFormatFunction

下图演示了默认情况下滑块输入值如何与相应的滑块值相似，并且与labelFormatFunction中设置的格式不匹配。

Slider without input formatter

如果要设置滑块输入值的格式，使其与拇指标签匹配，则可以将labelFormatFunction中设置的相同函数传递给 inputFormatFunction 以实现一致的格式。

Slider with input formatter

但是，如果指定了 inputFormatFunction，则还必须编写相应的 inputParseFunction，用于将用户输入解析为可理解的滑块值。在大多数情况下，如果指定输入FormatFunction，应将labelFormatFunction设置为相同的值确保标签和输入之间的一致性。

此属性重写默认输入格式化程序，该格式化程序通过在输入值上调用 toString() 进行格式化。

示例:

inputParseFunction

示例代码:

// 将滑块输入的格式设置为带单位的缩写数字
// 例如，位置 1500 处的拇指将以 1.5k 的输入标签呈现
slider.inputFormatFunction = function(value, type){
  if(value >= 1000000){
    return (value / 1000000).toPrecision(3) + "m"
  }
  if(value >= 100000){
    return (value / 1000).toPrecision(3) + "k"
  }
  if(value >= 1000){
    return (value / 1000).toPrecision(2) + "k"
  }
  return value.toFixed(0);
}

inputParseFunction InputParser inherited 起始版本: GeoScene API for JavaScript 4.22

用于分析由inputFormatFunction格式化的滑块输入的函数。如果设置了inputFormatFunction则必须设置此属性。否则，滑块值可能不会更新到其预期位置。

覆盖默认输入解析，这是一个已解析的浮点数。

示例:

inputFormatFunction

示例代码:

// 将滑块输入（字符串值）解析为滑块可理解的数字值
// 这假设滑块已经配置了 inputFormatFunction
// 例如，如果输入是1.5k，则此函数将解析
// it to a value of 1500
slider.inputParseFunction = function(value, type, index){
  let charLength = value.length;
  let valuePrefix = parseFloat(value.substring(0,charLength-1));
  let finalChar = value.substring(charLength-1);

  if(parseFloat(finalChar) >= 0){
    return parseFloat(value);
  }
  if(finalChar === "k"){
    return valuePrefix * 1000;
  }
  if(finalChar === "m"){
    return valuePrefix * 1000000;
  }
  return value;
}

label String

widget 默认的label 当在另一个小部件（如 Expand 或 LayerList 小部件）中使用此标签时，将显示此标签。

labelFormatFunction LabelFormatter inherited

Slider.labelFormatFunction的修改版本，它是一个自定义函数，用于设置缩略图、最小值、最大值和平均值上的标签的格式。覆盖默认的标签格式化程序。此函数还支持日期格式。

示例代码:

// For thumb values, rounds each label to whole numbers
slider.labelFormatFunction = function(value, type) {
  return (type === "value-change") ? value.toFixed(0): value;
}

max Number inherited

滑块的最大值或上限。如果最大滑块 value构造函数中的值大于中设置max 此属性，则max将更新以匹配最大值滑块 value。

示例代码:

slider.max = 150;

min Number inherited

滑块的最小值或下限。如果最小滑块 value构造函数中的值大于中设置的min 此属性，则min将更新以匹配最小的滑块 value。

示例代码:

slider.min = -150;

persistSizeRangeEnabled Boolean 起始版本: GeoScene API for JavaScript 4.22

Only applicable when three thumbs (i.e. handles) are set on the slider (i.e. when primaryHandleEnabled is true). 此属性通常用于发散或高于和低于渲染器的配置。

当为 true时, 则确保above 内的符号大小与所有滑块拇指位置的below 范围内的符号大小一致。换言之，随着滑块拇指的更新，stops 中的大小值将根据大小范围约束（maxSize - minSize）内数据值的位置按比例进行调整。如果为 false,则即使滑块拇指值发生更改，停靠点中的大小值也将保持不变。

在大多数情况下，应将此值设置为true以使above 范围内的大小与below 范围内的大小保持一致，以避免地图误读。

默认值:false

示例:

primaryHandleEnabled

示例代码:

slider.primaryHandleEnabled = true;
slider.persistSizeRangeEnabled = true;

precision Number inherited 起始版本: GeoScene API for JavaScript 4.22

定义滑块缩略图值的舍入方式。此数字表示该数字的小数位数滑块缩略图值应在移动时舍入。

此值还指示数据范围缩略图标记的精度小于 10（即（最大值 - 最小值）< 10）。

当数据范围大于 10 时，标签显示，精度为不超过两个小数位，但实际的滑块缩略图值将保持此属性中指定的精度。

例如，给定默认精度 4 和以下滑块配置，缩略图的标签将显示两个小数位，但实际精度即使用户滑动或移动缩略图，缩略图值也不会丢失。

const slider = new Slider({
  min: 20,
  max: 100,  // data range of 80
  values: [50.4331],
  // thumb label will display 50.43
  // thumb value will maintain precision, so
  // value will remain at 50.4331
  container: "sliderDiv"
});

如果用户手动输入的值的精度高于此属性，该缩略图值的精度将保持不变，直到缩略图由用户移动。此时，该值将根据指示的精度进行舍入。

如果缩略图标签不可见，则必须使用labelInputs启用它们。

请记住，此属性会将拇指舍入值，不应专门使用用于格式化目的。要设置缩略图label的格式，请使用标签FormatFunction属性。

默认值:4

示例代码:

slider.precision = 7;

primaryHandleEnabled Boolean 起始版本: GeoScene API for JavaScript 4.22

如果为 true, 则滑块将在默认情况下已提供的两个句柄之间呈现第三个句柄。这是主句柄。必须为要渲染的主句柄定义三个或五个stops 主句柄代表中间停止。

当 handlesSyncedToPrimary 为 true时, 此句柄将控制其他句柄在移动时的位置。

这通常用于发散或 above-and-below 渲染器配置。

默认值:false

示例:

handlesSyncedToPrimary
persistSizeRangeEnabled

示例代码:

// enables the primary handles and syncs it with the others
slider.primaryHandleEnabled = true;
slider.handlesSyncedToPrimary = true;
slider.persistSizeRangeEnabled = true;

state Stringreadonly inherited

视图模型的状态。

可选值:"ready"|"disabled"

stops ColorSizeStop []

The colors and sizes corresponding with data values in the ColorVariable and SizeVariable of the renderer associated with the slider.

Use the fromRendererResult() method to conveniently construct these stops from a renderer generated from the univariateColorSize smart mapping module.

Use updateVisualVariables() to update the renderer's visual variables with the values matching the slider thumb positions.

示例:

fromRendererResult()
updateVisualVariables()

示例代码:

slider.stops = [
  { value: 25, color: "white", size: 1000 },
  { value: 75, color: "dodgerblue", size: 100000 }
];

syncedSegmentsEnabled Boolean inherited 起始版本: GeoScene API for JavaScript 4.22

如果为true，则当用户拖动任何段时，所有段将同步在一起以更新缩略图值。这将在拖动任何段时保持所有缩略图之间的间隔。仅当visibleElements.interactiveTrack 为true 时才适用。

在启用了primary handle is enabled中，这允许您禁用handlesSyncedToPrimary，以使句柄移动独立于中间（主）句柄，但仍然为最终用户提供了一个选项，通过滑块拖动事件将句柄与主句柄同步。

默认值:false

示例:

visibleElements
handlesSyncedToPrimary

示例代码:

slider.visibleElements = {
  interactiveTrack: true
};
slider.primaryHandleEnabled = true;
slider.handlesSyncedToPrimary = false;
slider.syncedSegmentsEnabled = true;

viewModel ColorSizeSliderViewModel

"颜色大小滑块"微件的视图模型。这个类包含所有的逻辑（属性和方法）来控制此小部件的行为。请参阅 ColorSizeSliderViewModel 类以访问 ColorSizeSlider 小部件上的所有属性和方法。

visible Boolean inherited

是否显示widget

如果为false, 小部件将不再呈现在web文档中。这可能会影响文档中其他元素或小部件的布局。例如，如果此小部件是与 view UI, 右上角关联的三个小部件中的第一个，那么当此小部件不可见时，其他小部件将重新定位。有关更多信息，请参阅CSS display 值"none".

默认值:true

示例代码:

// 在view中隐藏widget
widget.visible = false;

visibleElements Object inherited 起始版本: GeoScene API for JavaScript 4.22

小部件中显示的可见元素。此属性提供打开/关闭小部件显示的各个元素的功能

Property:

interactiveTrack Boolean

optional

默认值:false

如果为 true，则在轨道上显示保持两个滑块缩略图/手柄之间的间隔。

示例:

syncedSegmentsEnabled
segment-drag event

示例代码:

slider.visibleElements = {
  interactiveTrack: true
};
slider.syncedSegmentsEnabled = true;

zoomOptions Object inherited

将滑块轨道缩放到此属性中提供的范围。当提供最小和/或最大缩放值时， min 和 max 滑块值将被保留并呈现在滑块上的典型位置。但是，滑块轨道本身是缩放的，因此不能将拇指移动到提供的最小和最大缩放值之上或之下。

当滑块处于缩放状态时，轨道的缩放端会出现锯齿状。在下图中，请注意即使滑块最大值为200，顶部缩略图也无法移动超过 31 的缩放最大值。

slider-zoom

要退出缩放状态，用户可以单击锯齿线，或者开发人员可以将zoomOptions设置为 null。由开发人员为最终用户提供 UI 选项以启用滑块上的缩放。

当滑块与严重偏斜的数据集相关联时，设置zoomOptions 很有用，其中直方图由于异常值而仅呈现一两个条形。

slider-not-zoomed

您可以通过缩放滑块并根据缩放的最小值和最大值重新生成直方图来消除异常值的影响。这将提供更好的数据视图并使滑块对最终用户更有用。

属性:

min Number

optional

缩放的下限。

max Number

optional

缩放的上限。

示例代码:

// 将滑块缩放到只能移动拇指
// 到 10 和 25 的值之间的位置，而
// 保持滑块的绝对最小值和
// 最大值
slider.zoomOptions = {
  min: 10,
  max: 25
};

// disables zooming on the slider
slider.zoomOptions = null;

// 将滑块缩放到只能移动拇指
// to positions above the value of 10, while maintaining
// the slider's absolute minimum value
slider.zoomOptions = {
  min: 10
};

// 将滑块缩放到只能移动拇指
// to positions below the value of 25, while maintaining
// the slider's absolute maximum value
slider.zoomOptions = {
  max: 25
};

// zooms the slider to the handle positions
// with some padding
document.getElementById("zoomInButton").onclick = function() {
  const lowerThumb = slider.values[0];
  const upperThumb = slider.values[1];

  const range = upperThumb - lowerThumb;
  const padding = range * 0.3;

  const zoomMin = (lowerThumb - padding) > slider.min ? (lowerThumb - padding) : slider.min;
  const zoomMax = (upperThumb + padding) < slider.max ? (upperThumb + padding) : slider.max;

  slider.set({ zoomOptions: { min: zoomMin, max: zoomMax } });
};

方法列表

展示继承方法

隐藏继承方法

返回值类型	描述	类
String	更多信息用于为widgets的`class`属性构建值的实用方法	更多信息	Widget
	更多信息销毁widget实例。	更多信息	Widget
Boolean	更多信息在实例上触发事件。	更多信息	Widget
ColorSizeSlider	更多信息一个方便的函数，用于从univariateColorSize.createContinuousRenderer() 方法的结果创建此滑块。	更多信息	ColorSizeSlider
Boolean	更多信息指示实例上是否存在与提供的事件名称匹配的事件侦听器。	更多信息	Widget
Boolean	更多信息 `isFulfilled()` 可用于验证创建类的实例是否已完成(无论成功或失败)。	更多信息	Widget
Boolean	更多信息 `isRejected()` 可用于验证创建类的实例是否失败。	更多信息	Widget
Boolean	更多信息 `isResolved()` 可用于验证创建类的实例是否成功。	更多信息	Widget
Object	更多信息在实例上注册事件处理程序。	更多信息	Widget
	更多信息 Widget teardown helper.	更多信息	Widget
	更多信息这种方法主要由开发人员在实现自定义widget时使用。	更多信息	Widget
Object	更多信息这种方法主要由开发人员在实现自定义widget时使用。	更多信息	Widget
	更多信息立即将widget渲染到DOM。	更多信息	Widget
	更多信息这种方法主要由开发人员在实现自定义widget时使用。	更多信息	Widget
	更多信息一个方便的函数，用于从univariateColorSize.createContinuousRenderer() 方法的结果创建此滑块得 result 更新 ColorSizeSlider 小部件实例的属性。	更多信息	ColorSizeSlider
ClassBreaksRenderer	更多信息一个方便的函数，用于使用从滑块获取的值更新使用univariateColorSize.createContinuousRenderer() 方法生成的渲染器的可视变量。	更多信息	ColorSizeSlider
Array<(ColorVariable\|SizeVariable)>	更多信息一个方便的函数，用于使用从滑块获取的值更新使用 univariateColorSize.createContinuousRenderer() 方法生成的渲染器的可视变量。	更多信息	ColorSizeSlider
Promise	更多信息 `when()` 创建类的实例后，会被执行一次。	更多信息	Widget

方法详细说明

classes(classNames){String}inherited

用于为widget的类属性构建值的实用方法class 属性. 这有助于简化CSS类设置.

参数:

classNames String|String []|Object

repeatable

class 类名称

返回值:

类型	描述
String	The computed class name.

示例:

Guide - Widget development (rendering)

示例代码:

// .tsx语法显示在渲染widget时如何设置CSS classs .

render() {
  const dynamicIconClasses = {
    [CSS.myIcon]: this.showIcon,
    [CSS.greyIcon]: !this.showIcon
  };

  return (
    <div class={classes(CSS.root, CSS.mixin, dynamicIconClasses)} />
  );
}

destroy()inherited

销毁widget实例。

emit(type, event){Boolean}inherited

在实例上触发事件。仅当创建此类的子类时才应使用此方法。

参数:

type String

事件名称

event Object

optional

事件负载。

返回值:

类型	描述
Boolean	如果侦听器收到通知,则为`true`

fromRendererResult(rendererResult, histogramResult){ColorSizeSlider}static

一个方便的函数，用于从 univariateColorSize.createContinuousRenderer（）方法创建结果对象的 result 创建 ColorSizeSlider 小部件实例。

此方法设置滑块 stops, min, max, 和histogramConfig. 为其分配适当的 container 和任何其他可选属性仍然是开发人员的责任。

参数:

rendererResult ContinuousRendererResult

来自 createContinuousRenderer 方法创建结果对象。

histogramResult geoscene/smartMapping/statistics/histogram~HistogramResult

optional

结果直方图对象来自于histogram 方法。

返回值:

类型	描述
ColorSizeSlider	返回一个 ColorSizeSlider 实例。在为其分配有效container，之前，不会呈现此内容。

示例代码:

let params = {
  layer: layer,
  basemap: map.basemap,
  field: "POP",
  view: view,
  symbolType: "3d-volumetric",
  min: 0,
  max: 500000
};
colorAndSizeRendererCreator
  .createContinuousRenderer(params)
  .then(function(response) {
    // set generated renderer on the layer and add it to the map
    rendererResult = response;
    layer.renderer = response.renderer;

    return histogram({
      layer: layer,
      field: params.field,
      numBins: 70,
      maxValue: params.max,
      minValue: params.min
    });
  })
  .then(function(histogramResult) {
    let slider = ColorSizeSlider.fromRendererResult(rendererResult, histogramResult);
    slider.container = "slider";
  });

hasEventListener(type){Boolean}inherited

指示实例上是否存在与提供的事件名称匹配的事件侦听器。

参数:

type String

事件名称

返回值:

类型	描述
Boolean	如果类支持输入事件，则返回 true。

isFulfilled(){Boolean}inherited 起始版本: GeoScene API for JavaScript 4.22

isFulfilled() 可用于验证创建类的实例是否已完成(无论成功或失败)。如果已完成，将会返回true。

返回值:

类型	描述
Boolean	指示创建类的实例是否已完成（无论成功或失败）。

isRejected(){Boolean}inherited 起始版本: GeoScene API for JavaScript 4.22

isRejected() 可用于验证创建类的实例是否失败。如果失败, 将会返回 true 。

返回值:

类型	描述
Boolean	指示是否已拒绝创建类的实例。

isResolved(){Boolean}inherited 起始版本: GeoScene API for JavaScript 4.22

isResolved() 可用于验证创建类的实例是否成功。如果成功, 将会返回 true 。

返回值:

类型	描述
Boolean	指示是否已解析创建类的实例。

on(type, listener){Object}inherited

在实例上注册事件处理程序。调用此方法将事件与侦听器挂钩

参数:

type String|String []

要监听的event 或者事件数组

listener Function

事件触发时要调用的函数

返回值:

类型描述

Object

返回一个remove() 方法的事件处理程序，该方法用以停止侦听事件。

属性	类型	描述
remove	Function	当被调用时，从事件中移除监听器。

示例代码:

view.on("click", function(event){
  // event是事件触发后返回的事件句柄。
  console.log(event.mapPoint);
});

own(handles)inherited

Widget teardown helper. 当widget被销毁时，添加到它的任何句柄都将被自动删除。

参数:

handles WatchHandle|WatchHandle []

widget销毁后标记为删除的句柄。

postInitialize()inherited

这种方法主要由开发人员在实现自定义widget时使用。 在widget准备好后执行。

render(){Object}inherited

这种方法主要由开发人员在实现自定义widget时使用。 它必须由子类实现以进行渲染。

返回值:

类型	描述
Object	渲染虚拟节点。

renderNow()inherited

立即将widget渲染到DOM。

scheduleRender()inherited

这种方法主要由开发人员在实现自定义widget时使用。 计划小部件渲染。此方法对于影响UI的更改非常有用。

updateFromRendererResult(rendererResult, histogramResult)

一个方便的函数，用于从 univariateColorSize.createContinuousRenderer（）方法创建结果对象的 result 更新 ColorSizeSlider 小部件实例的属性。

参数:

rendererResult ContinuousRendererResult

来自 createContinuousRenderer 方法创建结果对象。

histogramResult geoscene/smartMapping/statistics/histogram~HistogramResult

optional

结果直方图对象来自于histogram 方法。

示例代码:

let params = {
  layer: layer,
  basemap: map.basemap,
  field: "POP",
  view: view,
  symbolType: "3d-volumetric",
  minValue: 0,
  maxValue: 500000
};
colorAndSizeRendererCreator
  .createContinuousRenderer(params)
  .then(function(response) {
    // set generated renderer on the layer and add it to the map
    rendererResult = response;
    layer.renderer = response.renderer;

    return histogram({
      layer: layer,
      field: params.field,
      numBins: 70,
      maxValue: params.maxValue,
      minValue: params.minValue
    });
  })
  .then(function(histogramResult) {
    slider.fromRendererResult(rendererResult, histogramResult);
  });

updateRenderer(renderer){ClassBreaksRenderer} 起始版本: GeoScene API for JavaScript 4.22

一个方便的函数，用于使用从滑块获取的值更新使用 univariateColorSize.createContinuousRenderer（）方法生成的呈现器。此方法适用于应用程序允许最终用户切换用于呈现数据的数据变量的情况。

参数:

renderer ClassBreaksRenderer

从 univariateColorSize.createContinuousRenderer（）方法创建结果对象生成的渲染器。

返回值:

类型	描述
ClassBreaksRenderer	返回更新的输入渲染器以匹配当前滑块值。这应该直接设置回它来自的层

示例代码:

slider.on(["thumb-change", "thumb-drag"], function() {
  layer.renderer = slider.updateRenderer( layer.renderer );
});

updateVisualVariables(variables){Array<(ColorVariable|SizeVariable)>}

一个方便的函数，用于使用从滑块获取的值更新使用 univariateColorSize.createContinuousRenderer() 方法生成的渲染器的可视变量。此方法适用于应用程序允许最终用户切换用于呈现数据的数据变量的情况。

参数:

variables Array<(ColorVariable|SizeVariable)>

要从与滑块关联的渲染器更新的可视变量。颜色和大小变量的属性将根据滑块缩略图值进行更新。

返回值:

类型	描述
Array<(ColorVariable\|SizeVariable)>	返回更新为匹配当前滑块值的输入视觉变量。这些应直接设置回它们来自的渲染器。

示例代码:

slider.on(["thumb-change", "thumb-drag"], function() {
  const renderer = layer.renderer.clone();
  renderer.visualVariables = slider.updateVisualVariables( renderer.visualVariables );
  layer.renderer = renderer;
});

when(callback, errback){Promise}inherited 起始版本: GeoScene API for JavaScript 4.22

when() 创建类的实例后，会被执行一次。该方法接受两个参数： callback 函数和 errback 函数。 callback 在类的实例加载时执行。如果类的实例无法加载，则执行 errback。

参数:

callback Function

optional

当 Promise 成功时，该函数将被调用。

errback Function

optional

当 Promise 失败时，该函数将被调用。

返回值:

类型	描述
Promise	返回回调结果的新promise，可用于 chain additional functions.

示例代码:

// 尽管此示例使用 BasemapGallery widget，但任何作为 Promise 的类实例都可以以相同的方式使用 when()
let bmGallery = new BasemapGallery();
bmGallery.when(function(){
  // 当 Promise resolved 时，函数将被执行
}, function(error){
  // 当 Promise 通过 rejected 抛错时，这个函数将被执行
});

Event Overview

Show inherited events

Hide inherited events

类型	描述	类
{oldValue: Number,type: "max-change",value: Number}	更多信息当用户更改滑块的max值时触发。	更多信息	SmartMappingSliderBase
{oldValue: Number,type: "min-change",value: Number}	更多信息当用户更改滑块的min值时触发。	更多信息	SmartMappingSliderBase
{index: Number,state: "start","drag",type: "segment-drag",thumbIndices: Number []}	更多信息当用户拖动滑块段时触发。	更多信息	SmartMappingSliderBase
{index: Number,oldValue: Number,type: "thumb-change",value: Number}	更多信息当用户通过箭头键和键盘编辑微件上的标签来更改缩略图的值时，将触发。	更多信息	SmartMappingSliderBase
{index: Number,state: "start","drag",type: "thumb-drag",value: Number}	更多信息当用户在微件上拖动缩略图时触发。	更多信息	SmartMappingSliderBase

Event Details

max-changeinherited

当用户更改滑块的max值时触发。

属性:

oldValue Number

滑块的前max 值（或界限）

type String

事件类型

该值通常是 "max-change".

value Number

触发事件时滑块的max（或界限）值。

示例代码:

slider.on("max-change", function() {
  const renderer = layer.renderer.clone();
  const visualVariable = renderer.visualVariables[0].clone();
  colorVariable.stops = slider.stops;
  renderer.visualVariables = [ visualVariable ];
  layer.renderer = renderer;
});

min-changeinherited

当用户更改滑块的min值时触发。

属性:

oldValue Number

滑块的前min 值（或界限）

type String

事件类型

该值通常是 "min-change".

value Number

触发事件时滑块的min值（或绑定值）。

示例代码:

slider.on("min-change", function() {
  const renderer = layer.renderer.clone();
  const visualVariable = renderer.visualVariables[0].clone();
  colorVariable.stops = slider.stops;
  renderer.visualVariables = [ visualVariable ];
  layer.renderer = renderer;
});

segment-draginherited 起始版本: GeoScene API for JavaScript 4.22

当用户拖动滑块的一段时激发。段是部分位于两个缩略图之间的轨道。这仅适用于当 visibleElements.interactiveTrack是true。

属性:

index Number

滑块中段的从 1 开始的索引。

state String

拖动的状态。

可选值:"start"|"drag"

type String

事件类型

该值通常是 "segment-drag".

thumbIndices Number []

线段两端的缩略图索引。

示例:

visibleElements

示例代码:

slider.on("segment-drag", () => {
  const renderer = layer.renderer.clone();
  const visualVariable = renderer.visualVariables[0].clone();
  colorVariable.stops = slider.stops;
  renderer.visualVariables = [ visualVariable ];
  layer.renderer = renderer;
});

thumb-changeinherited

当用户通过箭头键和键盘编辑微件上的标签来更改缩略图的值时，将触发。

属性:

index Number

触发事件的拇指的从 0 开始的索引。

oldValue Number

进行更改之前拇指的先前值。

type String

事件类型

该值通常是 "thumb-change".

value Number

触发事件时的 thumb 值。

示例代码:

slider.on("thumb-change", function() {
  const renderer = layer.renderer.clone();
  const visualVariable = renderer.visualVariables[0].clone();
  colorVariable.stops = slider.stops;
  renderer.visualVariables = [ visualVariable ];
  layer.renderer = renderer;
});

thumb-draginherited

当用户在微件上拖动缩略图时触发。

属性:

index Number

触发事件的拇指的从 0 开始的索引。

state String

拖动的状态。

可选值:"start"|"drag"

type String

事件类型

该值通常是 "thumb-drag".

value Number

触发事件时的 thumb 值。

示例代码:

slider.on("thumb-drag", function() {
  const renderer = layer.renderer.clone();
  const visualVariable = renderer.visualVariables[0].clone();
  colorVariable.stops = slider.stops;
  renderer.visualVariables = [ visualVariable ];
  layer.renderer = renderer;
});

GeoScene API for JavaScript参考手册

构造函数

属性列表

属性详细说明

方法列表

方法详细说明

Event Overview

Event Details