ggsvelte
GitHub
Navigate
On this page

ScaleColourOrdinal

Explicit ordinal color scale (categories → colors). British Colour spelling — same binding as ScaleColorOrdinal.

Default scheme "observable10"

Defaults

helper
scaleColourOrdinal
family
color-fill
aesthetic
color
scale type
ordinal
options type
OrdinalColorScaleOptions

Alias

This component re-exports ScaleColorOrdinal (same binding). Prefer the canonical spelling in new code.

Svelte component

import { GGPlot, GeomPoint, ScaleColourOrdinal } from "@ggsvelte/svelte";

<GGPlot data={rows} aes={{ x: "x", y: "y", color: "group" }}>
  <ScaleColourOrdinal />
  <GeomPoint />
</GGPlot>

JSON scales

{
  "scales": {
    "color": {
      "type": "ordinal"
    }
  }
}

Params

domain

Array<DomainValue>

Explicit semantic domain. Manual/ordinal scales use ordered values; sequential/binned scales use [min, max].

domainMode

"grow" | "data"

Ordinal domain stability: "grow" (default) preserves assignments across filters; "data" rebuilds from current data.

range

Array<string>

Explicit #rgb/#rrggbb colors. Manual pairs them with domain values; sequential/binned interpolate or sample them.

scheme

"observable10" | "ipsum" | "flexoki" | "tableau10" | "colorblind" | "stata" | "stata_s1color" | "stata_s1rcolor" | "stata_mono" | "economist" | "solarized" | "few" | "few_light" | "few_dark" | "fivethirtyeight" | "ptol" | "canva" | "wsj" | "wsj_rgby" | "wsj_red_green" | "wsj_black_green" | "wsj_dem_rep" | "tableau20" | "tableau_colorblind" | "tableau_seattle_grays" | "tableau_miller_stone" | "tableau_superfishel_stone" | "tableau_nuriel_stone" | "tableau_jewel_bright" | "tableau_summer" | "tableau_winter" | "tableau_green_orange_teal" | "tableau_red_blue_brown" | "tableau_purple_pink_gray" | "tableau_hue_circle" | "gdocs" | "hc" | "hc_dark" | "pander" | "calc" | "excel" | "excel_fill" | "excel_new" | "Dark2" | "Paired" | "Accent" | "hue" | "grey" | "gray" | "viridis" | "magma" | "plasma" | "inferno" | "cividis" | "turbo" | "Blues" | "Greens" | "Reds" | "Oranges" | "Purples" | "Greys" | "YlOrRd" | "YlGnBu" | "BuPu" | "RdYlBu" | "RdBu" | "BrBG" | "Spectral" | "PuOr" | "tableau_seq_blue_green" | "tableau_seq_blue_light" | "tableau_seq_orange_light" | "tableau_seq_blue" | "tableau_seq_orange" | "tableau_seq_green" | "tableau_seq_red" | "tableau_seq_purple" | "tableau_seq_brown" | "tableau_seq_gray" | "tableau_seq_gray_warm" | "tableau_seq_blue_teal" | "tableau_seq_orange_gold" | "tableau_seq_green_gold" | "tableau_seq_red_gold" | "tableau_div_orange_blue" | "tableau_div_red_green" | "tableau_div_green_blue" | "tableau_div_red_blue" | "tableau_div_red_black" | "tableau_div_gold_purple" | "tableau_div_red_green_gold" | "tableau_div_sunset_sunrise" | "tableau_div_orange_blue_white" | "tableau_div_red_green_white" | "tableau_div_green_blue_white" | "tableau_div_red_blue_white" | "tableau_div_red_black_white" | "tableau_div_orange_blue_light" | "tableau_div_temperature"

Named color scheme: categorical "observable10" (default), "ipsum", "flexoki", "tableau10", "colorblind", "hue", "grey", "gray", and ColorBrewer qualitative (Dark2/Paired/Accent); or sequential family "viridis" (default), "magma", "plasma", "inferno", "cividis", "turbo", plus ColorBrewer sequential/diverging (Blues, RdYlBu, …). Sequential-family names may also be used with ordinal scales (discrete sampling). When type is omitted, the named scheme selects its ordinal or sequential scale family.

reverse

boolean

Reverse the output color range. Default false.

naValue

string

Color for null/missing values. Default9.

unknownValue

string

Color for invalid, out-of-domain, or unmapped values. Default9.

onExhaust

"cycle" | "error"

Ordinal palette exhaustion policy: "cycle" (default) with a warning, or "error".

guide

GuideSpec

Guide presentation override (legend, colorbar, colorsteps, or none).

Guide interaction

Legend guide for discrete/manual/identity color. Set guide: "none" to hide.

Examples

← All scales · Palettes · Scales and guides

Docs