SizeSlider

SizeSlider 微件用于创作和浏览可使用 SizeVariable 渲染的任何图层中的数据驱动可视化效果。至少必须设置微件的最小值、最大值和停靠点属性。

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

具有批注的 SizeSlider

fromRendererResult 方法可用于方便地从 createContinuousRenderer 方法的结果创建此滑块。

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

let rendererResult = null;

sizeRendererCreator
  .createContinuousRenderer(sizeParams)
  .then(function(response) {
    rendererResult = response;
    layer.renderer = response.renderer;

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

此滑块应用于更新图层渲染器中的大小可视变量。应用程序开发人员负责在更新相应渲染器的大小变量时设置事件侦听器。

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

sizeSlider.on(["thumb-change", "thumb-drag"], function() {
  const renderer = layer.renderer.clone();
  const sizeVariable = renderer.visualVariables[0];
  renderer.visualVariables = [ sizeSlider.updateVisualVariable(sizeVariable) ];
  layer.renderer = renderer;
});

另请参阅：

构造函数

new SizeSlider(properties)

参数：

properties Object

optional

有关可能传递到构造函数中的所有属性的列表，请参阅属性。

示例：

// Typical usage
const slider = new SizeSlider({
  container: "sliderDiv",
  min: 0,
  max: 100,
  stops: [
    { value: 0, size: 4 },
    { value: 100, size: 40 }
  ]
});

属性概述

可以设置、检索或侦听任何属性。请参阅使用属性主题。

显示继承的属性

隐藏继承的属性

类型	描述	类：
String\|HTMLElement	更多详情表示包含微件的 DOM 元素的 ID 或节点。	更多详情	Widget
String	更多详情类的名称。	更多详情	Accessor
Boolean	更多详情仅适用于三个拇指（即	更多详情	SizeSlider
HistogramConfig	更多详情与滑块上表示的数据关联的直方图。	更多详情	SmartMappingSliderBase
String	更多详情创建微件时分配给微件的唯一 ID。	更多详情	Widget
LabelFormatter	更多详情用于设置用户输入格式的函数。	更多详情	SmartMappingSliderBase
InputParser	更多详情用于解析由 inputFormatFunction 格式化的滑块输入的函数。	更多详情	SmartMappingSliderBase
String	更多详情微件的默认标注。	更多详情	SizeSlider
LabelFormatter	更多详情 Slider.labelFormatFunction 的修改版本，它是一个自定义函数，用于设置拇指、最小值、最大值和平均值上的标注格式。	更多详情	SmartMappingSliderBase
Number	更多详情滑块的最大值或上限。	更多详情	SmartMappingSliderBase
Number	更多详情滑块的最小值或下限。	更多详情	SmartMappingSliderBase
Boolean	更多详情仅适用于三个拇指（即	更多详情	SizeSlider
Number	更多详情定义滑块拇指值应如何舍入。	更多详情	SmartMappingSliderBase
Boolean	更多详情当 `true` 时，滑块将在默认提供的两个句柄之间渲染第三个句柄。	更多详情	SizeSlider
String	更多详情视图模型的状态。	更多详情	SmartMappingSliderBase
SizeStop []	更多详情大小从 SizeVariable 停止以链接到滑块。	更多详情	SizeSlider
Object	更多详情公开可设置样式的微件的各种属性。	更多详情	SizeSlider
Boolean	更多详情当 `true`，当用户拖动任何段时，所有段将在更新拇指值时同步在一起。	更多详情	SmartMappingSliderBase
SizeSliderViewModel	更多详情 SizeSlider 微件的视图模型。	更多详情	SizeSlider
Boolean	更多详情指示微件是否可见。	更多详情	Widget
Object	更多详情显示在微件中的可见元素。	更多详情	SmartMappingSliderBase
Object	更多详情将滑块轨迹缩放到此属性中提供的边界。	更多详情	SmartMappingSliderBase

属性详细信息

container String|HTMLElement inherited

表示包含微件的 DOM 元素的 ID 或节点。此属性只能设置一次。以下示例是使用微件时的所有有效用例。

示例：

// Create the HTML div element programmatically at runtime and set to the widget's container
const basemapGallery = new BasemapGallery({
  view: view,
  container: document.createElement("div")
});

// Add the widget to the top-right corner of the view
view.ui.add(basemapGallery, {
  position: "top-right"
});

// Specify an already-defined HTML div element in the widget's container

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

// Add the widget to the top-right corner of the view
view.ui.add(basemapGallery, {
  position: "top-right"
});

// HTML markup
<body>
  <div id="viewDiv"></div>
  <div id="basemapGalleryDiv"></div>
</body>

// Specify the widget while adding to the view's UI
const basemapGallery = new BasemapGallery({
  view: view
});

// Add the widget to the top-right corner of the view
view.ui.add(basemapGallery, {
  position: "top-right"
});

declaredClass Stringreadonly inherited

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

handlesSyncedToPrimary Boolean 起始版本：GeoScene API for JavaScript 4.18

仅当滑块值上设置了三个拇指（即句柄）时适用。此属性指示外部句柄的位置是与中间控点同步还是与主控点同步。启用后，如果主句柄移动，则外部句柄位置将更新，同时与主句柄保持固定距离。

仅当 primaryHandleEnabled 为 true 时适用。

默认值：true

另请参阅：

primaryHandleEnabled

示例：

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

histogramConfig HistogramConfig inherited

与滑块上表示的数据关联的直方图。条柱通常使用直方图统计函数生成。

另请参阅：

示例：

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，或者如果不存在，则将自动生成。

inputFormatFunction LabelFormatter inherited 起始版本：GeoScene API for JavaScript 4.14

用于设置用户输入格式的函数。与设置拇指标注格式的 labelFormatFunction 相反，当用户开始编辑拇指值时，设置输入元素中拇指值的 inputFormatFunction 格式。

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

无输入格式化的滑块

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

无输入格式化的滑块

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

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

另请参阅：

inputParseFunction

示例：

// Formats the slider input to abbreviated numbers with units
// e.g. a thumb at position 1500 will render with an input label of 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.14

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

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

另请参阅：

inputFormatFunction

示例：

// Parses the slider input (a string value) to a number value understandable to the slider
// This assumes the slider was already configured with an inputFormatFunction
// For example, if the input is 1.5k this function will parse
// 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

微件的默认标注。当在另一个微件（如展开或 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

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

示例：

slider.max = 150;

min Number inherited

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

示例：

slider.min = -150;

persistSizeRangeEnabled Boolean 起始版本：GeoScene API for JavaScript 4.19

仅当在滑块上设置了三个拇指（即句柄）时才适用（即当 primaryHandleEnabled 为 true）。此属性通常用于发散或 above-and-below 渲染器配置。

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

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

默认值：false

另请参阅：

primaryHandleEnabled

示例：

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

precision Number inherited 起始版本：GeoScene API for JavaScript 4.14

定义滑块拇指值应如何舍入。此数字表示滑块拇指值在移动时应舍入到的小数位数。

当数据范围小于 10（即 (max - min) < 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"
});

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

