@arcgis/map-components
Version:
ArcGIS Map Components
1 lines • 2.24 MB
JSON
{"deprecation":"docs.json is deprecated and will be removed in a future release. Use api.json instead","timestamp":"2026-07-09T17:16:28","compiler":{"name":"@arcgis/lumina-compiler","version":"5.1.12","typescriptVersion":"6.0.2"},"components":[{"filePath":"src/components/area-measurement-2d/area-measurement-2d.tsx","tag":"arcgis-area-measurement-2d","overview":"","readme":"","usage":{},"docs":"The Area Measurement 2D component can be added to an [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/)\ncomponent to calculate and display the area and perimeter of a polygon.\n\nHow areas and perimeters are computed depends on the map's spatial reference.\n\nIn **geographic coordinate systems** (GCS), and in **Web Mercator**, areas and perimeters are computed geodetically, taking into consideration the curvature of the planet.\n\nIn **projected coordinate systems** (PCS), apart from Web Mercator, areas and perimeters are computed in a Euclidean manner (in their respective PCS).","docsTags":[{"name":"since","text":"4.28"},{"name":"superclass","text":"{\"name\":\"HTMLElement\",\"package\":\"global:\",\"viewUrl\":\"https://developer.mozilla.org/docs/Web/API/HTMLElement\"}"}],"encapsulation":"shadow","dependents":[],"dependencies":[],"dependencyGraph":{},"props":[{"name":"analysis","type":"AreaMeasurementAnalysis","complexType":{"original":"AreaMeasurementAnalysis","resolved":"AreaMeasurementAnalysis","references":{"default":{"location":"import","path":"@arcgis/core/analysis/AreaMeasurementAnalysis.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"The [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/AreaMeasurementAnalysis/)\ncreated or modified by the component.\n\nWhen connecting the Area Measurement 2D component to the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/)\ncomponent, it automatically creates an empty analysis and adds it to the Map's\n[arcgis-map.analyses](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#analyses) collection.\nYou can then wait for the [AreaMeasurementAnalysisView2D](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/AreaMeasurementAnalysisView2D/)\nto be created before accessing the analysis results.\n\n```js\n// Get the Map component and the Area Measurement 2D component, and wait until both are ready.\nconst viewElement = document.querySelector(\"arcgis-map\");\nawait viewElement.viewOnReady();\nconst areaMeasurement2dElement = document.querySelector(\"arcgis-area-measurement-2d\");\nawait areaMeasurement2dElement.componentOnReady();\n\n// Get the AreaMeasurementAnalysis created by the Area Measurement 2D component.\nconst analysis = areaMeasurement2dElement.analysis;\n\n// Get the AreaMeasurementAnalysisView2D and watch for results.\nconst analysisView = await viewElement.whenAnalysisView(analysis);\nconst handle = reactiveUtils.watch(\n () => analysisView?.result,\n () => {\n console.log(\"Analysis results:\", analysisView.result);\n },\n);\n```\nWhenever the component is destroyed, the analysis is automatically removed from the collection.\n\nAlternatively, a programmatically created [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/AreaMeasurementAnalysis/)\ncan be provided to the component.\nThen, the application itself needs to add it to and later remove it from the analyses collection of the Map component.\n\n```js\n// Create the AreaMeasurementAnalysis.\nconst areaMeasurementAnalysis = new AreaMeasurementAnalysis({\n geometry: new Polygon({\n rings: [\n [\n [-80.208889, 25.775278], // Maimi, Florida\n [-64.782, 32.293],      // Hamilton, Bermuda\n [-66.063889, 18.406389], // San Juan, Puerto Rico\n [-80.208889, 25.775278], // Maimi, Florida\n ],\n ],\n }),\n});\n\n// Get the Map component and the Area Measurement 2D component, and wait until both are ready.\nconst viewElement = document.querySelector(\"arcgis-map\");\nawait viewElement.viewOnReady();\nconst areaMeasurement2dElement = document.querySelector(\"arcgis-area-measurement-2d\");\nawait areaMeasurement2dElement.componentOnReady();\n\n// Add the analysis to the analyses collection of the Map component.\nviewElement.analyses.add(areaMeasurementAnalysis);\n\n// Connect the analysis to the measurement component:\nareaMeasurement2dElement.analysis = areaMeasurementAnalysis;\n```","docsTags":[],"values":[],"optional":true,"required":false},{"name":"autoDestroyDisabled","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"auto-destroy-disabled","reflectToAttr":false,"docs":"If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-area-measurement-2d/#destroy) method when you are done to\nprevent memory leaks.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideStartButton","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"hide-start-button","reflectToAttr":false,"docs":"If true, the button that starts a new measurement will be hidden.","docsTags":[{"name":"since","text":"5.0"}],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideUnitSelect","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"hide-unit-select","reflectToAttr":false,"docs":"If true, the unit selection dropdown will be hidden.","docsTags":[{"name":"since","text":"5.0"}],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideVisualization","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"hide-visualization","reflectToAttr":false,"docs":"Indicates whether the component's visualization is hidden in the view.","docsTags":[{"name":"since","text":"5.0"}],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"icon","type":"Icon[\"icon\"] | undefined","complexType":{"original":"Icon[\"icon\"] | undefined","resolved":"Icon[\"icon\"] | undefined","references":{"Icon":{"location":"import","path":"@esri/calcite-components/components/calcite-icon","id":"notImplemented"}}},"mutable":true,"attr":"icon","reflectToAttr":true,"docs":"Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).","docsTags":[{"name":"see","text":"[Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)"}],"default":"\"measure-area\"","values":[{"type":"string"}],"optional":true,"required":false},{"name":"label","type":"string | undefined","complexType":{"original":"string | undefined","resolved":"string | undefined","references":{}},"mutable":true,"attr":"label","reflectToAttr":false,"docs":"The component's default label.","docsTags":[],"values":[{"type":"string"}],"optional":true,"required":false},{"name":"referenceElement","type":"ArcgisReferenceElement | string | undefined","complexType":{"original":"ArcgisReferenceElement | string | undefined","resolved":"ArcgisReferenceElement | string | undefined","references":{"ArcgisReferenceElement":{"location":"local","path":"components/types","id":"notImplemented"}}},"mutable":true,"attr":"reference-element","reflectToAttr":false,"docs":"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.","docsTags":[{"name":"see","text":"[Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)"}],"values":[{"type":"string"},{"type":"object"}],"optional":true,"required":false},{"name":"snappingOptions","type":"SnappingOptions","complexType":{"original":"SnappingOptions","resolved":"SnappingOptions","references":{"default":{"location":"import","path":"@arcgis/core/views/interactive/snapping/SnappingOptions.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"The [SnappingOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/) for measuring.","docsTags":[{"name":"since","text":"4.28"}],"values":[],"optional":true,"required":false},{"name":"state","type":"AreaMeasurement2DState","complexType":{"original":"AreaMeasurement2DState","resolved":"AreaMeasurement2DState","references":{"AreaMeasurement2DState":{"location":"local","path":"components/arcgis-area-measurement-2d/types","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"The component's state. The values mean the following:\n\n* `disabled` - not ready yet\n* `ready` - ready for measuring\n* `measuring` - currently measuring\n* `measured` - measuring has finished","docsTags":[{"name":"readonly","text":""}],"values":[{"type":"string","value":"disabled"},{"type":"string","value":"ready"},{"type":"string","value":"unsupported"},{"type":"string","value":"measured"},{"type":"string","value":"measuring"}],"optional":true,"required":false},{"name":"unit","type":"SystemOrAreaUnit","complexType":{"original":"SystemOrAreaUnit","resolved":"SystemOrAreaUnit","references":{"SystemOrAreaUnit":{"location":"import","path":"@arcgis/core/core/units.js","id":"notImplemented"}}},"mutable":true,"attr":"unit","reflectToAttr":false,"docs":"Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in\n[unitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-area-measurement-2d/#unitOptions).","docsTags":[],"values":[{"type":"string","value":"metric"},{"type":"string","value":"imperial"},{"type":"string","value":"square-inches"},{"type":"string","value":"square-feet"},{"type":"string","value":"square-yards"},{"type":"string","value":"square-miles"},{"type":"string","value":"square-nautical-miles"},{"type":"string","value":"square-us-feet"},{"type":"string","value":"square-millimeters"},{"type":"string","value":"square-centimeters"},{"type":"string","value":"square-decimeters"},{"type":"string","value":"square-meters"},{"type":"string","value":"square-kilometers"},{"type":"string","value":"acres"},{"type":"string","value":"ares"},{"type":"string","value":"hectares"}],"optional":true,"required":false},{"name":"unitOptions","type":"Array<SystemOrAreaUnit>","complexType":{"original":"Array<SystemOrAreaUnit>","resolved":"Array<SystemOrAreaUnit>","references":{"Array":{"location":"global","path":"global:","id":"notImplemented"},"SystemOrAreaUnit":{"location":"import","path":"@arcgis/core/core/units.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.\nBy default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.\nPossible [unit](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-area-measurement-2d/#unit) values can only be a subset of this list.","docsTags":[],"values":[],"optional":true,"required":false},{"name":"view","type":"MapView | undefined","complexType":{"original":"MapView | undefined","resolved":"MapView | undefined","references":{"default":{"location":"import","path":"@arcgis/core/views/MapView.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"The view associated with the component. \n > **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 arcgis-area-measurement-2d component will be associated with a map or scene component rather than using the `view` property.","docsTags":[],"values":[],"optional":true,"required":false}],"methods":[{"name":"clear","returns":{"type":"Promise<void>","docs":""},"complexType":{"signature":"(): Promise<void>","parameters":[],"return":"Promise<void>","references":{"Promise":{"location":"global","path":"global:","id":"notImplemented"}}},"signature":"clear(): Promise<void>","parameters":[],"docs":"Clears the current measurement.","docsTags":[]},{"name":"componentOnReady","returns":{"type":"Promise<this>","docs":""},"complexType":{"signature":"(): Promise<this>","parameters":[],"return":"Promise<this>","references":{"Promise":{"location":"import","path":"typescript/lib/lib.es5.d.ts","id":"notImplemented"}}},"signature":"componentOnReady(): Promise<this>","parameters":[],"docs":"Creates a promise that resolves once the component is fully loaded.","docsTags":[{"name":"example","text":"```js\nconst arcgisAreaMeasurement2d = document.createElement(\"arcgis-area-measurement-2d\");\ndocument.body.append(arcgisAreaMeasurement2d);\nawait arcgisAreaMeasurement2d.componentOnReady();\nconsole.log(\"arcgis-area-measurement-2d is ready to go!\");\n```"},{"name":"inheritedFrom","text":"{\"name\":\"this\"}"}]},{"name":"destroy","returns":{"type":"Promise<void>","docs":""},"complexType":{"signature":"(): Promise<void>","parameters":[],"return":"Promise<void>","references":{"Promise":{"location":"global","path":"global:","id":"notImplemented"}}},"signature":"destroy(): Promise<void>","parameters":[],"docs":"Permanently destroy the component.","docsTags":[]},{"name":"start","returns":{"type":"Promise<void>","docs":""},"complexType":{"signature":"(): Promise<void>","parameters":[],"return":"Promise<void>","references":{"Promise":{"location":"global","path":"global:","id":"notImplemented"}}},"signature":"start(): Promise<void>","parameters":[],"docs":"Starts a new measurement.","docsTags":[]}],"events":[{"event":"arcgisPropertyChange","detail":"{ name: \"analysis\" | \"state\"; }","bubbles":true,"complexType":{"original":"{ name: \"analysis\" | \"state\"; }","resolved":"{ name: \"analysis\" | \"state\"; }","references":{}},"cancelable":true,"composed":true,"docs":"Emitted when the value of a property is changed. Use this to listen to changes to properties.","docsTags":[]},{"event":"arcgisReady","detail":"void","bubbles":true,"complexType":{"original":"void","resolved":"void","references":{}},"cancelable":true,"composed":true,"docs":"Emitted when the component associated with a map or scene view is ready to be interacted with.","docsTags":[]}],"styles":[],"slots":[],"parts":[],"listeners":[]},{"filePath":"src/components/area-measurement-3d/area-measurement-3d.tsx","tag":"arcgis-area-measurement-3d","overview":"","readme":"","usage":{},"docs":"The Area Measurement 3D component can be added to an [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/)\ncomponent to calculate and display area and perimeter of polygons.\n\n[](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n\nHow the area and perimeter are computed depends on the scene's spatial reference and the length of the measured perimeter.\n\nIn **geographic coordinate systems** (GCS) and in **Web Mercator**:\n- If the measurement's perimeter is below 100 km, they are computed in a Euclidean manner,\n in an [ECEF](https://en.wikipedia.org/wiki/ECEF) coordinate system (or equivalent on other planets).\n- If the perimeter is above 100 km, they are computed geodetically, and the visualization takes\n the curvature of the planet into consideration.\n\nIn **projected coordinate systems** (PCS), apart from Web Mercator, the area and perimeter\nare always calculated in a Euclidean manner (in their respective PCS).\n\nThe area may be visualized and calculated in two ways:\n1. If all the vertices are mostly coplanar (lying on the same plane),\n the measurement polygon is formed on that plane, and area and perimeter are calculated from its geometry.\n2. If the vertices don't form a planar surface, the measurement polygon\n is projected to a horizontal plane, and area and perimeter are calculated from its geometry.\n\n\n\nWhen the component is active, a horizontal \"laser\" line is drawn which indicates the height at the current mouse position.\nThis line can help in analyzing the heights of objects relative to each other and the terrain.\n\n**Things to consider**\n\n* Area Measurement 3D is designed to work in the Scene component. For measurements in the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/)\ncomponent, use [arcgis-area-measurement-2d](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-area-measurement-2d/).\n* Snapping is enabled by default. Holding the `CTRL` key disables it.\n* Layer types currently supported for snapping are:\n[FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/),\n[GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) (except Mesh geometries),\n[GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/),\n[WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/),\n[CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),\n[3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/),\nand [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).\n\n**See also**\n\n- [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/AreaMeasurementAnalysis/)\n- [Sample - Measurement in 3D](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)","docsTags":[{"name":"since","text":"4.28"},{"name":"superclass","text":"{\"name\":\"HTMLElement\",\"package\":\"global:\",\"viewUrl\":\"https://developer.mozilla.org/docs/Web/API/HTMLElement\"}"}],"encapsulation":"shadow","dependents":[],"dependencies":[],"dependencyGraph":{},"props":[{"name":"analysis","type":"AreaMeasurementAnalysis","complexType":{"original":"AreaMeasurementAnalysis","resolved":"AreaMeasurementAnalysis","references":{"default":{"location":"import","path":"@arcgis/core/analysis/AreaMeasurementAnalysis.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"The [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/AreaMeasurementAnalysis/)\ncreated or modified by the component.\n\nWhen connecting the Area Measurement 3D component to the [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/)\ncomponent, it automatically creates an empty analysis and adds it to the Scene's\n[arcgis-scene.analyses](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#analyses) collection.\nYou can then wait for the [AreaMeasurementAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/AreaMeasurementAnalysisView3D/)\nto be created before accessing the analysis results.\n\n```js\n// Get the Scene component and the Area Measurement 3D component, and wait until both are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst areaMeasurement3dElement = document.querySelector(\"arcgis-area-measurement-3d\");\nawait areaMeasurement3dElement.componentOnReady();\n\n// Get the AreaMeasurementAnalysis created by the Area Measurement 3D component.\nconst analysis = areaMeasurement3dElement.analysis;\n\n// Get the AreaMeasurementAnalysisView3D and watch for results.\nconst analysisView = await viewElement.whenAnalysisView(analysis);\nconst handle = reactiveUtils.watch(\n () => analysisView?.result,\n () => {\n console.log(\"Analysis results:\", analysisView.result);\n },\n);\n```\nWhenever the component is destroyed, the analysis is automatically removed from the collection.\n\nAlternatively, a programmatically created [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/AreaMeasurementAnalysis/)\ncan be provided to the component.\nThen, the application itself needs to add it to and later remove it from the analyses collection of the Scene component.\n\n```js\n// Create the AreaMeasurementAnalysis.\nconst areaMeasurementAnalysis = new AreaMeasurementAnalysis({\n geometry: new Polygon({\n spatialReference: { latestWkid: 3857, wkid: 102100 },\n rings: [\n [\n [-13624861.22274897, 4550346.5519295, 63.378210234455764],\n [-13624935.305160372, 4550273.144585712, 63.37829629518092],\n [-13624995.61798748, 4550334.030096778, 63.37819860037416],\n [-13624921.53589075, 4550407.42357004, 63.3783810287714],\n [-13624861.22274897, 4550346.5519295, 63.378210234455764]\n ]\n ]\n })\n});\n// Get the Scene component and the Area Measurement 3D component, and wait until both are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst areaMeasurement3dElement = document.querySelector(\"arcgis-area-measurement-3d\");\nawait areaMeasurement3dElement.componentOnReady();\n\n// Add the analysis to the analyses collection of the Scene component.\nviewElement.analyses.add(areaMeasurementAnalysis);\n\n// Connect the analysis to the measurement component:\nareaMeasurement3dElement.analysis = areaMeasurementAnalysis;\n```","docsTags":[],"values":[],"optional":true,"required":false},{"name":"autoDestroyDisabled","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"auto-destroy-disabled","reflectToAttr":false,"docs":"If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-area-measurement-3d/#destroy) method when you are done to\nprevent memory leaks.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideStartButton","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"hide-start-button","reflectToAttr":false,"docs":"If true, the button that starts a new measurement will be hidden.","docsTags":[{"name":"since","text":"5.0"}],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideUnitSelect","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"hide-unit-select","reflectToAttr":false,"docs":"If true, the unit selection dropdown will be hidden.","docsTags":[{"name":"since","text":"5.0"}],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideVisualization","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"hide-visualization","reflectToAttr":false,"docs":"Indicates whether the component's visualization is hidden in the view.","docsTags":[{"name":"since","text":"5.0"}],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"icon","type":"Icon[\"icon\"] | undefined","complexType":{"original":"Icon[\"icon\"] | undefined","resolved":"Icon[\"icon\"] | undefined","references":{"Icon":{"location":"import","path":"@esri/calcite-components/components/calcite-icon","id":"notImplemented"}}},"mutable":true,"attr":"icon","reflectToAttr":true,"docs":"Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).","docsTags":[{"name":"see","text":"[Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)"}],"default":"\"measure-area\"","values":[{"type":"string"}],"optional":true,"required":false},{"name":"label","type":"string | undefined","complexType":{"original":"string | undefined","resolved":"string | undefined","references":{}},"mutable":true,"attr":"label","reflectToAttr":false,"docs":"The component's default label.","docsTags":[],"values":[{"type":"string"}],"optional":true,"required":false},{"name":"referenceElement","type":"ArcgisReferenceElement | string | undefined","complexType":{"original":"ArcgisReferenceElement | string | undefined","resolved":"ArcgisReferenceElement | string | undefined","references":{"ArcgisReferenceElement":{"location":"local","path":"components/types","id":"notImplemented"}}},"mutable":true,"attr":"reference-element","reflectToAttr":false,"docs":"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.","docsTags":[{"name":"see","text":"[Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)"}],"values":[{"type":"string"},{"type":"object"}],"optional":true,"required":false},{"name":"state","type":"AreaMeasurement3DState","complexType":{"original":"AreaMeasurement3DState","resolved":"AreaMeasurement3DState","references":{"AreaMeasurement3DState":{"location":"local","path":"components/arcgis-area-measurement-3d/types","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"The component's state. The values mean the following:\n\n* `disabled` - not ready yet\n* `ready` - ready for measuring\n* `measuring` - currently measuring\n* `measured` - measuring has finished","docsTags":[{"name":"readonly","text":""}],"values":[{"type":"string","value":"disabled"},{"type":"string","value":"ready"},{"type":"string","value":"unsupported"},{"type":"string","value":"measured"},{"type":"string","value":"measuring"}],"optional":true,"required":false},{"name":"unit","type":"SystemOrAreaUnit","complexType":{"original":"SystemOrAreaUnit","resolved":"SystemOrAreaUnit","references":{"SystemOrAreaUnit":{"location":"import","path":"@arcgis/core/core/units.js","id":"notImplemented"}}},"mutable":true,"attr":"unit","reflectToAttr":false,"docs":"Unit system (imperial, metric) or specific unit used for displaying the area values. Possible values are listed in\n[unitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-area-measurement-3d/#unitOptions).","docsTags":[],"values":[{"type":"string","value":"metric"},{"type":"string","value":"imperial"},{"type":"string","value":"square-inches"},{"type":"string","value":"square-feet"},{"type":"string","value":"square-yards"},{"type":"string","value":"square-miles"},{"type":"string","value":"square-nautical-miles"},{"type":"string","value":"square-us-feet"},{"type":"string","value":"square-millimeters"},{"type":"string","value":"square-centimeters"},{"type":"string","value":"square-decimeters"},{"type":"string","value":"square-meters"},{"type":"string","value":"square-kilometers"},{"type":"string","value":"acres"},{"type":"string","value":"ares"},{"type":"string","value":"hectares"}],"optional":true,"required":false},{"name":"unitOptions","type":"Array<SystemOrAreaUnit>","complexType":{"original":"Array<SystemOrAreaUnit>","resolved":"Array<SystemOrAreaUnit>","references":{"Array":{"location":"global","path":"global:","id":"notImplemented"},"SystemOrAreaUnit":{"location":"import","path":"@arcgis/core/core/units.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.\nBy default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.\nPossible [unit](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-area-measurement-3d/#unit) values can only be a subset of this list.","docsTags":[],"values":[],"optional":true,"required":false},{"name":"view","type":"SceneView | undefined","complexType":{"original":"SceneView | undefined","resolved":"SceneView | undefined","references":{"default":{"location":"import","path":"@arcgis/core/views/SceneView.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"The view associated with the component. \n > **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 arcgis-area-measurement-3d component will be associated with a map or scene component rather than using the `view` property.","docsTags":[],"values":[],"optional":true,"required":false}],"methods":[{"name":"clear","returns":{"type":"Promise<void>","docs":""},"complexType":{"signature":"(): Promise<void>","parameters":[],"return":"Promise<void>","references":{"Promise":{"location":"global","path":"global:","id":"notImplemented"}}},"signature":"clear(): Promise<void>","parameters":[],"docs":"Clears the current measurement.","docsTags":[]},{"name":"componentOnReady","returns":{"type":"Promise<this>","docs":""},"complexType":{"signature":"(): Promise<this>","parameters":[],"return":"Promise<this>","references":{"Promise":{"location":"import","path":"typescript/lib/lib.es5.d.ts","id":"notImplemented"}}},"signature":"componentOnReady(): Promise<this>","parameters":[],"docs":"Creates a promise that resolves once the component is fully loaded.","docsTags":[{"name":"example","text":"```js\nconst arcgisAreaMeasurement3d = document.createElement(\"arcgis-area-measurement-3d\");\ndocument.body.append(arcgisAreaMeasurement3d);\nawait arcgisAreaMeasurement3d.componentOnReady();\nconsole.log(\"arcgis-area-measurement-3d is ready to go!\");\n```"},{"name":"inheritedFrom","text":"{\"name\":\"this\"}"}]},{"name":"destroy","returns":{"type":"Promise<void>","docs":""},"complexType":{"signature":"(): Promise<void>","parameters":[],"return":"Promise<void>","references":{"Promise":{"location":"global","path":"global:","id":"notImplemented"}}},"signature":"destroy(): Promise<void>","parameters":[],"docs":"Permanently destroy the component.","docsTags":[]},{"name":"start","returns":{"type":"Promise<void>","docs":""},"complexType":{"signature":"(): Promise<void>","parameters":[],"return":"Promise<void>","references":{"Promise":{"location":"global","path":"global:","id":"notImplemented"}}},"signature":"start(): Promise<void>","parameters":[],"docs":"Starts a new measurement.","docsTags":[]}],"events":[{"event":"arcgisPropertyChange","detail":"{ name: \"analysis\" | \"state\"; }","bubbles":true,"complexType":{"original":"{ name: \"analysis\" | \"state\"; }","resolved":"{ name: \"analysis\" | \"state\"; }","references":{}},"cancelable":true,"composed":true,"docs":"Emitted when the value of a property is changed. Use this to listen to changes to properties.","docsTags":[]},{"event":"arcgisReady","detail":"void","bubbles":true,"complexType":{"original":"void","resolved":"void","references":{}},"cancelable":true,"composed":true,"docs":"Emitted when the component associated with a map or scene view is ready to be interacted with.","docsTags":[]}],"styles":[],"slots":[],"parts":[],"listeners":[]},{"filePath":"src/components/attachments/attachments.tsx","tag":"arcgis-attachments","overview":"","readme":"","usage":{},"docs":"","docsTags":[{"name":"internal"},{"name":"superclass","text":"{\"name\":\"HTMLElement\",\"package\":\"global:\",\"viewUrl\":\"https://developer.mozilla.org/docs/Web/API/HTMLElement\"}"}],"encapsulation":"shadow","dependents":[],"dependencies":[],"dependencyGraph":{},"props":[{"name":"attachmentInfos","type":"Collection<AttachmentInfo>","complexType":{"original":"Collection<AttachmentInfo>","resolved":"Collection<AttachmentInfo>","references":{"default":{"location":"import","path":"@arcgis/core/rest/query/support/AttachmentInfo.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"A collection of [AttachmentInfo](https://developers.arcgis.com/javascript/latest/references/core/rest/query/support/AttachmentInfo/) defined on a feature.","docsTags":[{"name":"see","text":"[ArcGIS REST API - Attachment Infos (Feature Service)](https://developers.arcgis.com/rest/services-reference/attachment-infos-feature-service-.htm)"},{"name":"readonly","text":""}],"values":[],"optional":true,"required":false},{"name":"attachmentKeywords","type":"Array<string> | null | undefined","complexType":{"original":"Array<string> | null | undefined","resolved":"Array<string> | null | undefined","references":{"Array":{"location":"global","path":"global:","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"An array of strings used to identify attachment(s). When attachments are displayed, this property is used to query attachments using an exact match on the keywords provided.","docsTags":[],"values":[],"optional":true,"required":false},{"name":"attachmentTypes","type":"Array<\"image\" | \"model\" | \"text\" | \"video\" | \"application\" | \"audio\"> | null | undefined","complexType":{"original":"Array<\"image\" | \"model\" | \"text\" | \"video\" | \"application\" | \"audio\"> | null | undefined","resolved":"Array<\"image\" | \"model\" | \"text\" | \"video\" | \"application\" | \"audio\"> | null | undefined","references":{"Array":{"location":"global","path":"global:","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"An array of strings representing MIME types. When attachments are displayed, this property is used to query attachments based on MIME type. Valid values: application, audio, image, model, text, and video.","docsTags":[],"values":[],"optional":true,"required":false},{"name":"autoDestroyDisabled","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"auto-destroy-disabled","reflectToAttr":false,"docs":"If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-attachments/#destroy) method when you are done to\nprevent memory leaks.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"capabilities","type":"AttachmentsCapabilities","complexType":{"original":"AttachmentsCapabilities","resolved":"AttachmentsCapabilities","references":{"AttachmentsCapabilities":{"location":"import","path":"@arcgis/core/widgets/Attachments/types.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"The capabilities needed for the attachments component.","docsTags":[{"name":"since","text":"4.27"}],"values":[],"optional":true,"required":false},{"name":"displayType","type":"AttachmentsDisplay","complexType":{"original":"AttachmentsDisplay","resolved":"AttachmentsDisplay","references":{"AttachmentsDisplay":{"location":"import","path":"@arcgis/core/widgets/Attachments/types.js","id":"notImplemented"}}},"mutable":true,"attr":"display-type","reflectToAttr":false,"docs":"String indicating how to [display](https://developers.arcgis.com/javascript/latest/references/core/widgets/Attachments/#displayType) the attachments.\n\n| Value | Description |\n| ------ | ----------- |\n| auto | Default value. If a feature layer's capabilities supports [resizing attachments](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#capabilities), the popup will display attachments in `preview` mode.|\n| preview | Shows a thumbnail image of the attachment.|\n| list | Shows a list of attachment links. |","docsTags":[],"default":"\"auto\"","values":[{"type":"string","value":"list"},{"type":"string","value":"auto"},{"type":"string","value":"preview"}],"optional":true,"required":false},{"name":"graphic","type":"Graphic | null | undefined","complexType":{"original":"Graphic | null | undefined","resolved":"Graphic | null | undefined","references":{"default":{"location":"import","path":"@arcgis/core/Graphic.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"The graphic for the attachments.","docsTags":[],"values":[],"optional":true,"required":false},{"name":"hideAddButton","type":"boolean | undefined","complexType":{"original":"boolean | undefined","resolved":"boolean | undefined","references":{}},"mutable":true,"attr":"hide-add-button","reflectToAttr":false,"docs":"Indicates whether to hide the `Add` button which prompts the dialog to add a new attachment.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideAddSubmitButton","type":"boolean | undefined","complexType":{"original":"boolean | undefined","resolved":"boolean | undefined","references":{}},"mutable":true,"attr":"hide-add-submit-button","reflectToAttr":false,"docs":"Indicates whether to hide the `add` button after selecting the attachment to add..","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideCancelAddButton","type":"boolean | undefined","complexType":{"original":"boolean | undefined","resolved":"boolean | undefined","references":{}},"mutable":true,"attr":"hide-cancel-add-button","reflectToAttr":false,"docs":"Indicates whether to hide the `cancel` button after selecting the attachment to add.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideCancelUpdateButton","type":"boolean | undefined","complexType":{"original":"boolean | undefined","resolved":"boolean | undefined","references":{}},"mutable":true,"attr":"hide-cancel-update-button","reflectToAttr":false,"docs":"Indicates whether to hide the `cancel` button after selecting an attachment to update an existing attachment.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideDeleteButton","type":"boolean | undefined","complexType":{"original":"boolean | undefined","resolved":"boolean | undefined","references":{}},"mutable":true,"attr":"hide-delete-button","reflectToAttr":false,"docs":"Indicates whether to hide the `delete` button to delete an existing attachment.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideErrorMessage","type":"boolean | undefined","complexType":{"original":"boolean | undefined","resolved":"boolean | undefined","references":{}},"mutable":true,"attr":"hide-error-message","reflectToAttr":false,"docs":"Indicates whether to hide an error message if adding or updating an attachment results in errors.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideProgressBar","type":"boolean | undefined","complexType":{"original":"boolean | undefined","resolved":"boolean | undefined","references":{}},"mutable":true,"attr":"hide-progress-bar","reflectToAttr":false,"docs":"Indicates whether to hide a progress bar when adding an attachment.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"hideUpdateButton","type":"boolean | undefined","complexType":{"original":"boolean | undefined","resolved":"boolean | undefined","references":{}},"mutable":true,"attr":"hide-update-button","reflectToAttr":false,"docs":"Indicates whether to hide an `update` button to allow updating on existing attachments.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"icon","type":"IconName","complexType":{"original":"IconName","resolved":"IconName","references":{"IconName":{"location":"local","path":"components/types","id":"notImplemented"}}},"mutable":true,"attr":"icon","reflectToAttr":false,"docs":"Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).","docsTags":[{"name":"since","text":"4.27"},{"name":"see","text":"[Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)"}],"default":"\"attachment\"","values":[{"type":"string"}],"optional":true,"required":false},{"name":"label","type":"string | null | undefined","complexType":{"original":"string | null | undefined","resolved":"string | null | undefined","references":{}},"mutable":true,"attr":"label","reflectToAttr":false,"docs":"The component's default label.","docsTags":[{"name":"since","text":"4.11"}],"values":[{"type":"string"}],"optional":true,"required":false},{"name":"referenceElement","type":"ArcgisReferenceElement | string | undefined","complexType":{"original":"ArcgisReferenceElement | string | undefined","resolved":"ArcgisReferenceElement | string | undefined","references":{"ArcgisReferenceElement":{"location":"local","path":"components/types","id":"notImplemented"}}},"mutable":true,"attr":"reference-element","reflectToAttr":false,"docs":"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.","docsTags":[{"name":"see","text":"[Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)"}],"values":[{"type":"string"},{"type":"object"}],"optional":true,"required":false},{"name":"state","type":"AttachmentsViewModelState","complexType":{"original":"AttachmentsViewModelState","resolved":"AttachmentsViewModelState","references":{"AttachmentsViewModelState":{"location":"import","path":"@arcgis/core/widgets/Attachments/AttachmentsViewModel.js","id":"notImplemented"}}},"mutable":true,"reflectToAttr":false,"docs":"The current state of the component.","docsTags":[{"name":"readonly","text":""}],"default":"\"ready\"","values":[{"type":"string","value":"disabled"},{"type":"string","value":"ready"},{"type":"string","value":"loading"}],"optional":true,"required":false},{"name":"submitting","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"reflectToAttr":false,"docs":"Indicates whether there is currently an attachment being added, updated or deleted.","docsTags":[{"name":"since","text":"4.27"},{"name":"readonly","text":""}],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false}],"methods":[{"name":"componentOnReady","returns":{"type":"Promise<this>","docs":""},"complexType":{"signature":"(): Promise<this>","parameters":[],"return":"Promise<this>","references":{"Promise":{"location":"import","path":"typescript/lib/lib.es5.d.ts","id":"notImplemented"}}},"signature":"componentOnReady(): Promise<this>","parameters":[],"docs":"Creates a promise that resolves once the component is fully loaded.","docsTags":[{"name":"example","text":"```js\nconst arcgisAttachments = document.createElement(\"arcgis-attachments\");\ndocument.body.append(arcgisAttachments);\nawait arcgisAttachments.componentOnReady();\nconsole.log(\"arcgis-attachments is ready to go!\");\n```"},{"name":"inheritedFrom","text":"{\"name\":\"this\"}"}]},{"name":"destroy","returns":{"type":"Promise<void>","docs":""},"complexType":{"signature":"(): Promise<void>","parameters":[],"return":"Promise<void>","references":{"Promise":{"location":"global","path":"global:","id":"notImplemented"}}},"signature":"destroy(): Promise<void>","parameters":[],"docs":"Permanently destroy the component.","docsTags":[]}],"events":[{"event":"arcgisPropertyChange","detail":"{ name: \"submitting\" | \"state\" | \"attachmentInfos\"; }","bubbles":true,"complexType":{"original":"{ name: \"submitting\" | \"state\" | \"attachmentInfos\"; }","resolved":"{ name: \"submitting\" | \"state\" | \"attachmentInfos\"; }","references":{}},"cancelable":true,"composed":true,"docs":"Emitted when the value of a property is changed. Use this to listen to changes to properties.","docsTags":[]},{"event":"arcgisReady","detail":"void","bubbles":true,"complexType":{"original":"void","resolved":"void","references":{}},"cancelable":true,"composed":true,"docs":"Emitted when the component associated with a map or scene view is ready to be interacted with.","docsTags":[]}],"styles":[],"slots":[],"parts":[],"listeners":[]},{"filePath":"src/components/basemap-gallery/basemap-gallery.tsx","tag":"arcgis-basemap-gallery","overview":"","readme":"","usage":{},"docs":"The Basemap Gallery component displays a collection images representing basemaps from [ArcGIS.com](https://www.arcgis.com/index.html) or a user-defined set of map or image services. When a new basemap is selected from the Basemap Gallery, the map's basemap layers are removed and replaced with the basemap layers of the associated basemap selected in the gallery.","docsTags":[{"name":"since","text":"4.28"},{"name":"superclass","text":"{\"name\":\"HTMLElement\",\"package\":\"global:\",\"viewUrl\":\"https://developer.mozilla.org/docs/Web/API/HTMLElement\"}"}],"encapsulation":"shadow","dependents":[],"dependencies":[],"dependencyGraph":{},"props":[{"name":"activeBasemap","type":"BasemapProperties | string | undefined","complexType":{"original":"BasemapProperties | string | undefined","resolved":"BasemapProperties | string | undefined","references":{"BasemapProperties":{"location":"import","path":"@arcgis/core/Basemap.js","id":"notImplemented"}}},"mutable":true,"attr":"active-basemap","reflectToAttr":false,"docs":"The map's current [basemap](https://developers.arcgis.com/javascript/latest/references/core/Map/#basemap).","docsTags":[],"values":[{"type":"string"},{"type":"object"}],"optional":true,"required":false},{"name":"autoDestroyDisabled","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"auto-destroy-disabled","reflectToAttr":false,"docs":"If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-gallery/#destroy) method when you are done to\nprevent memory leaks.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"disabled","type":"boolean","complexType":{"original":"boolean","resolved":"boolean","references":{}},"mutable":true,"attr":"disabled","reflectToAttr":true,"docs":"When true, the component is visually withdrawn and cannot receive user interaction.","docsTags":[],"default":"false","values":[{"type":"boolean"}],"optional":true,"required":false},{"name":"headingLevel","type":"HeadingLevel","complexType":{"original":"HeadingLevel","resolved":"HeadingLevel","references":{"HeadingLevel":{"location":"local","path":"components/types","id":"notImplemented"}}},"mutable":true,"attr":"heading-level","reflectToAttr":false,"docs":"Indicates the heading level to use for the message \"No basemaps available\"\nwhen no basemaps are available in the Basemap Gallery.","docsTags":[],"default":"2","values":[{"type":"number","value":"6"},{"type":"number","value":"1"},{"type":"number","value":"2"},{"type":"number","value":"3"},{"type":"number","value":"4"},{"type":"number","value":"5"}],"optional":true,"required":false},{"name":"icon","type":"string","complexType":{"original":"string","resolved":"string","references":{}},"mutable":true,"attr":"icon","reflectToAttr":false,"docs":"Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).","docsTags":[{"name":"see","text":"[Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)"}],"default":"\"basemap\"","values":[{"type":"string"}],"optional":true,"required":false},{"name":"label","type":"