Skip to content

Swipe

ESM:
Use dark colors for code blocksCopy
1
import "@arcgis/map-components/components/arcgis-swipe";
CDN:
No specific import is needed for this component.
Since:ArcGIS Maps SDK for JavaScript 4.31

The Swipe component provides a tool to show a portion of a layer or layers on top of a map. Layers can be swiped vertically or horizontally to easily compare two layers or see what is underneath a layer.

To use the Swipe component, set the leadingLayers and trailingLayers properties to determine what will be compared on either side of the component. If one of these properties is not set, then the Swipe component will overlay the existing map.

Known limitations

  • This component is not currently supported within a Scene component.
See also

Demo

Properties

PropertyAttributeType
autoDestroyDisabledauto-destroy-disabledboolean
direction
reflected
direction"horizontal" | "vertical"
disabled
reflected
disabledboolean
hideDivider
reflected
hide-dividerboolean
hideHandle
reflected
hide-handleboolean
iconiconstring
labellabelstring
leadingLayersCollection<Layer>
messageOverridesRecord<string, unknown>
position
deprecatedreflected
position"bottom-leading" | "bottom-left" | "bottom-right" | "bottom-trailing" | "manual" | "top-leading" | "top-left" | "top-right" | "top-trailing"
referenceElementreference-elementHTMLArcgisLinkChartElement | HTMLArcgisMapElement | HTMLArcgisSceneElement | string
state
readonlyreflected
state"disabled" | "ready"
swipePositionswipe-positionnumber
trailingLayersCollection<Layer>
viewMapView

autoDestroyDisabled

Property
autoDestroyDisabled: boolean

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

direction

reflected
Property
direction: "horizontal" | "vertical"

The direction the Swipe component moves across the view. If "horizontal", the component will move left and right and if "vertical", the component will move up and down.

Attribute
direction
Default value
"horizontal"

disabled

reflected
Property
disabled: boolean

When true, sets the component to a disabled state so the user cannot interact with it.

Attribute
disabled
Default value
false

hideDivider

reflected
Property
hideDivider: boolean

When true, the divider between the leading and trailing layers will be hidden.

Attribute
hide-divider
Default value
false

hideHandle

reflected
Property
hideHandle: boolean

When true, the handle from which you drag the component will be hidden.

Attribute
hide-handle
Default value
false

icon

Property
icon: string

Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).

See also
Attribute
icon
Default value
"compare"

label

Property
label: string

The component's default label.

Attribute
label
Default value
"Swipe"

leadingLayers

Property
leadingLayers: Collection<Layer>

A collection of layers that will show on the left or top side of the Swipe component.

messageOverrides

Property
messageOverrides: Record<string, unknown>

Replace localized message strings with your own strings.

Note: Individual message keys may change between releases.

position

deprecatedreflected
Property
position: "bottom-leading" | "bottom-left" | "bottom-right" | "bottom-trailing" | "manual" | "top-leading" | "top-left" | "top-right" | "top-trailing"
Deprecatedsince 4.34, use slot instead.
Attribute
position

referenceElement

Property

By assigning the id attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.

See also
Attribute
reference-element

state

readonlyreflected
Property
state: "disabled" | "ready"

The current state of the component.

Attribute
state
Default value
"disabled"

swipePosition

Property
swipePosition: number

The position of the Swipe component. This determines what percentage of the view will be taken up by the leadingLayers.

Attribute
swipe-position
Default value
25

trailingLayers

Property
trailingLayers: Collection<Layer>

A collection of layers that will show on the right or bottom side of the Swipe component.

view

Property
view: MapView

The view associated with the component.

Note: The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this view property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the Swipe component will be associated with a map or scene component rather than using the view property.

Methods

MethodSignature
componentOnReadycomponentOnReady(): Promise<void>
destroydestroy(): Promise<void>

componentOnReady

Method
componentOnReady(): Promise<void>

Create a promise that resolves once component is fully loaded.

Example
Use dark colors for code blocksCopy
1
2
3
4
const arcgisSwipe = document.querySelector("arcgis-swipe");
document.body.append(arcgisSwipe);
await arcgisSwipe.componentOnReady();
console.log("arcgis-swipe is ready to go!");
Returns
Promise<void>

destroy

Method
destroy(): Promise<void>

Permanently destroy the component.

Returns
Promise<void>

Events

arcgisPropertyChange

Event
arcgisPropertyChange: CustomEvent<{ name: "state"; }>

Emitted when the value of a property is changed. Use this to listen to changes to properties.

bubbles
composed
cancelable

arcgisReady

Event
arcgisReady: CustomEvent<void>

Emitted when the component associated with a map or scene view is ready to be interacted with.

bubbles
composed
cancelable

arcgisSwipeChange

Event
arcgisSwipeChange: CustomEvent<void>
Since:ArcGIS Maps SDK for JavaScript 4.34Swipe since 4.31, arcgisSwipeChange added at 4.34.

Fires when the swipe position changes and the drag handle is released on the component.

Note: To constantly listen to changes while dragging, use the arcgisSwipeInput event instead.

bubbles
composed
cancelable

arcgisSwipeInput

Event
arcgisSwipeInput: CustomEvent<void>
Since:ArcGIS Maps SDK for JavaScript 4.34Swipe since 4.31, arcgisSwipeInput added at 4.34.

Fires when the swipe position is updated. This event is fired continuously while dragging the handle.

bubbles
composed
cancelable

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.