Skip to content
Version 2026.25

Text Input ​

An editable text field that reads and writes a tag on commit.

In Studio ​

In Studio, double-click Text Input in the Components category of the Components panel. It is added to the open view, where you can drag it into place.

When to use ​

Use Text Input for an operator-entered string or number where a Slider's draggable range does not fit — a setpoint typed as a number, a free-text field.

Properties ​

PropertyTypeDefaultDescription
ValueString(none)Legacy write target, used only when the component has no value binding — same contract as Button's value field.
LabelStringValueThe caption shown above the field.
PlaceholderStringEnter value...Placeholder text shown when the field is empty and not focused.
Requires Signaturefalse, truefalseSame contract as Button's Requires Signature — defers the write to the electronic-signature dialog.
Input Typetext, numbertexttext (default) accepts any entry. number makes it a numeric entry field: an entry that is not a number is refused — nothing is written and the field shows an error — even when no Min Value or Max Value is set. Setting either limit also makes the field numeric.
Min ValueString(none)The lowest number an operator may enter. Blank means no lower limit. Setting either Min Value or Max Value makes the field numeric: an entry that is not a number is refused. Can be bound, for example to a limit held in the PLC; while a bound limit cannot be read, every entry is refused and the field says "Limit not available — try again".
Max ValueString(none)The highest number an operator may enter. Blank means no upper limit. Same rules as Min Value.
DecimalsString(none)Rounds an accepted entry to this many decimal places before it is written (0 to 10). Blank means no rounding. Only applies when Min Value or Max Value is set.
FormatString(none)How a number-mode field shows its value while it is not being edited, as a number pattern such as 0,0.## (3.5999999 shows as 3.6, 1234.5 as 1,234.5). Blank shows the value as-is, or rounded to Decimals if that is set. Editing always shows the full value. Bindable.
Out Of Rangerefuse, clamprefuseWhat happens to an entry outside the limits. refuse (the default) writes nothing and shows the allowed range, for example "Must be 0–100"; clamp writes the nearest limit instead.
Field Styleauto, well, compact, underlineautoHow the field is drawn: auto (default), well, compact or underline. well is a filled, taller field, compact is the classic small bordered field, and underline is a line under the text. auto is well in a Daylight project and compact otherwise.
On-Screen Keyboardauto, numeric, full, offautoThe on-screen keypad for this field: auto (default), numeric, full or off. auto follows the project's On-Screen Keyboard setting, which opens the keypad only where there is no physical keyboard (a touch screen or Lens) and is off on a desktop browser. A project that does not use the Daylight look has that setting off unless it is set. numeric or full force that keypad here and off disables it for this field.
UnitString(none)The unit shown on the numeric keypad. Blank uses the engineering unit of the tag the field writes to.
Field ColorColor#F5F5F5The fill of the field well, and of the compact field while it is being edited. The underline style has no fill. It is a property with one built-in default: set it to a color, or to a var(--name) that a style class defines.
Border ColorColor#B0B0B0The field border while idle. Focus and a refused entry keep their own colors.
Text ColorColor#000000The value typed in the field.
Caption ColorColor#666666The caption above the field. It wins over the --raylux-c-text-input-caption-color variable.
Quality Markstandard, dimstandardHow a lost link is marked when a value this component shows has Stale or Bad quality. standard (the default) draws the quality outline and glyph over the value. dim keeps the last good value on screen, faded, with nothing drawn over it: it suits a dense panel where one lost link turns a whole column Bad. The value still reads as not live, and a binding that fails to evaluate keeps its outline either way.

Binding ​

Click Bind… on the Value property and bind it to a tag or an expression to drive the live value.

To let an operator change the tag from this component, tick Bidirectional (read-write) on the binding. Without it the component only displays the value.

Writes on blur or Enter, not on every keystroke — the field shows the live tag value while unfocused and a local edit buffer while focused, and Escape discards the edit. Focusing the field selects its whole value, so typing replaces it.