如果拇指标注不可见，则必须使用 labelInputsEnabled 启用它们。

请记住，此属性对拇指值进行舍入，不应专门用于格式设置目的。若要设置拇指 labels 的格式，请使用 labelFormatFunction 属性。

默认值：4

示例：

slider.precision = 7;

primaryHandleEnabled Boolean 起始版本：GeoScene API for JavaScript 4.18

当 true 时，滑块将在默认提供的两个句柄之间渲染第三个句柄。这是主句柄。当 handlesSyncedToPrimary 是 true 时，此句柄将在移动时控制其他句柄的位置。

默认值：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 SizeStop []

大小从 SizeVariable 停止以链接到滑块。

另请参阅：

updateVisualVariable()

示例：

const slider = new SizeSlider({
  container: "sliderDiv",
  min: 0,
  max: 100,
  stops: [
    { value: 0, size: 4 },
    { value: 100, size: 40 }
  ]
});

style Object

公开可设置样式的微件的各种属性。

属性：

trackFillColor Color

optional

默认值：new Color([149, 149, 149])

滑块轨道的颜色。对于仅存在大小变量的单色可视化效果，应将此颜色设置为与 SimpleRenderer 中符号的颜色相匹配。

trackBackgroundColor Color

optional

默认值：new Color([224, 224, 224])

滑块轨道的背景色。通常，此颜色应柔和，且不干扰 trackFillColor。

示例：

