Components Chart
map
A world-countries (or US-states) basemap that fills regions by value (choropleth) or category (highlight) so the audience leaves knowing where.
Use when the story is geographic — program reach, service territories, where the grants landed, the regions you operate in. Author a value per named region (full name, postal/ISO code, or a common alias); choropleth shades each region on a single-hue ramp (low→high), while highlight gives each named region its own categorical colour. The default basemap is the world (Equal Earth projection); add us (or usa) for the US-states map. On the world map you can also name a continent, a bloc (European Union, ASEAN), or a stated category (Global South, Global North, Global South — Africa) and the kernel fills every member. Because the term is contested, two sourced views of the Global South ship: Global South (G77 + China) and Global South — Brandt Line (the 1980 North–South divide) — pick the framing your deck argues. Regions the basemap can't match are reported in the legend, never silently dropped.
When to use
- The story is geographic. Reach for a map only when WHERE is the point — coverage areas, jurisdictions, service territories, where the grants or pilots landed. If the geography is incidental and the comparison is really between named things, a
progressorstatsrow reads faster than a basemap. - Choropleth for magnitude, highlight for membership. Use the default choropleth when each region carries a number and the audience needs the gradient — how much, where. Use
highlightwhen the named regions are a set (the eight pilot states, the four regions we serve) and there is no magnitude to rank. - Name regions any common way. Country names resolve by full name, ISO code, or common alias (
Brazil/BR/Burma→Myanmar); onmap us, by full name, postal code, or abbreviation (California/CA/Calif.). A name the basemap can't bind is reported as a muted ‘?’ row in the legend and stamped on the figure — fix the spelling, don't ignore the gap.
When not to use
- A map as decoration. If the regions aren't the comparison — you just want a US-shaped graphic behind some numbers — drop the basemap. An
imagescrim or astatsrow carries headline figures without implying the geography is the message. - Too many shades to read. A choropleth past a dozen distinct values asks the eye to rank colours it can't separate. Bucket the values, switch to
highlightfor a categorical read, or lead with aprogressranking and keep the map as support. - Sub-region precision the basemap doesn't have. The basemaps draw US states and world countries — not counties, districts, sub-national regions, or city pins, and the world cut (110m) omits the smallest city-states. If the story lives below that line, a labelled
imageof the real map serves better than forcing it onto the basemap.
Slots
| Slot | Selector | Required | Description |
|---|---|---|---|
title | h2 | yes | Slide heading — name the geography and the takeaway (‘Where the program runs’). |
regions | ul > li | yes | One li per region (or group). Lead with the name — world (default): full (Brazil), ISO (BR), alias (Burma), or a group (European Union, Sub-Saharan Africa, Global South) that expands to its members; US (map us): full (California), postal (CA), or abbreviation (Calif.) — then a trailing inline-code value: Brazil \4.2\``. In choropleth the value drives the ramp; in highlight it's an optional legend label. Names the basemap can't resolve surface as muted ‘?’ legend rows. |
Variants
us — us
Swaps the default world map for the US-states basemap (d3.geoAlbersUsa, AK/HI insets) — map us (alias map usa). Same authoring and read modes; names resolve by full name, postal code, or abbreviation (California / CA / Calif.).
<!-- _class: map us -->
## Grant dollars by state — unevenly.
- California `48.2`
- Texas `36.4`
- New York `31.0`
- Florida `27.5`
- Illinois `19.3`
- Ohio `14.1`
- Georgia `11.8`
- Washington `9.6` highlight — highlight
Categorical mode — each named region takes its own --catN colour and unnamed regions stay neutral. For ‘which ones’, not ‘how much’. Works on either basemap.
<!-- _class: map highlight -->
## The regions we serve.
- Kenya `East Africa`
- Nigeria `West Africa`
- India `South Asia`
- Brazil `Latin America` robinson — robinson
Swaps the default Equal Earth projection for Robinson — the familiar boardroom compromise. Same authoring; only the world map's shape changes. Equal Earth (default) preserves relative area; Robinson trades a little area fidelity for the silhouette many audiences expect.
<!-- _class: map robinson -->
## Where our field offices operate.
- United States `42`
- Brazil `31`
- Nigeria `27`
- Kenya `24`
- India `38`
- Indonesia `19`
- Germany `22`
- Australia `12` grouped — grouped
Naming a continent or bloc fills every member; grouped clusters the legend by continent. For coverage told at bloc scale.
<!-- _class: map highlight grouped -->
## Coverage by economic bloc.
- European Union `Tier 1`
- ASEAN `Tier 1`
- Sub-Saharan Africa `Tier 2`
- Latin America `Tier 2`