import "@arcgis/map-components/components/arcgis-table-list";The Table List component provides a way to display a list of tables associated with a Map.
Demo
Properties
| Property | Attribute | Type |
|---|---|---|
autoDestroyDisabled | auto-destroy-disabled | boolean |
closed | closed | boolean |
collapsedreflected | collapsed | boolean |
dragEnabled | drag-enabled | boolean |
filterPlaceholder | filter-placeholder | string |
filterPredicate | | (((item: TableListListItem) => void)) |
filterText | filter-text | string |
hideFlow | hide-flow | boolean |
hideStatusIndicators | hide-status-indicators | boolean |
icon | icon | string |
label | label | string |
listItemCreatedFunction | | (((event: TableListListItemCreatedHandlerEvent) => void)) |
map | | Map | WebMap |
minDragEnabledItems | min-drag-enabled-items | number |
minFilterItems | min-filter-items | number |
positiondeprecated | position | "bottom-leading" | "bottom-left" | "bottom-right" | "bottom-trailing" | "manual" | "top-leading" | "top-left" | "top-right" | "top-trailing" |
referenceElement | reference-element | HTMLArcgisLinkChartElement | HTMLArcgisMapElement | HTMLArcgisSceneElement | string |
selectedItems | | Collection<TableListListItem> |
selectionMode | selection-mode | "multiple" | "none" | "single" | "single-persist" |
showCloseButton | show-close-button | boolean |
showCollapseButton | show-collapse-button | boolean |
showErrors | show-errors | boolean |
showFilter | show-filter | boolean |
showHeading | show-heading | boolean |
showTemporaryTableIndicators | show-temporary-table-indicators | boolean |
statereadonlyreflected | state | "disabled" | "loading" | "ready" |
tableItemsreadonly | | Collection<TableListListItem> |
view | | LinkChartView | MapView | SceneView |
autoDestroyDisabled
autoDestroyDisabled: booleanIf 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
closed
closed: booleanIndicates whether a component is closed. When true, the component will be hidden.
- Attribute
- closed
- Default value
- false
collapsed
collapsed: booleanIndicates whether the widget is collapsed.
- Attribute
- collapsed
- Default value
- false
dragEnabled
dragEnabled: booleanIndicates whether list items may be reordered within the list by dragging and dropping.
- Attribute
- drag-enabled
- Default value
- false
filterPlaceholder
filterPlaceholder: stringPlaceholder text used in the filter input if visibleElements.filter is true.
- Attribute
- filter-placeholder
- Default value
- ""
filterPredicate
filterPredicate: (((item: TableListListItem) => void))Specifies a function to handle filtering list items.
- Default value
- null
filterText
filterText: stringThe value of the filter input text string if visibleElements.filter is true.
- Attribute
- filter-text
- Default value
- ""
hideStatusIndicators
hideStatusIndicators: boolean- Attribute
- hide-status-indicators
- Default value
- false
icon
icon: stringIcon 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
- "table"
listItemCreatedFunction
listItemCreatedFunction: (((event: TableListListItemCreatedHandlerEvent) => void))Specifies a function that accesses each ListItem.
map
A reference to a map containing the tables.
minDragEnabledItems
minDragEnabledItems: numberThe minimum number of list items required to enable drag and drop reordering with dragEnabled.
- Attribute
- min-drag-enabled-items
- Default value
- 2
minFilterItems
minFilterItems: numberThe minimum number of list items required to display the visibleElements.filter input box.
- Attribute
- min-filter-items
- Default value
- 10
position
position: "bottom-leading" | "bottom-left" | "bottom-right" | "bottom-trailing" | "manual" | "top-leading" | "top-left" | "top-right" | "top-trailing"slot instead.- Attribute
- position
referenceElement
referenceElement: HTMLArcgisLinkChartElement | HTMLArcgisMapElement | HTMLArcgisSceneElement | stringBy 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.
- Attribute
- reference-element
selectedItems
selectedItems: Collection<TableListListItem>A collection of selected ListItems representing table list items selected by the user.
selectionMode
selectionMode: "multiple" | "none" | "single" | "single-persist"Specifies the selection mode.
- Attribute
- selection-mode
- Default value
- "none"
showCollapseButton
showCollapseButton: boolean- Attribute
- show-collapse-button
- Default value
- false
showTemporaryTableIndicators
showTemporaryTableIndicators: boolean- Attribute
- show-temporary-table-indicators
- Default value
- false
state
state: "disabled" | "loading" | "ready"The current state of the component.
- Attribute
- state
- Default value
- "disabled"
tableItems
tableItems: Collection<TableListListItem>The collection of table ListItems displayed within the component.
view
view: LinkChartView | MapView | SceneViewThe 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
viewproperty which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the Table List component will be associated with a map or scene component rather than using theviewproperty.
Methods
| Method | Signature |
|---|---|
componentOnReady | componentOnReady(): Promise<void> |
destroy | destroy(): Promise<void> |
componentOnReady
componentOnReady(): Promise<void>Create a promise that resolves once component is fully loaded.
Example
const arcgisTableList = document.querySelector("arcgis-table-list");
document.body.append(arcgisTableList);
await arcgisTableList.componentOnReady();
console.log("arcgis-table-list is ready to go!");- Returns
- Promise<void>
Events
| Event | Type |
|---|---|
arcgisClose | CustomEvent<void> |
arcgisPropertyChange | CustomEvent<{ name: "state"; }> |
arcgisReady | CustomEvent<void> |
arcgisTriggerAction | CustomEvent<TableListTriggerActionEvent> |
arcgisClose
arcgisClose: CustomEvent<void>Emitted when the component's close button is clicked.
arcgisPropertyChange
arcgisPropertyChange: CustomEvent<{ name: "state"; }>Emitted when the value of a property is changed. Use this to listen to changes to properties.
arcgisReady
arcgisReady: CustomEvent<void>Emitted when the component associated with a map or scene view is ready to be interacted with.
arcgisTriggerAction
arcgisTriggerAction: CustomEvent<TableListTriggerActionEvent>Emitted when an action is triggered on the component.