Link Chart

Collection containing a flat list of all the created LayerViews related to the basemap, operational layers, and group layers in this view.

A collection of analyses associated with the view.

Read more...

Indicates whether animations are disabled in the view. This includes animated symbols (animated CIMSymbol, PictureMarkerSymbol from a GIF/animated PNG), animated renderers (FlowRenderer), animated layers (MediaLayer, VideoLayer), and animations triggered by view navigation (for example, goTo()). Setting this property to true disables all animations in the view.

Attribute

animations-disabled

Default value

false

The ARIA attributes for the view container. Provides accessibility information to assistive technologies such as screen readers. Supports the following properties: label, description, describedByElements, and labelledByElements.

If true, the component will not be destroyed automatically when it is disconnected from the document. This is useful when you want to move the component to a different place on the page, or temporarily hide it. If this is set, make sure to call the destroy method when you are done to prevent memory leaks.

Attribute

auto-destroy-disabled

Default value

false

The background color of the LinkChartView. If the view's link chart changes, the view's background is reset to the link chart's background, even if the user set it previously.

Default value

null

Specifies a basemap for the link chart. The basemap is only visible when the link chart is set to a geographic layout. See documentation on layouts for more detail. The basemap is a set of layers that give geographic context to the LinkChartView and the other operational layers in the link chart.

Attribute

basemap

Represents the view for a single basemap after it has been added to the link chart.

Represents the view's center point; when setting the center, you may pass a esri/geometry/Point instance or a string representing a longitude/latitude pair ("-100.4593, 36.9014"). Setting the center immediately changes the current view. For animating the view, see this component's goTo() method.

Attribute

center

Specifies constraints to scale, zoom, and rotation that may be applied to the LinkChartView.

Indicates whether layer's displayFilter are honored when rendering layers in the view. If false, display filters are ignored and all features are rendered.

Attribute

display-filter-disabled

Default value

false

The extent represents the visible portion of a link chart within the view as an instance of Extent. Setting the extent immediately changes the view without animation. To animate the view, see this component's goTo() method. When the view is rotated, the extent does not update to include the newly visible portions of the link chart.

A rejected view indicates a fatal error making it unable to display.

Allows for adding graphics directly to the default graphics in the View.

Examples

1
2
// Adds a graphic to the View
graphics.add(pointGraphic);

1
2
// Removes a graphic from the View
graphics.remove(pointGraphic);

Use the highlights property instead.

Options for configuring the highlight.

The highlights property is a collection of HighlightGroup objects that allow you to visually emphasize specific features on the link chart.

Indication whether the view is being interacted with (for example when panning or by an interactive tool).

Default value

false

The ID of a WebLinkChart from an ArcGIS Enterprise portal.

To configure the portal url you must set the portalUrl property on config before the Link Chart component loads.

Attribute

item-id

A collection containing a hierarchical list of all the created LayerViews of the operational layers in the link chart.

An array of objects that encountered an error while loading the component or any of its dependencies (e.g., basemap, ground, layers, tables). You may inspect the errors by accessing each object's loadError property.

The magnifier allows for showing a portion of the view as a magnifier image on top of the view.

An instance of a WebLinkChart object to display in the view.

Indication whether the view is being navigated (for example when panning).

Default value

false

Options to configure the navigation behavior of the View.

Use the padding property to make the center, and extent, etc.

Default value

{left: 0, top: 0, right: 0, bottom: 0}

A Popup object that displays general content or attributes from layers in the map.

Read more...

Controls whether the popup opens automatically when users click on the view.

Attribute

popup-disabled

Default value

false

When true, this property indicates whether the view successfully satisfied all dependencies, signaling that the following conditions are met.

Default value

false

Defines which anchor stays still while resizing the browser window. The default, center, ensures the view's center point remains constantly visible as the window size changes. The other options allow the respective portion of the view to remain visible when the window's size is changed.

Attribute

resize-align

Default value

"center"

Represents the current value of one pixel in the unit of the view's spatialReference. The value of resolution is calculated by dividing the view's extent width by its width.

The clockwise rotation of due north in relation to the top of the view in degrees. The view may be rotated by directly setting the rotation or by using the following mouse event: Right-click + Drag. WebLinkChart rotation may be disabled by setting the rotationEnabled property in constraints to false.

Attribute

rotation

Default value

0

Represents the link chart scale at the center of the view. Setting the scale immediately changes the view. For animating the view, see this component's goTo() method.

Attribute

scale

The spatial reference of the view. This indicates the projected or geographic coordinate system used to locate geographic features in the link chart.

Default value

null

Indication whether the view is animating, being navigated with or resizing.

Default value

false

Indicates if the view is visible on the page.

Attribute

suspended

Default value

true

This property specifies the base colors used by some widgets and components to render graphics and labels.

Default value

null

The view's time extent. Time-aware layers display their temporal data that falls within the view's time extent. Setting the view's time extent is similar to setting the spatial extent because once the time extent is set, the view updates automatically to conform to the change.

Default value

null

Defines the time zone of the view. The time zone property determines how dates and times are represented to the user, but the underlying data is unchanged.

Attribute

time-zone

Default value

"system"

