Bar Graph

Functional reference for BarGraphObject, including its runtime role and the supported settings available in the design environment.

Updated 3 min read
On this page (8 sections)
  1. Functional explanation
  2. Object name
  3. Settings
  4. Colors
  5. Text
  6. Position / Size
  7. Access Control
  8. Visibility

Functional explanation

BarGraphObject compares categorical values in bar form. It can be used for production counts, energy categories, downtime reasons, or similar grouped metrics.

The object is useful when category comparison matters more than time-based trend viewing. Keep the category labels concise so they remain readable.

Use it when the page needs a compact grouped comparison instead of a continuous trend line.

Object name

Set the object name shown in the bar graph decorator context.

SettingDescriptionExampleUnits
Object NameName used to identify the Bar Graph object.ProductionGraphText

Settings

Configure the chart behavior, orientation, and data source for the bar graph.

SettingDescriptionExampleUnits
Animation SpeedAnimation speed used by the chart.500ms
Legend PositionPosition of the legend. Supported values are Top and Bottom.BottomEnum
OrientationBar graph orientation. Supported values are Vertical and Horizontal.VerticalEnum
Value UnitUnit suffix appended to tooltip values.pcsText
Value FormatNumber format of the tooltip value, the same patterns as the Format of a variable: 0 shows no decimals, 0.00 always shows two decimals, 0.0## shows one to three decimals and #,##0.00 adds a thousands separator. Empty shows three significant digits, for example 1234.5 as 1.23e+3.#,##0.0Text
Show GridShows the grid lines when enabled.trueBoolean
JSON VariableVariable or expression that provides chart data as JSON.PLC1.BarGraphDataExpression
JSON Dynamic DataStatic JSON payload defining chart series and values.[{"label":"Line 1","values":[10,20]}]JSON array

Colors

Configure the color scheme for the bar graph elements.

SettingDescriptionExampleUnits
Background ColorBackground color of the chart area.#f5f5f5Color
Grid ColorColor of the grid lines.#e0e0e0Color
Zero Line ColorColor of the zero-value axis line.#666666Color
Axis Line ColorColor of the axis lines.#333333Color
Text ColorText color used for axis labels.#333333Color
Tooltip BackgroundBackground color of the tooltip.rgba(0,0,0,0.8)Color
Tooltip Text ColorText color of the tooltip.#ffffffColor

Text

Configure the font settings for the legend, category axis, and value axis labels.

11 rows
SettingDescriptionExampleUnits
Legend Font FamilyFont family used for the legend text.ArialFont family name
Legend Font SizeFont size used for the legend text.12px
Legend Font WeightFont weight used for the legend text.400CSS font weight
Category Axis Font FamilyFont family used for category axis labels.ArialFont family name
Category Axis Font SizeFont size used for category axis labels.12px
Category Axis Font WeightFont weight used for category axis labels.400CSS font weight
Category Axis Label RotationRotation angle for category axis labels.0Degrees
Value Axis Font FamilyFont family used for value axis labels.ArialFont family name
Value Axis Font SizeFont size used for value axis labels.12px
Value Axis Font WeightFont weight used for value axis labels.400CSS font weight
Value Axis Label RotationRotation angle for value axis labels.0Degrees

Position / Size

Configure the position and size of the Bar Graph object.

SettingDescriptionExampleUnits
TopTop position of the object.100px
LeftLeft position of the object.220px
WidthWidth of the object.420px
HeightHeight of the object.240px
Z-indexLayer order of the object. Higher values appear in front of lower values.10Number

Access Control

Configure access control for the Bar Graph object.

SettingDescriptionExampleUnits
Access Control EnableEnables access control evaluation for the object.trueBoolean
Access ControlExpression controlling who can use or see the object.SYSTEM.UserGroups == "Operators"Expression
Access Control FilterCSS filter applied when access control is used to alter the object appearance.blur(0px) contrast(30%)CSS filter

Visibility

Configure the runtime visibility and blinking behavior for the Bar Graph object.

SettingDescriptionExampleUnits
VisibilityExpression controlling whether the object is visible.PLC1.BarGraphVisibleExpression
BlinkExpression or boolean controlling graph blinking.PLC1.AlarmActiveBoolean or expression
Blink SpeedBlink speed used during runtime.500ms
Blink OffsetBlink offset used to stagger blinking between objects.falseBoolean
Something missing or wrong in this article? Contact us