slider.style = {
  trackFillColor: new Color("dodgerblue"),
  trackBackgroundColor: new Color([50,50,50])
};

syncedSegmentsEnabled Boolean inherited 起始版本：GeoScene API for JavaScript 4.20

当 true，当用户拖动任何段时，所有段将在更新拇指值时同步在一起。这将在拖动任何段时保持所有拇指之间的间隔。仅当 visibleElements.interactiveTrack 是 true 时才适用。

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

默认值：false

另请参阅：

visibleElements
handlesSyncedToPrimary

示例：

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

viewModel SizeSliderViewModel

SizeSlider 微件的视图模型。此类包含控制此微件行为的所有逻辑（属性和方法）。请参阅 SizeSliderViewModel 类以访问 SizeSlider 微件上的所有属性和方法。

visible Boolean inherited

指示微件是否可见。

如果 false，则该微件将不再呈现在 web 文档中。这可能会影响文档中其他元素或微件的布局。例如，如果此微件是与视图 UI 右上角关联的三个微件中的第一个，则当此微件变为不可见时，其他微件将重新定位。有关详细信息，请参阅 "none" 的 CSS 显示值。

默认值：true

示例：

// Hides the widget in the view
widget.visible = false;

visibleElements Object inherited 起始版本：GeoScene API for JavaScript 4.20

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

属性：

interactiveTrack Boolean

optional

默认值：false

当 true，在轨道上显示交互段，这些段保持两个滑块拇指/句柄之间的间隔。

另请参阅：

syncedSegmentsEnabled
Segment-drag 事件

示例：

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

zoomOptions Object inherited

将滑块轨迹缩放到此属性中提供的边界。将滑块轨迹缩放到此属性中提供的边界。提供最小和/或最大缩放值时，将保留绝对最小和最大滑块值，并在滑块上的典型位置渲染。但是，滑块轨道本身会缩放，因此拇指不能移动到提供的最小和最大缩放值的上方或下方。

当滑块处于缩放状态时，轨道的缩放末端将显示锯齿状。在下图中，请注意，即使滑块最大值为 200，上拇指也无法移动超过缩放最大值 31。

slider-zoom

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

当滑块绑定到严重倾斜的数据集时，设置 zoomOptions 很有用，其中直方图由于异常值而仅呈现一个或两个条柱。

slider-not-zoomed

您可以通过缩放滑块并根据缩放的最小值和最大值重新生成直方图来消除异常值的影响。

属性：

min Number

optional

缩放的下限。

max Number

optional

缩放的上限。

示例：

// zooms the slider to so thumbs can only be moved
// to positions between the values of 10 and 25 while
// maintaining the slider's absolute minimum and
// maximum values
slider.zoomOptions = {
  min: 10,
  max: 25
};

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

// zooms the slider to so thumbs can only be moved
// to positions above the value of 10, while maintaining
// the slider's absolute minimum value
slider.zoomOptions = {
  min: 10
};

// zooms the slider to so thumbs can only be moved
// 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	更多详情用于为微件的 `class` 属性构建值的实用程序方法。	更多详情	Widget
	更多详情销毁微件实例。	更多详情	Widget
Boolean	更多详情在实例上发出事件。	更多详情	Widget
SizeSlider	更多详情一个方便函数，用于从 createContinuousRenderer 方法的结果创建 SizeSlider 微件实例。	更多详情	SizeSlider
Boolean	更多详情指示实例上是否存在与提供的事件名称匹配的事件侦听器。	更多详情	Widget
Boolean	更多详情 `isFulfilled()` 可用于验证是否满足类的创建实例（已解决或已拒绝）。	更多详情	Widget
Boolean	更多详情 `isRejected()` 可用于验证创建类的实例是否被拒绝。	更多详情	Widget
Boolean	更多详情 `isResolved()` 可用于验证是否解析了类的创建实例。	更多详情	Widget
Object	更多详情在实例上注册事件处理程序。	更多详情	Widget
	更多详情微件拆解助手。	更多详情	Widget
	更多详情此方法主要由开发人员在实现自定义微件时使用。	更多详情	Widget
