categoryAxis.labelsObject

Configures the axis labels.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            color: "red",
            font: "12px Arial",
            rotation: 45
        }
    }
});
</script>

categoryAxis.labels.backgroundString

The background color of the labels. Any valid CSS color string will work here, including hex and rgb.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            background: "yellow"
        }
    }
});
</script>

categoryAxis.labels.borderObject

The border of the labels.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            border: {
                color: "blue",
                width: 1,
                dashType: "solid"
            }
        }
    }
});
</script>

categoryAxis.labels.border.colorString(default: "black")

The color of the border. Any valid CSS color string will work here, including hex and rgb.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            border: {
                color: "red"
            }
        }
    }
});
</script>

categoryAxis.labels.border.dashTypeString(default: "solid")

The dash type of the border.

"solid"

Specifies a solid line.

"dot"

Specifies a line consisting of dots.

"dash"

Specifies a line consisting of dashes.

"longDash"

Specifies a line consisting of a repeating pattern of long-dash.

"dashDot"

Specifies a line consisting of a repeating pattern of dash-dot.

"longDashDot"

Specifies a line consisting of a repeating pattern of long-dash-dot.

"longDashDotDot"

Specifies a line consisting of a repeating pattern of long-dash-dot-dot.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            border: {
                dashType: "dash"
            }
        }
    }
});
</script>

categoryAxis.labels.border.widthNumber(default: 0)

The width of the border.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            border: {
                width: 2
            }
        }
    }
});
</script>

categoryAxis.labels.colorString

The text color of the labels. Any valid CSS color string will work here, including hex and rgb.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            color: "blue"
        }
    }
});
</script>

categoryAxis.labels.fontString(default: "12px Arial,Helvetica,sans-serif")

The font style of the labels.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            font: "14px Verdana"
        }
    }
});
</script>

categoryAxis.labels.formatString

The format of the labels.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            format: "MMM yyyy"
        }
    }
});
</script>

categoryAxis.labels.marginNumber | Object(default: 0)

The margin of the labels.

Example

pseudo
    // sets the top, right, bottom and left margin to 3px.
    margin: 3

    // sets the top and left margin to 1px
    // margin right and bottom are with 0px (by default)
    margin: { top: 1, left: 1 }

categoryAxis.labels.mirrorBoolean

Mirrors the axis labels and ticks. If the labels are normally on the left side of the axis, mirroring the axis will render them to the right.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            mirror: true
        }
    }
});
</script>

categoryAxis.labels.paddingNumber | Object(default: 0)

The padding of the labels.

Example

pseudo
    // sets the top, right, bottom and left padding to 3px.
    padding: 3

    // sets the top and left padding to 1px
    // padding right and bottom are with 0px (by default)
    padding: { top: 1, left: 1 }

categoryAxis.labels.rotationNumber(default: 0)

The rotation angle of the labels.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            rotation: 45
        }
    }
});
</script>

categoryAxis.labels.skipNumber(default: 1)

Number of labels to skip. Skips rendering the first n labels.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            skip: 2
        }
    }
});
</script>

categoryAxis.labels.stepNumber(default: 1)

Label rendering step. Every n-th label is rendered where n is the step

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            step: 2
        }
    }
});
</script>

categoryAxis.labels.templateString | Function

The template which renders the labels.

The fields which can be used in the template are:

  • value - the category value
  • dataItem - the data item for the category
  • format - the default format of the label
  • culture - the default culture (if set) on the label
  • index - the 0-based index of the current label
  • count - the total number of labels on the axis

Example

<div id="chart"></div>
<script>
// chart initialization
$("#chart").kendoChart({
     title: {
         text: "My Chart Title"
     },
     series: [{
         name: "Series 1",
         data: [200, 450, 300, 125]
     }],
     categoryAxis: {
         categories: [2000, 2001, 2002, 2003],
         labels: {
             // labels template
             template: "Year: #= value #"
         }
     }
});
</script>

categoryAxis.labels.visibleBoolean(default: true)

The visibility of the labels.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            visible: false
        }
    }
});
</script>

categoryAxis.labels.cultureString

Culture to use for formatting the dates. See Globalization for more information. It defaults to the global culture.

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            culture: "de-DE"
        }
    },
    series: [{
        type: "line",
        data: [
            { date: new Date(2023, 0, 1), value: 10 },
            { date: new Date(2023, 0, 2), value: 20 },
            { date: new Date(2023, 0, 3), value: 15 }
        ],
        field: "value",
        categoryField: "date"
    }]
});
</script>

categoryAxis.labels.dateFormatsObject

Date format strings

Example

<div id="stock-chart"></div>
<script>
$("#stock-chart").kendoStockChart({
    categoryAxis: {
        labels: {
            dateFormats: {
                days: "dd/MM",
                months: "MMM yyyy"
            }
        }
    },
    series: [{
        type: "line",
        data: [
            { date: new Date(2023, 0, 1), value: 10 },
            { date: new Date(2023, 1, 1), value: 20 },
            { date: new Date(2023, 2, 1), value: 15 }
        ],
        field: "value",
        categoryField: "date"
    }]
});
</script>

"hours"

"HH:mm"

"days"

"M/d"

"weeks"

"M/d"

"months"

"MMM 'yy"

"years"

"yyyy"

The Chart will choose the appropriate format for the current baseUnit. Setting the labels format option will override these defaults.