The Draw widget allows you to draw simple graphics and text on the map. You can also use it to add line distance or polygon area to the feature as text.
This widget provides basic sketching and markup functionality to a web app. It also displays some measurements (if configured to do so) for drawn features, such as length for lines and area and perimeter for polygons. When the widget initially opens, a window appears that contains the following draw tools:
- Point
- Line
- Polyline
- Freehand polyline
- Arrow
- Triangle
- Rectangle
- Circle
- Ellipse
- Polygon
- Freehand polygon
- Text
Configure the Draw widget
This widget can be set to open automatically when an app starts. Hover over the widget and click the Do not open this widget when the app starts button to change the setting to Open this widget automatically when the app starts. (For widgets that you need to add to the app first, you can turn on this option after configuring the widget.)
To configure the Draw widget, complete the following steps:
- Hover over the widget and click the Configure this widget button to open the configuration window.
Note:
If you need to add the widget to the app first, click a widget placeholder on the Widget tab. In the Choose Widget window that opens, select the widget and click OK.
- Set the location, distance, or area units.
- Select the unit for the location, distance, or area. The abbreviation and conversion factor are not editable.
- Optionally, change the order of the units. Click the up or down arrow of the unit in the Actions column to modify the order.
- To delete a unit of measure, click the close button of the unit in the Actions column.
- To add a unit of measure, select Add location unit, Add length unit, or Add area unit on the Locations, Distances, or Areas tab, respectively.
- Select the unit for the location, distance, or area. The abbreviation and conversion factor are not editable.
- Check Add the drawing as an operational layer of the map to include Points, Lines, Areas, and Text layers in the Layers List. With this setting turned on, users can select from common layer options such as zooming to the layer's extent and setting a visibility range.
- Click OK to close the dialog box.
By default, all supported units appear on the Locations, Distances, and Areas tabs.
Use the Draw widget
To get started with the Draw widget, complete the following steps:
- Click a button to select the drawing mode.
- Optionally, change the drawing style using the symbol picker.
- For points, select the marker category (different symbols are available in each category) to set the symbol size, color, transparency, outline color, and outline width of the symbol. Only the size field is available for picture marker symbols.
- For lines, select a predefined symbol from the box. You can also customize the color, style, transparency, and width of the symbol.
- For polygons, select a predefined symbol from the box. You can also customize the fill color, transparency, outline color, and outline width of the symbol.
- For text, type in the Text box, and select a font color and size for the text.
- For points, select the marker category (different symbols are available in each category) to set the symbol size, color, transparency, outline color, and outline width of the symbol. Only the size field is available for picture marker symbols.
- Optionally, show a corresponding measurement in the map for the point location, line length, or polygon area or perimeter. You can also choose a unit of measurement and set the font color and size for the text.
- Draw the desired features and text on the map.
- If the app was configured to add your drawings as an operational layer of the map, open the Layer List widget to see your new Points, Lines, Areas, and Text layers. You can select from common layer options, such as zoom to the layer's extent and set a visibility range.
- Click Undo or Redo to cancel or repeat your drawings, or click Clear to remove them all from the map.