-
createVisualVariable
(params)
{Promise<VisualVariableResult>}
此方法生成一個不透明度可視變量,其默認 alpha 值根據為指定字段或表達式查詢的統計信息優化映射到數據值。
可以通過多種方式調用此方法。最常見的情況是提供
layer
和field
。在這種情況下,數據的統計信息並不為人所知,並且用戶不知道要將哪些 alpha 值映射到數據值。您可以選擇使用valueExpression
而不是字段,根據運行時執行的腳本返回的數值來可視化特征。提供其他選項是為了方便更多涉及的自定義可視化創作應用程序。例如,如果您已經在另一個操作中生成了統計信息,則可以在
statistics
參數中傳遞統計信息,以避免對服務器進行額外的調用。參數:
規格:類型 說明 params Object用於根據從給定字段或表達式返回的數據生成不透明度可視變量的輸入參數。有關每個參數的詳細信息,請參見下表。
規格:為其生成視覺變量的層。
field可選的 將查詢其數據以進行統計並用作數據驅動可視化基礎的字段的名稱。如果使用
valueExpression
,則忽略此屬性。normalizationField可選的 用於規範化給定
field
值的字段名稱。提供歸一化字段有助於最大限度地減少一些可視化錯誤並標準化數據,因此所有特征都以最小的偏差進行可視化,因為麵積差異或計數變化。此選項通常在可視化密度時使用。valueExpression可選的 遵循 Arcade Visualization Profile 定義的規範的 Arcade 表達式。表達式可以使用
$feature
全局變量引用字段值,並且必須返回一個數字。此屬性覆蓋field
屬性,因此用於代替輸入field
值。valueExpressionTitle可選的 說明從
valueExpression
返回的值的文本。這是由Legend 小部件使用的。sqlExpression可選的 計算為數字的 SQL 表達式。
sqlWhere可選的 用於過濾統計查詢函數的 SQL where 子句。例如,這在您希望避免除以零的情況下很有用,就像創建優勢可視化的情況一樣。
legendOptions可選的 當提供表達式而不是字段名稱時,提供用於為字段設置標題的選項。此標題將表示 Legend 中的字段。
規格:title可選的 用於表示 Legend 中給定字段或表達式的標題。
statistics可選的 從 summaryStatistics 函數生成的統計對象。如果該字段的統計信息已經生成,則在此處傳遞對象以避免向服務器進行第二次統計查詢。
minValue可選的 用戶設置的自定義最小值。將此與
maxValue
結合使用以生成上下限之間的統計信息。這將是返回的視覺變量中的最低點。maxValue可選的 用戶設置的自定義最大值。將此與
minValue
結合使用以生成上下限之間的統計信息。這將是返回的視覺變量中的最高點。view可選的 signal可選的 允許可取消的請求。如果取消,promise 將被拒絕,並出現名為
AbortError
的錯誤。另見AbortController。返回:
類型 說明 Promise<VisualVariableResult> 解析為 VisualVariableResult 的實例。 例子:
let layer = new FeatureLayer({ url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/counties_politics_poverty/FeatureServer/0" }); // visualization based on field and normalization field let params = { layer: layer, field: "POP_POVERTY", normalizationField: "TOTPOP_CY" }; // when the promise resolves, apply the visual variable to the renderer opacityVariableCreator.createVisualVariable(params) .then(function(response){ let renderer = layer.renderer.clone(); renderer.visualVariables = [ response.visualVariable ]; layer.renderer = renderer; });
let layer = new FeatureLayer({ url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/counties_politics_poverty/FeatureServer/0" }); // visualization based off Arcade expression let params = { layer: layer, valueExpression: "($feature.POP_POVERTY / $feature.TOTPOP_CY) * 100", view: view, valueExpressionTitle: "% of people living in poverty" }; // when the promise resolves, apply the visual variable to the renderer opacityVariableCreator.createVisualVariable(params) .then(function(response){ let renderer = layer.renderer.clone(); renderer.visualVariables = [ response.visualVariable ]; layer.renderer = renderer; });
基本信息
以下是所在類或對象的基本信息。
AMD:
require(["esri/smartMapping/renderers/opacity"], (opacityVariableCreator) => { /* code goes here */ });
ESM:
import * as opacityVariableCreator from "@arcgis/core/smartMapping/renderers/opacity";
對象:
esri/smartMapping/renderers/opacity
自從:用於 JavaScript 4.6 的 ArcGIS API
用法說明
opacity.createVisualVariable
函數(或屬性)的定義如下:
相關用法
- JavaScript ArcGIS SceneView double-click事件用法及代碼示例
- JavaScript ArcGIS geometryEngineAsync.overlaps用法及代碼示例
- JavaScript ArcGIS Expand.when用法及代碼示例
- JavaScript ArcGIS Sublayer.JoinTableDataSource用法及代碼示例
- JavaScript ArcGIS FillSymbol3DLayer.outline用法及代碼示例
- JavaScript ArcGIS Ground.loadAll用法及代碼示例
- JavaScript Object valueOf()用法及代碼示例
- JavaScript ArcGIS LabelClass.repeatLabelDistance用法及代碼示例
- JavaScript ArcGIS KMLLayerView.when用法及代碼示例
- JavaScript ArcGIS Daylight.visibleElements用法及代碼示例
- JavaScript Uint8Array.of()用法及代碼示例
- JavaScript ArcGIS CIMSymbol.CIMTextSymbol用法及代碼示例
- JavaScript new Legend用法及代碼示例
- JavaScript Slider.effectiveMin用法及代碼示例
- JavaScript Sketch.classes用法及代碼示例
- JavaScript Sketch.visible用法及代碼示例
- JavaScript ArcGIS AreaMeasurement3D.analysis用法及代碼示例
- JavaScript ArcGIS PolygonDrawAction draw-complete事件用法及代碼示例
- JavaScript ArcGIS PathSymbol3DLayer用法及代碼示例
- JavaScript ArcGIS decorators.cast用法及代碼示例
- JavaScript ArcGIS VectorTileLayer.apiKey用法及代碼示例
- JavaScript Swipe.when用法及代碼示例
- JavaScript ColorSlider用法及代碼示例
- JavaScript ArcGIS IntegratedMeshLayer.visible用法及代碼示例
- JavaScript ArcGIS BuildingFilter用法及代碼示例
注:本文由純淨天空篩選整理自arcgis.com大神的英文原創作品 opacity.createVisualVariable。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。