Skip to content

Bar Vertical

The Bar Vertical shows a value as a vertical bar with a scale beside it. It is the building block the OpenBridge charts use for their axes, and works on its own as a compact level indicator in a dashboard. It is found in the Chart - OpenBridge section of the Perspective Component Palette as Bar Vertical. It is marked (Beta), because the upstream component is.

Vertical bar from 0 to 1 at 0.58, with its scale on the right, beside two trend rows

The bar is as tall as the component: resize the component to make the bar longer or shorter. Tickmarks and labels keep their size, so a longer bar gets more room between them rather than larger text. The bar and scale take a fixed width; make the component’s width large enough to show the labels.

Name Description Property Type
value The value the bar is filled up to. Default 50. value
minValue Lowest value of the scale. Default 0. value
maxValue Highest value of the scale. Default 100. value
priority regular (default) or enhanced, which draws the bar and setpoint in the blue instrument colours. value
Name Description Property Type
hasScale Show the tickmarks. Default true. value
side Side of the bar the scale is drawn on: right (default) or left. value
showLabels Label the primary tickmarks. Default true. value
primaryTickmarkInterval Interval of the long, labelled tickmarks. Shown when hasPrimaryTickmarkInterval is on (default on, 20). value
secondaryTickmarkInterval Interval of the medium tickmarks. Shown when hasSecondaryTickmarkInterval is on (default on, 10). value
tertiaryTickmarkInterval Interval of the short tickmarks. Shown when hasTertiaryTickmarkInterval is on (default off, 5). value
paddingTop Space above the scale, in px, that keeps the end labels inside the component. Default 16. value
paddingBottom Space below the scale, in px. Default 16. value

The interval properties only appear in the Property Editor while their has… toggle is on, and the secondary and tertiary toggles only while hasScale is on. For a slim bar without a scale — as in a list of percentages — set hasScale and showLabels to false.

advices is a list of ranges drawn along the scale, each with min, max, type (advice or caution) and hinted (draw the range dimmed). See Advice Zones.

advicePosition sets where the ranges are drawn: center (inside the bar, default), inner (over the short tickmarks) or outer (beside the scale, without overlapping it).

Turn on hasSetpoint to show a setpoint marker at setpoint. The other setpoint properties only appear while hasSetpoint is on:

Name Description Property Type
setpoint Value of the setpoint marker. Default 50. value
autoAtSetpoint Work out whether the value is at the setpoint from autoAtSetpointDeadband. Default true. value
autoAtSetpointDeadband How close the value must be to the setpoint to count as at setpoint. Default 1. value
atSetpoint Whether the value is at the setpoint. Appears when autoAtSetpoint is false. value

See Setpoint for how the marker looks in each state.

style works as on the maritime instruments; see Style and Events.

The Bar Vertical has no component events of its own.

A level indicator for a KPI card: minValue 0, maxValue 1, priority enhanced, primary tickmarks every 0.5 and secondary every 0.1, and value bound to the KPI. The component is placed in a column flex container above a Readout showing the same value.

Built on the OpenBridge Design System