Chart

Виджет визуализации данных с поддержкой столбчатых и линейных графиков, координатных осей и подсказок.

Обзор

Chart расширяет Sparkline до полноценного компонента диаграмм. Поддерживает переключение между столбчатым (BAR) и линейным (LINE) режимами, координатные оси, числовые метки и подсветку столбцов при наведении.

Столбчатая диаграмма

Chart latencyChart = new Chart()
        .type(Chart.Type.BAR)
        .values(List.of(12, 18, 15, 25, 14))
        .barColor(Color.CYAN);

API

API

Метод	Описание
axisColor()	Возвращает цвет координатных осей диаграммы.
barColor()	Возвращает цвет столбцов в режиме столбчатой диаграммы.
type(Type)	Устанавливает режим отображения диаграммы (LINE или BAR).
Chart()	Creates a chart with its default size and line mode.

Chart::axisColor()

Цвет осей

Возвращает цвет координатных осей диаграммы.

Возвращает MutableColor: The mutable RGBA axis color; changing it overrides the style value..

Chart::barColor()

Цвет столбцов

Возвращает цвет столбцов в режиме столбчатой диаграммы.

Возвращает MutableColor: The mutable RGBA bar color; changing it overrides the style value..

Chart::type(Type)

Тип диаграммы

Устанавливает режим отображения диаграммы (LINE или BAR).

Параметр	Тип	Описание
type	Type	Rendering mode; null selects LINE.

Возвращает Chart: This chart for fluent configuration..

Chart()

Create a chart

Creates a chart with its default size and line mode.

Data

Метод	Описание
values(List)	Replaces the plotted values from a Number list.
values(float[])	Replaces the plotted values without boxing numeric inputs.
categories(List)	Sets optional labels aligned by index with the plotted values.
categories()	Returns the current immutable category-label list.

Chart::values(List)

Set chart values

Replaces the plotted values from a Number list.

Параметр	Тип	Описание
values	List	Values in data order; null clears the series and null entries are treated as zero.

Возвращает Chart: This chart for fluent configuration..

Chart::values(float[])

Set chart values from floats

Replaces the plotted values without boxing numeric inputs.

Параметр	Тип	Описание
data	float[]	Values in data order; null clears the series and non-finite values create gaps.

Возвращает Chart: This chart for fluent configuration..

Chart::categories(List)

Set category labels

Sets optional labels aligned by index with the plotted values.

Параметр	Тип	Описание
categories	List	Category labels in value order; null or an empty list hides labels.

Возвращает Chart: This chart for fluent configuration..

Chart::categories()

Get category labels

Returns the current immutable category-label list.

Возвращает List: An immutable list of category labels, empty when labels are not configured..

Appearance

Метод	Описание
type()	Returns the active line or bar rendering mode.
hoveredBarColor()	Returns the mutable color used for the hovered bar.
barValuesVisible(boolean)	Enables or hides numeric labels rendered on bars.
barValuePlacement(BarValuePlacement)	Selects where numeric labels appear relative to each bar.

Chart::type()

Get chart type

Returns the active line or bar rendering mode.

Возвращает Type: The current rendering mode; defaults to LINE..

Chart::hoveredBarColor()

Get hovered bar color

Returns the mutable color used for the hovered bar.

Возвращает MutableColor: The mutable RGBA hovered-bar color..

Chart::barValuesVisible(boolean)

Show bar values

Enables or hides numeric labels rendered on bars.

Параметр	Тип	Описание
barValuesVisible	boolean	True to render bar value labels.

Возвращает Chart: This chart for fluent configuration..

Chart::barValuePlacement(BarValuePlacement)

Place bar value labels

Selects where numeric labels appear relative to each bar.

Параметр	Тип	Описание
barValuePlacement	BarValuePlacement	Placement mode; null resets to HEAD.

Возвращает Chart: This chart for fluent configuration..

Custom Rendering

Метод	Описание
barRenderer(BarRenderer)	Installs or clears a custom bar renderer.
barValueRenderer(BarValueRenderer)	Installs or clears a custom bar-value label renderer.
barTooltipRenderer(BarTooltipRenderer)	Installs or clears a custom tooltip renderer for hovered bars.
renderer(WidgetRender)	Sets the widget-level renderer used for chart rendering hooks.

Chart::barRenderer(BarRenderer)

Customize bar rendering

Installs or clears a custom bar renderer.

Параметр	Тип	Описание
barRenderer	BarRenderer	Custom renderer callback, or null to use the built-in bar rendering.

Возвращает Chart: This chart for fluent configuration..

Chart::barValueRenderer(BarValueRenderer)

Customize bar value labels

Installs or clears a custom bar-value label renderer.

Параметр	Тип	Описание
barValueRenderer	BarValueRenderer	Custom renderer callback, or null to use built-in value labels.

Возвращает Chart: This chart for fluent configuration..

Chart::barTooltipRenderer(BarTooltipRenderer)

Customize bar tooltips

Installs or clears a custom tooltip renderer for hovered bars.

Параметр	Тип	Описание
barTooltipRenderer	BarTooltipRenderer	Custom renderer callback, or null to use the built-in tooltip.

Возвращает Chart: This chart for fluent configuration..

Chart::renderer(WidgetRender)

Set chart renderer

Sets the widget-level renderer used for chart rendering hooks.

Параметр	Тип	Описание
renderer	WidgetRender	Widget renderer callback.

Возвращает Chart: This chart for fluent configuration..

Layout

Метод	Описание
preferredWidth(float)	Sets the preferred chart width in UI pixels.
preferredHeight(float)	Sets the preferred chart height in UI pixels.
preferredSize(float, float)	Sets preferred width and height in UI pixels.

Chart::preferredWidth(float)

Set preferred chart width

Sets the preferred chart width in UI pixels.

Параметр	Тип	Описание
preferredWidth	float	Preferred width in UI pixels; non-positive or non-finite values use the default.

Возвращает Chart: This chart for fluent configuration..

Chart::preferredHeight(float)

Set preferred chart height

Sets the preferred chart height in UI pixels.

Параметр	Тип	Описание
preferredHeight	float	Preferred height in UI pixels; non-positive or non-finite values use the default.

Возвращает Chart: This chart for fluent configuration..

Chart::preferredSize(float, float)

Set preferred chart size

Sets preferred width and height in UI pixels.

Параметр	Тип	Описание
width	float	Preferred width in UI pixels.
height	float	Preferred height in UI pixels.

Возвращает Chart: This chart for fluent configuration..

Interaction

Метод	Описание
onBarClick(EventListener)	Registers a listener for clicks on chart bars.

Chart::onBarClick(EventListener)

Listen for bar clicks

Registers a listener for clicks on chart bars.

Параметр	Тип	Описание
listener	EventListener	Listener receiving the clicked bar event.

Возвращает EventSubscription: A subscription handle that can be cancelled..