Functional explanation
DonutObject is a circular proportional chart. It is used to show part-to-whole relationships such as running versus idle time or category distribution.
The object is useful when relative share is more important than exact tabular values. Keep the number of segments limited so the chart stays readable.
Use it when a compact circular comparison is easier to read than a straight bar chart.
Object name
Set the object name shown in the donut decorator context.
| Setting | Description | Example | Units |
|---|---|---|---|
| Object Name | Name used to identify the Donut object. | StatusDonut | Text |
No rows match the filter.
Settings
Configure the ring size, animation, and data source for the donut chart.
| Setting | Description | Example | Units |
|---|---|---|---|
| Radius Width | Width of the donut ring. | 30 | px |
| Animation Speed | Duration of the opening animation, in which the segments grow from zero and the values count up. After that, a value change moves the segments and their texts to their new position in at most 400 ms, and the value text shows the new value directly. | 500 | ms |
No rows match the filter.
Data
Configure the data source and dynamic data entries for the donut chart.
| Setting | Description | Example | Units |
|---|---|---|---|
| JSON Variable | Variable or expression that provides chart data as a JSON array. | PLC1.DonutData | Expression |
| JSON Dynamic Data | Static JSON array defining chart segments with value, color, and label fields. In the designer each segment has an Editor for its value expression and an Editor for its label, in which variable names are replaced by their current values. | [{"value":70,"color":"#28a745","label":"Running"}] | JSON array |
No rows match the filter.
Text
Configure the label and value text appearance for the donut chart.
| Setting | Description | Example | Units |
|---|---|---|---|
| Label Font Family | Font family used for the segment labels. | Arial | Font family name |
| Label Font Size | Font size used for the segment labels. | 12 | px |
| Label Font Weight | Font weight used for the segment labels. | 400 | CSS font weight |
| Label Text Margin | Margin around the label text. | 5 | px |
| Label Hidden | Hides the label text when true. | false | Boolean |
| Value Font Family | Font family used for the value text. | Arial | Font family name |
| Value Font Size | Font size used for the value text. | 14 | px |
| Value Font Weight | Font weight used for the value text. | 700 | CSS font weight |
| Value Text Margin | Margin around the value text. | 5 | px |
| Value Unit | Unit suffix displayed next to values. | % | Text |
| Value Format | Number format of the value text, 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 whole numbers while the values count up in the opening animation, and the value as given afterwards. | 0.0 | Text |
| Value Hidden | Hides the value text when true. | false | Boolean |
No rows match the filter.
Position / Size
Configure the position and size of the Donut object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Top | Top position of the object. | 100 | px |
| Left | Left position of the object. | 220 | px |
| Width | Width of the object. | 220 | px |
| Height | Height of the object. | 220 | px |
| Z-index | Layer order of the object. Higher values appear in front of lower values. | 10 | Number |
No rows match the filter.
Access Control
Configure access control for the Donut object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Access Control Enable | Enables access control evaluation for the object. | true | Boolean |
| Access Control | Expression controlling who can use or see the object. | SYSTEM.UserGroups == "Operators" | Expression |
| Access Control Filter | CSS filter applied when access control is used to alter the object appearance. | blur(0px) contrast(30%) | CSS filter |
No rows match the filter.
Visibility
Configure the runtime visibility and blinking behavior for the Donut object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Visibility | Expression controlling whether the object is visible. | PLC1.DonutVisible | Expression |
| Blink | Expression or boolean controlling donut blinking. | PLC1.AlarmActive | Boolean or expression |
| Blink Speed | Blink speed used during runtime. | 500 | ms |
| Blink Offset | Blink offset used to stagger blinking between objects. | false | Boolean |
No rows match the filter.