SVGGraph options: axis_levels_h

« Return to previous page

Option name:

axis_levels_h

Default value:

null

Added in version:

3.6

Data type:

integer [?]

The datatypes used in this documentation for specifying SVGGraph options are described below. All options can be a literal value of the data type described, a variable containing the data type, or an expression that will produce the data type when evaluated (and they must always be valid PHP expressions).

array: An array, the number and data types of its members will depend on the option for which is it used.
boolean: A boolean TRUE or FALSE value, or any values that convert easily such as 1, "1", 0 and "".
callback: A callable function, which can be either the name of a function or an anonymous function itself.
colour: Any of the colour values supported by SVG inside a single or double quoted string. These include three and six digit hex codes, RGB and RGBA colours, and colour names. SVG uses "none" for no colour, which generally leaves things transparent.
fill: A colour value or one of the gradients and patterns supported by SVGGraph. See the SVGGraph colours page for details.
integer: A negative or positive whole number or 0.
measurement: An integer or float value, or a string containing a number followed by one of these CSS units: px, in, cm, mm, pt, pc.
number: Any number supported by PHP, for example 1 or -3.2 or 1.63e5 or M_PI.
string: Single or double quoted strings. Remember to double-quote your strings if you are inserting a line break:
"Line 1\nLine 2".

Per-dataset:

Supported by:

Bar3DGraph BarAndLineGraph BarGraph BoxAndWhiskerGraph BubbleGraph CandlestickGraph CylinderGraph FloatingBarGraph GanttChart GroupedBar3DGraph GroupedBarGraph GroupedCylinderGraph Histogram HorizontalBar3DGraph HorizontalBarGraph HorizontalFloatingBarGraph HorizontalGroupedBar3DGraph HorizontalGroupedBarGraph HorizontalStackedBar3DGraph HorizontalStackedBarGraph LineGraph MultiLineGraph MultiScatterGraph MultiSteppedLineGraph PopulationPyramid ScatterGraph StackedBar3DGraph StackedBarAndLineGraph StackedBarGraph StackedCylinderGraph StackedGroupedBar3DGraph StackedGroupedBarGraph StackedGroupedCylinderGraph StackedLineGraph SteppedLineGraph

Tags:

axis

Sets the number of levels of horizontal axis division labels.

Setting this option to a value greater than one enables multiple levels of axis labels. The different strings for each level can come from structured data, or from a callback function, or formatted from datetime keys.

Consecutive divisions with the same string for a level are collapsed, with the label appearing only once.

Example 1 - three levels from structured data:

$settings['axis_levels_h'] = 3;
$settings['structure'] = [
  'key' => 0, 'value' => [1, 2, 3],
  'axis_text' => [4, 5, 6],
];

In this example the three levels of division labels come from fields 4, 5 and 6 in the data array.

Example 2 - two levels from callback function:

$settings['axis_levels_h'] = 2;
$settings['axis_text_callback_x'] = function($v) {
  return [ (string)$v % 10, (string)floor($v / 10) ];
};

This example separates the numeric key into units and tens.

Example 3 - three levels from datetime data:

$settings['axis_levels_h'] = 3;
$settings['datetime_text_format'] = ['H:i', 'd m', 'Y'];

This example formats the datetime values as hours and minutes; day and month; year.

See also:: axis_levels_v division_style structure axis_text_callback_x

« Back to top of page Main SVGGraph page »