arcgis-grid-controls

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.

The custom color used for drawing the grid, if any.

Returns true if the grid is enabled for display. Use trySetDisplayEnabled() to enable or disable grid display.

Returns true if the grid is set to scale dynamically. When dynamic scaling is enabled, grid cells are added or removed to ensure that grid cells are a reasonable size on screen as the user zooms. The way additional grid lines are shown is controlled by the majorLineInterval property.

Returns the actual spacing of grid lines after dynamic scaling has been applied at the current scale.

Controls the color of the major grid lines. Minor grid lines are a slightly transparent version of this color.

Returns true if the grid is in a valid state for manually setting grid properties or starting an interactive placement.

True if the grid is currently not displayed (and therefore also not a valid snap target), because dynamicScaling is off and the grid cells are too small to render at the current scale.

Controls display of the color and theme selection options.

Controls display of the dynamic scaling toggle. Dynamic scaling adjusts the size of the grid to work well regardless of view scale.

Controls display of the grid enabled toggle. This toggle controls whether the grid is displayed.

Controls display of the grid snapping enabled toggle. This toggle controls whether snapping is enabled.

Controls display of the line interval input field for setting the interval between major grid lines.

Controls display of the numeric input fields for setting grid spacing and rotation.

Controls display of the out of scale warning. This warning is displayed when the grid is not shown because it would be too small at the current scale and dynamic scaling is disabled.

Controls display of the grid placement buttons. These buttons allow the user to start interactive configuration of the grid.

Controls display of the rotate with map toggle. This toggle controls whether the grid rotates with the map.

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

See also

• Calcite Icons

Sets the interactive placement state, either starting or ending a draw operation that implicitly adjusts the grid. Interactive placement allows the user to define the center of the grid, then the scale and rotation of the grid by drawing a second point. Setting this to "place" allows the user to move the grid center only. Setting this to "rotate" keeps the scale and center of the grid constant while rotating the grid by defining a second point.

The component's default label.

Controls the number of grid cells shown between major grid lines. Can be anything between 1 and 15. No minor grid lines are shown when this is set to 1.

Replace localized message strings with your own strings.

Note: Individual message keys may change between releases.

Since

ArcGIS Maps SDK for JavaScript 4.33

Use this property to disable the interactive grid placement buttons as needed. An example use case might be to block interaction while another interactive operation (e.g. sketching) is in progress.

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

• Associate components with a Map or Scene component

Controls whether the grid rotates with the map, or stays fixed to the screen.

Rotation of the grid in radians. NOTE: UI controls convert to and from degrees automatically.

Controls snapping behavior if snappingOptions has been defined. If snappingOptions have been defined, disabling or enabling grid snapping will also disable or enable grid display.

The SnappingOptions that will be controlled by this component if the snapping toggle is enabled for display. If SnappingOptions are provided, grid display will be automatically enabled or disabled to match snapping state.

Length of a grid cell. Grid cells are always square. Defined in unit.

The color scheme used to display the grid. This will be light, dark, or custom. When theme is set to custom, the customColor is shown, otherwise a default light or dark theme color is used.

Unit of measure (foot, meter, etc) used when defining the spacing grid cell. Note that units are defined relatively to the map's spatial reference length unit, which will not correspond to geographic distance unless using a special-purpose basemap within a supported target area.

When using Web Mercator, the projection defines the length of a meter in projection system units; this length is equal to a geographic meter only at the equator. On screen, the size of the grid cells is constant from the equator to the poles, but the real-world size of the grid cell is much larger further from the equator.

The length of the grid cells can usefully correspond to a geographic length when the Grid is used with an appropriate spatial reference (for example a local system or a State Plane system) within the reference's area of interest.

The view associated with the component.

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

Creates a promise that resolves once the component is fully loaded.

Permanently destroy the component.

Call this to turn the grid on/off.