Legend
A layer can be configured with a legend by pointing its Legend field to a .csv file or by including a JSON legend
array into the layer’s Raw Variables. The Legend Tool renders symbologies and gradient scales for any properly configured on layer.
On the Configure page, under Tools, you can specify additional options:
- displayOnStart: Whether the expanded legend should automatically be displayed on start (
true
/false
) - justification: The legend will display on the right side of the screen if set to
right
, otherwise default to the left side
{
"displayOnStart": true,
"justification": "right"
}
legend.csv example:
color,strokecolor,shape,value
purple,#000,discreet,This
cyan,#000,discreet,is
lime,#000,discreet,a
yellow,#000,discreet,sentential
orange,#000,discreet,example
red,#000,discreet,of
purple,#000,continuous,what
red,#000,continuous,values
white,#000,continuous,the
blue,#000,continuous,legend
pink,#000,circle,csv
green,#000,discreet,files
orange,#000,discreet,could
crimson,cyan,square,possibly
indigo,#FFF,rect,contain
Raw Variables examples:
{
"legend": [
{
"color": "purple",
"strokecolor": "#000",
"shape": "discreet",
"value": "This"
},
{
"color": "cyan",
"strokecolor": "#000",
"shape": "discreet",
"value": "is"
},
{
"color": "lime",
"strokecolor": "#000",
"shape": "discreet",
"value": "a"
},
{
"color": " yellow",
"strokecolor": "#000",
"shape": "discreet",
"value": "sentential"
},
{
"color": "orange",
"strokecolor": "#000",
"shape": "discreet",
"value": "example"
},
{
"color": "red",
"strokecolor": "#000",
"shape": "discreet",
"value": "of"
},
{
"color": "purple",
"strokecolor": "#000",
"shape": "continuous",
"value": "what"
},
{
"color": "red",
"strokecolor": "#000",
"shape": "continuous",
"value": "values"
},
{
"color": "white",
"strokecolor": "#000",
"shape": "continuous",
"value": "the"
},
{
"color": "blue",
"strokecolor": "#000",
"shape": "continuous",
"value": "legend"
},
{
"color": "pink",
"strokecolor": "#000",
"shape": "circle",
"value": "csv"
},
{
"color": "green",
"strokecolor": "#000",
"shape": "discreet",
"value": "files"
},
{
"color": " orange",
"strokecolor": "#000",
"shape": "discreet",
"value": "could"
},
{
"color": "crimson",
"strokecolor": "cyan",
"shape": "square",
"value": "possibly"
},
{
"color": "indigo",
"strokecolor": "#FFF",
"shape": "rect",
"value": "contain"
}
]
}
header
The header/properties must be color,strokecolor,shape,value
.
color
Any CSS color to use as the main fill color.
strokecolor
Any CSS color to use as the stroke/border color. Note: discreet and continuous shapes have no borders.
shape
Can be either circle
, square
, rect
, discreet
and continuous
. Discreet and continuous describe scales. These scales are broken into groups by a change in shape value. For instance, “discreet, discreet, discreet, circle, discreet, discreet” represents a discreet scales of three colors, a circle and then a discreet scale of two colors.
value
A string value for the legend entry.