ggsvelte
GitHub
Navigate
On this page

ScaleXDiscrete

Discrete (band) x position scale for categories.

Defaults

helper
scaleXDiscrete
family
position-discrete
aesthetic
x
scale type
band
options type
DiscretePositionScaleOptions

Svelte component

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

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

JSON scales

{
  "scales": {
    "x": {
      "type": "band"
    }
  }
}

Params

domain

Array<DomainValue>

Explicit domain, PINNING the scale: [min, max] for continuous scales (numbers, or temporal strings for time); the full category list for band scales. Data outside the domain is dropped with a warning.

reverse

boolean

Reverse the scale's output direction. Default false.

breaks

Array<number | string>

Explicit tick positions in data units (numbers, or ISO date strings for time scales); for binned scales these are the bin boundaries. Omit for automatic ticks. Binned scales allow at most 65 boundaries (64 bins); non-binned explicit ticks are not capped.

labels

string

Tick label format string. Time scales: strftime-style ("%Y-%m", "%b %d", "%H:%M"). Numeric scales: ",d" (grouped integer), ".1f" (fixed decimals), ".0%" (percent), "~s" (SI prefix). Omit for automatic formatting.

expand

ScaleExpansion

Display-domain padding. Non-temporal continuous/binned axes default to { mult: 0.05, add: 0 }; time axes default to zero. Pinned domains still receive display expansion.

naValue

number | unknown

Replacement for missing/censored positional values, resolved after OOB and before transform. A finite number substitutes; null (default) keeps them missing. The replacement is itself checked against the transform/domain rules.

guide

GuideSpec | BandAxisGuideSpec

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

Guide interaction

Axis guide on the position channel (band axis guide when type is band). Set guide to customize ticks/labels or guide: "none" to hide.

Examples

← All scales · Palettes · Scales and guides

Docs