dojo.require("esri.layers.graphics");Description
(Added at v1.0)
A layer that contains one or more
Graphicfeatures. Each map contains a GraphicsLayer by default, accessible using the
Map.graphicsproperty. You can create your own graphics layers and add them to the map. Graphics layers can be reordered within the group of graphics layers. However, the graphics layer in
Map.graphicsis always on top. Also, all graphics layers are always on top of
TiledMapServiceLayersand
DynamicMapServiceLayers.
SamplesSearch for
samplesthat use this class.
Class hierarchyesri/layers.Layer |_esri/layers.GraphicsLayerSubclasses Constructors Properties Methods Events
[ On Style Events | Connect Style Event ]
All On Style event listeners receive a single event object. Additionally, the event object also contains a 'target' property whose value is the object which fired the event.
Events click{
event: <Object
>
}
Fires when a graphic has been clicked. dbl-click Fires when a graphic has been double clicked. error
{
error: <Error
>
}
Fires when there is a problem retrieving a layer. graphic-add
{
graphic: <Graphic
>
}
Fires when a graphic is added to the GraphicsLayer. graphic-draw
{
graphic: <Graphic
>
}
Fires when a graphic is drawn. graphic-node-add
{ graphic: <Fires when a graphic's DOM node is created and added to the layer. graphic-node-removeGraphic
>, node: <HTMLElement
> }
{ graphic: <This event is fired when a graphic's DOM node is removed (consider the node destroyed). graphic-removeGraphic
>, node: <HTMLElement
> }
{
graphic: <Graphic
>
}
Fires when a graphic is removed from the GraphicsLayer. graphics-clear Fires when all graphics in the GraphicsLayer are cleared. load
{
layer: <Layer
>
}
Fires after layer properties for the layer are successfully populated. mouse-down <MouseEvent
> mouseEvent Fires when a mouse button is pressed down and the mouse cursor is on a graphic. mouse-drag <MouseEvent
> mouseEvent Fires while the mouse is being dragged until the mouse button is released. mouse-move <MouseEvent
> mouseEvent Fires as the mouse moves through a graphic on the GraphicsLayer. mouse-out <MouseEvent
> mouseEvent Fires as the mouse exits a graphic on the GraphicsLayer. mouse-over <MouseEvent
> mouseEvent Fires when the mouse first enters into a graphic on the GraphicsLayer. mouse-up <MouseEvent
> mouseEvent Fires when a mouse button is released and the mouse cursor is on a graphic. opacity-change
{
opacity: <Number
>
}
Fires when the layer opacity has been changed, and returns an object with the opacity value. refresh-interval-change This event is fired when the layer's refreshInterval
is modified. resume Fires when a layer resumes drawing. scale-range-change Fires when a layer's minScale and/or maxScale is changed. scale-visibility-change Fires when a layer's scale visibility changes. suspend Fires when a layer suspends drawing. update Fires any time a layer has finished loading or updating itself. update-end
{
error: <Error
>
}
Fires when a layer has finished updating its content. update-start Fires when a layer begins to update its content. visibility-change
{
visible: <Boolean
>
}
Fires when the layer visibility has been changed, and returns an object with a Boolean visible property containing the new visibility value of the layer.
Constructor Details
Creates a new GraphicsLayer object. (Added at v1.4)
Sample:var countyLayer = new esri.layers.GraphicsLayer();
Creates a new GraphicsLayer object with parameters. (Added at v1.4)
Parameters: <Object
> options Optional See options list for parameters. options
properties: <String
> className Optional Class attribute to set for the layer's node. <String
| String[]
> dataAttributes Optional List of attribute fields to be added as custom data attributes to graphics node. Applicable only when layer surfaceType
is "svg"
. For other surface types, this option is ignored. <Boolean
> displayOnPan Optional When true, graphics are displayed during panning. When false, the graphics are turned off during pan movement. Setting to false may improve performance in Internet Explorer. The default is true. <String
> id Optional Id to assign to the layer. If not assigned, esri.Map
assigns value. <InfoTemplate
> infoTemplate Optional The info template for the layer. <Number
> opacity Optional Initial opacity or transparency of layer. Values range from 0.0 to 1.0, where 0.0 is 100% transparent and 1.0 has no transparency. The default value is 1.0. Not supported in Internet Explorer. <Number
> refreshInterval Optional Refresh interval of the layer in minutes. Non-zero value sets up automatic layer refresh at the specified interval. <Boolean
> styling Optional Indicates whether the layer is responsible for styling graphics. Default is true
i.e. styling is based on graphics symbol or the layer's renderer. You can set it to false
and use CSS to define style. Applicable only when layer surfaceType
is "svg"
. For other surface types, this option is ignored. <Boolean
> visible Optional Initial visibility of the layer. Default is true. Sample:
var graphicsLayer = new esri.layers.GraphicsLayer({opacity:0.20});
Property Details
The URL, when available, where the layer's attribution data is stored. (Added at v3.1)
classattribute of the layer's node.
(Added at v3.7)Provides credential information for the layer such as userid and token if the layer represents a resource that is secured with token-based authentication. This value is available after the layer has been loaded i.e. layer.loaded
is true. (Added at v2.5)
List of attribute fields added as custom data attributes to graphics node. Applicable only when layer surfaceType
is "svg"
. (Added at v3.7)
The array of graphics that make up the layer.
When true, the layer has attribution data. Use the
getAttributionDatamethod to retrieve this data as JSON.
(Added at v3.1)Known values: true | false
Default value: false
ID assigned to the layer. If not assigned, esri.Map assigns value. By default, the ID of the layer is "layer" followed by a number. The ID can be user defined only in the layer constructor.
Sample:population = new esri.layers.ArcGISDynamicMapServiceLayer("http://myserver/arcgis/rest/population/MapServer/Layers", {id:"population"});
population.id = "population";
function getMapLayers() { for (var j=0, jl=myMap.layerIds.length; j<jl; j++) { var currentLayer = myMap.getLayer(myMap.layerIds[j]); alert("id: " + currentLayer.id); } }
The info template for the layer. (Added at v3.9)
Set if the layer failed to load. (Added at v3.9)
When the layer is loaded, the value becomes "true", and layer properties can be accessed. The
onLoadevent is also fired.
Known values: true | false
Maximum visible scale for the layer. If the map is zoomed in beyond this scale, the layer will not be visible. A value of 0 means the layer does not have a maximum scale. (Added at v3.1)
Default value: 0
Minimum visible scale for the layer. If the map is zoomed out beyond this scale, the layer will not be visible. A value of 0 means the layer does not have a visible scale. (Added at v3.1)
Default value: 0
Opacity or transparency of layer. Values range from 0.0 to 1.0, where 0.0 is 100% transparent and 1.0 has no transparency.
Known values: 0.0 - 1.0
Default value: 1.0
Refresh interval of the layer in minutes. Non-zero value indicates automatic layer refresh at the specified interval. Value of 0 indicates auto refresh is not enabled. (Added at v3.7)
Renderer assigned to the GraphicsLayer. (Added at v1.4)
When true, the layer's attribution is displayed on the map. (Added at v3.1)
Known values: true | false
Default value: true
Indicates whether the layer is responsible for styling graphics. When true
, styling is based on graphics symbol or the layer's renderer. When false
, graphics styling is disabled. Applicable only when layer surfaceType
is "svg"
. (Added at v3.7)
Known values: true | false
Type of vector graphics surface used to draw graphics. (Added at v3.7)
Known values: "svg" | "canvas-2d" | "vml"
Default value: "svg" on all browsers - except IE8 or earlier where "vml" is used to draw graphics.
When true, the layer is suspended. A layer is considered to be suspended when one of the following is true:
Layer.suspend
method.Known values: true | false
Visibility of the layer.
Known values: true | false
Default value: true
When true, the layer is visible at the current map scale. (Added at v3.1)
Known values: true | false
Method Details
Adds a graphic. It is not recommended to call
add()
on a
FeatureLayeras the layer automatically manages fetching (from the service) and clearing graphics based on its
mode. Additional graphics added to the layer by calling
add()
may be lost during this process. For feature layers, we recommend using
applyedits()to add, delete, and update features.
Parameters: <Graphic
> graphic Required The graphic to add. Sample:
function addGraphic(geometry) { var symbol = new esri.symbol.SimpleFillSymbol(); graphicsLayer.add(new esri.Graphic(geometry, symbol)); }
Adds a new attribute or changes the value of an existing attribute on the layer's node. Removes the attribute if the value is null
or undefined
. (Added at v3.7)
String
> name Required The name of the attribute. <String
> value Required The value of the attribute. Set this value as null
to remove the attribute.
Clears all graphics. It is not recommended to call
clear()
on a
FeatureLayeras the layer automatically manages fetching (from the service) and clearing graphics based on its
mode. Explicitly calling
clear()
to clear the graphics will interfere with the integrity of this process. For feature layers, we recommend using
applyedits()to add, delete, and update features.
Sample:graphicsLayer.clear();
Disables all mouse events on the graphics layer.
Enables all mouse events on the graphics layer.
Asynchrously returns custom data for the layer when available. (Added at v3.1)
Returns reference to the map control the layer is added to. Returns null
or undefined
if it is not added to a map. (Added at v3.7)
Returns the layer's DOM node. (Added at v3.7)
Sets the visibility of the layer to "false". The layer is not removed, but it is hidden from view.
Returns true if the layer is visible at the given scale. (Added at v3.1)
Parameters: <Number
> scale Required The scale at which to check if the layer is visible.
Redraws all the graphics in the layer. This method is functionally equivalent to refresh. (Added at v3.3)
Removes a graphic. It is not recommended to call
remove()
on a
FeatureLayeras the layer automatically manages fetching (from the service) and clearing graphics based on its
mode. Explicitly calling
remove()
to remove the graphics will interfere with the integrity of this process. For feature layers, we recommend using
applyedits()to add, delete, and update features.
Parameters: <Graphic
> graphic Required The graphic to remove.
Resumes layer drawing. (Added at v3.1)
Specify or change the info template for a layer. (Added at v2.2)
Sample:var cityLayer = new esri.layers.GraphicsLayer(); var infoTemplate = new esri.InfoTemplate("${CITY_NAME}","${*}"); cityLayer.setInfoTemplate(infoTemplate);
Set the maximum scale for the layer. (Added at v3.1)
Parameters: <Number
> scale Required The maximum scale at which the layer is visible.
Set the minimum scale for the layer. (Added at v3.1)
Parameters: <Number
> scale Required The minimum scale at which the layer is visible.
Initial opacity or transparency of layer. Not supported in Internet Explorer.
Parameters: <Number
> opacity Required Value from 0 to 1, where 0 is 100% transparent and 1 has no transparency. The default value is 1.
Changes the layer's refresh interval to the given value (in minutes). Non-zero value sets up automatic layer refresh at the specified interval. Value of 0 stops auto refresh. (Added at v3.7)
Parameters: <Number
> interval Required Refresh interval of the layer in minutes. Non-zero value indicates automatic layer refresh at the specified interval. Value of 0
indicates auto refresh is not enabled.
Sets the renderer for the graphics layer.
Parameters: <Renderer
> renderer Required The renderer used for the graphic.
Set the scale range for the layer. If minScale
and maxScale
are set to 0 then the layer will be visible at all scales. (Added at v3.1)
Number
> minScale Required The minimum scale at which the layer is visible. <Number
> maxScale Required The maximum scale at which the layer is visible.
Sets the visibility of the layer. When true, the layer is visible.
Parameters: <Boolean
> isVisible Required Set the visibility of the layer.
Sets the visibility of the layer to "true".
Suspends layer drawing. (Added at v3.1)
Event Details
[ On Style Events | Connect Style Event ]
Fires when a graphic has been clicked. Should be used in favor of onClick. (Added at v3.5)
Event Object Properties: <Object
> event The returned object contains screenPoint, mapPoint, and Graphic.
Fires when a graphic has been double clicked. Should be used in favor of onDblClick. (Added at v3.5)
Fires when there is a problem retrieving a layer. Should be used in favor of onError. (Added at v3.5)
Fires when a graphic is added to the GraphicsLayer. Should be used in favor of onGraphicAdd. (Added at v3.5)
Event Object Properties: <Graphic
> graphic The added graphic.
Fires when a graphic is drawn. A graphic is drawn or redrawn when:
Graphic
> graphic Graphic being drawn. When the layer surfaceType
is "svg"
or "vml"
, the graphic's DOM node is accessible with graphic.getNode().
Fires when a graphic's DOM node is created and added to the layer. Fires only when the layer surfaceType is "svg"
or "vml"
. (Added at v3.7)
This event is fired when a graphic's DOM node is removed (consider the node destroyed). The DOM node of a graphic is removed when:
Fires only when the layer surfaceType is
"svg"
or
"vml"
.
(Added at v3.7)Fires when a graphic is removed from the GraphicsLayer. Should be used in favor of onGraphicRemove. (Added at v3.5)
Event Object Properties: <Graphic
> graphic The removed graphic.
Fires when all graphics in the GraphicsLayer are cleared. Should be used in favor of onGraphicsClear. (Added at v3.5)
Fires after layer properties for the layer are successfully populated. This event must be successful before the layer can be added to the map. Should be used in favor of onLoad. (Added at v3.5)
Event Object Properties: <Layer
> layer The loaded layer.
Fires when a mouse button is pressed down and the mouse cursor is on a graphic. Should be used in favor of onMouseDown. (Added at v3.5)
Fires while the mouse is being dragged until the mouse button is released. Should be used in favor of onMouseDrag. (Added at v3.5)
Fires as the mouse moves through a graphic on the GraphicsLayer. Should be used in favor of onMouseMove. (Added at v3.5)
Fires as the mouse exits a graphic on the GraphicsLayer. Should be used in favor of onMouseOut. (Added at v3.5)
Fires when the mouse first enters into a graphic on the GraphicsLayer. Should be used in favor of onMouseOver. (Added at v3.5)
Fires when a mouse button is released and the mouse cursor is on a graphic. Should be used in favor of onMouseUp. (Added at v3.5)
Fires when the layer opacity has been changed, and returns an object with the opacity value. Should be used in favor of onOpacityChange. (Added at v3.5)
Event Object Properties: <Number
> opacity Fires when the layer opacity (transparency) changes. A number property named opacity that indicates the new opacity. Values range from 0.0 to 1.0, where 0.0 is 100% transparent and 1.0 has no transparency.
This event is fired when the layer's refreshInterval
is modified. (Added at v3.7)
Fires when a layer resumes drawing. Should be used in favor of onResume. (Added at v3.5)
Fires when a layer's minScale and/or maxScale is changed. Should be used in favor of onScaleRangeChange. (Added at v3.5)
Fires when a layer's scale visibility changes. The scale visibility changes when a layer is initially visible and becomes invisible because the map scale does not intersect the layer's scale range or vice versa. Should be used in favor of onScaleVisibilityChange. (Added at v3.5)
Fires when a layer suspends drawing. Should be used in favor of onSuspend. (Added at v3.5)
Fires when a layer has finished updating its content. It is the responsibility of the subclass to determine when this event is fired. Should be used in favor of onUpdateEnd. (Added at v3.5)
Event Object Properties: <Error
> error Optional argument. The error object is available when an error occurs during the update.
Fires when a layer begins to update its content. It is the responsibility of the subclass to determine when this event is fired. Should be used in favor of onUpdateStart. (Added at v3.5)
Fires when the layer visibility has been changed, and returns an object with a Boolean visible property containing the new visibility value of the layer. Should be used in favor of onVisibilityChange. (Added at v3.5)
Event Object Properties: <Boolean
> visible Fires when the layer visibility changes. A boolean property named visible indicates whether or not the layer is visible after visibility changed.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4