plotArea Object

The plot area configuration options. The plot area is the area which displays the series.

Example - configure the chart plot area

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    background: "green",

  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.background String (default: "white")

The background color of the chart plot area. Accepts a valid CSS color string, including hex and rgb.

Example - set the chart plot area background as a hex string

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    background: "#aa00bb"
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

Example - set the chart plot area background as a RGB value

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    background: "rgb(128, 0, 255)"
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

Example - set the chart plot area background by name

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    background: "green"
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.border Object

The border of the chart plot area.

Example - set the chart plot area border

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    border: {
      width: 2,
      color: "green"
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.border.color String (default: "black")

The color of the border. Accepts a valid CSS color string, including hex and rgb.

Example - set the chart plot area border color

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    border: {
      width: 2,
      color: "green"
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.border.dashType String (default: "solid")

The dash type of the border.

The following dash types are supported:

  • "dash" - a line consisting of dashes
  • "dashDot" - a line consisting of a repeating pattern of dash-dot
  • "dot" - a line consisting of dots
  • "longDash" - a line consisting of a repeating pattern of long-dash
  • "longDashDot" - a line consisting of a repeating pattern of long-dash-dot
  • "longDashDotDot" - a line consisting of a repeating pattern of long-dash-dot-dot
  • "solid" - a solid line

Example - set the chart plot area border dash type

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    border: {
      width: 2,
      dashType: "dashDot"
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.border.width Number (default: 0)

The width of the border in pixels. By default the border width is set to zero which means that the border will not appear.

Example - set the chart plot area border width

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    border: {
      width: 2
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.margin Number|Object (default: 5)

The margin of the chart plot area. A numeric value will set all margins.

Example - set the chart plot area margin

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    margin: 10
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.margin.bottom Number (default: 5)

The bottom margin of the chart plot area.

Example - set the chart plot area bottom margin

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    margin: {
      bottom: 10
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.margin.left Number (default: 5)

The left margin of the chart plot area.

Example - set the chart plot area left margin

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    margin: {
      left: 10
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.margin.right Number (default: 5)

The right margin of the chart plot area.

Example - set the chart plot area right margin

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    margin: {
      right: 10
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.margin.top Number (default: 5)

The top margin of the chart plot area.

Example - set the chart plot area top margin

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    margin: {
      top: 10
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.opacity Number (default: 1)

The background opacity of the chart plot area. By default the background is opaque.

Example - set the chart plot area opacity

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    background: "green",
    opacity: 0.1
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.padding Number|Object

The padding of the chart plot area. A numeric value will set all paddings.

The default padding for pie, donut, radar and polar charts is proportional of the chart size.

Example - set the chart plot area padding

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    padding: 10
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.padding.bottom Number (default: 5)

The bottom padding of the chart plot area.

Example - set the chart plot area bottom padding

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    padding: {
      bottom: 10
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.padding.left Number (default: 5)

The left padding of the chart plot area.

Example - set the chart plot area left padding

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    padding: {
      left: 10
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.padding.right Number (default: 5)

The right padding of the chart plot area.

Example - set the chart plot area right padding

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    padding: {
      right: 10
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>

plotArea.padding.top Number (default: 5)

The top padding of the chart plot area.

Example - set the chart plot area top padding

<div id="chart"></div>
<script>
$("#chart").kendoChart({
  plotArea: {
    padding: {
      top: 10
    }
  },
  series: [
    { data: [1, 2, 3] }
  ]
});
</script>
In this article