\Kendo\Dataviz\UI\ChartXAxisItemLabels

A PHP class representing the labels setting of ChartXAxisItem.

Methods

background

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

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value string

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->background('value');
?>

border

The border of the labels.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value \Kendo\Dataviz\UI\ChartXAxisItemLabelsBorder|array

Example - using \Kendo\Dataviz\UI\ChartXAxisItemLabelsBorder

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$border = new \Kendo\Dataviz\UI\ChartXAxisItemLabelsBorder();
$color = 'value';
$border->color($color);
$labels->border($border);
?>

Example - using array

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$color = 'value';
$labels->border(array('color' => $color));
?>

color

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

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value string

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->color('value');
?>

culture

The culture to use when formatting date values. See the globalization overview for more information.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value string

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->culture('value');
?>

dateFormats

The format used to display the labels when the x values are dates. Uses kendo.format. Contains one placeholder ("{0}") which represents the category value.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value \Kendo\Dataviz\UI\ChartXAxisItemLabelsDateFormats|array

Example - using \Kendo\Dataviz\UI\ChartXAxisItemLabelsDateFormats

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$dateFormats = new \Kendo\Dataviz\UI\ChartXAxisItemLabelsDateFormats();
$days = 'value';
$dateFormats->days($days);
$labels->dateFormats($dateFormats);
?>

Example - using array

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$days = 'value';
$labels->dateFormats(array('days' => $days));
?>

font

The font style of the labels. Accepts a valid CSS color string, for example "20px 'Courier New'".

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value string

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->font('value');
?>

format

The format used to display the labels. Uses kendo.format. Contains one placeholder ("{0}") which represents the category value.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value string

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->format('value');
?>

margin

The margin of the labels. A numeric value will set all margins.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value float|\Kendo\Dataviz\UI\ChartXAxisItemLabelsMargin|array

Example - using float

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->margin(1);
?>

Example - using \Kendo\Dataviz\UI\ChartXAxisItemLabelsMargin

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$margin = new \Kendo\Dataviz\UI\ChartXAxisItemLabelsMargin();
$bottom = 1;
$margin->bottom($bottom);
$labels->margin($margin);
?>

Example - using array

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$bottom = 1;
$labels->margin(array('bottom' => $bottom));
?>

mirror

If set to true the chart will mirror 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.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value boolean

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->mirror(true);
?>

padding

The padding of the labels. A numeric value will set all paddings.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value float|\Kendo\Dataviz\UI\ChartXAxisItemLabelsPadding|array

Example - using float

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->padding(1);
?>

Example - using \Kendo\Dataviz\UI\ChartXAxisItemLabelsPadding

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$padding = new \Kendo\Dataviz\UI\ChartXAxisItemLabelsPadding();
$bottom = 1;
$padding->bottom($bottom);
$labels->padding($padding);
?>

Example - using array

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$bottom = 1;
$labels->padding(array('bottom' => $bottom));
?>

position

The position of the axis labels. By default, labels are positioned next to the axis. When position is set to end, the labels are placed at the end of the crossing axis— typically, at the top or right end of the Chart unless the crossing axis was reversed. or When position is set to start, the labels are placed at the start of the crossing axis— typically, at the left or bottom end of the Chart unless the crossing axis was reversed..

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value string

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->position('value');
?>

rotation

The rotation angle of the labels. By default the labels are not rotated. Can be set to "auto" in which case the labels will be rotated only if the slot size is not sufficient for the entire labels.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value float|string|\Kendo\Dataviz\UI\ChartXAxisItemLabelsRotation|array

Example - using float

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->rotation(1);
?>

Example - using string

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->rotation('value');
?>

Example - using \Kendo\Dataviz\UI\ChartXAxisItemLabelsRotation

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$rotation = new \Kendo\Dataviz\UI\ChartXAxisItemLabelsRotation();
$align = 'value';
$rotation->align($align);
$labels->rotation($rotation);
?>

Example - using array

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$align = 'value';
$labels->rotation(array('align' => $align));
?>

skip

The number of labels to skip.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value float

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->skip(1);
?>

step

The label rendering step - render every n-th label. By default every label is rendered.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value float

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->step(1);
?>

template

The template which renders the labels.The fields which can be used in the template are: value - the category value.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value string|\Kendo\JavaScriptFunction

Example - using string

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->template('value');
?>

Example - using \Kendo\JavaScriptFunction

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->template(new \Kendo\JavaScriptFunction('function() { }'));
?>

visible

If set to true the chart will display the x axis labels. By default the x axis labels are visible.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value boolean

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->visible(true);
?>

visual

A function that can be used to create a custom visual for the labels. The available argument fields are: createVisual - a function that can be used to get the default visual.; culture - the default culture (if set) on the label; format - the default format of the label; options - the label options.; rect - the kendo.geometry.Rect that defines where the visual should be rendered.; sender - the chart instance (may be undefined).; text - the label text. or value - the category value.

Returns

\Kendo\Dataviz\UI\ChartXAxisItemLabels

Parameters

$value \Kendo\JavaScriptFunction

Example

<?php
$labels = new \Kendo\Dataviz\UI\ChartXAxisItemLabels();
$labels->visual(new \Kendo\JavaScriptFunction('function() { }'));
?>
In this article
Not finding the help you need?