Palettes

Named color schemes are scale inputs, not themes. Pass a scheme name into a color or fill scale child to encode data series. Chart paper and axes stay on themes.

Swatches and ramps for every scheme live on the Palettes showcase.

Using schemes

Categorical names pair with discrete / ordinal scales. Sequential names pair with continuous, binned, or discrete-sampled viridis shells. A scheme from the wrong family is a validation error (scale-scheme-type).

<script lang="ts">
  import {
    GeomPoint,
    GGPlot,
    ScaleColorDiscrete,
  } from "@ggsvelte/svelte";

  const rows = [
    { x: 1, y: 2, species: "a" },
    { x: 2, y: 4, species: "b" },
  ];
</script>

<GGPlot data={rows} aes={{ x: "x", y: "y", color: "species" }}>
  <ScaleColorDiscrete scheme="tableau10" />
  <GeomPoint />
</GGPlot>

<ScaleColorContinuous scheme="viridis" />
<!-- or family shell: -->
<ScaleColorViridisC option="magma" />

Scale helpers

Discrete (categorical schemes)

Pass scheme="tableau10" (or another categorical name) on discrete/ordinal shells. Brewer, hue, and grey set the scheme by construction.

• <ScaleColorDiscrete />
• <ScaleFillDiscrete />
• <ScaleColorOrdinal />
• <ScaleFillOrdinal />
• <ScaleColorBrewer />
• <ScaleFillBrewer />
• <ScaleColorHue />
• <ScaleFillHue />
• <ScaleColorGrey />
• <ScaleFillGrey />
• <ScaleColorManual />
• <ScaleFillManual />

Continuous and binned (sequential schemes)

Pass scheme="viridis" (or another sequential name) on continuous/binned shells. Gradient* helpers take explicit color stops instead of a name.

• <ScaleColorContinuous />
• <ScaleFillContinuous />
• <ScaleColorBinned />
• <ScaleFillBinned />
• <ScaleColorViridisC />
• <ScaleColorViridisD />
• <ScaleColorViridisB />
• <ScaleColorDistiller />
• <ScaleColorFermenter />
• <ScaleColorGradient />
• <ScaleColorGradient2 />
• <ScaleColorGradientn />

British Colour aliases export the same components (ScaleColourDiscrete, …). Snake_case builder helpers (scale_color_discrete) accept the same options.

Categorical schemes

Use with ScaleColorDiscrete, ScaleFillDiscrete, ordinal shells, or family-specific helpers. Default when unset: observable10.

Sequential schemes

Use with continuous / binned color scales, viridis family shells, ColorBrewer distiller/fermenter, or discrete sampling of a viridis ramp (ScaleColorViridisD).

See also

• Palettes showcase — swatches and sequential lab
• Themes reference — paper, ink, and interaction chrome
• Scales and guides — channels, exhaustion, and guide presentation
• palette-exhausted — when a discrete domain outruns the finite palette