Functional explanation
InputObject is a text entry field used to read and write variable values. It is suitable for numeric setpoints, string input, and operator entry fields that must allow direct manual editing.
The object can act as a normal writable input or as a read-only display field depending on the configuration. It is commonly used where operators must enter a value precisely instead of using a button or slider.
Use it for manual entry when the value must be typed, validated, and written back to a process variable or local variable.
Object name
Set the object name shown in the input decorator context.
| Setting | Description | Example | Units |
|---|---|---|---|
| Object Name | Name used to identify the Input object. | SetpointInput | Text |
No rows match the filter.
Variable / Expression
Configure the variable or expression bound to the input value.
| Setting | Description | Example | Units |
|---|---|---|---|
| Variable / Expression | Variable or expression bound to the field value. | PLC1.Setpoint | Expression |
No rows match the filter.
Label
Configure the label text shown with the Input object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Label | Label text displayed with the input field. | Setpoint | Text |
No rows match the filter.
Text
Configure the text formatting and display behavior for the Input object.
16 rows
| Setting | Description | Example | Units |
|---|---|---|---|
| Color | Text color used for the input. | #212529 | Color |
| Background Color | Background color used behind the input. A gradient can be used here as well as a single color; see the Gradients section of the Color Library article. | #FFFFFF | Color |
| Font Family | Font family used for the input text. | Arial | Font family name |
| Font Align | Horizontal alignment of the input text: Left, Center or Right. | Left | Selection |
| Font Size | Font size used for the input text. A number without a unit is applied in px. | 14 | px |
| Font Weight | Font weight used for the input text. | 400 | CSS font weight |
| Padding | Space between the border and the input text. Enter one to four values in the order top, right, bottom, left, for example 4 8 for 4 px at the top and bottom and 8 px at the left and right. A number without a unit is applied in px. | 4 8 | px |
| Read Only | Makes the field display-only when true. | false | Boolean |
| Password Field | Masks the input like a password field. | false | Boolean |
| Floating Point | Treats the value as a floating-point number and shows it with the number of Decimals. When off, a value from one variable is shown with the Format of that variable when the variable has one, and the Input shows the plain value while it is being edited. | true | Boolean |
| Decimals | Number of decimals used for numeric display when Floating Point is on. It overrides the Format of the variable for this input. | 2 | Number |
| Units | Appends the configured variable unit when true. | true | Boolean |
| Numpad | Enables the on-screen numpad for text entry. | false | Boolean |
| Decimal Symbol | Enables the decimal symbol on the numpad. | true | Boolean |
| Minus Symbol | Enables the minus symbol on the numpad. | true | Boolean |
| Keyboard | Enables the on-screen keyboard for text entry. | false | Boolean |
No rows match the filter.
Position / Size
Configure the position and size of the Input 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. | 180 | px |
| Height | Height of the object. | 32 | px |
| Z-index | Layer order of the object. Higher values appear in front of lower values. | 10 | Number |
No rows match the filter.
Border
Configure the border styling for the Input object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Border Color | Border color used for the input. | #CED4DA | Color |
| Border Color States | Dynamic border color state rules JSON array. | [{"state":"alarm","color":"#dc3545"}] | JSON array |
| Border Width | Border width used for the input. | 1 | px |
| Border Radius | Corner radius of the input border. | 4 | px |
| Border Visibility | Expression controlling whether the border is visible. | SYSTEM.UserGroups == "Operators" | Expression |
| Border Blink | Expression or boolean controlling border blinking. | PLC1.AlarmActive | Boolean or expression |
| Border Blink Speed | Blink speed used for the border. | 500 | ms |
| Border Blink Offset | Blink offset used to stagger border blinking between objects. | false | Boolean |
No rows match the filter.
Animate Position / Size
Configure the runtime animation settings for height, width, top, and left of the Input object.
22 rows
| Setting | Description | Example | Units |
|---|---|---|---|
| Animate Height Variable | Variable or expression that drives runtime height animation. | PLC1.Level | Variable or expression |
| Animate Height Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Height Maximum Raw | End of the raw value span. The animated height reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Height Minimum px | Start of the pixel span. The animated height runs from 0 px up to the difference between Maximum px and Minimum px. | 20 | px |
| Animate Height Maximum px | End of the pixel span. With Minimum px at 0, this is the height at full scale. | 60 | px |
| Animate Height Reverse | Sets the edge the height grows from. Cleared grows the object upwards from the bottom edge, which suits level and fill graphics. Selected grows it downwards from the top edge. | false | Boolean |
| Animate Width Variable | Variable or expression that drives runtime width animation. | PLC1.Value | Variable or expression |
| Animate Width Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Width Maximum Raw | End of the raw value span. The animated width reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Width Minimum px | Start of the pixel span. The animated width runs from 0 px up to the difference between Maximum px and Minimum px. | 80 | px |
| Animate Width Maximum px | End of the pixel span. With Minimum px at 0, this is the width at full scale. | 220 | px |
| Animate Width Reverse | Sets the edge the width grows from. Cleared grows the object to the right from the left edge. Selected grows it to the left from the right edge. | false | Boolean |
| Animate Top Variable | Variable or expression that drives runtime top-position animation. | PLC1.PositionTop | Variable or expression |
| Animate Top Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Top Maximum Raw | End of the raw value span. The offset reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Top Minimum px | Start of the pixel span. A rising value moves the object upwards from its resting position by up to the difference between Maximum px and Minimum px. To move the object downwards, set Minimum px above Maximum px. | 100 | px |
| Animate Top Maximum px | End of the pixel span. A rising value moves the object upwards by up to the difference between Maximum px and Minimum px. | 260 | px |
| Animate Left Variable | Variable or expression that drives runtime left-position animation. | PLC1.PositionLeft | Variable or expression |
| Animate Left Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Left Maximum Raw | End of the raw value span. The offset reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Left Minimum px | Start of the pixel span. A rising value moves the object to the right from its resting position by up to the difference between Maximum px and Minimum px. To move the object to the left, set Minimum px above Maximum px. | 200 | px |
| Animate Left Maximum px | End of the pixel span. A rising value moves the object to the right by up to the difference between Maximum px and Minimum px. | 420 | px |
No rows match the filter.
Access Control
Configure access control for the Input 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 Input object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Visibility | Expression controlling whether the object is visible. | PLC1.InputVisible | Expression |
| Blink | Expression or boolean controlling input 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.