Object	更多详情此方法主要由开发人员在实现自定义微件时使用。	更多详情	Widget
	更多详情立即将微件渲染给 DOM。	更多详情	Widget
	更多详情此方法主要由开发人员在实现自定义微件时使用。	更多详情	Widget
	更多详情一个方便函数，用于从 createContinuousRenderer 方法的结果更新 SizeSlider 微件实例的属性。	更多详情	SizeSlider
SizeVariable	更多详情一个方便函数，用于更新 SizeVariable 以匹配滑块上的停靠点值。	更多详情	SizeSlider
Promise	更多详情 `when()` 可以在创建类的实例后利用。	更多详情	Widget

方法详细信息

classes(classNames){String}inherited

用于为微件的 class 属性构建值的实用程序方法。这有助于简化 CSS 类设置。

参数：

classNames String|String []|Object

repeatable

类名称

类型	说明
String	计算的类名。

另请参阅：

指南 - 微件开发（渲染）

示例：

// .tsx syntax showing how to set CSS classes while rendering the widget

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

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

destroy()inherited

销毁微件实例。

emit(type, event){Boolean}inherited

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

参数：

type String

事件的名称。

event Object

optional

事件负载。

类型	说明
Boolean	`true` 如果听取了侦听者的通知

fromRendererResult(rendererResult, histogramResult){SizeSlider}static

一个方便函数，用于从 createContinuousRenderer 方法的结果创建 SizeSlider 微件实例。

此方法设置滑块停靠点、最小值、最大值和 histogramConfig。开发人员仍然有责任为其分配适当的容器和任何其他可选属性。

参数：

rendererResult ContinuousRendererResult

来自 createContinuousRenderer 方法的结果对象。

histogramResult HistogramResult

optional

来自直方图方法的结果直方图对象。

类型	说明
SizeSlider	返回一个 SizeSlider 实例。在为其分配有效容器之前，不会呈现此内容。

示例：

const params = {
  layer: layer,
  basemap: map.basemap,
  field: "POP_POVERTY"
};

let rendererResult = null;

sizeRendererCreator
  .createContinuousRenderer(colorParams)
  .then(function(response) {
    rendererResult = response;
    layer.renderer = response.renderer;

    return histogram({
      layer: layer,
      valueExpression: params.field,
      numBins: 30
    });
  })
   .then(function(histogramResult) {

     const sizeSlider = SizeSlider.fromRendererResult(rendererResult, histogramResult);
     sizeSlider.container = "slider";

     // when the user slides the handle(s), update the renderer
     // with the updated size properties

     sizeSlider.on(["thumb-change", "thumb-drag"], function() {
       const renderer = layer.renderer.clone();
       const sizeVariable = renderer.visualVariables[0];
       renderer.visualVariables = [ sizeSlider.updateVisualVariable( sizeVariable ) ];
       layer.renderer = renderer;
     });
   })
   .catch(function(error) {
     console.log("there was an error: ", error);
   });

hasEventListener(type){Boolean}inherited

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

参数：

type String

事件的名称。

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

isFulfilled(){Boolean}inherited 起始版本：GeoScene API for JavaScript 4.19

isFulfilled() 可用于验证是否满足类的创建实例（已解决或已拒绝）。如果已完成，将返回 true。

类型	说明
Boolean	指示是否已完成创建类的实例（已解决或已拒绝）。

isRejected(){Boolean}inherited 起始版本：GeoScene API for JavaScript 4.19

isRejected() 可用于验证创建类的实例是否被拒绝。如果被拒绝，将返回 true。

类型	说明
Boolean	指示创建类的实例是否已被拒绝。

isResolved(){Boolean}inherited 起始版本：GeoScene API for JavaScript 4.19

isResolved() 可用于验证是否解析了类的创建实例。如果被解析，将返回 true。

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

on(type, listener){Object}inherited

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

参数：

type String|String []

要侦听的事件或事件数组。

listener Function

事件激发时要调用的函数。

类型说明

Object

返回具有 remove() 方法的事件处理程序，应调用该方法以停止侦听事件。

属性	类型	说明
remove	Function	调用时，从事件中删除侦听器。

示例：

view.on("click", function(event){
  // event is the event handle returned after the event fires.
  console.log(event.mapPoint);
});

own(handles)inherited

微件拆解助手。当微件被销毁时，添加到其中的任何句柄都将自动删除。

参数：

handles WatchHandle|WatchHandle []

在微件被销毁后标记为删除的句柄。

postInitialize()inherited

