Изменения документа Диаграммы Схемы Графики

Редактировал(а) Coluns 31.03.2023
От версии 28.1
отредактировано hrapitan
на 11.03.2023
Изменить комментарий: Загрузить новое изображение 2023-02-19_17-17-57.png
К версии 37.1
отредактировано hrapitan
на 11.03.2023
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -235,8 +235,8 @@
235 235  1*. line3D ([[линии с эффектом 3D>>attach:2023-02-19_17-55-07.png]]);
236 236  1*. xy_area ([[область в координатах>>attach:R.png]]);
237 237  1*. xy_line_and_shape ([[линии в координатах и с точками в узлах>>attach:2023-02-19_17-13-11.png]]);
238 -1*. xy_line3D (линии в координатах и с эффектом 3D);
239 -1*. xy_step (состояния).
238 +1*. xy_line3D ([[линии в координатах и с эффектом 3D>>attach:2023-02-19_17-13-48.png]]);
239 +1*. xy_step ([[состояния>>attach:2023-02-19_17-17-57.png]]).
240 240  1. В поле "**Содержимое**" вносятся данные для визуализации в режиме "(% style="color:#16a085" %)**inline**(%%)" (подробности ниже).
241 241  1. В поле "**Высота**" при желании можно задать высоту графика в пикселях. По умолчанию график будет отрисован в размере 300x400 pix.
242 242  1. В поле "**Параметры**" вносятся дополнительные настройки для построения графиков. Эта строка содержит список сопоставлений имени параметра со значением. Доступные имена и значения параметров зависят от используемого источника данных (подробности ниже).
... ... @@ -245,3 +245,131 @@
245 245  1. В поле "**Ширина**" при желании можно задать ширину графика в пикселях. По умолчанию график будет отрисован в размере 300x400 pix.
246 246  
247 247  === Параметры графиков/диаграмм ===
248 +
249 +
250 +Поле "**Параметры**" служит для определения условий построения графиков и диаграмм. В него вносится список сопоставлений имени параметра со значением, разделителем между параметром и значением служит знак "(% style="color:#16a085" %)**:**(%%)", а между парами <//параметр: значение//> — знак "(% style="color:#16a085" %)**;**(%%)".
251 +
252 +==== Параметры построения ====
253 +
254 +|=Имя параметра|=Возможные значения|=Описание
255 +|range|(%%)(% style="color:#16a085" %)//A1-..//|Определяет диапазон ячеек таблицы, используемых для построения графика.  Порядковый номер столбца ячейки обозначается заглавной буквой латинского алфавита, а номер строки — арабской цифрой. Синтаксис: "(% style="color:#16a085" %)range:N#-M~#~#(%%)", где N и M — заглавные латинские буквы, обозначающие начальный и конечный столбцы диапазона, а # и ~#~# — арабские цифры, обозначающие начальную и конечную строки диапазона. Пример записи диапазона: "(% style="color:#16a085" %)//range:B2-D5//(%%)".
256 +|series|(% bis_skin_checked="1" %)(% bis_skin_checked="1" %)
257 +(((
258 +(% style="color:#16a085" %)//columns//(%%)
259 +(% style="color:#16a085" %)//rows//
260 +)))|(% bis_skin_checked="1" %)(% bis_skin_checked="1" %)
261 +(((
262 +Определяет ориентацию осей графика (x/y) относительно колонок таблицы. Пример записи диапазона: "(% style="color:#16a085" %)//series:columns//(%%)"
263 +)))
264 +
265 +(% class="wikigeneratedid" %)
266 +Поддерживаются также **дополнительные параметры** построения, наборы которых завися от типа графиков. Подробные сведения можно получить из [[документации>>https://java-online.ru/jfreechart-attributes.xhtml||rel="noopener noreferrer" target="_blank"]].
267 +
268 +==== Визуальные параметры ====
269 +
270 +|=Имя параметра|=Значение по умолчанию|=Описание
271 +|backgroundColor|Grey background|Цвет фона области, не относящейся к диаграмме; задается с использованием шестнадцатеричной системы счисления, например FFAACC (первые 2 буквы соответствуют красному цвету, следующие 2 — зеленому, а последние 2 — синему)
272 +|plotBackgroundColor|White|Цвет фона области графика (в шестнадцатеричном виде)
273 +|plotBorderColor|Black|Цвет границы графика (в шестнадцатеричном виде)
274 +|borderColor|Black|Цвет внешней границы графа (в шестнадцатеричном виде)
275 +|legendBackgroundColor|White|Цвет фона поля легенды (в шестнадцатеричном виде)
276 +|plotBorderVisible|true|Видимость границы области графика. Допустимые значения (% style="color:#16a085" %)//true// (%%)и (% style="color:#16a085" %)//false//
277 +|legendVisible|true|Отображение легенды. Допустимые значения (% style="color:#16a085" %)//true// (%%)и (% style="color:#16a085" %)//false//
278 +
279 +==== Дополнительные параметры для круговых диаграмм ====
280 +
281 +|=Имя параметра|=Значение по умолчанию|=Описание
282 +|pie_label_format|{0}|Формат метки для сегментов круговой диаграммы. Используйте {0} там, где должен быть вставлен ключ круговой секции, {1} для абсолютного значения секции и {2} для процентной суммы круговой секции, например, {0} = {1} ({2}) будет отображаться как «яблоко = 120 (5%)»
283 +
284 +=== {{id name="inline"/}}Типы источников данных и режимы визуализации ===
285 +
286 +Расширение "**Chart**" поддерживает два режима работы — "(% style="color:#16a085" %)**inline**(%%)" и "(% style="color:#16a085" %)**xdom**(%%)", которые определяют тип источника данных:
287 +
288 +* в режиме "(% style="color:#16a085" %)**inline**(%%)" для построения графиков используются встроенные данные, которые вносятся непосредственно в макросе;
289 +* в режиме "(% style="color:#16a085" %)**xdom**(%%)" для построения графиков и диаграмм используются таблицы данных, расположенные в пределах вики.
290 +
291 +Рассмотрим оба варианта использования макроса.
292 +
293 +
294 +==== Визуализация в режиме "**inline**" ====
295 +
296 +В этом режиме макрос строит диаграммы и графики на основе данных, вносимых непосредственно в макросе. Данные вносятся в поле "**Содержимое**" в виде таблицы, записанной на языке разметки вики-страницы.
297 +
298 +
299 +[[image:2023-02-19_19-43-36.png]]
300 +
301 +
302 +При этом в поле "**Параметры**" можно определять диапазон ячеек таблицы, используемых в качестве поставщика данных. Порядковый номер столбца ячейки обозначается заглавной буквой латинского алфавита, а номер строки — арабской цифрой. В приведенном примере для построения графиков используются ячейки столбцов со 2 по 4 и строк со 2 по 5, это описывается выражением "(% style="color:#16a085" %)//range:B2-D5//(%%)".
303 +
304 +В поле "**Источник**" макроса должно значится "(% style="color:#16a085" %)//inline//(%%)".
305 +
306 +
307 +==== Визуализация в режиме "**xdom**" ====
308 +
309 +Для использования этого варианта в поле "**Источник**" макроса должно значится "(% style="color:#16a085" %)//xdom//(%%)".
310 +
311 +В данном режиме макрос строит диаграммы и графики на основе данных, содержащихся в таблице на какой-либо странице в пределах вики. Для того, чтобы макрос работал, таблице необходимо присвоить идентификатор, используя код в режиме источника:
312 +
313 +(% bis_skin_checked="1" class="box" %)
314 +(((
315 +~(% id="//произвольный_идентификатор//" %)
316 +)))
317 +
318 +Рассмотрим процесс на примере страницы с двумя таблицами:
319 +
320 +
321 +[[image:1678526683284-692.png]]
322 +
323 +
324 +В режиме источника каждой из таблиц мы присвоили идентификаторы ("(% style="color:#16a085" %)//table1//(%%)" и "(% style="color:#16a085" %)//table2//(%%)"), сохранили изменения, а затем скопировали адрес этой страницы (вкладка "**Информация**", поле "**Ссылка на страницу**" ).
325 +
326 +Осталось внести эти данные в макрос.
327 +
328 +В начало строки поля "**Параметры**" добавляем 2 параметра:
329 +
330 +* первым идет параметр "//document~://", за которым следует скопированная ссылка на страницу с таблицей;
331 +* вторым следует параметр "//table~://", за которым идет идентификатор нужной нам таблицы.
332 +
333 +**Схема записи:**
334 +
335 +(% bis_skin_checked="1" class="box" %)
336 +(((
337 +document:<//ссылка на страницу//>;table:<//идентификатор таблицы//>;
338 +)))
339 +
340 +В поле "**Источник**" ставим тип "(% style="color:#16a085" %)**//xdom//**(%%)".
341 +
342 +Таблицу 1 из примера мы используем для создания линейных графиков. Окно макроса для нее будет [[выглядеть так>>attach:2023-02-20_11-34-28.png||onclick="window.open(this.href, '', 'resizable=no,status=no,location=no,toolbar=no,menubar=no,fullscreen=no,scrollbars=no,dependent=no'); return false;"]].
343 +
344 +**Код макроса в разметке**:
345 +
346 +(% bis_skin_checked="1" class="box" %)
347 +(((
348 +~{~{chart type="(% style="color:#f39c12" %)line(%%)" params="document:(% style="color:#f39c12" %)База знаний.Работа в XWIKI.Советы и рецепты.Diagrams Schemes Graphs.Tablitsy-s-dannymi-dlia-grafikov.WebHome(%%);table:(% style="color:#f39c12" %)table1(%%);range:B2-D5;series:columns;" source="(% style="color:#f39c12" %)xdom(%%)"}}~{~{/chart}}
349 +)))
350 +
351 +В нем тип графика, адрес страницы, идентификатор таблицы и тип источника данных выделены рыжим.
352 +
353 +**Результат рендеринга макроса из Таблицы 1:**
354 +
355 +[[image:2023-02-20_12-41-34.png||height="305" width="400"]]
356 +
357 +
358 +Таблицу 2 из примера мы используем для создания круговой диаграммы. Окно макроса для нее будет [[выглядеть так>>attach:2023-02-20_12-19-01.png||onclick="window.open(this.href, '', 'resizable=no,status=no,location=no,toolbar=no,menubar=no,fullscreen=no,scrollbars=no,dependent=no'); return false;"]].
359 +
360 +**Код макроса в разметке**:
361 +
362 +(% bis_skin_checked="1" class="box" %)
363 +(((
364 +~{~{chart type="(% style="color:#f39c12" %)pie(%%)" params="document:(% style="color:#f39c12" %)База знаний.Работа в XWIKI.Советы и рецепты.Diagrams Schemes Graphs.Tablitsy-s-dannymi-dlia-grafikov.WebHome(%%);table:(% style="color:#f39c12" %)table2(%%);range:B2-D5;series:columns;" source="(% style="color:#f39c12" %)xdom(%%)"}}~{~{/chart}}
365 +)))
366 +
367 +В нем тип графика, адрес страницы, идентификатор таблицы и тип источника данных выделены рыжим.
368 +
369 +**Результат рендеринга макроса из Таблицы 2:**
370 +
371 +[[image:2023-02-20_12-41-52.png||height="337" width="400"]]
372 +
373 +
374 +=== Примеры использования **Chart **Extension ===
375 +
1678526683284-692.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.hp
Размер
... ... @@ -1,0 +1,1 @@
1 +212.8 KB
Содержимое
2023-02-19_19-43-36.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.hp
Размер
... ... @@ -1,0 +1,1 @@
1 +119.9 KB
Содержимое
2023-02-20_11-34-28.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.hp
Размер
... ... @@ -1,0 +1,1 @@
1 +46.4 KB
Содержимое
2023-02-20_12-19-01.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.hp
Размер
... ... @@ -1,0 +1,1 @@
1 +46.8 KB
Содержимое
2023-02-20_12-41-34.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.hp
Размер
... ... @@ -1,0 +1,1 @@
1 +35.5 KB
Содержимое