Polygons¶

Code¶

1 * {
2   fill: #000080;
3 }

Details¶

This simple rule applies a dark blue (#000080) fill to all the polygons in the dataset.

Code¶

1 * {
2   fill: #000080;
3   stroke: #FFFFFF;
4   stroke-width: 2;
5 }

Details¶

This example is similar to the Simple polygon example above, with the addition of the “stroke” and “stroke-width” attributes, that add a white, 2 pixels wide border around each polygon.

Code¶

1 * {
2   fill: #000080;
3   fill-opacity: 0.5;
4   stroke: #FFFFFF;
5   stroke-width: 2;
6 }

Details¶

This example is similar to the Simple polygon with stroke example, save for defining the fill’s opacity in line 3. The value of 0.5 results in partially transparent fill that is 50% opaque. An opacity value of 1 would draw the fill as 100% opaque, while an opacity value of 0 would result in a completely transparent (0% opaque) fill. In this example, since the background is white, the dark blue looks lighter. Were the points imposed on a dark background, the resulting color would be darker.

Code¶

1 * {
2   fill: url("colorblocks1.png");
3   fill-mime: 'image/png';
4 }

Details¶

This style fills the polygon with a tiled graphic. The graphic is selected providing a url for the fill, which in this case is meant to the relative to the styles directory contained within the data directory (an absolute path could have been provided, as well as a internet reference). Line 3 specifies that the image itself is a png (by default the code assumes jpegs are used and will fail to parse the file unless we specify its mime type). The size of the image is not specified, meaning the native size is going to be used. In case a rescale is desired, the “fill-size” attribute can be used to force a different size.

Code¶

1 * {
2   fill: symbol("shape://times");
3   :fill {
4     size: 16;
5     stroke: #990099;
6     stroke-width: 1px;
7   }
8 }

Details¶

In this example the fill is specified to be the “shape://times” symbol, which is going to be tiled creating a cross-hatch effect.

The details of the hatch are specified at line 3*, where the pseudo-selector “:fill” is used to match the contents of the fill, and specify that we want a symbol large 16 pixels (the larger the symbol, the coarser the cross hatch will be), and painted with a 1 pixel wide purple stroke.

Code¶

1 * {
2   fill: #40FF40;
3   stroke: white;
4   stroke-width: 2;
5   label: [name];
6   font-fill: black;
7 }

Details¶

The single rule in the CSS applies to all feature: first it fills all polygons a light green with white outline, and then applies the “name” attribute as the label, using the default font (Times), with black color and default font size (10 px).

Code¶

1 * {
2   fill: #40FF40;
3   stroke: white;
4   stroke-width: 2;
5   label: [name];
6   font-fill: black;
7   halo-color: white;
8   halo-radius: 3;
9 }

Details¶

This example builds on Polygon with default label, with the addition of a halo around the labels on lines 7-8. A halo creates a color buffer around the label to improve label legibility. Line 9 sets the radius of the halo, extending the halo 3 pixels around the edge of the label, and line 8 sets the color of the halo to white. Since halos are most useful when set to a sharp contrast relative to the text color, this example uses a white halo around black text to ensure optimum readability.

Code¶

 1 * {
 2   fill: #40FF40;
 3   stroke: white;
 4   stroke-width: 2;
 5   label: [name];
 6   font-family: Arial;
 7   font-size: 11px;
 8   font-style: normal;
 9   font-weight: bold;
10   font-fill: black;
11   label-anchor: 0.5 0.5;
12   label-auto-wrap: 60;
13   label-max-displacement: 150;
14 }

Details¶

This example is similar to the Polygon with default label example, with additional styling options for the labels.

The font is setup to be Arial, 11 pixels, “normal” (as opposed to “italic”) and bold.

The “label-anchor” affects where the label is placed relative to the centroid of the polygon, centering the label by positioning it 50% (or 0.5) of the way horizontally along the centroid of the polygon, as well as vertically in exactly the same way.

Finally, there are two added touches for label placement optimization: The “label-auto-wrap” attribute ensures that long labels are split across multiple lines by setting line wrapping on the labels to 60 pixels, whilst the “label-max-displacement” allows the label to be displaced by up to 150 pixels. This ensures that labels are compacted and less likely to spill over polygon boundaries. Notice little Massive County in the corner, whose label is now displayed.

Code¶

 1 [parseLong(pop) < 200000] {
 2   fill: #66FF66;
 3 }
 4
 5 [parseLong(pop) >= 200000] [parseLong(pop) < 500000] {
 6   fill: #33CC33;
 7 }
 8
 9 [parseLong(pop) >= 500000] {
10   fill: #009900;
11 }

Details¶

Each polygon in our fictional country has a population that is represented by the population (“pop”) attribute. This style contains three rules that alter the fill based on the value of “pop” attribute, with smaller values yielding a lighter color and larger values yielding a darker color.

The three rules are designed as follows:

The order of the rules does not matter in this case, since each shape is only rendered by a single rule.

The first rule fills light green all polygons whose “pop” attribute is below 200,000, the second paints medium green all poygons whose “pop” attribute is between 200,000 and 500,000, while the third rule paints dark green the remaining polygons.

What’s interesting in the filters is the use of the “parseLong” filter function: this function is necessary because the “pop” attribute is a string, leaving it as is we would have a string comparison, whilst the function turns it into a number, ensuring proper numeric comparisons instead.

Code¶

 1 * {
 2   fill: #0000CC;
 3   stroke: black;
 4 }
 5
 6 [@sd < 100M] {
 7    stroke-width: 7;
 8    label: [name];
 9    label-anchor: 0.5 0.5;
10    font-fill: white;
11    font-family: Arial;
12    font-size: 14;
13    font-weight: bold;
14 }
15
16 [@sd > 100M] [@sd < 200M] {
17    stroke-width: 4;
18 }
19
20 [@sd > 200M] {
21    stroke-width: 1;
22 }

Details¶

It is often desirable to make shapes larger at higher zoom levels when creating a natural-looking map. This example varies the thickness of the lines according to the zoom level. Polygons already do this by nature of being two dimensional, but another way to adjust styling of polygons based on zoom level is to adjust the thickness of the stroke (to be larger as the map is zoomed in) or to limit labels to only certain zoom levels. This is ensures that the size and quantity of strokes and labels remains legible and doesn’t overshadow the polygons themselves.

Zoom levels (or more accurately, scale denominators) refer to the scale of the map. A scale denominator of 10,000 means the map has a scale of 1:10,000 in the units of the map projection.

This style contains three rules, defined as follows:

The first rule (lines 1-4) defines the attributes that are not scale dependent: dark blue fill, black outline.

The second (lines 6-14) rule provides specific overrides for the higher zoom levels, asking for a large stroke (7 pixels) and a label, which is only visible at this zoom level. The label is white, bold, Arial 14 pixels, its contents are coming form the “name” attribute.

The third rule (lines 16-18) specifies a stroke width of 4 pixels for medium zoom levels, whilst for low zoom levels the stroke width is set to 1 pixel by the last rule (lines 20-22).

The resulting style produces a polygon stroke that gets larger as one zooms in and labels that only display when zoomed in to a sufficient level.