On this page
Scales
Every public Scale* component: position, color/fill, and style
channels. Props match the fluent helpers on @ggsvelte/spec and
the PortableSpec scales object. For palette specimens, see Palettes; for guide behavior, see Scales and guides.
100 scales (100 primary components; search also matches Colour/Ordinal aliases)
Position — continuous
ScaleXContinuousContinuous linear x position scale (default numeric family).ScaleXLog10Base-10 log x position scale (pre-stat log10 transform on a linear scale).ScaleXReverseContinuous x position scale with reverse: true (output direction flipped).ScaleXSqrtSquare-root x position scale (pre-stat sqrt transform on a linear scale).ScaleYContinuousContinuous linear y position scale (default numeric family).ScaleYLog10Base-10 log y position scale (pre-stat log10 transform on a linear scale).ScaleYReverseContinuous y position scale with reverse: true (output direction flipped).ScaleYSqrtSquare-root y position scale (pre-stat sqrt transform on a linear scale).
Position — binned
ScaleXBinnedBinned x position scale: quantitative values map to ordered bins (breaks are bin boundaries).ScaleYBinnedBinned y position scale: quantitative values map to ordered bins (breaks are bin boundaries).
Position — temporal
ScaleXDateTemporal x position scale (date).ScaleXDatetimeTemporal x position scale (datetime).ScaleXMonthDayTemporal x position scale (month-day (year collapsed)).ScaleXTimeTemporal x position scale (time-of-day).ScaleYDateTemporal y position scale (date).ScaleYDatetimeTemporal y position scale (datetime).ScaleYMonthDayTemporal y position scale (month-day (year collapsed)).ScaleYTimeTemporal y position scale (time-of-day).
Position — discrete
ScaleXDiscreteDiscrete (band) x position scale for categories.ScaleYDiscreteDiscrete (band) y position scale for categories.
Color and fill
ScaleColorBinnedBinned color scale: continuous values → ordered color steps.ScaleColorBrewerColorBrewer qualitative color scale (discrete categories).ScaleColorContinuousContinuous sequential color scale (default continuous color family).ScaleColorDateSequential color scale trained on calendar dates.ScaleColorDatetimeSequential color scale trained on datetime values.ScaleColorDiscreteDiscrete color scale for categorical data (default ordinal family).ScaleColorDistillerColorBrewer sequential/diverging color ramp (distiller).ScaleColorFermenterColorBrewer binned color steps (fermenter).ScaleColorGradientTwo-stop continuous color gradient (low/high).ScaleColorGradient2Three-stop diverging continuous color gradient (low/mid/high).ScaleColorGradientnN-stop continuous color gradient from an ordered color list.ScaleColorGreyGrey ramp color palette for discrete categories.ScaleColorHueEvenly spaced hue color palette for discrete categories.ScaleColorIdentityIdentity color scale: source values are validated #rgb/#rrggbb colors used as-is.ScaleColorLog10Sequential color scale with log10 pre-training transform.ScaleColorManualManual color mapping: domain values paired with explicit colors.ScaleColorOrdinalExplicit ordinal color scale (categories → colors).ScaleColorSqrtSequential color scale with sqrt pre-training transform.ScaleColorStepsTwo-stop binned color steps (low/high).ScaleColorSteps2Three-stop diverging binned color steps (low/mid/high).ScaleColorStepsnN-stop binned color steps from an ordered color list.ScaleColorViridisBViridis-family color scale — binned (viridis_b).ScaleColorViridisCViridis-family color scale — continuous (viridis_c).ScaleColorViridisDViridis-family color scale — discrete (viridis_d).ScaleFillBinnedBinned fill scale: continuous values → ordered color steps.ScaleFillBrewerColorBrewer qualitative fill scale (discrete categories).ScaleFillContinuousContinuous sequential fill scale (default continuous color family).ScaleFillDateSequential fill scale trained on calendar dates.ScaleFillDatetimeSequential fill scale trained on datetime values.ScaleFillDiscreteDiscrete fill scale for categorical data (default ordinal family).ScaleFillDistillerColorBrewer sequential/diverging fill ramp (distiller).ScaleFillFermenterColorBrewer binned fill steps (fermenter).ScaleFillGradientTwo-stop continuous fill gradient (low/high).ScaleFillGradient2Three-stop diverging continuous fill gradient (low/mid/high).ScaleFillGradientnN-stop continuous fill gradient from an ordered color list.ScaleFillGreyGrey ramp fill palette for discrete categories.ScaleFillHueEvenly spaced hue fill palette for discrete categories.ScaleFillIdentityIdentity fill scale: source values are validated #rgb/#rrggbb colors used as-is.ScaleFillLog10Sequential fill scale with log10 pre-training transform.ScaleFillManualManual fill mapping: domain values paired with explicit colors.ScaleFillOrdinalExplicit ordinal fill scale (categories → colors).ScaleFillSqrtSequential fill scale with sqrt pre-training transform.ScaleFillStepsTwo-stop binned fill steps (low/high).ScaleFillSteps2Three-stop diverging binned fill steps (low/mid/high).ScaleFillStepsnN-stop binned fill steps from an ordered color list.ScaleFillViridisBViridis-family fill scale — binned (viridis_b).ScaleFillViridisCViridis-family fill scale — continuous (viridis_c).ScaleFillViridisDViridis-family fill scale — discrete (viridis_d).
Size, linewidth, and alpha
ScaleAlphaBinnedBinned alpha scale: continuous values → stepped numeric style.ScaleAlphaContinuousContinuous sequential alpha scale.ScaleAlphaDateSequential alpha scale trained on calendar dates.ScaleAlphaDatetimeSequential alpha scale trained on datetime values.ScaleAlphaDiscreteDiscrete alpha scale for categories (ordinal).ScaleAlphaIdentityIdentity alpha scale: source numbers used as mapped style values.ScaleAlphaManualManual alpha mapping: domain values paired with explicit numbers.ScaleLinewidthBinnedBinned linewidth scale: continuous values → stepped numeric style.ScaleLinewidthContinuousContinuous sequential linewidth scale.ScaleLinewidthDateSequential linewidth scale trained on calendar dates.ScaleLinewidthDatetimeSequential linewidth scale trained on datetime values.ScaleLinewidthDiscreteDiscrete linewidth scale for categories (ordinal).ScaleLinewidthIdentityIdentity linewidth scale: source numbers used as mapped style values.ScaleLinewidthManualManual linewidth mapping: domain values paired with explicit numbers.ScaleRadiusContinuous size scale with radius (linear) mapping instead of area.ScaleSizeAreaContinuous size scale with area mapping (zero maps to zero area).ScaleSizeBinnedBinned size scale: continuous values → stepped numeric style.ScaleSizeBinnedAreaBinned size scale with area mapping (zero maps to zero area).ScaleSizeContinuousContinuous sequential size scale.ScaleSizeDateSequential size scale trained on calendar dates.ScaleSizeDatetimeSequential size scale trained on datetime values.ScaleSizeDiscreteDiscrete size scale for categories (ordinal).ScaleSizeIdentityIdentity size scale: source numbers used as mapped style values.ScaleSizeManualManual size mapping: domain values paired with explicit numbers.
Shape and linetype
ScaleLinetypeBinnedBinned linetype scale: continuous values → finite named symbols.ScaleLinetypeDiscreteDiscrete linetype scale for categories (named symbols).ScaleLinetypeIdentityIdentity linetype scale: source names used as mapped symbols.ScaleLinetypeManualManual linetype mapping: domain values paired with named symbols.ScaleShapeBinnedBinned shape scale: continuous values → finite named symbols.ScaleShapeDiscreteDiscrete shape scale for categories (named symbols).ScaleShapeIdentityIdentity shape scale: source names used as mapped symbols.ScaleShapeManualManual shape mapping: domain values paired with named symbols.
How to set a scale
Nest a Scale* child under GGPlot, call the
matching fluent helper on a builder, or write the PortableSpec scales object. Channels not configured are inferred from data.
import {
GGPlot,
GeomPoint,
ScaleColorContinuous,
ScaleXContinuous,
} from "@ggsvelte/svelte";
<GGPlot data={rows} aes={{ x: "year", y: "value", color: "temp" }}>
<ScaleXContinuous labels="d" />
<ScaleColorContinuous scheme="viridis" />
<GeomPoint />
</GGPlot>