此方法主要由开发人员在实现自定义微件时使用。在微件准备好进行渲染后执行。

render(){Object}inherited

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

类型	说明
Object	渲染的虚拟节点。

renderNow()inherited

立即将微件渲染给 DOM。

scheduleRender()inherited

此方法主要由开发人员在实现自定义微件时使用。计划微件渲染。此方法对于影响 UI 的更改很有用。

updateFromRendererResult(rendererResult, histogramResult)

一个方便函数，用于从 createContinuousRenderer 方法的结果更新 SizeSlider 微件实例的属性。当应用程序允许最终用户切换用于渲染数据的数据变量时，此方法非常有用。

参数：

rendererResult ContinuousRendererResult

来自 createContinuousRenderer 方法的结果对象。

histogramResult HistogramResult

optional

来自直方图方法的结果直方图对象。

示例：

const params = {
  layer: layer,
  basemap: map.basemap,
  field: "POP_POVERTY"
};

let rendererResult = null;

sizeRendererCreator
  .createContinuousRenderer(colorParams)
  .then(function(response) {
    rendererResult = response;
    layer.renderer = response.renderer;

    return histogram({
      layer: layer,
      valueExpression: params.field,
      numBins: 30
    });
  })
   .then(function(histogramResult) {
     sizeSlider.updateFromRendererResult(rendererResult, histogramResult);
   })
   .catch(function(error) {
     console.log("there was an error: ", error);
   });

updateVisualVariable(sizeVariable){SizeVariable}

一个方便函数，用于更新 SizeVariable 以匹配滑块上的停靠点值。

这对于具有设置 minDataValue 和 maxDataValue 的大小视觉变量特别有用。此方法将正确重建要在渲染器上设置的变量，以便它与滑块上的停靠点匹配。

参数：

sizeVariable SizeVariable

要更新到渲染器中的大小可视变量以设置滑块上的设置的停靠点。

类型	说明
SizeVariable	返回要在渲染器上设置的已更新的可视变量。

示例：

sizeSlider.on(["thumb-change", "thumb-drag"], function() {
  const renderer = layer.renderer.clone();
  const sizeVariable = renderer.visualVariables[0];
  renderer.visualVariables = [ sizeSlider.updateVisualVariable( sizeVariable ) ];
  layer.renderer = renderer;
});

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

when() 可以在创建类的实例后利用。此方法采用两个输入参数：callback 函数和 errback 函数。在类的实例加载时执行 callback。如果类的实例无法加载，则执行 errback。

参数：

callback Function

optional

解析 promise 时要调用的函数。

errback Function

optional

promise 失败时要执行的函数。

类型	说明
Promise	返回回调结果的新 promise，`callback` 结果可用于链接其他函数。

示例：

// Although this example uses the BasemapGallery widget, any class instance that is a promise may use when() in the same way
let bmGallery = new BasemapGallery();
bmGallery.when(function(){
  // This function will execute once the promise is resolved
}, function(error){
  // This function will execute if the promise is rejected due to an error
});

事件概述

显示继承的事件

隐藏继承的事件

类型	描述	类：
{oldValue: Number,type: "max-change",value: Number}	更多详情当用户更改滑块的最大值时激发。	更多详情	SmartMappingSliderBase
{oldValue: Number,type: "min-change",value: Number}	更多详情当用户更改滑块的最小值时激发。	更多详情	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

事件详细信息

max-changeinherited

当用户更改滑块的最大值时激发。

属性：

oldValue Number

滑块的前最大值（或边界）。

type String

事件的类型。

该值始终为"max-change"。

value Number

发出事件时滑块的最大值（或边界）。

示例：

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

当用户更改滑块的最小值时激发。

属性：

oldValue Number

滑块以前的最小值（或界限）。

type String

事件的类型。

该值始终为"min-change"。

value Number

发出事件时滑块的最小值（或界限）的值。

示例：

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.20

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

属性：

index Number

滑块中段的基于 1 的索引。

state String

拖动的状态。

可能的值："start"|"drag"

type String

事件的类型。

该值始终为"segment-change"。

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

发出事件时拇指的值。

示例：

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

发出事件时拇指的值。

示例：

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参考手册

构造函数

属性概述

属性详细信息

方法概述

方法详细信息

事件概述

事件详细信息