@arcgis/map-components 5.1.0-next.124 → 5.1.0-next.125

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -21,7 +21,10 @@ import type { ListItemModifier, State } from "@arcgis/core/widgets/LayerList/typ
21
21
  import type { List as List } from "@esri/calcite-components/components/calcite-list";
22
22
 
23
23
  /**
24
- * The Layer List provides a way to display a list of layers and switch on/off their visibility.
24
+ * > [!WARNING]
25
+ * > The Layer List (next) component is the successor to the Layer List component, provided to you early for testing and feedback. In version 6.0, the implementation of [arcgis-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list/) will be updated under the hood to that of [arcgis-layer-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/), and this component will be removed. There is a breaking change in how events for [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#catalogLayerList) and [tableList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#tableList) are handled compared to Layer List. To update at version 6.0, simply remove `-next` from the component name.
26
+ *
27
+ * The Layer List (next) provides a way to display a list of layers and switch on/off their visibility.
25
28
  * The [listItemCreatedFunction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#listItemCreatedFunction) and the [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) API provides access to each layer's properties, allows
26
29
  * the developer to configure actions related to the layer, and allows the developer to add content to the item related to the layer.
27
30
  *
@@ -36,7 +39,8 @@ import type { List as List } from "@esri/calcite-components/components/calcite-l
36
39
  * >
37
40
  * > - The Layer List supports keyboard navigation using the [Treegrid Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/treegrid/) for improved accessibility. Refer to the Calcite List component documentation for detailed keyboard interaction guidelines: [Calcite List Keyboard Navigation](https://developers.arcgis.com/calcite-design-system/components/list/#keyboard-navigation).
38
41
  *
39
- * @since 4.28
42
+ * @since 5.1
43
+ * @beta
40
44
  */
