Feature

ESM:
Use dark colors for code blocksCopy
1
import "@arcgis/map-components/components/arcgis-feature";
CDN:
No specific import is needed for this component.

The Feature component displays a graphic according to its PopupTemplate. This component is useful in instances where you want to display information about a feature but without the use of a Popup.

Demo

Properties

PropertyAttributeType
auto-destroy-disabled
boolean
default-popup-template-enabled
boolean
heading-level
number
hide-content-attachments
boolean
hide-content-expression
boolean
hide-content-fields
boolean
hide-content-media
boolean
hide-content-text
boolean
hide-last-edited-info
boolean
hide-last-edit-info
boolean
hide-title
boolean
icon
string
label
string
position
"bottom-leading" | "bottom-left" | "bottom-right" | "bottom-trailing" | "manual" | "top-leading" | "top-left" | "top-right" | "top-trailing"
reference-element
state
readonly
state
"disabled" | "error" | "loading" | "ready"
time-zone
string

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

defaultPopupTemplateEnabled

Property
defaultPopupTemplateEnabled: boolean

Enables automatic creation of a popup template for layers that have popups enabled but no popupTemplate defined.

Attribute
default-popup-template-enabled
Default value
false

graphic

Property
graphic: Graphic

The Graphic used to represent the feature.

Default value
null

headingLevel

Property
headingLevel: number

Indicates the heading level to use for the title of the feature widget.

Attribute
heading-level
Default value
2

hideContentAttachments

Property
hideContentAttachments: boolean

Indicates whether to hide all AttachmentsContent.

Attribute
hide-content-attachments
Default value
false

hideContentExpression

Property
hideContentExpression: boolean

Indicates whether to hide all ExpressionContent.

Attribute
hide-content-expression
Default value
false

hideContentFields

Property
hideContentFields: boolean

Indicates whether to hide all FieldsContent.

Attribute
hide-content-fields
Default value
false

hideContentMedia

Property
hideContentMedia: boolean

Indicates whether to hide all MediaContent.

Attribute
hide-content-media
Default value
false

hideContentText

Property
hideContentText: boolean

Indicates whether to hide all TextContent.

Attribute
hide-content-text
Default value
false

hideLastEditedInfo

Property
hideLastEditedInfo: boolean

Indicates whether to hide the lastEditInfo.

Attribute
hide-last-edited-info
Default value
false

hideLastEditInfo

deprecatedProperty
hideLastEditInfo: boolean
Deprecatedsince 4.33, use hideLastEditedInfo instead.
Attribute
hide-last-edit-info
Default value
false

hideTitle

Property
hideTitle: boolean

Indicates whether to hide the title associated with the feature.

Attribute
hide-title
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
"polygon"

label

Property
label: string

The widget's default label.

Read more...

Attribute
label

location

Property
location: Point

The location of the graphic to be displayed.

Read more...

Default value
null

map

Property
map: Map

A map is required when the input graphic has a popupTemplate that contains Arcade expressions in ExpressionInfo or ExpressionContent that may use the $map profile variable to access data from layers within a map.

Default value
null

position

Property
position: "bottom-leading" | "bottom-left" | "bottom-right" | "bottom-trailing" | "manual" | "top-leading" | "top-left" | "top-right" | "top-trailing"
Attribute
position
Default value
"bottom-left"

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

spatialReference

Property
spatialReference: SpatialReference

The spatial reference used for Arcade operations.

Default value
null

state

readonlyreflected

Attribute changes are reflected on the DOM.

Property
state: "disabled" | "error" | "loading" | "ready"

The current state of the component.

Attribute
state
Default value
"disabled"

timeZone

Property
timeZone: string

Dates and times displayed in the widget will be displayed in this time zone.

Read more...

Attribute
time-zone

Slots

No slots to display.

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

Events triggered on this element will be propagated to their outermost elements.

composed

The event is composable and will propagate across the shadow DOM into the standard DOM.

cancelable

The event's default behavior can be canceled, allowing for custom behavior to be implemented instead.

arcgisReady

Event
arcgisReady: CustomEvent<void>

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

bubbles

Events triggered on this element will be propagated to their outermost elements.

composed

The event is composable and will propagate across the shadow DOM into the standard DOM.

cancelable

The event's default behavior can be canceled, allowing for custom behavior to be implemented instead.

Methods

MethodSignature
componentOnReady(): Promise<void>
destroy(): Promise<void>
nextMedia(contentElementIndex: number): Promise<void>
previousMedia(contentElementIndex: number): Promise<void>
setActiveMedia(contentElementIndex: number, mediaInfoIndex: number): 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 arcgisFeature = document.querySelector("arcgis-feature");
document.body.append(arcgisFeature);
await arcgisFeature.componentOnReady();
console.log("arcgis-feature is ready to go!");
Returns
Promise<void>

destroy

Method
destroy(): Promise<void>

Permanently destroy the component.

Returns
Promise<void>

nextMedia

Method
nextMedia(contentElementIndex: number): Promise<void>

Paginates to the next media info.

Parameters
ParameterTypeOptional?
contentElementIndex
number
Returns
Promise<void>

previousMedia

Method
previousMedia(contentElementIndex: number): Promise<void>

Paginates to the previous media info.

Parameters
ParameterTypeOptional?
contentElementIndex
number
Returns
Promise<void>

setActiveMedia

Method
setActiveMedia(contentElementIndex: number, mediaInfoIndex: number): Promise<void>

Paginates to a specified media info object. For example, you may have media content which contains multiple mediaInfos. This method allows you to specify the index of the mediaInfos you wish to display.

Parameters
ParameterTypeOptional?
contentElementIndex
number
mediaInfoIndex
number
Returns
Promise<void>

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