The look of a chart is set by chart styles: a style:style (or
style:default-style) of family chart, applied through the
chart:style-name attribute of a chart element (see the
charts page). A chart style holds a
style:chart-properties element for the chart-specific settings, and usually
a style:graphic-properties element (fills, lines; see
graphic formatting) and
a style:text-properties element (fonts) as well. This page lists every
attribute and child of style:chart-properties (sections 17.22 to 17.24 and
20.2 to 20.73 of OpenDocument 1.3 part 3). Each attribute is only read on the elements
named in its row; elsewhere it has no effect.
General
| Attribute | Read on | Values and meaning |
|---|---|---|
chart:auto-position | elements with svg:x, svg:y | Boolean. true: svg:x and svg:y are ignored and the consumer chooses a position; false: they are used. Default true if x and y are absent, false if present. |
chart:auto-size | elements with svg:width, svg:height | Boolean. true: size is chosen by the consumer. Default true if width and height are absent, false if present. |
chart:scale-text | all chart objects with text | Boolean. true: the text is scaled when the chart is resized. |
chart:three-dimensional | plot area | Boolean. true: the chart is shown as a 3D scene. |
chart:deep | plot area | Boolean. true: series are placed behind each other along the z-axis, which shows the series names. Ignored unless chart:three-dimensional is true. |
chart:right-angled-axes | plot area | Boolean. true: a 3D chart is sheared instead of rotated, so x and y axes form a right angle in the projection. Ignored unless three-dimensional. |
chart:vertical | plot area | Boolean. false: horizontal x-axis, vertical y-axis (column charts); true: vertical x-axis, horizontal y-axis (bar charts). |
chart:include-hidden-cells | plot area | Boolean; default true: data in hidden cells is plotted. |
chart:treat-empty-cells | plot area | use-zero (missing values become zero), leave-gap (nothing plotted; a continuous plot stops and restarts at the next valid point), ignore (nothing plotted, the plot continues). Default ignore for scatter charts, leave-gap for all others. |
chart:series-source (deprecated) | plot area | columns or rows: whether the tabular data holds its series in columns or rows. Series with their own chart:values-cell-range-address take priority. |
chart:lines (deprecated) | – | Boolean: whether lines connect the points. Use draw:stroke instead. |
style:direction | chart text | ltr (text follows style:writing-mode) or ttb (characters stacked top to bottom, not rotated). |
style:rotation-angle | axis, data label, title | Angle. On an axis: rotates each tick label (not the axis title). On a data label, data point, series or plot area: rotates the data labels. On a title: rotates the title. |
Axes
All of these are read on a style applied to a chart:axis.
| Attribute | Values and meaning |
|---|---|
chart:display-label | Boolean: whether labels appear on the axis (as opposed to a title for it). |
chart:visible | Boolean, default true: whether the axis (or, on a series, the series) is visible. |
chart:axis-position | start, end, or a number: where the axis line crosses the scale of the crossing axis. On a y-axis the value is on the first x-axis, and the other way round. For a category crossing axis, 1 is the first category, 2 the second and so on. If the first x-axis has this attribute it also sets the origin for data on the first y-axis, overriding chart:origin. |
chart:axis-label-position | near-axis (beside the axis line; the side follows chart:axis-position: outside the coordinate system for start or end, otherwise on the side of the lower crossing values), near-axis-other-side, outside-start (outside the region, where the crossing axis is at its minimum), outside-end (at its maximum). Missing but with chart:axis-position given: near-axis. |
chart:tick-mark-position | at-labels, at-axis, at-labels-and-axis. Matters only when labels are not at the axis line (outside-start or outside-end). Missing but with chart:axis-position given: at-labels-and-axis. |
chart:tick-marks-major-inner | Boolean: major tick marks towards the inside of the plot area (drawn right of an axis on the left side, left of one on the right side). With the outer ones also true, one mark crosses the axis. |
chart:tick-marks-major-outer | Boolean: major tick marks towards the outside. |
chart:tick-marks-minor-inner | Boolean: minor tick marks towards the inside (by chart:interval-minor-divisor). |
chart:tick-marks-minor-outer | Boolean: minor tick marks towards the outside. |
chart:interval-major | Double: the major interval. |
chart:interval-minor-divisor | Positive integer: the major interval is divided by this to get the minor interval. |
chart:minimum, chart:maximum | Double: lowest and highest value of the axis. |
chart:origin | Double: where the drawing of a series attached to the axis starts (the base of bars, the base line of an area chart). |
chart:logarithmic | Boolean: logarithmic instead of proportional scaling. |
chart:reverse-direction | Boolean, default false: reverse the axis direction. The normal direction is x left to right, y bottom to top, 3D systems left-handed, polar systems counter-clockwise. On circle charts the y-axis value makes sectors clockwise; on ring charts the x-axis value reverses the ring order. |
chart:label-arrangement | side-by-side (one line), stagger-even (even labels on the side-by-side line; counting starts at 1), stagger-odd. |
chart:text-overlap | Boolean: whether axis labels may overlap. |
text:line-break | Boolean: whether axis labels may wrap. |
chart:link-data-style-to-source | Boolean, only in chart documents that sit inside a document supplying the data. true: the number format of the axis labels comes from the data document; false: style:data-style-name is used. |
chart:gap-width | Integer percentage of one bar’s width: the gap between neighbouring groups of bars. Read on a y-axis. |
chart:overlap | Integer percentage of one bar’s width: overlap of bars within a category; negative values leave gaps. Read on a y-axis. |
Plot area
| Attribute | Read on | Values and meaning |
|---|---|---|
chart:stacked | plot area | Boolean: series values are accumulated per category; bars are stacked. |
chart:percentage | plot area | Boolean: values are accumulated per category and the sum is treated as 100 percent; the y-axis shows percentages. false has no effect. |
chart:connect-bars | plot area | Boolean: bars of the same series are joined by lines. |
chart:group-bars-per-axis | plot area | Boolean. false: all bars on the same x-axis form one group, side by side; true: only bars attached to the same x- and y-axis form a group. |
chart:solid-type | data point, series, plot area | Shape of bars in 3D bar charts: cuboid, cylinder, cone, pyramid. |
chart:angle-offset | plot area | Angle: counter-clockwise rotation of the polar coordinate in circle, ring and radar charts. Default 90deg. |
chart:hole-size | plot area | Percent: diameter of the inner hole of a ring chart relative to the outer diameter of the outermost ring. |
chart:pie-offset | data point, series | Non-negative integer: distance of a segment from the centre as a percentage of the radius (circle charts). For ring charts, an additional distance as a percentage of the ring’s thickness. |
chart:japanese-candle-stick | plot area | Stock charts. false: opening and closing values are left and right ticks; true: a coloured bar, with a colour depending on whether the opening value is larger than the closing value. |
chart:sort-by-x-values | plot area | Boolean, for chart types with x-values such as scatter. true: points are shown in ascending x order; false: in data order. |
chart:mean-value | plot area, series | Boolean: show a line at the mean of a series. |
chart:interpolation | plot area, series | How points of line and scatter charts are joined: none (straight lines), cubic-spline, b-spline, step-start (one step at the start of each interval), step-end (at the end), step-center-x (one step in the horizontal centre), step-center-y (steps to the mean of consecutive values). The two splines are defined with formulas in the specification (see below). |
chart:spline-order | with b-spline | Positive integer: degree of the polynomials. |
chart:spline-resolution | with any interpolation but none | Positive integer: number of straight segments between two data points. 1 is the same as none. |
The B-spline of order p passes through the data points (consecutive repeats removed). The parameters t use the centripetal method with power 0.5, the knot vector is built by averaging parameters, control points solve the matrix equation given by the B-spline basis functions, and points are computed with de Boor’s algorithm at k equal steps per interval. The cubic spline is the unique piecewise cubic through the points whose first and second derivatives are continuous, with second derivatives zero at the ends for an open curve, or matching first and second derivatives at both ends for a closed curve (first point equals last), again sampled at k steps per interval. The full formulas are in 20.27 of the specification.
Data labels
Read on a style applied to a chart:data-label, chart:data-point,
chart:series or chart:plot-area; the nearest one wins.
| Attribute | Values and meaning |
|---|---|
chart:data-label-number | none (default), value, percentage, value-and-percentage. style:data-style-name picks the number format of the value, style:percentage-data-style-name that of the percentage. |
chart:data-label-text | Boolean: show the category in the label. |
chart:data-label-series | Boolean: show the series name. |
chart:data-label-symbol | Boolean: show a legend symbol. |
chart:label-position | avoid-overlap (an algorithm tries to avoid overlap), center, top, top-right, right, bottom-right, bottom, bottom-left, left, top-left, inside, outside, near-origin. For inside: in a pie, inside the piece on the bisecting line at the outer radius; in a bar, inside at the end given by the value; in a polar chart, on the side facing the centre. outside is the opposite. near-origin: inside the point at the side near the origin (the start of a bar or the base line of an area). |
chart:label-position-negative | Same values; used for negative values. Ignored without chart:label-position; otherwise that one is used for both. |
The parts of a textual label are joined by the text of
chart:label-separator (see below); the default is one space.
Symbols
Read on a style applied to a chart:data-point, chart:series
or chart:plot-area.
| Attribute | Values and meaning |
|---|---|
chart:symbol-type | none; automatic (a different symbol per series, round robin, in the order of the names below); named-symbol (use chart:symbol-name); image (use chart:symbol-image). |
chart:symbol-name | Only with named-symbol: square, diamond, arrow-down, arrow-up, arrow-right, arrow-left, bow-tie, hourglass, circle, star, x, plus, asterisk, horizontal-bar, vertical-bar. The glyphs are implementation-defined. |
chart:symbol-width, chart:symbol-height | Non-negative lengths; used when the type is not none. |
Error indicators
Read on a style applied to a chart:error-indicator,
chart:series or chart:plot-area.
| Attribute | Values and meaning |
|---|---|
chart:error-category | none (default), variance, standard-deviation, standard-error (standard deviation of the mean), percentage (of each value, by chart:error-percentage), error-margin (a percentage of the largest value, by chart:error-margin), constant (fixed absolute values from the two limits), cell-range (values from the two ranges). Variance and deviations assume an equal distribution. |
chart:error-upper-indicator | Boolean: show positive indicators (value added to the point). |
chart:error-lower-indicator | Boolean: show negative indicators (value subtracted). |
chart:error-upper-limit, chart:error-lower-limit | Double: absolute value in each direction for constant. |
chart:error-upper-range, chart:error-lower-range | Cell range list for cell-range. |
chart:error-percentage | Double: percentage for percentage. |
chart:error-margin | Double: percentage of the largest value for error-margin. |
Regression curves
Read on a style applied to a chart:regression-curve,
chart:series or chart:plot-area.
| Attribute | Values and meaning |
|---|---|
chart:regression-type | none (default), linear (y = A·x + B), logarithmic (y = A·ln(x) + B), exponential (y = A·eB·x), power (y = A·xB), polynomial (y = A0 + A1x + … + Anxn, with n from chart:regression-max-degree), moving-average. |
chart:regression-name | String: the curve’s name; default empty. |
chart:regression-force-intercept | Boolean, default false. For linear, exponential and polynomial: true makes the curve cross the y-axis at chart:regression-intercept-value; false calculates it from the data. |
chart:regression-intercept-value | Double. Default 0 for linear and polynomial, 1 for exponential. Read only with the force attribute. |
chart:regression-max-degree | Positive integer, at least 2, default 2. Polynomial only. |
chart:regression-period | Positive integer, minimum and default 2: the number k of points averaged. Moving average only. |
chart:regression-moving-type | Moving average only; default prior. With data points (xj, yj), j = 1 to N, the curve has the points (ri, si) for i = 1 to N−k+1, joined by straight lines. Always si is the mean of yi to yi+k−1. The abscissa is: prior, ri = xi+k−1; central, ri = xk/2+i for even k and x(k−1)/2+i for odd k; averaged-abscissa, the mean of xi to xi+k−1. |
Child elements
chart:symbol-image– an image used for data points; only withchart:symbol-type="image". Attribute:xlink:href(the image’s location). No children.chart:label-separator– the text (atext:pchild) that separates the parts of a data label: the value, the percentage and the label text. Without the element the default is one space (U+0020). Use it in styles of data labels, data points, series or plot areas; if a data label’s style has none, the parent element’s separator is used. No attributes.
Source
OpenDocument Version 1.3, OASIS Standard, 27 April 2021, part 3 (schema), sections
17.22 to 17.24 and 20.2 to 20.73, plus style:direction (20.263),
style:rotation-angle (20.347) and text:line-break (20.429);
read in full for this page. The 3D, fill and line properties a chart style may also
carry are in the
graphic formatting
page.