The Choropleth component displays divided geographical areas shaded in relation to some data variable. It's build on top of primitives from the GeoMap component.
Using this component requires some knowledge about the d3-geo
library, projections, geoJSON… please have a look at the
official d3 documentation
for further information.
Like for GeoMap, you must pass an array of features
which determine the geometries to render on the map, then you pass
an array of data which, each datum is merged with its corresponding
feature using the match
property, the value is picked according
to the value
accessor.
Please note that because the features file is pretty huge, it's not included
in the generated code, you can find the file used for this example
here,
you'll have to pass the features
array to the features
property.
The responsive alternative of this component is ResponsiveChoropleth
.
This component also have a canvas implementations,
ChoroplethCanvas, which should be used
when you have complex geometries as it offers better performance.
Chart width.
Chart height.
'Depends on device'
Adjust pixel ratio, useful for HiDPI screens.
Chart margin.
'id'
Label accessor.
'value'
Value accessor.
'value'
Value formatter.
Defines uppper and lower bounds of color shading
'mercator'
Defines the projection to use.
100
Projection scale.
0.5
, 0.5
][0.5
, 0.5
]
Projection x/y translation.
0
, 0
, 0
][0
, 0
, 0
]
Projection rotation.
Define style for common elements such as labels, axes…
0
Control border width.
'#000000'
#152538
Method to compute border color.
Define patterns and gradients.
Define rules to apply patterns and gradients
'nivo'
Defines color range.
'nivo'
#666666
Defines the color to use for features without value.
false
Enable meridians and parallels, useful for showing projection distortion.
0.5
Control meridians and parallel lines width.
'#999999'
#dddddd
Control meridians and parallel lines color.
true
Enable/disable interactivity.
onClick handler, it receives clicked node data and style plus mouse event.
Custom tooltip component.
Showcase custom tooltip.
'graticule'
, 'features'
]Defines the order of layers.
Optional chart's legends.
Defines legend anchor relative to chart's viewport.
Legend direction, must be one of 'column', 'row'.
Justify symbol and label.
Legend block x translation.
Legend block y translation.
Legend item width.
Legend item height.
Spacing between each item.
Item symbol size.
Item layout direction.