Indicates whether the view is being updated by additional data requests to the network, or by processing received data.

Default value

false

Internal view of the component.

Represents the current view as a Viewpoint or point of observation on the view. Setting the viewpoint immediately changes the current view. For animating the view, see this component's goTo() method.

Represents the level of detail (LOD) at the center of the view. A zoom level (or scale) is a number that defines how large or small the contents of a link chart appear in a link chart view. Zoom level is a number usually between 0 (global view) and 23 (very detailed view) and is used as a shorthand for predetermined scale values. A value of -1 means the view has no LODs. When setting the zoom value, the LinkChartView converts it to the corresponding scale, or interpolates it if the zoom is a fractional number. LinkChartView can display link charts with different projections at a full range of scales, and so use the scale property on this component rather than zoom level.

Setting the zoom immediately changes the current view. For animating the view, see this component's goTo() method. Setting this property in conjunction with center is a convenient way to set the initial extent of the view.

Attribute

zoom

Adds a layer to the map layers collection.

Parameters

Returns

Promise<void>

Adds a layer or array of layers to the map layers collection.

Parameters

Returns

Promise<void>

Closes the popup.

Returns

Promise<void>

Create a promise that resolves once component is fully loaded.

Example

1
2
3
4
const arcgisLinkChart = document.querySelector("arcgis-link-chart");
document.body.append(arcgisLinkChart);
await arcgisLinkChart.componentOnReady();
console.log("arcgis-link-chart is ready to go!");

Returns

Promise<void>

Destroys the view, and any associated resources, including its map, popup, and UI elements.

Returns

Promise<void>

Sets the view to a given target.

Parameters

Returns

Promise<unknown>

Opens the popup at the given location with content defined either explicitly with content or driven from the PopupTemplate of input features.

Parameters

Returns

Promise<void>

Parameters

Returns

Point

Parameters

Returns

MapViewScreenPoint | null | undefined

Call this method to clear any fatal errors resulting from a lost WebGL context.

Returns

Promise<void>

viewOnReady() may be leveraged once an instance of the component and its underlying view is created and ready. This method takes two input parameters, a callback function and an errback function, and returns a promise. The callback executes when the promise resolves, and the errback executes if the promise is rejected.

See also

• Watch for changes - waiting for components or views to be ready

Example

1
2
3
const viewElement = document.querySelector("arcgis-link-chart");
await viewElement.viewOnReady();
// The view is now ready to be used.

Parameters

Returns

Promise<void>

Gets the analysis view created for the given analysis object.

Read more

Parameters

Returns

Promise<ElevationProfileAnalysisView2D>

Gets the LayerView created on the view for the given layer.

Parameters

Returns

Promise<LayerView>

Fires when a ArcgisLinkChart fails to load or if one of its dependencies fails to load (e.g., basemap, ground, layers).

See also

• loadErrorSources

Example

1
2
3
viewElement.addEventListener("arcgisLoadError", () => {
  console.log(viewElement.loadErrorSources);
});

Fires when the view for an analysis is created.

Read more

Fires when an error occurs during the creation of an analysis view after an analysis is added to the view.

Read more

Fires after an analysis view is destroyed.

Read more

This event is for view related property changes: zoom, scale, center, rotation, extent, camera, viewpoint. This event will also emit if stationary toggles from true to false.

Fires after a user clicks on the view.

Fires after double-clicking on the view.

Fires during a pointer drag on the view.

Fires during a pointer drag on the view.

Fires right after a user clicks on the view.

Is emitted after two consecutive immediate-click events.

Fires after a keyboard key is pressed.

Fires after a keyboard key is pressed.

Fires after each layer in the link chart has a corresponding LayerView created and rendered in the view.

Fires when an error emits during the creation of a LayerView after a layer has been added to the link chart.

Fires after a LayerView is destroyed and is no longer rendered in the view.

Fires when a wheel button of a pointing device (typically a mouse) is scrolled on the view.

Fires after a mouse button is pressed, or a finger touches the display.

Fires after a mouse cursor enters the view, or a display touch begins.

Fires after a mouse cursor leaves the view, or a display touch ends.

Fires after the mouse or a finger on the display moves.

Fires after a mouse button is released, or a display touch ends.

This event is for the ready property and will be emitted when the view is ready. This event will also emit if the map property is changed.

Fires if the view encounters a content or rendering error.

Example

1
2
3
viewElement.addEventListener("arcgisViewReadyError", () => {
  // handle error
});

Default slot for adding components to the link chart. User is responsible for positioning the content via CSS.

Slot for components positioned in the top-left corner.

Slot for components positioned in the top-right corner.

Slot for components positioned in the bottom-left corner.

Slot for components positioned in the bottom-right corner.

Slot for components positioned at the top-start (top-left in LTR, top-right in RTL).

Slot for components positioned at the top-end (top-right in LTR, top-left in RTL).

Slot for components positioned at the bottom-start (bottom-left in LTR, bottom-right in RTL).

Slot for components positioned at the bottom-end (bottom-right in LTR, bottom-left in RTL).

Slot for the Popup component to open automatically on click. When using this slot, the popup-disabled attribute must be set to true. Only the Popup component can be placed in this slot.