Widget "NumericInput" is used to enter a numerical value. Tapping the widget opens widget "NumPad" automatically, allowing input using the numeric keys or slider.
If an OPC UA node is bound, it is also possible to displays the unit according to the selected system of measurement. With a node binding, the limits of the OPC UA node are used; with value binding, the configured values of properties "minValue" and "maxValue" are used.
The following properties cannot be used in compound widget "Mapping":
zIndex, left, top, height, width
Appearance
|
|
Editor |
Web browser |
Properties
Type |
Description |
Bindable |
Necessary |
Default value |
|
ellipsis |
Defines whether a number that is too long should be indicated by an ellipsis, e.g. "12012 ..." instead of "120125100". |
|
|
false |
|
Defines the usability of the widget. A disabled widget (enable=false) does not react to user interaction and does not trigger events. The "disabled..." style is displayed at runtime. The "enable" behavior is inherited from the container widgets to the child widgets. |
|
|
true |
||
Defines the number format for the widget. |
|
|
{'metric':{ 'decimalPlaces' : 1, 'minimumIntegerDigits' : 1 }, 'imperial' :{ 'decimalPlaces' : 1, 'minimumIntegerDigits' : 1 }, 'imperial-us' :{ 'decimalPlaces' : 1, 'minimumIntegerDigits' : 1 }} |
||
keyboard |
Defines whether an on-screen keyboard is used for entries. If keyboard=true, an on-screen keyboard is used and opens automatically as soon as input is required in the widget. If keyboard=false, it must be ensured that a hardware keyboard is available. |
|
|
true |
|
limitViolationPolicy |
Defines the behavior in case of a value range violation. This property is not applied if the set value is the default value or if the value comes from a binding or the action/event system. |
|
|
noSubmit |
|
maxValue |
Defines the maximum permissible value for value binding. With node binding, the "high" attribute for the EU range from the OPC UA variable is used. |
|
|
100 |
|
minValue |
Defines the minimum permissible value for value binding. With node binding, the "low" attribute for the EU range from the OPC UA variable is used. |
|
|
0 |
|
Value with unit for node binding. |
|
|
|
||
numPadStyle |
Reference to a customizable widget style. This style is used for the numeric pad. |
|
|
default |
|
numpadPosition |
Defines the position of the number pad. The number pad is always placed relative to the widget. |
|
|
right |
|
permissionOperate |
Defines the roles that are permitted to use the widget. For roles without sufficient rights, the widget does not react to user interaction and does not trigger events. |
|
|
|
|
permissionView |
Defines the roles that are permitted to see the widget. For roles without sufficient rights, the widget is hidden. |
|
|
|
|
showUnit |
Defines whether the unit should be displayed. A node binding is necessary for this. |
|
|
true |
|
Reference to a customizable widget style. |
|
|
default |
||
submitOnChange |
Defines whether changes, such as entry of a different value, should be submitted to the server immediately. Submit immediately = true. If false, action SubmitChange can be used to send the new value to the server. |
|
|
true |
|
Defines the unit code of the widget. |
|
|
|
||
unitAlign |
Defines the position of the unit, e.g. °C. |
|
|
left |
|
unitWidth |
Defines the minimum width of the unit's area. Value 0 means that an automatic width is set in relation to the size of the widget. |
|
|
0 |
|
useDigitGrouping |
Defines whether number grouping should take place. If useDigitGrouping = true, the number 100000 will become 100,000, for example. |
|
|
true |
|
This property can be used to carry out a variable binding. The bound value is displayed in the widget. |
|
|
0 |
||
Defines the visibility of the widget. The widget can be hidden with visible=false. (visible = true, hidden = false). The "visible" behavior is inherited from the container widget to the child widgets. |
|
|
true |
||
zIndex determines the z-order of the widget. With overlapping widgets, the zIndex determines which widget is on the top and which one is on the bottom. The widget with the larger zIndex is on top, and the one with the smaller zIndex is on the bottom. The zIndex must be unique within a piece of content or a container widget. The zIndex is automatically assigned by the visual editor and can therefore be changed via the toolbar. |
|
|
|
||
left |
Absolute position measured from the left border of the surrounded element (e.g. container widget or content). |
|
|
|
|
top |
Absolute position measured from the top border of the surrounded element (e.g. container widget or content). |
|
|
|
|
height |
Defines the total height of the widget in pixels. A value in % refers to the height of the surrounding element. |
|
|
30 |
|
width |
Defines the total width of the widget in pixels. A value in % refers to the width of the surrounding element. |
|
|
100 |
|
unitTextAlign |
Defines the position of the unit symbol in its container. The size of the container can be changed with property "unitWidth". |
|
|
center |
|
tooltip |
Defines the text that should appear as information when the tooltip indicator is pressed. You can use a static text or a text from the text system. For more information, see here. Mode "Tooltip" must be enabled for this. There are two different options for this: •Using action "ShowTooltip" •Using action "Client system" ShowTooltips. |
|
|
|
|
draggable |
Defines whether the widget can be dragged at runtime. This can be used to perform actions or establish relationships between two widgets. If true, the widget can be moved onto another widget. The source widget remains in its position and a copy is created and dragged. Actions OnDragStart and OnDragEnd can be used. If false, the widget cannot be moved. For more information, see here. |
|
|
false |
|
tabIndex |
Property tabIndex is used to manage the tab order during keyboard operation. For additional information, see Keyboard operation. ENTER triggers event Click if tabIndex ≥0. According to the OnStart configuration in the HMI application, a value can be entered and applied accordingly with OnEnd. |
|
|
0 |
Styleable properties
type |
description |
defaultValue |
|
borderWidth |
Defines the width of the border around the widget. |
2px 6px 2px 2px |
|
activeBorderWidth |
Defines the width of border around the widget during active operation. |
2px 6px 2px 2px |
|
disabledBorderWidth |
Defines the width of the border around the widget in the disabled state. |
2px 6px 2px 2px |
|
cornerRadius |
Defines the corner style of the widget. |
0px |
|
backColor |
Defines the background color of the widget. |
#FFFFFF |
|
disabledBackColor |
Defines the background color of the widget in the disabled state. |
#F1F1F1 |
|
backGroundGradient |
Defines the background color of the widget as a color gradient. |
|
|
disabledBackGroundGradient |
Defines the background color of the widget as a color gradient in the disabled state. |
|
|
borderColor |
Defines the color of the border around the widget. |
#555555 |
|
disabledBorderColor |
Defines the color of the border around the widget in the disabled state. |
#C8C8C8 |
|
activeBorderColor |
Defines the color of the border around the widget during operation. |
#FF8800 |
|
activeBackColor |
Defines the background color of a widget during operation. |
#F1F1F1 |
|
activeTextColor |
Defines the color used to display the text during operation. |
#000000 |
|
borderStyle |
Defines the style of the border around the widget. Borders can be unbroken, dashed or dotted. |
solid |
|
textColor |
Defines the color used to display the text. |
#000000 |
|
disabledTextColor |
Defines the color of the text in the disabled state. |
#C8C8C8 |
|
textAlign |
Defines the orientation of the text. |
right |
|
opacity |
Defines the transparency of the widget. The lower the value, the more transparent the widget. |
1 |
|
fontName |
Defines the font used for the text shown. |
Arial |
|
fontSize |
Defines the size of the font used to display the text. |
20px |
|
unitFontSize |
Defines the font size used to display the unit, e.g °C. |
14px |
|
rotation |
Defines the rotation of the widget, e.g. a value of 90 degrees changes the rotation of the widget by 90 degrees clockwise. |
0deg |
|
bold |
Defines whether the text is shown in bold. |
true |
|
italic |
Defines whether the text is shown in italics. |
false |
|
shadow |
Defines the shadow of the widget. |
none |
|
padding |
Defines the spacing between the outer boundary of the widget and its content. For more information, see here. |
0 15px 0 15px |
|
margin |
Defines the offset of the external boundary of the widget to the widget's actual set position. For more information, see here. |
0px |