В этом разделе описано XML-представление содержимого диаграммы:
- введение в документы диаграмм;
- диаграмма;
- заголовок, подзаголовок и нижний колонтитул;
- легенда;
- область построения;
- стена;
- основание диаграммы;
- оси координат;
- ряды данных;
- категории;
- точка данных;
- среднее значение;
- индикатор ошибок;
- кривые регрессии.
10.1 Введение в документы диаграмм
править
Документы диаграмм всегда содержатся внутри других XML-документов. Существует два типа документов, в которых могут содержаться диаграммы:
- документы, которые не предоставляют данные для диаграммы, данные в диаграмме содержатся в элементе
<table:table>
внутри элемента <chart:chart>
;
- документы, которые предоставляют данные для диаграммы, данные диаграммы могут содержаться в элементе
<table:table>
в родительском документе, например в электронной таблице или текстовом документе.
Данные диаграммы описываются атрибутом table:cell-range-address
в элементе <chart:plot-area>
. Элемент <chart:plot-area>
представляет визуальный контейнер всего ряда данных в диаграмме.
Элемент <chart:chart>
представляет всю диаграмму, включая заголовки, легенду и графический объект, отображающий базовые данные, называемый областью построения. Данные, лежащие в основе диаграммы, представлены элементом таблицы. Этот элемент может также существовать для встроенных диаграмм, которые получают данные из документа-контейнера. В этом случае диаграмма может быть визуализирована без получения данных из контейнерного документа.
<define name="chart-chart">
<element name="chart:chart">
<ref name="chart-chart-attlist"/>
<optional>
<ref name="chart-title"/>
</optional>
<optional>
<ref name="chart-subtitle"/>
</optional>
<optional>
<ref name="chart-footer"/>
</optional>
<optional>
<ref name="chart-legend"/>
</optional>
<ref name="chart-plot-area"/>
<optional>
<ref name="table-table"/>
</optional>
</element>
</define>
Атрибут chart:class
определяет тип диаграммы. Тип диаграммы представлен токеном из пространства имен, означающим идентификатор, которому предшествует XML-префикс пространства имен, подобно любому имени атрибута или элемента в данной спецификации. Спецификацией определено несколько типов диаграмм в пространстве имен диаграммы (URN:urn:oasis:names:tc:opendocument:xmlns:chart:1.0). Также могут использоваться дополнительные типы диаграмм при условии использования другого пространства имен.
Тип диаграммы может быть указан более точно путем изменения свойств, которые могут быть добавлены к стилям диаграммы. Например, трехмерная горизонтальная гистограмма задана с помощью атрибута класса chart:bar
путем добавления свойств трехмерности и горизонтального расположения в соответствующий стиль.
<define name="chart-chart-attlist" combine="interleave">
<attribute name="chart:class">
<ref name="namespacedToken"/>
</attribute>
</define>
Предопределенные типы диаграмм:
- линейная (line) — точки каждого ряда данных соединены линиями;
- с областями (area) — область под рядом данных заполнена, а дополнительные ряды данных расположены ярусами;
- круговая (circle) — круговая диаграмма поделена на сегменты согласно относительным весам точек данных;
- кольцевая (ring) — каждый ряд данных представляет собой концентрические кольца, где каждое кольцо отображено так, будто оно является частью круговой диаграммы;
- диаграмма XY (scatter) — пара рядов данных, используемых для определения позиции каждой точки по осям X и Y;
- лепестковая (radar) — точки данных в полярной системе координат, где значение каждой точки определяет расстояние от центра диаграммы, причем точки данных серии соединены так, что формируют замкнутую линию вокруг центра;
- гистограмма (bar) — каждая точка данных изображена как полоса длиной, пропорциональной значению точки данных;
- биржевая (stock) — четыре ряда данных интерпретируются как значение при открытии биржи, минимальное значение, максимальное и значение при закрытии биржи;
- пузырьковая (bubble) — первые два или три ряда данных определяют позиции как в диаграмме XY, где размер области каждой точки определяется относительно значения в третьем ряду данных;
- поверхность (surface) — точки данных интерпретируются как табулированные данные, где каждое значение определяет высоту в определенном месте сетки, что на графике может быть отображено с помощью цветов для интервалов высот, путем создания цветовых карт подобно географическим картам;
- диаграмма Ганта (gannt) — пара рядов данных, которая используется для определения начальной и конечной позиции для горизонтальных полос.
Пример — В следующей таблице показаны примеры предопределенных типов диаграмм. Те диаграммы, которые используют один или два ряда данных, используют два ряда данных со значениями 1;2;3;4 и 1;4;9;16 и метки a;b;c;d. Те типы диаграмм, которые используют больше, чем два ряда данных (биржевая и пузырьковая), используют ряды данных 1;2;3;4 и их комбинации. Лепестковая диаграмма использует два ряда данных с пятью точками.
chart:line
|
chart:area
|
chart:circle
|
chart:ring
|
chart:scatter
|
chart:radar
|
chart:bar
|
chart:stock
|
chart:bubble
|
chart:surface
|
chart:gantt
|
|
Атрибуты svg:width
и svg:height
(см. раздел 9.2.15) определяют размер всей диаграммы. Если они опущены, размер диаграммы определяется размером окна, в котором будет отображена диаграмма.
<define name="chart-chart-attlist" combine="interleave">
<ref name="common-draw-size-attlist"/>
</define>
Отображение строк и столбцов
править
Атрибуты chart:column-mapping
и chart:row-mapping
содержат, если задан, список индексов рядов данных. Числа определяют переупорядочение данных, которые поступают из документа-контейнера, предоставляющего данные для диаграммы. Нумерация начинается с 1. Упорядоченный по возрастанию список, начинающийся с 1, не вызовет никакого эффекта. Чтобы поменять два ряда, нужно поменять номера в списке. Например, для 1 3 2 4
меняются второй и третий ряды.
Атрибуты chart:column-mapping
и chart:row-mapping
не должны использоваться одновременно.
<define name="chart-chart-attlist" combine="interleave">
<optional>
<attribute name="chart:column-mapping">
<ref name="string"/>
</attribute>
</optional>
</define>
<define name="chart-chart-attlist" combine="interleave">
<optional>
<attribute name="chart:row-mapping">
<ref name="string"/>
</attribute>
</optional>
</define>
Атрибут chart:style-name
ссылается на стиль диаграммы (см. раздел 14.16).
В пределах стиля, применяемого к элементу <chart:chart>
, могут использоваться свойства заполнения (описано в разделе 15.14) и свойства контурной линии (описано в разделе 15.13), а также свойство масштабирования текста, описанное в разделе 15.29.1.
<define name="chart-chart-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
10.3 Заголовок, подзаголовок и нижний колонтитул
править
Элемент <chart:title>
представляет главный заголовок объекта в документе диаграммы. Этот элемент может содержать фиксированный текст или элемент <table:cell-address>
, указывающий на текст, который должен быть отображен как заголовок. Этот элемент может быть подэлементом chart:axis
(см. раздел 10.8). В этом случае заголовок будет отображен за пределами осей координат.
<define name="chart-title">
<element name="chart:title">
<ref name="chart-title-attlist"/>
<optional>
<ref name="text-p"/>
</optional>
</element>
</define>
Заголовок диаграммы может быть привязан к ячейке таблицы, поэтому текущее содержимое данной ячейки будет отображено в названии диаграммы.
<define name="chart-title-attlist" combine="interleave">
<optional>
<attribute name="table:cell-range">
<ref name="cellAddress"/>
</attribute>
</optional>
</define>
Общий атрибут расположения для графических объектов может использоваться в элементах <chart:title>
.
<define name="chart-title-attlist" combine="interleave">
<ref name="common-draw-position-attlist"/>
</define>
Атрибут chart:style-name
определяет стиль диаграммы для элемента <chart:title>
. В данном стиле могут быть использованы свойства заполнения и обрамления. Они применяются к области, окружающей заголовок (см. разделы 15.14 и 15.13 для получения дополнительной информации). В дополнение к этому могут использоваться свойства текста. Они применяются непосредственно к тексту заголовка (см. раздел 15.4).
<define name="chart-title-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Элемент <chart:subtitle>
представляет подзаголовок, который может использоваться для отображения дополнительного заголовка к диаграмме.
Структура элемента <chart:subtitle>
схожа со структурой элемента <chart:title>
. С элементом <chart:subtitle>
могут быть связаны те же атрибуты, что и с элементом <chart:title>
(см. раздел 10.3.1 для получения дополнительной информации).
<define name="chart-subtitle">
<element name="chart:subtitle">
<ref name="chart-title-attlist"/>
<optional>
<ref name="text-p"/>
</optional>
</element>
</define>
Элемент <chart:footer>
представляет нижний колонтитул под областью построения диаграммы.
Структура элемента подзаголовка та же, что и для элемента заголовка <chart:title>
(см. раздел 10.3.1 для получения дополнительной информации).
<define name="chart-footer">
<element name="chart:footer">
<ref name="chart-title-attlist"/>
<optional>
<ref name="text-p"/>
</optional>
</element>
</define>
Элемент <chart:legend>
определяет, отображается ли легенда на диаграмме. Положение легенды может быть указано как относительное или как абсолютное. Размер легенды вычисляется автоматически и поэтому не может быть установлен через атрибут.
<define name="chart-legend">
<element name="chart:legend">
<ref name="chart-legend-attlist"/>
<empty/>
</element>
</define>
Легенда может быть помещена автоматически, рядом с областью построения или в одном из углов. Размещение определяется атрибутом chart:legend-position
, который может принимать значения start
, end
, top
, bottom
для размещения легенды рядом с областью построения и top-start
, bottom-start
, top-end
или bottom-end
для размещения легенды в углах. Если легенда расположена рядом с областью построения в любом из четырех положений start
, end
, top
bottom
, дополнительный атрибут выравнивания chart:legend-align
определяет, какая граница (start
, end
) или ось координат (center
) легенды и области построения должна быть выровнены.
<define name="chart-legend-attlist" combine="interleave">
<choice>
<group>
<attribute name="chart:legend-position">
<choice>
<value>start</value>
<value>end</value>
<value>top</value>
<value>bottom</value>
</choice>
</attribute>
<optional>
<attribute name="chart:legend-align">
<choice>
<value>start</value>
<value>center</value>
<value>end</value>
</choice>
</attribute>
</optional>
</group>
<attribute name="chart:legend-position">
<choice>
<value>top-start</value>
<value>bottom-start</value>
<value>top-end</value>
<value>bottom-end</value>
</choice>
</attribute>
<empty/>
</choice>
</define>
Пример — Если chart:legend-position="right"
, легенда будет размещена справа от области построения диаграммы. Значения chart:legend-align
, равные start
, center
и end
, приведут к положению легенды, как изображено зеленым, красным и синим квадратами соответственно.
Положение легенды может быть задано в абсолютных координатах, как для любого отображаемого объекта. Если доступны и положение рисунка, и опции размещения легенды, то размещение легенды имеет приоритет, и позиция будет определена автоматически.
<define name="chart-legend-attlist" combine="interleave">
<ref name="common-draw-position-attlist"/>
</define>
Для размещения дополнительных пунктов легенда должна быть расширена. Атрибут style:legend-expansion
определяет, в каком направлении расширяется легенда. Расширение легенды по wide
и high
вызывает расширение легенды по горизонтали и вертикали. Расширение balanced
вызывает расширение в обоих направлениях. Значение расширения custom
с числовым style:legend-expansion-aspect-ratio
заставляет легенду расширяться таким образом, что соблюдается отношение между шириной и высотой.
<define name="chart-legend-attlist" combine="interleave">
<choice>
<attribute name="style:legend-expansion">
<choice>
<value>wide</value>
<value>high</value>
<value>balanced</value>
</choice>
</attribute>
<group>
<attribute name="style:legend-expansion">
<value>custom</value>
</attribute>
<attribute name="style:legend-expansion-aspect-ratio">
<ref name="double"/>
</attribute>
</group>
<empty/>
</choice>
</define>
Дополнительная информация о стиле легенды может быть задана через атрибут chart:style-name
. В стиле могут устанавливаться свойства заполнения и обрамления. Они применимы к легенде (см. разделы 15.14 и 15.13 для получения дополнительной информации). В дополнение к этому, стиль может определить свойства текста. Они применимы к тексту внутри объекта легенды (см. раздел 15.4).
<define name="chart-legend-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Элемент <chart:plot-area>
является контейнером для графических объектов, которые представляют данные диаграммы. Основное предназначение области построения — быть контейнером для элементов ряда, которые представляют единственный ряд данных и элементы координатной оси.
<define name="chart-plot-area">
<element name="chart:plot-area">
<ref name="chart-plot-area-attlist"/>
<zeroOrMore>
<ref name="dr3d-light"/>
</zeroOrMore>
<zeroOrMore>
<ref name="chart-axis"/>
</zeroOrMore>
<zeroOrMore>
<ref name="chart-series"/>
</zeroOrMore>
<optional>
<ref name="chart-stock-gain-marker"/>
</optional>
<optional>
<ref name="chart-stock-loss-marker"/>
</optional>
<optional>
<ref name="chart-stock-range-line"/>
</optional>
<optional>
<ref name="chart-wall"/>
</optional>
<optional>
<ref name="chart-floor"/>
</optional>
</element>
</define>
Позиционирование области построения
править
Позиция и размер области построения определяются общими атрибутами положения и размера для отображаемых объектов. Если атрибуты положения и размера не указаны, то значения вычисляются визуализирующим приложением.
<define name="chart-plot-area-attlist" combine="interleave">
<ref name="common-draw-position-attlist"/>
<ref name="common-draw-size-attlist"/>
</define>
Атрибут chart:style-name
, который установлен для элемента <chart:plot-area>
, используется для всех элементов данных, содержащихся в области построения, если не определены дополнительные стили в одном из подэлементов. Эти элементы данных могут быть элементами <chart:series>
и <chart:data-point>
.
Если диаграмма является трехмерной, то к области построения могут быть применены трехмерные свойства сцены (см. разделы 15.22—15.26 для получения дополнительной информации).
<define name="chart-plot-area-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Атрибуты данных области построения
править
Если диаграмма встроена в документ, в котором содержатся данные для диаграммы, атрибут table:cell-range-address
отражает диапазоны, в которых находятся все данные для диаграммы. Заданный здесь диапазон интерпретируется диаграммой как последовательные ряды данных.
<define name="chart-plot-area-attlist" combine="interleave">
<optional>
<attribute name="table:cell-range-address">
<ref name="cellRangeAddress"/>
</attribute>
</optional>
</define>
Если первая строка или столбец, или оба, содержат метки, то это задается атрибутом chart:data-source-has-labels
.
<define name="chart-plot-area-attlist" combine="interleave">
<optional>
<attribute name="chart:data-source-has-labels" a:defaultValue="none">
<choice>
<value>none</value>
<value>row</value>
<value>column</value>
<value>both</value>
</choice>
</attribute>
</optional>
</define>
Свойство форматирования диаграммы chart:series-source
, которое описано в разделе 15.34.1, определяет, каким образом расположены данные в таблице: по строкам или по столбцам.
10.5.1 Трехмерная область построения
править
Область построения может быть отображена как трехмерная сцена, как описано в разделе 9.4.1. Все трехмерные атрибуты, которые могут применяться к элементу <dr3d:scene>
, включая атрибут dr3d:transform
, могут применяться и к элементу <chart:plot-area>
. Он представляет вращение сцены диаграммы, которая является трехмерной областью построения (см. раздел 9.4.1 для получения дополнительной информации). В дополнение к этому, элемент <chart:plot-area>
может содержать элемент <dr3d:light>
, как описано в разделе 9.4.2.
<define name="chart-plot-area-attlist" combine="interleave">
<ref name="dr3d-scene-attlist"/>
<ref name="common-dr3d-transform-attlist"/>
</define>
Элемент <chart:wall>
может содержаться в элементе <chart:plot-area>
. Он устанавливает стены диаграммы. Для двумерных диаграмм стена охватывает всю область построения. Для трехмерных диаграмм стена, как правило, состоит из двух перпендикулярных прямоугольников.
<define name="chart-wall">
<element name="chart:wall">
<ref name="chart-wall-attlist"/>
<empty/>
</element>
</define>
Атрибут svg:width
устанавливает ширину стены для трехмерных диаграмм.
<define name="chart-wall-attlist" combine="interleave">
<optional>
<attribute name="svg:width">
<ref name="length"/>
</attribute>
</optional>
</define>
Элемент <chart:wall>
может иметь атрибут chart:style-name
для дальнейшего определения стилей оформления, которые могут включать свойства заполнения и обрамления. Для получения более подробной информации см. разделы 15.14 и 15.13.
<define name="chart-wall-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Элемент <chart:floor>
может содержаться в элементе <chart:plot-area>
. Для трехмерных диаграмм элемент <chart:floor>
представлен в качестве дополнения к элементу <chart:wall>
.
<define name="chart-floor">
<element name="chart:floor">
<ref name="chart-floor-attlist"/>
<empty/>
</element>
</define>
Размер основания вычисляется на основе размера области построения, которая всегда представлена прямоугольником, служащим в качестве ограничения для трехмерной сцены. Атрибут svg:width
может использоваться для установления ширины основания.
<define name="chart-floor-attlist" combine="interleave">
<optional>
<attribute name="svg:width">
<ref name="length"/>
</attribute>
</optional>
</define>
Элемент <chart:floor>
может иметь атрибут chart:style-name
для дальнейшего определения стилей оформления. К основанию диаграммы могут быть применены свойства заполнения и обрамления. Для получения более подробной информации см. разделы 15.14 и 15.13.
<define name="chart-floor-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Элемент <chart:axis>
в основном содержит данные стиля, в частности — информацию о масштабе. Данные диаграммы обычно структурированы следующим образом:
- несколько рядов данных, состоящих из названий, например названий компании;
- значения, например объем выпуска продукции компанией по годам;
- каждое значение в ряду данных принадлежит определенной категории, например году.
<define name="chart-axis">
<element name="chart:axis">
<ref name="chart-axis-attlist"/>
<optional>
<ref name="chart-title"/>
</optional>
<optional>
<ref name="chart-categories"/>
</optional>
<zeroOrMore>
<ref name="chart-grid"/>
</zeroOrMore>
</element>
</define>
Атрибут chart:dimension
определяет, вдоль какой реальной оси на диаграмме, отображаются значения шкалы текущей оси (значения какой шкалы будут отображаться для каждого измерения).
Диаграмма может содержать более одной оси одного и того же измерения. Например, может быть две оси y. Ряды данных могут быть привязаны к каждой из осей. Таким образом, данные могут группироваться по различным измерениям Чтобы привязать специальную ось координат к некоторому ряду данных, для координатной оси должен быть задан элемент <chart:series>
с атрибутом chart:axis-name
. Если с координатной осью не связан ни один ряд данных, она становится копией существующей оси того же измерения.
Позиция оси на диаграмме определяется визуализирующим приложением и зависит от типа диаграммы. На горизонтальных гистограммах при визуализации обычно отображается ось измерения x в нижней части области построения. Если имеется две оси измерения y, то при формировании изображения вторая ось может быть отображена в верхней части области построения.
<define name="chart-axis-attlist" combine="interleave">
<attribute name="chart:dimension">
<choice>
<value>x</value>
<value>y</value>
<value>z</value>
</choice>
</attribute>
</define>
Атрибут chart:name
может использоваться для именования оси, таким образом на него можно ссылаться, например для ряда данных.
<define name="chart-axis-attlist" combine="interleave">
<optional>
<attribute name="chart:name">
<ref name="string"/>
</attribute>
</optional>
</define>
Атрибут chart:style-name
может быть связан с осями. Свойство обрамления может применяться к осям (см. раздел 15.13). Эти свойства влияют на все линии координатной оси. Текстовые свойства также применимы к координатным осям (см. раздел 15.4). Эти свойства влияют на внешний вид всех объектов текстового типа. Также могут быть использованы свойства координатных осей, описанные в разделе 15.31.
Стиль диаграммы, на который ссылается атрибут chart:style-name
может определять вид отображения данных, используемых для подписей осей. Для получения дополнительной информации см. раздел 14.1.
<define name="chart-axis-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Пример — Гистограмма.
В этом примере две оси y. Одна из них имеет название primary-value
. Ряды данных были прикреплены к этой именованной оси. Для второй оси нет прикрепленных данных, поэтому имя оси не было задано, и ось — просто копия первой.
<chart:chart chart:class="bar">
<chart:title>
<text:p>Title of my chart</text:p>
</chart:title>
<chart:plot-area>
<chart:axis chart:dimension="x"
chart:axis-name="x"/>
<chart:axis chart:dimension="y"
chart:axis-name="primary-value"/>
<chart:axis chart:dimension="y"/>
<chart:series chart:values-address="Sheet1.A1:.A7"
chart:attached-axis="primary-value"/>
</chart:plot-area>
</chart:chart>
Элемент <chart:grid>
может содержаться в элементе <chart:axis>
. Он добавляет сетку для координатной оси.
<define name="chart-grid">
<element name="chart:grid">
<ref name="chart-grid-attlist"/>
</element>
</define>
Атрибут chart:class
определяет, используются ли основные или вспомогательные метки деления шкалы. Если используются основные линии сетки, метки деления являются их продолжением. Вспомогательные линии сетки не имеют меток деления.
<define name="chart-grid-attlist" combine="interleave">
<optional>
<attribute name="chart:class" a:defaultValue="major">
<choice>
<value>major</value>
<value>minor</value>
</choice>
</attribute>
</optional>
</define>
Элемент <chart:grid>
может иметь атрибут chart:style-name
для дальнейшего определения стилей оформления. Свойства обрамления могут быть применены к координатной сетке, и влияние распространится на линии сетки. Для получения более детальной информации о свойствах обрамления см. раздел 15.13.
<define name="chart-grid-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Элемент <chart:series>
используется для представления рядов данных на диаграмме. Если диаграмма требует больше входных данных, как, например, пузырьковая диаграмма и диаграмма ХУ, то подэлементы <chart:domain>
должны быть определены таким образом, чтобы содержать преимущественно атрибуты cell-range-address
соответствующих данных.
<define name="chart-series">
<element name="chart:series">
<ref name="chart-series-attlist"/>
<zeroOrMore>
<ref name="chart-domain"/>
</zeroOrMore>
<optional>
<ref name="chart-mean-value"/>
</optional>
<optional>
<ref name="chart-regression-curve"/>
</optional>
<optional>
<ref name="chart-error-indicator"/>
</optional>
<zeroOrMore>
<ref name="chart-data-point"/>
</zeroOrMore>
</element>
</define>
Атрибут chart:values-cell-range-address
позволяет задать диапазон значений из данного ряда, которые должны быть отображены.
<define name="chart-series-attlist" combine="interleave">
<optional>
<attribute name="chart:values-cell-range-address">
<ref name="cellRangeAddress"/>
</attribute>
</optional>
</define>
Атрибут chart:label-cell-address
позволяет привязать некоторое имя для ряда данных.
<define name="chart-series-attlist" combine="interleave">
<optional>
<attribute name="chart:label-cell-address">
<ref name="cellAddress"/>
</attribute>
</optional>
</define>
Атрибут chart:class
может быть использован для установки типа диаграммы, который будет использован для визуализации данных элемента <chart:series>
. Атрибут chart:class
элемента <chart:series>
переопределяет атрибут chart:class
для всей диаграммы. Это позволяет создавать диаграммы с множественными субдиаграммами, например одномерная диаграмма с одним или несколькими рядами данных, отображенными в виде линий. Для более подробной информации о доступных классах диаграмм см. раздел 10.2.
<define name="chart-series-attlist" combine="interleave">
<optional>
<attribute name="chart:class">
<ref name="namespacedToken"/>
</attribute>
</optional>
</define>
Атрибут chart:attached-axis
может использоваться для привязки рядов данных к элементу <chart:axis>
.
<define name="chart-series-attlist" combine="interleave">
<optional>
<attribute name="chart:attached-axis">
<ref name="string"/>
</attribute>
</optional>
</define>
Свойства стиля для рядов данных могут быть назначены при помощи атрибута chart:style-name
. Свойства обрамления могут быть применены к элементу <chart:series>
. Для получения более детальной информации о свойствах обрамления см. разделы 15.14 и 15.13. Текстовые свойства также применимы к тексту, описывающему ряды данных, расположенному ниже (см. раздел 15.4 для более получения подробной информации).
<define name="chart-series-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Для пузырьковых и точечных диаграмм для элемента <chart:series>
может быть задан один элемент <chart:domain>
или более.
Для диаграмм ХУ один элемент <chart:domain>
обязателен. Его атрибут cell-range-address
ссылается на значения по координате х для диаграмм ХУ.
Для пузырьковых диаграмм два элемента <chart:domain>
обязательны. Их атрибут cell-range-address
ссылается на значения по координатам х и у для пузырьковых диаграмм.
Для обоих типов диаграмм должен быть по крайней мере один элемент <chart:series>
с несколькими субэлементами <chart:domain>
. Все остальные элементы <chart:series>
могут не включать вышеперечисленного. В этом случае используется тот домен, который был указан первым.
<define name="chart-domain">
<element name="chart:domain">
<optional>
<attribute name="table:cell-range-address">
<ref name="cellRangeAddress"/>
</attribute>
</optional>
</element>
</define>
Элемент <chart:categories>
представляет диапазон адресов ячеек, содержащих подписи к категориям, имеющимbся в каждой последовательности.
Элемент может содержать атрибут table:cell-range-address
, отмечающий область, из которой были взяты подписи к категориям. Если этот атрибут или элемент <chart:categories>
пропущены, приложение использует атрибут chart:data-source-has-labels
.
<define name="chart-categories">
<element name="chart:categories">
<optional>
<attribute name="table:cell-range-address">
<ref name="cellRangeAddress"/>
</attribute>
</optional>
</element>
</define>
Если отдельная точка ряда данных требует особого отображения, то для применения необходимых свойств используется элемент <chart:data-point>
.
<define name="chart-data-point">
<element name="chart:data-point">
<ref name="chart-data-point-attlist"/>
<empty/>
</element>
</define>
Атрибут chart:repeated
служит для упрощения в том случае, если несколько последовательных точек имеют одинаковые свойства. Например, нижеследующие XML-фрагменты имеют одинаковый смысл:
<chart:series chart:style-name="ch9">
<chart:data-point/>
<chart:data-point/>
<chart:data-point/>
<chart:data-point/>
</chart:series>
<chart:series chart:style-name="ch9">
<chart:data-point chart:repeated="4"/>
</chart:series>
<define name="chart-data-point-attlist" combine="interleave">
<optional>
<attribute name="chart:repeated">
<ref name="nonNegativeInteger"/>
</attribute>
</optional>
</define>
Атрибут chart:style-name
относится к стилю диаграммы. Свойства заполнения и обрамления применяются к каждой точке данных (см. разделы 15.14 и 15.13). Текстовые свойства также могут быть применены к подписи, расположенной непосредственно под значением (см. раздел 15.4).
<define name="chart-data-point-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Свойства форматирования линии среднего значения содержатся в элементе <chart:mean-value>
, который может являться частью элемента <chart:series>
.
<define name="chart-mean-value">
<element name="chart:mean-value">
<ref name="chart-mean-value-attlist"/>
<empty/>
</element>
</define>
Атрибут chart:style-name
указывает на стиль диаграммы, содержащий свойства форматирования для линии среднего значения.
<define name="chart-mean-value-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Свойства форматирования индикаторов ошибок содержатся в элементе <chart:error-indicator>
, который может быть частью рядов данных.
<define name="chart-error-indicator">
<element name="chart:error-indicator">
<ref name="chart-error-indicator-attlist"/>
<empty/>
</element>
</define>
Атрибут chart:style-name
указывает на стиль диаграммы, содержащий свойства форматирования индикатора ошибок.
<define name="chart-error-indicator-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
Свойства форматирования кривых регрессии содержатся в элементе <chart:regression-curve>
, который может быть частью рядов данных.
<define name="chart-regression-curve">
<element name="chart:regression-curve">
<ref name="chart-regression-curve-attlist"/>
<empty/>
</element>
</define>
Атрибут chart:style-name
указывает на стиль диаграммы, содержащий свойства форматирования индикатора ошибок. Стиль диаграммы может, главным образом, содержать свойство «вид регрессии», описанное в разделе 15.35.1.
<define name="chart-regression-curve-attlist" combine="interleave">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
10.14.1 Метки биржевой диаграммы
править
Свойства биржевой диаграммы, как например, различные цвета заливки свечей или стили линий наибольшего и наименьшего значения (линия диапазона), находятся в отдельных элементах.
Свечи биржевых диаграмм, у которых значение закрытия располагаются выше, чем значение открытия, используют свойства форматирования элемента <chart:stock-gain-marker>
, в то время как биржевые диаграммы, у которых значение закрытия располагаются ниже, чем значение открытия, используют свойства элемента chart:stock-loss-marker
>.
<define name="chart-stock-gain-marker">
<element name="chart:stock-gain-marker">
<ref name="common-stock-marker-attlist"/>
</element>
</define>
<define name="chart-stock-loss-marker">
<element name="chart:stock-loss-marker">
<ref name="common-stock-marker-attlist"/>
</element>
</define>
<define name="chart-stock-range-line">
<element name="chart:stock-range-line">
<ref name="common-stock-marker-attlist"/>
</element>
</define>
Атрибут стиля диаграммы chart:style-name
определяет свойства оформления меток биржевых диаграмм.
<define name="common-stock-marker-attlist">
<optional>
<attribute name="chart:style-name">
<ref name="styleNameRef"/>
</attribute>
</optional>
</define>
|
Это произведение не охраняется авторским правом. В соответствии со статьёй 1259 Гражданского кодекса Российской Федерации не являются объектами авторских прав официальные документы государственных органов и органов местного самоуправления муниципальных образований, в том числе законы, другие нормативные акты, судебные решения, иные материалы законодательного, административного и судебного характера, официальные документы международных организаций, а также их официальные переводы; государственные символы и знаки (флаги, гербы, ордена, денежные знаки и тому подобное), а также символы и знаки муниципальных образований; произведения народного творчества (фольклор), не имеющие конкретных авторов; сообщения о событиях и фактах, имеющие исключительно информационный характер (сообщения о новостях дня, программы телепередач, расписания движения транспортных средств и тому подобное).
|
|