В этом документе описывается, как создавать диаграммы Венна с помощью Chart API.
Оглавление
Особенности диаграммы
| Стандартные функции
|
Введение
Диаграммы Венна представляют собой диаграммы с перекрывающимися кружками, которые показывают, сколько общего имеют разные группы. Charts поддерживает диаграммы Венна с двумя или тремя кругами. Вы указываете относительные размеры кругов и степень перекрытия между ними.
Типы диаграмм ( cht
)
Задайте диаграмму Венна со следующим синтаксисом:
Синтаксис
cht=v
Строка данных представляет собой набор из семи элементов, разделенных разделителем, соответствующим вашему формату данных , как описано здесь:
- Первые три значения определяют размеры трех кругов: A, B и C. Для диаграммы только с двумя кругами укажите ноль для третьего значения.
- Четвертое значение определяет размер пересечения A и B.
- Пятое значение определяет размер пересечения A и C. Для диаграммы только с двумя кругами не указывайте здесь значение.
- Шестое значение определяет размер пересечения B и C. Для диаграммы только с двумя кругами не указывайте здесь значение.
- Седьмое значение определяет размер общего пересечения A, B и C. Для диаграммы только с двумя кругами не указывайте здесь значение.
Обратите внимание, что в диаграммах Венна все значения пропорциональны, а не абсолютны. Это означает, что диаграмма со значениями 10,20,30 будет выглядеть так же, как диаграмма со значениями 100,200,300 (если ваш тип кодировки принимает эти значения).
Описание | Пример |
---|---|
Трехкруговая диаграмма Венна. |
|
Чтобы указать диаграмму из двух кругов, укажите ноль для круга C и не указывайте значения перекрытия, включающие C. | cht=v |
Серия Цвета chco
Вы можете указать цвета всех серий, каждой серии или некоторых серий с помощью параметра chco
.
Синтаксис
chco=<color_1>,...,<color_n>
- < цвет >
- Цвет серии в шестнадцатеричном формате RRGGBB . Укажите разные цвета для разных серий, добавив значения цветов через запятую. Если цветов меньше, чем серий, последний цвет повторяется, но в диаграммах Венна одинаковые цвета могут затруднить чтение диаграммы.
Описание | Пример |
---|---|
Разный цвет для каждого круга. | chco=FF6342,ADDE63,63C6DE |
Если цветов меньше, чем кругов, повторяется последний указанный цвет. Однако это затрудняет чтение диаграммы. | |
Стандартные функции
Остальные функции на этой странице являются стандартными функциями диаграмм.
Укажите цвета, используя 6-значную строку шестнадцатеричных значений плюс два необязательных значения прозрачности в формате RRGGBB[ AA ]
. Например:
-
FF0000
= Красный -
00FF00
= Зеленый -
0000FF
= Синий -
000000
= Черный -
FFFFFF
= Белый
AA
— необязательное значение прозрачности, где 00
— полностью прозрачный, а FF
— полностью непрозрачный. Например:
-
0000FFFF
= сплошной синий -
0000FF66
= Прозрачный синий
Название графика chtt
, chts
[ Все графики ]
Вы можете указать текст заголовка, цвет и размер шрифта для диаграммы.
Синтаксис
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
— указывает заголовок диаграммы.
- < название_диаграммы >
- Название для отображения диаграммы. Вы не можете указать, где это будет отображаться, но при желании вы можете указать размер и цвет шрифта. Используйте знак + для обозначения пробелов и символ вертикальной черты (
|
) для обозначения разрывов строк.
chts
[ Необязательно ] — цвета и размер шрифта для параметра chtt
.
- <цвет >
- Цвет заголовка в шестнадцатеричном формате RRGGBB . Цвет по умолчанию — черный.
- <размер_шрифта >
- Размер шрифта заголовка, в пунктах.
- <opt_alignment>
- [ Необязательно ] Выравнивание заголовка. Выберите одно из следующих строковых значений с учетом регистра: «l» (слева), «c» (по центру), «r» (справа). По умолчанию — «с».
Примеры
Описание | Пример |
---|---|
Диаграмма с заголовком, использующая цвет и размер шрифта по умолчанию. Укажите пробел со знаком плюс ( Используйте символ вертикальной черты ( | chtt=Site+visitors+by+month| |
Диаграмма с синим заголовком размером 20 пунктов, выровненным по правому краю. | chtt=Site+visitors |
Текст и стиль легенды диаграммы chdl
, chdlp
, chdls
[ Все диаграммы ]
Легенда — это боковая часть диаграммы, содержащая небольшое текстовое описание каждой серии. Вы можете указать текст, связанный с каждой серией в этой легенде, и указать, где на диаграмме он должен появиться.
См. также chma
, чтобы узнать, как установить поля вокруг легенды.
Примечание о строковых значениях: в строках меток разрешены только символы, безопасные для URL. В целях безопасности вам следует закодировать URL-адресом все строки, содержащие символы, не входящие в набор символов 0-9a-zA-Z
. Кодировщик URL-адресов можно найти в документации по визуализации Google .
Синтаксис
chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>
chdl
— текст каждой серии для отображения в легенде.
- < метка_серии_данных >
- Текст для записей легенды. Каждая метка применяется к соответствующей серии в массиве
chd
. Используйте знак + для пробела. Если вы не укажете этот параметр, на диаграмме не будет легенды. Невозможно указать разрыв строки в метке. Легенда обычно расширяется, чтобы вместить текст легенды, а область диаграммы сжимается, чтобы вместить легенду.
chdlp
— [ необязательно ] Положение легенды и порядок записей легенды. Вы можете указать <position> и/или <label_order> . Если вы укажете оба, разделите их чертой. Вы можете добавить «s» к любому значению, если хотите, чтобы пустые записи легенды в chdl
были пропущены в легенде. Примеры: chdlp=bv
, chdlp=r
, chdlp=bv|r
, chdlp=bvs|r
- < опт_позиция >
- [ Необязательно ] Указывает положение легенды на диаграмме. Чтобы указать дополнительное отступы между легендой и областью диаграммы или границей изображения, используйте параметр
chma
. Выберите одно из следующих значений:-
b
– Легенда внизу диаграммы, записи легенды расположены в горизонтальном ряду. -
bv
— легенда внизу диаграммы, записи легенды в вертикальном столбце. -
t
— Легенда вверху диаграммы, записи легенды расположены в горизонтальном ряду. -
tv
— Легенда вверху диаграммы, записи легенды в вертикальном столбце. -
r
— [ по умолчанию ] Легенда справа от диаграммы, записи легенды в вертикальном столбце. -
l
— легенда слева от диаграммы, записи легенды в вертикальном столбце.
-
- <opt_label_order>
- [ Необязательно ] Порядок отображения меток в легенде. Выберите одно из следующих значений:
-
l
[ По умолчанию для вертикальных легенд ] Отображать метки в порядке, указанном вchdl
. -
r
— отображать метки в порядке, обратном заданномуchdl
. Это полезно в составных гистограммах, чтобы показать легенду.
в том же порядке, в котором появляются полосы. -
a
— [ По умолчанию для горизонтальных легенд ] Автоматическое упорядочение: примерно означает сортировку по длине, сначала самый короткий, измеряемый в блоках по 10 пикселей. Если два элемента имеют одинаковую длину (разделены на блоки по 10 пикселей), первым будет отображаться тот, который указан первым. -
0,1,2...
— Пользовательский порядок меток. Это список индексов меток, отсчитываемых от нуля, изchdl
, разделенных запятыми.
-
chdls
— [ необязательно ] Задает цвет и размер шрифта текста легенды.
- < цвет >
- Цвет текста легенды в шестнадцатеричном формате RRGGBB .
- < размер >
- Размер пункта текста легенды.
Примеры
Описание | Пример |
---|---|
Два примера легенд. Укажите текст легенды в том же порядке, что и ряд данных. | chdl=NASDAQ|FTSE100|DOW chdl=First|Second|Third |
На первой диаграмме показаны записи горизонтальной легенды ( | |
В этом примере показано изменение размера шрифта. | |
Поля диаграммы chma
[ Все диаграммы ]
Вы можете указать размер полей диаграммы в пикселях. Поля рассчитываются внутрь от указанного размера диаграммы ( chs
); Увеличение размера поля не увеличивает общий размер диаграммы, а, при необходимости, уменьшает ее область.
Поля по умолчанию — это все, что осталось после расчета размера диаграммы. Это значение по умолчанию зависит от типа диаграммы. Указанные вами поля являются минимальным значением; если в области диаграммы остается место для полей, размер поля будет таким же, как и оставшееся; вы не можете сжимать поля меньше, чем требуется для любых легенд и надписей. Вот диаграмма, показывающая основные части диаграммы:
Поля диаграммы включают метки осей и область легенды . Размер области легенды изменяется автоматически, чтобы точно соответствовать тексту, если только вы не укажете большую ширину с помощью Совет: Если в гистограмме столбцы имеют фиксированный размер (по умолчанию), ширину области диаграммы нельзя уменьшить. Вы должны указать меньший или изменяемый размер полосы с помощью |
Синтаксис
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- < левое_поле >, < правое_поле >, < верхнее_поле >, < нижнее_поле >
- Минимальный размер поля вокруг области диаграммы в пикселях. Увеличьте это значение, чтобы включить некоторые отступы, чтобы метки осей не сталкивались с границами диаграммы.
- <opt_legend_width> , <opt_legend_height>
- [ Необязательно ] Ширина поля вокруг легенды в пикселях. Используйте это, чтобы легенда не сталкивалась с областью диаграммы или краями изображения.
Примеры
Описание | Пример |
---|---|
В этом примере диаграмма имеет минимальное поле в 30 пикселей с каждой стороны. Поскольку ширина легенды диаграммы превышает 30 пикселей, поле справа устанавливается на ширину легенды диаграммы и отличается от других полей. Метки осей находятся за пределами области графика и поэтому рисуются внутри поля. |
|
Чтобы добавить поле вокруг легенды, установите значение для параметров В этом примере ширина легенды составляет примерно 60 пикселей. Если вы установите для |
|
Фоновые заливки chf
[ Все графики ]
Вы можете указать цвета и стили заливки для области данных диаграммы и/или всего фона диаграммы. К типам заливок относятся сплошные заливки, полосатые заливки и градиенты. Вы можете указать разные заливки для разных областей (например, всей области диаграммы или только области данных). Заливка области диаграммы перезаписывает заливку фона. Все заливки задаются с помощью параметра chf
, и вы можете смешивать разные типы заливок (сплошные, полосатые, градиенты) на одной диаграмме, разделяя значения вертикальной чертой ( | ). Заливки области диаграммы перезаписывают заливки фона диаграммы.
Сплошные заливки chf
[ Все графики ]
Вы можете указать сплошную заливку для фона и/или области диаграммы или назначить значение прозрачности для всей диаграммы. Вы можете указать несколько заливок, используя символ вертикальной черты ( |
). (Карты: только фон).
Синтаксис
chf=<fill_type>,s,<color>|...
- < тип_заполнения >
- Заполняемая часть диаграммы. Укажите одно из следующих значений:
-
bg
— заливка фона -
c
- Заливка области диаграммы. Не поддерживается для картографических диаграмм. -
a
. Сделайте всю диаграмму (включая фон) прозрачной. Первые шесть цифр< color >
игнорируются, и только последние две (значение прозрачности) применяются ко всей диаграмме и всем заливкам. -
b <index>
— столбчатая сплошная заливка (только гистограммы). Замените <index> индексом серии столбцов, чтобы залить их сплошным цветом. Эффект аналогичен указаниюchco
на гистограмме. Пример см. в разделе «Цвета серии гистограмм» .
-
- с
- Указывает сплошную или прозрачную заливку.
- < цвет >
- Цвет заливки в шестнадцатеричном формате RRGGBB . Для прозрачных пленок первые шесть цифр игнорируются, но их все равно необходимо включить.
Примеры
Описание | Пример |
---|---|
В этом примере фон диаграммы заливается бледно-серым цветом ( | |
В этом примере фон диаграммы заливается бледно-серым цветом ( | |
В этом примере ко всей диаграмме применяется прозрачность 50 % (80 в шестнадцатеричном формате равно 128, или прозрачность около 50 %). Обратите внимание на фон ячейки таблицы, просвечивающий через диаграмму. | |
Градиентная заливка chf
[ Линия, Столбец, Google-o-meter, Радар, Разброс, Венн ]
К областям диаграммы или фону можно применить одну или несколько градиентных заливок. Градиентная заливка — это переход от одного цвета к другому. (Круговые диаграммы Google-o-meter: только фон.)
Каждая градиентная заливка определяет угол, а затем два или более цветов, привязанных к указанному местоположению. Цвет меняется по мере перемещения от одного якоря к другому. У вас должно быть как минимум два цвета с разными значениями <color_centerpoint> , чтобы один мог плавно переходить в другой. Каждый дополнительный градиент определяется парой <color> , <color_centerpoint> .
Синтаксис
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- < тип_заполнения >
- Область диаграммы для заполнения. Одно из следующих:
-
bg
— заливка фона -
c
- Заливка области диаграммы. -
b <index>
— градиентная заливка столбцов (только гистограммы). Замените <index> индексом серии столбцов, которые нужно заполнить градиентом. Пример см. в разделе «Цвета серии гистограмм» .
-
- LG
- Определяет градиентную заливку.
- < угол >
- Число, определяющее угол градиента от 0 (по горизонтали) до 90 (по вертикали).
- < цвет >
- Цвет заливки в шестнадцатеричном формате RRGGBB .
- <color_centerpoint>
- Указывает точку привязки для цвета. С этой точки цвет начнет тускнеть по мере приближения к другому якорю. Диапазон значений составляет от 0,0 (нижний или левый край) до 1,0 (верхний или правый край), наклоненный под углом, заданным < угол >.
Примеры
Описание | Пример |
---|---|
Область диаграммы имеет горизонтальный линейный градиент, заданный с углом в ноль градусов ( Цвета: персиковый ( Фон диаграммы нарисован серым цветом ( | |
Область диаграммы имеет диагональный линейный градиент (снизу слева направо) с углом в сорок пять градусов ( Персиковый ( Синий ( Фон диаграммы нарисован серым цветом ( | |
Область диаграммы имеет вертикальный (сверху вниз) линейный градиент, заданный с углом девяносто градусов ( Синий ( Персиковый ( Фон диаграммы нарисован серым цветом ( | |
Полосатая заливка chf
[ Линия, Бар, Гугл-о-метр, Радар, Разброс, Венн ]
Вы можете указать полосатую фоновую заливку для области диаграммы или всей диаграммы. (Круговые диаграммы Google-o-meter: только фон.)
Синтаксис
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- < тип_заполнения >
- Область диаграммы для заполнения. Одно из следующих:
-
bg
— заливка фона -
c
- Заполнение области диаграммы -
b <index>
— полосатая заливка (только гистограммы). Замените <index> индексом серии столбцов, которые будут заполнены полосами. Пример см. в разделе «Цвета серии гистограмм» .
-
- лс
- Задает заливку линейными полосами.
- < угол >
- Угол всех полос относительно оси Y. Используйте
0
для вертикальных полос или90
для горизонтальных полос. - < цвет >
- Цвет этой полосы в шестнадцатеричном формате RRGGBB . Повторите < цвет > и < ширину > для каждой дополнительной полосы. У вас должно быть как минимум две полоски. Полосы чередуются, пока диаграмма не заполнится.
- < ширина >
- Ширина этой полосы от
0
до1
, где1
— полная ширина диаграммы. Полосы повторяются до тех пор, пока диаграмма не заполнится. Повторите < цвет > и < ширину > для каждой дополнительной полосы. У вас должно быть как минимум две полоски. Полосы чередуются, пока диаграмма не заполнится.
Примеры
Описание | Пример |
---|---|
| chf= |
| chf= |