This website is for Vega-Lite v3. Go to the main Vega-Lite homepage for the latest release.

Square

Edit this page
// Single View Specification
{
  "data": ... ,
  "mark": "square",
  "encoding": ... ,
  ...
}

square marks is similar to point mark, except that (1) the shape value is always set to square (2) they are filled by default.

Square Mark Properties

A square mark definition can contain any standard mark properties and the following special properties:

Property Type Description
size Number

Default size for marks.

  • For point/circle/square, this represents the pixel area of the marks. For example: in the case of circles, the radius is determined in part by the square root of the size value.
  • For bar, this represents the band size of the bar, in pixels.
  • For text, this represents the font size, in pixels.

Default value: 30 for point, circle, square marks; rangeStep - 1 for bar marks with discrete dimensions; 5 for bar marks with continuous dimensions; 11 for text marks.

Example: Scatterplot with Square

Here are an example scatter plot with square marks:

Square Config

// Top-level View Specification
{
  ...
  "config": {
    "square": ...,
    ...
  }
}

The square property of the top-level config object sets the default properties for all square marks. If mark property encoding channels are specified for marks, these config values will be overridden.

The square config can contain any point mark properties (except type, style, and clip).