Published-release documentation · release compatibility

Action Reference

Every direct action accepts one option object and returns a new immutable ChartProgram. Choose a task family for readable behavior, defaults, inference, and errors; use the exact lookup when you already know the action name. H0–H4 are catalog role tags, not grammar levels or trace depths. An action’s relative hierarchy comes from the smaller actions it composes. The API-layer labels user-facing, advanced, and primitive independently describe exposure.

Charts, Data, and Composition ActionsCreate complete charts, manage data, select marks, and compose complete programs. Mark ActionsCreate, edit, jitter, and remove semantic chart marks. Encoding ActionsMap fields and constants to position, grouping, color, shape, size, and appearance. Statistical Layer ActionsCreate and edit regression, density, interval, error, and box-plot layers. Guide, Axis, Grid, and Title ActionsCreate, edit, and remove axes, grids, legends, and chart titles. Advanced chart actionsAtomic channel changes and reusable mark selections. Extension actionsWrapped actions and public authoring primitives. Program and rendering functionsPackage functions, renderers, and internal trace boundaries. Exact TypeScript contractThe complete generated `ChartProgram` action interface.

Exact action lookup

Use document search with Ctrl+K, or filter the alphabetical list by action name, API layer, or domain. Each action has one canonical family entry.

Action Authoring role API layer Domain
applyTextMetrics H3 user-facing core
applyTheme H3 user-facing core
bindMarkData H2 user-facing core
createAnnotation H1, H2 user-facing marks
createArcMark H2 user-facing marks
createAreaMark H2 user-facing marks
createAreaPlot H0 user-facing charts
createAxes H3 user-facing axes
createBarMark H2 user-facing marks
createBarPlot H0 user-facing charts
createBeeswarmPlot H0 user-facing charts
createBin2DData H2 user-facing core
createBinData H1 user-facing statistics
createBoxPlot H0, H1 user-facing statistics
createCanvas H3 user-facing core
createCompleteData H1 user-facing statistics
createComputedData H1 user-facing statistics
createCoordinate H2 user-facing core
createData H2 user-facing core
createDensityData H2 user-facing core
createDensityPlot H0, H1 user-facing statistics
createDerivedData H2 user-facing core
createDotPlot H0, H1 user-facing charts
createDumbbellPlot H0, H1 user-facing charts
createECDFData H1 user-facing statistics
createECDFPlot H0, H1 user-facing charts
createErrorBand H1 user-facing statistics
createErrorBar H1 user-facing statistics
createFlattenData H1 user-facing statistics
createFoldData H1 user-facing statistics
createGradientPlot H0, H1 user-facing statistics
createGraphics H4 primitive primitives
createGrid H3 user-facing grid
createGuides H3 user-facing legend_and_title
createHeatmap H0 user-facing charts
createHistogram H0, H1 user-facing charts
createHorizonPlot H0, H1 user-facing statistics
createHorizontalGrid H3 user-facing grid
createImputedData H1 user-facing statistics
createIntervalData H1 user-facing statistics
createIntervalPlot H0, H1 user-facing charts
createLegend H3 user-facing legend_and_title
createLineMark H2 user-facing marks
createLinePlot H0 user-facing charts
createLollipopPlot H0, H1 user-facing charts
createLookupData H1 user-facing statistics
createMarkLabels H1, H2 user-facing marks
createNormalizedData H1 user-facing statistics
createParallelAxes H3 user-facing axes
createParallelAxis H3 user-facing axes
createParallelCoordinates H0 user-facing charts
createPiePlot H0 user-facing charts
createPointMark H2 user-facing marks
createPolarLinePlot H0 user-facing charts
createPolarScatterPlot H0 user-facing charts
createRadarPlot H0 user-facing charts
createRadialAxis H3 user-facing axes
createRadialAxisLabels H3 user-facing axes
createRadialAxisLine H3 user-facing axes
createRadialAxisTicks H3 user-facing axes
createRadialAxisTitle H3 user-facing axes
createRadialBarPlot H0 user-facing charts
createRadialGrid H3 user-facing grid
createRaincloudPlot H0, H1 user-facing charts
createRectMark H2 user-facing marks
createReferenceBand H1, H2 user-facing marks
createReferenceLine H1, H2 user-facing marks
createRegression H1 user-facing statistics
createRegressionBand H1 user-facing statistics
createRegressionData H2 user-facing core
createRegressionLine H1 user-facing statistics
createRegressionPlot H0, H1 user-facing charts
createRegressionStatisticsData H2 user-facing core
createRosePlot H0 user-facing charts
createRugPlot H0 user-facing charts
createRuleMark H2 user-facing marks
createScale H2 user-facing core
createScatterPlot H0 user-facing charts
createSortedData H1 user-facing statistics
createStackData H1 user-facing statistics
createStatisticalReference H1, H2 user-facing marks
createStripPlot H0 user-facing charts
createSummaryData H1 user-facing statistics
createTextMark H2 user-facing marks
createTextPlot H0 user-facing charts
createThetaAxis H3 user-facing axes
createThetaAxisLabels H3 user-facing axes
createThetaAxisLine H3 user-facing axes
createThetaAxisTicks H3 user-facing axes
createThetaAxisTitle H3 user-facing axes
createThetaGrid H3 user-facing grid
createTickMark H2 user-facing marks
createTimeUnitData H2 user-facing core
createTitle H3 user-facing legend_and_title
createVerticalGrid H3 user-facing grid
createViolinPlot H0, H1 user-facing statistics
createWindowData H2 user-facing core
createXAxis H3 user-facing axes
createXAxisLabels H3 user-facing axes
createXAxisLine H3 user-facing axes
createXAxisTicks H3 user-facing axes
createXAxisTicksAndLabels H3 user-facing axes
createXAxisTitle H3 user-facing axes
createYAxis H3 user-facing axes
createYAxisLabels H3 user-facing axes
createYAxisLine H3 user-facing axes
createYAxisTicks H3 user-facing axes
createYAxisTicksAndLabels H3 user-facing axes
createYAxisTitle H3 user-facing axes
editArcMark H3 user-facing marks
editAreaMark H3 user-facing marks
editAxes H3 user-facing axes
editBarMark H3 user-facing marks
editBin2DData H2 user-facing core
editBinData H1, H3 user-facing statistics
editBoxPlot H1, H3 user-facing statistics
editCanvas H3 user-facing core
editColorScale H2 user-facing core
editCompleteData H1, H3 user-facing statistics
editCompositionLayout H3 user-facing composition
editComputedData H1, H3 user-facing statistics
editCoordinate H2 user-facing core
editDensity H2, H3 user-facing encodings
editDensityData H2 user-facing core
editDerivedData H2 user-facing core
editECDFData H1, H3 user-facing statistics
editECDFPlot H1, H3 user-facing charts
editEndpointPlot H1, H3 user-facing charts
editErrorBand H1, H3 user-facing statistics
editErrorBandBoundary H1, H3 user-facing statistics
editErrorBar H1, H3 user-facing statistics
editFacetGuides H3 user-facing composition
editFacetHeaders H3 user-facing composition
editFacetScales H3 user-facing composition
editFacetSource H3 user-facing composition
editFilteredData H2 user-facing core
editFlattenData H1, H3 user-facing statistics
editFoldData H1, H3 user-facing statistics
editGradientPlot H1, H3 user-facing statistics
editGraphics H4 primitive primitives
editGrid H3 user-facing grid
editHorizon H2, H3 user-facing encodings
editHorizontalGrid H3 user-facing grid
editImputedData H1, H3 user-facing statistics
editIntervalData H1, H3 user-facing statistics
editLegend H3 user-facing legend_and_title
editLegendBlock H3 user-facing legend_and_title
editLegendBorder H3 user-facing legend_and_title
editLegendLabels H3 user-facing legend_and_title
editLegendLayout H3 user-facing legend_and_title
editLegendSymbols H3 user-facing legend_and_title
editLegendTitle H3 user-facing legend_and_title
editLineMark H3 user-facing marks
editLookupData H1, H3 user-facing statistics
editMarkLabelPlacement H3 user-facing marks
editMarkLabelSelection H3 user-facing marks
editMarkSelection H3 advanced mark-selection
editNormalizedData H1, H3 user-facing statistics
editOpacityScale H2 user-facing core
editParallelAxis H3 user-facing axes
editParallelScale H2 user-facing core
editPointMark H3 user-facing marks
editRadarPlot H1, H3 user-facing charts
editRadialAxis H3 user-facing axes
editRadialAxisLabels H3 user-facing axes
editRadialAxisLine H3 user-facing axes
editRadialAxisTicks H3 user-facing axes
editRadialAxisTitle H3 user-facing axes
editRadialGrid H3 user-facing grid
editRaincloudPlot H1, H3 user-facing charts
editRectMark H3 user-facing marks
editRegression H1, H3 user-facing statistics
editRegressionBand H1, H3 user-facing statistics
editRegressionData H2 user-facing core
editRegressionLine H1, H3 user-facing statistics
editRegressionStatisticsData H2 user-facing core
editRScale H2 user-facing core
editRuleMark H3 user-facing marks
editScale H2 user-facing core
editSemantic H4 primitive primitives
editShapeScale H2 user-facing core
editSizeScale H2 user-facing core
editSortedData H1, H3 user-facing statistics
editStackData H1, H3 user-facing statistics
editStrokeDashScale H2 user-facing core
editStrokeScale H2 user-facing core
editStrokeWidthScale H2 user-facing core
editSummaryData H1, H3 user-facing statistics
editTextMark H3 user-facing marks
editThetaAxis H3 user-facing axes
editThetaAxisLabels H3 user-facing axes
editThetaAxisLine H3 user-facing axes
editThetaAxisTicks H3 user-facing axes
editThetaAxisTitle H3 user-facing axes
editThetaGrid H3 user-facing grid
editThetaScale H2 user-facing core
editTickMark H3 user-facing marks
editTimeUnitData H2 user-facing core
editTitle H3 user-facing legend_and_title
editVerticalGrid H3 user-facing grid
editViolinPlot H1, H3 user-facing statistics
editWindowData H2 user-facing core
editXAxis H3 user-facing axes
editXAxisLabels H3 user-facing axes
editXAxisLine H3 user-facing axes
editXAxisTicks H3 user-facing axes
editXAxisTicksAndLabels H3 user-facing axes
editXAxisTitle H3 user-facing axes
editXOffsetScale H2 user-facing core
editXScale H2 user-facing core
editYAxis H3 user-facing axes
editYAxisLabels H3 user-facing axes
editYAxisLine H3 user-facing axes
editYAxisTicks H3 user-facing axes
editYAxisTicksAndLabels H3 user-facing axes
editYAxisTitle H3 user-facing axes
editYOffsetScale H2 user-facing core
editYScale H2 user-facing core
encodeAngle H2 user-facing encodings
encodeBarWidth H2 user-facing encodings
encodeChannels H2 advanced encodings
encodeColor H2 user-facing encodings
encodeDensity H2 user-facing encodings
encodeDx H2 user-facing encodings
encodeDy H2 user-facing encodings
encodeGroup H2 user-facing encodings
encodeHistogram H2 user-facing encodings
encodeHorizon H2 user-facing encodings
encodeOpacity H2 user-facing encodings
encodeParallelCoordinates H2 user-facing encodings
encodePathOrder H2 user-facing encodings
encodePointRadius H2 user-facing encodings
encodeR H2 user-facing encodings
encodeRadius H2 user-facing encodings
encodeShape H2 user-facing encodings
encodeSize H2 user-facing encodings
encodeStroke H2 user-facing encodings
encodeStrokeDash H2 user-facing encodings
encodeStrokeWidth H2 user-facing encodings
encodeText H2 user-facing encodings
encodeTheta H2 user-facing encodings
encodeX H2 user-facing encodings
encodeX2 H2 user-facing encodings
encodeXOffset H2 user-facing encodings
encodeXRange H2 user-facing encodings
encodeY H2 user-facing encodings
encodeY2 H2 user-facing encodings
encodeYOffset H2 user-facing encodings
encodeYRange H2 user-facing encodings
facet H0 user-facing composition
facetGrid H0 user-facing composition
filterData H2 user-facing core
filterMarks H3 user-facing mark-selection
fitCanvas H3 user-facing core
highlightMarks H3 user-facing mark-selection
insertCompositionChild H3 user-facing composition
jitterPoints H3 user-facing marks
layoutLabels H3 user-facing marks
layoutSeries H2 user-facing encodings
orderCategories H2 user-facing encodings
packPoints H3 user-facing marks
removeCategoryOrder H2, H3 user-facing encodings
removeCompositionChild H3 user-facing composition
removeCoordinate H2 user-facing core
removeData H2 user-facing core
removeEncoding H2, H3 user-facing encodings
removeGrid H3 user-facing grid
removeJitter H3 user-facing marks
removeLabelLayout H3 user-facing marks
removeLegend H3 user-facing legend_and_title
removeMark H3 user-facing marks
removeMarkFilter H3 user-facing mark-selection
removeMarkHighlight H3 user-facing mark-selection
removeMarkLabels H3 user-facing marks
removeMarkSelection H3 advanced mark-selection
removeParallelAxes H3 user-facing axes
removeParallelAxis H3 user-facing axes
removePathOrder H2, H3 user-facing encodings
removePointPacking H3 user-facing marks
removePointRadius H2, H3 user-facing encodings
removeRadialAxis H3 user-facing axes
removeScale H2 user-facing core
removeTextMetrics H3 user-facing core
removeTheme H3 user-facing core
removeThetaAxis H3 user-facing axes
removeTitle H3 user-facing legend_and_title
removeXAxis H3 user-facing axes
removeYAxis H3 user-facing axes
reorderCompositionChildren H3 user-facing composition
repeatCharts H0 user-facing composition
replaceCompositionChild H3 user-facing composition
reviseData H3 user-facing core
selectMarks H3 advanced mark-selection
Documentation provenance

293 actions · sha256:e755591a2e5f5e2b494867583876e28020a478c5220b77bdc6ad469a6224891d