41
45
  export abstract class ArcgisLayerListNext extends LitElement {
42
46
  /**
@@ -49,45 +53,166 @@ export abstract class ArcgisLayerListNext extends LitElement {
49
53
  * @default false
50
54
  */
51
55
  accessor autoDestroyDisabled: boolean;
52
- /** The CatalogLayerList that displays a catalog layer's dynamic group layer. */
56
+ /**
57
+ * The CatalogLayerList that displays a catalog layer's [dynamic group layer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/#dynamicGroupLayer).
58
+ * The catalog layer list will be displayed as an expandable ListItem in the root of the layer list when a CatalogLayer is present in the map.
59
+ * This property is set when a catalog layer's dynamic group layer is expanded in the LayerList. Otherwise, it is `null`.
60
+ * This property is useful for listening to the [arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/#event-arcgisTriggerAction) event and managing selections in catalog layers.
61
+ *
62
+ * ![CatalogLayerList](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/catalog-layer-list.avif)
63
+ *
64
+ * @example
65
+ * ```js
66
+ * // Use reactiveUtils to respond to the layerListElement.catalogLayerList "arcgisTriggerAction" event
67
+ * const catalogLayerListActionHandle = reactiveUtils.on(
68
+ * () => layerListElement.catalogLayerList,
69
+ * "arcgisTriggerAction",
70
+ * async (event) => {
71
+ * const { action, item } = event.detail;
72
+ * if (action.id === "add-layer") {
73
+ * try {
74
+ * const parentCatalogLayer = getCatalogLayerForLayer(item.layer);
75
+ * if (!parentCatalogLayer) {
76
+ * return;
77
+ * }
78
+ * await addLayerFromDynamicGroup(item.layer);
79
+ * alert(`Added ${item.layer.title} to the map`);
80
+ * } catch (error) {
81
+ * console.error("Failed to add layer from dynamic group", error);
82
+ * alert(`Unable to add ${item.layer.title} to the map`);
83
+ * }
84
+ * layerListElement?.openedLayers?.pop();
85
+ * }
86
+ * },
87
+ * );
88
+ * layerListHandles.push(catalogLayerListActionHandle);
89
+ *
90
+ * // Use reactiveUtils to watch for a selected item in the layerListElement.catalogLayerList
91
+ * const catalogSelectionWatchHandle = reactiveUtils.watch(
92
+ * () =>
93
+ * layerListElement.catalogLayerList?.selectedItems?.at(0)?.layer as Layer,
94
+ * (layer) => {
95
+ * layer && handleLayerSelection(layer);
96
+ * },
97
+ * );
98
+ * layerListHandles.push(catalogSelectionWatchHandle);
99
+ * ```
100
+ */
53
101
  get catalogLayerList(): ArcgisCatalogLayerList | undefined;
102
+ /**
103
+ * [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/) specific properties.
104
+ * Catalog layers will display their [CatalogLayer#dynamicGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/#dynamicGroupLayer) as an expandable [arcgis-catalog-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/) in the Layer List component.
105
+ * This list item will only be displayed when catalog layers with dynamic group layers are loaded in the map.
106
+ * These are the properties that are used to configure the [arcgis-catalog-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/).
107
+ *
108
+ * @see [arcgis-catalog-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/) for more details on the catalog layer list and its properties.
109
+ * @example
110
+ * ```js
111
+ * layerListElement.catalogOptions = {
112
+ * listItemCreatedFunction: (event) => {
113
+ * const { item } = event;
114
+ * item.actionsSections = [
115
+ * [
116
+ * {
117
+ * title: "Add layer to map",
118
+ * icon: "add-layer",
119
+ * id: "add-layer"
120
+ * }
121
+ * ]
122
+ * ];
123
+ * },
124
+ * selectionMode: "single"
125
+ * };
126
+ * ```
127
+ */
54
128
  accessor catalogOptions: CatalogLayerListParams | undefined;
55
129
  /**
56
130
  * Indicates whether a component is closed. When `true`, the component will be hidden.
57
131
  *
58
132
  * @default false
59
- * @since 4.33
60
133
  */
61
134
  accessor closed: boolean;
62
135
  /**
63
- * A collection of selected [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/)s representing operational layers
64
- * selected by the user.
136
+ * Indicates whether the component is collapsed.
137
+ * When collapsed, only the collapse button and heading are displayed.
65
138
  *
66
139
  * @default false
67
- * @see [selectionMode](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/#selectionMode)
140
+ * @see [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showCollapseButton)
141
+ * @example
142
+ * ```js
143
+ * layerListElement.collapsed = true;
144
+ * ```
68
145
  */
69
146
  accessor collapsed: boolean;
70
- /** @default false */
147
+ /**
148
+ * Indicates whether [list items](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) may be reordered within the list by dragging and dropping.
149
+ * MapImageLayer [MapImageLayer#sublayers](https://developers.arcgis.com/javascript/latest/references/core/layers/MapImageLayer/#sublayers) can be reordered only within their parent MapImageLayer and can not be dragged out as a separate layer.
150
+ * Drag won't be enabled until the number of list items is equal to or greater than than the value set set in [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#minDragEnabledItems).
151
+ *
152
+ * @default false
153
+ * @see [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#minDragEnabledItems)
154
+ * @example
155
+ * ```js
156
+ * layerListElement.dragEnabled = true;
157
+ * ```
158
+ */
71
159
  accessor dragEnabled: boolean;
72
- /** @default "" */
160
+ /**
161
+ * Placeholder text used in the filter input if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter) is true.
162
+ *
163
+ * @default ""
164
+ * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter)
165
+ * @example
166
+ * ```js
167
+ * layerListElement.filterPlaceholder = "Filter layers";
168
+ * ```
169
+ */
73
170
  accessor filterPlaceholder: string;
171
+ /**
172
+ * Specifies a function to handle filtering [list items](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/).
173
+ *
174
+ * @example
175
+ * ```js
176
+ * layerListElement.filterPredicate = (item) => item.title.toLowerCase().includes("streets");
177
+ * ```
178
+ */
74
179
  accessor filterPredicate: ((item: ListItem | TableListListItem) => boolean) | undefined;
75
- /** @default "" */
180
+ /**
181
+ * The value of the filter input if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter) is true.
182
+ *
183
+ * @default ""
184
+ * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter)
185
+ * @example
186
+ * ```js
187
+ * reactiveUtils.watch(
188
+ * () => layerListElement.filterText,
189
+ * (filterText) => console.log(filterText)
190
+ * );
191
+ * ```
192
+ */
76
193
  accessor filterText: string;
77
194
  /**
78
- * Indicates the heading level to use for the heading of the widget.
195
+ * Indicates the heading level to use for the heading of the component.
196
+ * By default, the heading is rendered as a level 2 heading (e.g., `<h2>Layer List</h2>`).
197
+ * Depending on the component's placement in your app, you may need to adjust this heading for proper semantics.
198
+ * This is important for meeting accessibility standards.
79
199
  *
80
200
  * @default 2
201
+ * @see [showHeading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showHeading)
202
+ * @example
203
+ * ```js
204
+ * layerListElement.headingLevel = 3;
205
+ * ```
81
206
  */
82
207
  accessor headingLevel: HeadingLevel;
83
208
  /**
84
- * This property provides the ability to turn individual elements of the component's display on/off.
209
+ * This property provides the ability to show or hide the catalog layer list.
85
210
  *
86
211
  * @default false
87
212
  */
88
213
  accessor hideCatalogLayerList: boolean;
89
214
  /**
90
- * This property provides the ability to turn individual elements of the component's display on/off.
215
+ * This property provides the ability to show or hide status indicators.
91
216
  *
92
217
  * @default false
93
218
  */
@@ -100,14 +225,107 @@ export abstract class ArcgisLayerListNext extends LitElement {
100
225
  * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
101
226
  */
102
227
  accessor icon: IconName;
228
+ /**
229
+ * [KnowledgeGraphLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/KnowledgeGraphLayer/) specific properties.
230
+ * [KnowledgeGraphLayer#tables](https://developers.arcgis.com/javascript/latest/references/core/layers/KnowledgeGraphLayer/#tables)
231
+ * as an expandable [arcgis-table-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/) in the Layer List component and can be accessed with the [tableList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#tableList) property.
232
+ * This tables list item will only be displayed when knowledge graph layers with tables are loaded in the map.
233
+ * These are the properties that are used to configure the [arcgis-table-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/).
234
+ *
235
+ * @see [arcgis-table-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/) for more details on the table list and its properties.
236
+ * @example
237
+ * ```js
238
+ * layerListElement.knowledgeGraphOptions = {
239
+ * filterPlaceholder: "Filter tables",
240
+ * listItemCreatedFunction: (event) => {
241
+ * const { item } = event;
242
+ * item.actionsSections = [
243
+ * [
244
+ * {
245
+ * icon: "table",
246
+ * id: "open-table",
247
+ * title: "Show table"
248
+ * },
249
+ * {
250
+ * icon: "information",
251
+ * id: "information",
252
+ * title: "Show information"
253
+ * }
254
+ * ]
255
+ * ];
256
+ * },
257
+ * minFilterItems: 1
258
+ * }
259
+ * ```
260
+ */
103
261
  accessor knowledgeGraphOptions: TableListParams | undefined;
104
262
  /** The component's default label. */
105
263
  accessor label: string | undefined;
264
+ /** @internal */
106
265
  accessor layerTablesAvailable: Collection<TableSupportedLayers>;
266
+ /** @internal */
107
267
  accessor listItemCanGiveFunction: CanSortFunction | undefined;
268
+ /** @internal */
108
269
  accessor listItemCanReceiveFunction: CanSortFunction | undefined;
270
+ /**
271
+ * A function that executes each time a [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) is created.
272
+ * Use this function to add actions and panels to list items, and to override
273
+ * the default settings of a list item. Actions can be added to list items
274
+ * using the [ListItem#actionsSections](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/#actionsSections)
275
+ * property.
276
+ *
277
+ * @see [Sample - LayerList component with actions](https://developers.arcgis.com/javascript/latest/sample-code/layer-list-actions/)
278
+ * @example
279
+ * ```js
280
+ * layerListElement.listItemCreatedFunction = async function (event) {
281
+ * // The event object contains an item property.
282
+ * // It is a ListItem referencing the associated layer
283
+ * // and other properties. You can control the visibility of the
284
+ * // item, its title, and actions using this object.
285
+ * const item = event.item;
286
+ *
287
+ * await item.layer.when();
288
+ *
289
+ * if (item.title === "US Demographics") {
290
+ * // An array of objects defining actions to place in the LayerList.
291
+ * // By making this array two-dimensional, you can separate similar
292
+ * // actions into separate groups with a breaking line.
293
+ * item.actionsSections = [
294
+ * [
295
+ * {
296
+ * title: "Go to full extent",
297
+ * icon: "zoom-out-fixed",
298
+ * id: "full-extent",
299
+ * },
300
+ * {
301
+ * title: "Layer information",
302
+ * icon: "information",
303
+ * id: "information",
304
+ * },
305
+ * ],
306
+ * [
307
+ * {
308
+ * title: "Increase opacity",
309
+ * icon: "chevron-up",
310
+ * id: "increase-opacity",
311
+ * },
312
+ * {
313
+ * title: "Decrease opacity",
314
+ * icon: "chevron-down",
315
+ * id: "decrease-opacity",
316
+ * },
317
+ * ],
318
+ * ];
319
+ * }
320
+ * }
321
+ * ```
322
+ */
109
323
  accessor listItemCreatedFunction: ListItemModifier | null | undefined;
110
- /** Overwrite localized strings for this component */
324
+ /**
325
+ * Overwrite localized strings for this component
326
+ *
327
+ * @internal
328
+ */
111
329
  accessor messageOverrides: {
112
330
  componentLabel?: string | undefined;
113
331
  back?: string | undefined;
@@ -189,12 +407,47 @@ export abstract class ArcgisLayerListNext extends LitElement {
189
407
  disconnected: string;
190
408
  paused: string;
191
409
  }>;
192
- /** @default 2 */
410
+ /**
411
+ * The minimum number of list items required to enable drag and drop reordering with [dragEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#dragEnabled).
412
+ *
413
+ * @default 2
414
+ * @see [dragEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#dragEnabled)
415
+ * @example
416
+ * ```js
417
+ * layerListElement.dragEnabled = true;
418
+ * layerListElement.minDragEnabledItems = 5;
419
+ * ```
420
+ */
193
421
  accessor minDragEnabledItems: number;
194
- /** @default 10 */
422
+ /**
423
+ * The minimum number of list items required to display the [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter) input box.
424
+ *
425
+ * @default 10
426
+ * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter)
427
+ * @example
428
+ * ```js
429
+ * layerListElement.showFilter = true;
430
+ * layerListElement.minFilterItems = 5;
431
+ * ```
432
+ */
195
433
  accessor minFilterItems: number;
196
- /** @default [] */
434
+ /**
435
+ * A collection of [Layer](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/)s that are opened
436
+ * in a [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#catalogLayerList) or [tableList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#tableList) flow item.
437
+ * This property is useful for backing out of the catalog layer list or table list
438
+ * programmatically to the parent layer list.
439
+ *
440
+ * @default []
441
+ * @see [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#catalogLayerList)
442
+ * @see [tableList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#tableList)
443
+ * @example
444
+ * ```js
445
+ * // back out of the catalog layer list to the main layer list
446
+ * layerListElement.openedLayers.pop();
447
+ * ```
448
+ */
197
449
  get openedLayers(): Collection<FlowLayer>;
450
+ /** A collection of [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/)s representing the operational layers in the layer list. */
198
451
  get operationalItems(): Collection<ListItem>;
199
452
  /**
200
453
  * 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.
@@ -202,10 +455,16 @@ export abstract class ArcgisLayerListNext extends LitElement {
202
455
  * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
203
456
  */
204
457
  accessor referenceElement: ArcgisReferenceElement | string | undefined;
458
+ /**
459
+ * A collection of selected [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/)s representing operational layers
460
+ * selected by the user in the layer list.
461
+ *
462
+ * @see [selectionMode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#selectionMode)
463
+ */
205
464
  accessor selectedItems: Collection<ListItem>;
206
465
  /**
207
466
  * Specifies the selection mode.
208
- * Selected items are available in the [selectedItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/#selectedItems) property.
467
+ * Selected items are available in the [selectedItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#selectedItems) property.
209
468
  *
210
469
  * | Value | Description |
211
470
  * | ----- | ----------- |
@@ -215,8 +474,7 @@ export abstract class ArcgisLayerListNext extends LitElement {
215
474
  * | single-persist | Allows only one item to be selected at a time and prevents de-selection. Once an item is selected, it remains selected until another item is selected. This is useful when you want to ensure that there is always exactly one selected item. |
216
475
  *
217
476
  * @default "none"
218
- * @since 4.29
219
- * @see [selectedItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/#selectedItems)
477
+ * @see [selectedItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#selectedItems)
220
478
  * @example
221
479
  * ```js
222
480
  * layerListElement.selectionMode = "multiple";
@@ -224,37 +482,37 @@ export abstract class ArcgisLayerListNext extends LitElement {
224
482
  */
225
483
  accessor selectionMode: List["selectionMode"];
226
484
  /**
227
- * This property provides the ability to turn individual elements of the component's display on/off.
485
+ * This property provides the ability to show or hide the close button.
228
486
  *
229
487
  * @default false
230
488
  */
231
489
  accessor showCloseButton: boolean;
232
490
  /**
233
- * This property provides the ability to turn individual elements of the component's display on/off.
491
+ * This property provides the ability to show or hide the collapse button.
234
492
  *
235
493
  * @default false
236
494
  */
237
495
  accessor showCollapseButton: boolean;
238
496
  /**
239
- * This property provides the ability to turn individual elements of the component's display on/off.
497
+ * This property provides the ability to show or hide error indicators.
240
498
  *
241
499
  * @default false
242
500
  */
243
501
  accessor showErrors: boolean;
244
502
  /**
245
- * This property provides the ability to turn individual elements of the component's display on/off.
503
+ * This property provides the ability to show or hide the filter input.
246
504
  *
247
505
  * @default false
248
506
  */
249
507
  accessor showFilter: boolean;
250
508
  /**
251
- * This property provides the ability to turn individual elements of the component's display on/off.
509
+ * This property provides the ability to show or hide the heading.
252
510
  *
253
511
  * @default false
254
512
  */
255
513
  accessor showHeading: boolean;
256
514
  /**
257
- * This property provides the ability to turn individual elements of the component's display on/off.
515
+ * This property provides the ability to show or hide temporary layer indicators.
258
516
  *
259
517
  * @default false
260
518
  */
@@ -265,6 +523,40 @@ export abstract class ArcgisLayerListNext extends LitElement {
265
523
  * @default "disabled"
266
524
  */
267
525
  get state(): State;
526
+ /**
527
+ * The [arcgis-table-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/) component instance that displays the tables associated with a [KnowledgeGraphLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/KnowledgeGraphLayer/).
528
+ * The table list will be displayed as an expandable list item.
529
+ * This property is set when a knowledge graph layer's tables list item is expanded in the LayerList.
530
+ * Otherwise, it is `null`.
531
+ * This list item will only be displayed when knowledge graph layers with tables are loaded in the map and will be displayed as a child of the knowledge graph layer.
532
+ * This property is useful for listening to the [arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/#event-arcgisTriggerAction) event and managing selections in knowledge graph tables.
533
+ *
534
+ * ![tableList](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/layer-list-tableList.avif)
535
+ *
536
+ * @see [knowledgeGraphOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#knowledgeGraphOptions) for configuring the table list and its items.
537
+ * @example
538
+ * // Use reactiveUtils to respond to the layerListElement.tableList "arcgisTriggerAction" event
539
+ * const tableListActionHandle = reactiveUtils.on(
540
+ * () => layerListElement.tableList,
541
+ * "arcgisTriggerAction",
542
+ * (event: any) => {
543
+ * const { action, item } = event.detail;
544
+ * if (action.id === "information") {
545
+ * alert(`${item.layer?.title}`);
546
+ * }
547
+ * },
548
+ * );
549
+ * layerListHandles.push(tableListActionHandle);
550
+ *
551
+ * // Use reactiveUtils to watch for a selected item in the layerListElement.tableList
552
+ * const tableSelectionWatchHandle = reactiveUtils.watch(
553
+ * () => layerListElement.tableList?.selectedItems?.at(0)?.layer,
554
+ * (layer) => {
555
+ * layer && handleLayerSelection(layer);
556
+ * },
557
+ * );
558
+ * layerListHandles.push(tableSelectionWatchHandle);
559
+ */
268
560
  get tableList(): ArcgisTableList | undefined;
269
561
  /**
270
562
  * The view associated with the component.
@@ -280,7 +572,6 @@ export abstract class ArcgisLayerListNext extends LitElement {
280
572
  * | checkbox | Displays checkbox icons on the near side. See [check-square-f](https://developers.arcgis.com/calcite-design-system/icons/?icon=check-square-f&library=Calcite%20UI&query=check) and [square](https://developers.arcgis.com/calcite-design-system/icons/?icon=square&library=Calcite%20UI&query=square) calcite icons. | ![visibilityAppearance-checkbox](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/layer-list/visibilityAppearance-checkbox.avif) |
281
573
  *
282
574
  * @default "default"
283
- * @since 4.29
284
575
  * @example
285
576
  * ```js
286
577
  * layerListElement.visibilityAppearance = "checkbox";
@@ -289,11 +580,7 @@ export abstract class ArcgisLayerListNext extends LitElement {
289
580
  accessor visibilityAppearance: VisibilityAppearance;
290
581
  /** Permanently destroy the component. */
291
582
  destroy(): Promise<void>;
292
- /**
293
- * Emitted when the component's close button is clicked.
294
- *
295
- * @since 4.33
296
- */
583
+ /** Emitted when the component's close button is clicked. */
297
584
  readonly arcgisClose: import("@arcgis/lumina").TargetedEvent<this, void>;
298
585
  /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
299
586
  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
@@ -27,7 +27,11 @@ class ie extends Z {
27
27
  const o = r === "pull" ? this.listItemCanGiveFunction : this.listItemCanReceiveFunction, a = p(e, this.operationalItems);
28
28
  if (!a?.sortable)
29
29
  return !1;
30
- const s = p(t, this.operationalItems), n = C(t), l = p(i, this.operationalItems), h = C(i), _ = !!n && !!h && n === h, u = { selected: a, from: s, to: l }, v = t.group, m = i.group, b = s?.layer?.type ?? "", c = l?.layer?.type ?? "", k = /* @__PURE__ */ new Set(["map-image", "catalog", "knowledge-graph"]);
30
+ const s = p(t, this.operationalItems), n = C(t), l = p(i, this.operationalItems), h = C(i), _ = !!n && !!h && n === h, u = {
31
+ selected: a,
32
+ from: s,
33
+ to: l
34
+ }, v = t.group, m = i.group, b = s?.layer?.type ?? "", c = l?.layer?.type ?? "", k = /* @__PURE__ */ new Set(["map-image", "catalog", "knowledge-graph"]);
31
35
  return v && m && typeof o == "function" ? o(u) : _ && !k.has(b) && !k.has(c) && a?.layer?.type !== "sublayer";
32
36
  }, this._onCatalogOpen = (e) => {
33
37
  this.openedLayers.push(e.layer?.parent);
@@ -9,7 +9,7 @@ import type SceneView from "@arcgis/core/views/SceneView.js";
9
9
  import type MapView from "@arcgis/core/views/MapView.js";
10
10
  import type SubtypeSublayer from "@arcgis/core/layers/support/SubtypeSublayer.js";
11
11
  import type BatchAttributeFormViewModel from "@arcgis/core/widgets/BatchAttributeForm/BatchAttributeFormViewModel.js";
12
- import type TemplateItem from "../arcgis-feature-templates/TemplateItem.js";
12
+ import type TemplateListItem from "@arcgis/core/editing/templates/TemplateListItem.js";
13
13
  import type { EsriClipboard, ClipboardItem as EsriClipboardItem } from "@arcgis/core/applications/Components/clipboard.js";
14
14
  import type { ApplySet, ApplySetLayerEditResult, ApplySetServiceEditResult } from "@arcgis/core/applications/Components/applySetUtils.js";
15
15
  import type { ClipboardMove } from "./ClipboardMove.js";
@@ -127,7 +127,7 @@ export default class PasteViewModel extends Accessor {
127
127
  disabled: boolean;
128
128
  available: boolean;
129
129
  }[];
130
- accessor pasteTemplate: TemplateItem | undefined;
130
+ accessor pasteTemplate: TemplateListItem | undefined;
131
131
  get pasteTemplateIsValid(): boolean;
132
132
  /** @default true */
133
133
  accessor pasteWithAttributes: boolean;
@@ -112,7 +112,7 @@ const h = /* @__PURE__ */ new Set([
112
112
  sv: "se",
113
113
  th: "th",
114
114
  zh: "cn"
115
- }, P = L`:host{display:block;width:310px;max-width:100%}.slider{height:50px}.scale-indicator-container{position:relative;width:100%;margin-top:5px}.scale-indicator-icon{transform:scale(.8,1.7);margin-left:-6px;width:1px}.scale-menu-list{max-height:220px;overflow-y:auto}.scale-menu-input{max-width:120px}.scale-menu-button-container{display:flex;direction:ltr;justify-content:space-between}.scale-menu-button{min-width:0}:dir(rtl) .scale-menu-button-container>*{direction:rtl}.preview-container{padding:6px;background-color:var(--calcite-color-foreground-1);box-shadow:0 1px 2px #0000004d}`, l = [
115
+ }, P = L`:host{display:block;width:310px;max-width:100%}.slider{height:50px}.scale-indicator-container{position:relative;width:100%;margin-top:2px}.scale-indicator-icon{transform:scale(.8,1.7);margin-left:-6px;width:1px;--calcite-icon-color: var(--calcite-color-text-3)}.scale-menu-list{max-height:220px;overflow-y:auto}.scale-menu-input{max-width:120px}.scale-menu-button-container{display:flex;direction:ltr;justify-content:space-between}.scale-menu-button{min-width:0}:dir(rtl) .scale-menu-button-container>*{direction:rtl}.preview-container{padding:6px;background-color:var(--calcite-color-foreground-1);box-shadow:0 1px 2px #0000004d}`, l = [
116
116
  { id: "world", scale: 147914382, minScale: 147914382, maxScale: 1e8 },
117
117
  { id: "continent", scale: 5e7, minScale: 99999999, maxScale: 35e6 },
118
118
  { id: "countriesBig", scale: 25e6, minScale: 34999999, maxScale: 15e6 },
@@ -1,5 +1,5 @@
1
1
  /// <reference path="../../index.d.ts" />
2
- import type TemplateItem from "../arcgis-feature-templates/TemplateItem.js";
2
+ import type TemplateListItem from "@arcgis/core/editing/templates/TemplateListItem.js";
3
3
  import type { PublicLitElement as LitElement } from "@arcgis/lumina";
4
4
 
5
5
  /**
@@ -10,5 +10,5 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
10
10
  * @internal
11
11
  */
12
12
  export abstract class ArcgisTemplateImage extends LitElement {
13
- accessor template: TemplateItem | undefined;
13
+ accessor template: TemplateListItem | undefined;
14
14
  }