Skip to content

Legend

Examples for the ss-c-legend module: series keys for charts and maps. Set each swatch's colour with --ss-legend-color. Swatches are decorative; the label carries the meaning.

Swatch shapes

  • Bar
  • Line
  • Forecast
  • Point
  • Area
HTML
<ul class="ss-c-legend" aria-label="Legend">
            <li class="ss-c-legend__item"><span class="ss-c-legend__swatch" style="--ss-legend-color: var(--ss-color-accent)" aria-hidden="true"></span>Bar</li>
            <li class="ss-c-legend__item"><span class="ss-c-legend__swatch ss-c-legend__swatch--line" style="--ss-legend-color: var(--ss-color-success)" aria-hidden="true"></span>Line</li>
            <li class="ss-c-legend__item"><span class="ss-c-legend__swatch ss-c-legend__swatch--dashed" style="--ss-legend-color: var(--ss-color-warning)" aria-hidden="true"></span>Forecast</li>
            <li class="ss-c-legend__item"><span class="ss-c-legend__swatch ss-c-legend__swatch--point" style="--ss-legend-color: var(--ss-color-error)" aria-hidden="true"></span>Point</li>
            <li class="ss-c-legend__item"><span class="ss-c-legend__swatch ss-c-legend__swatch--area" style="--ss-legend-color: var(--ss-color-info)" aria-hidden="true"></span>Area</li>
        </ul>

Vertical with values

Land use

  • Green space38%
  • Residential27%
  • Water21%
  • Other14%
HTML
<div style="max-width: 16rem">
            <p class="ss-c-legend__title" id="land-use">Land use</p>
            <ul class="ss-c-legend ss-c-legend--vertical" aria-labelledby="land-use">
                <li class="ss-c-legend__item"><span class="ss-c-legend__swatch ss-c-legend__swatch--area" style="--ss-legend-color: var(--ss-color-success)" aria-hidden="true"></span>Green space<span class="ss-c-legend__value">38%</span></li>
                <li class="ss-c-legend__item"><span class="ss-c-legend__swatch ss-c-legend__swatch--area" style="--ss-legend-color: var(--ss-color-warning)" aria-hidden="true"></span>Residential<span class="ss-c-legend__value">27%</span></li>
                <li class="ss-c-legend__item"><span class="ss-c-legend__swatch ss-c-legend__swatch--area" style="--ss-legend-color: var(--ss-color-info)" aria-hidden="true"></span>Water<span class="ss-c-legend__value">21%</span></li>
                <li class="ss-c-legend__item"><span class="ss-c-legend__swatch ss-c-legend__swatch--area" style="--ss-legend-color: var(--ss-color-muted)" aria-hidden="true"></span>Other<span class="ss-c-legend__value">14%</span></li>
            </ul>
        </div>

Interactive toggles

HTML
<ul class="ss-c-legend" aria-label="Series">
            <li><button type="button" class="ss-c-legend__toggle" aria-pressed="true"><span class="ss-c-legend__swatch ss-c-legend__swatch--line" style="--ss-legend-color: var(--ss-color-accent)" aria-hidden="true"></span>Temperature</button></li>
            <li><button type="button" class="ss-c-legend__toggle" aria-pressed="false"><span class="ss-c-legend__swatch ss-c-legend__swatch--line" style="--ss-legend-color: var(--ss-color-success)" aria-hidden="true"></span>Humidity</button></li>
            <li><button type="button" class="ss-c-legend__toggle" aria-pressed="true"><span class="ss-c-legend__swatch ss-c-legend__swatch--point" style="--ss-legend-color: var(--ss-color-error)" aria-hidden="true"></span>Alerts</button></li>
        </ul>