Skip to content

Text Input ui-text-input

Adds a single text input row to your dashboard, with a configurable "type" (text, password, etc).

Properties

PropDynamicDescription
GroupDefines which group of the UI Dashboard this widget will render in.
SizeControls the width of the text input field with respect to the parent group. Maximum value is the width of the group.
IconRenders a Material Design icon within the Text Input. There is no need to include the "mdi-" prefix.
Icon PositionIf "Icon" is defined, this property controls which side of the "Label" the icon will render on.
Icon Inner PositionIf "Icon" is defined, this property controls if icon is render inside or outside the text input box
LabelThe text shown within the text input field.
TooltipThe text shown when hovering over the text input field.
ModeThe type of HTML input to display. Options - text | password | email | number | tel | color | date | time | week | month | datetime-local
PassthroughIf this node receives a msg in Node-RED, should it be passed through to the output as if a new value was inserted to the input?
Send On "Delay"If true, then a msg will be emitted will be sent after the delay specified in "Delay (ms)".
DelayIf "Send on Delay" is true, then the value in the text input will be send after this (ms) delay.
Clear selection with buttonIf true, a clear icon/button appears on the rigth side to clear the text input
Send On "Focus Leave"Sends a msg when the text input loses focus. Will always send, even if the value has not changed.
Send On "Press Enter"Sends a msg when the user presses the enter key. Will always send, even if the value has not changed.
Send On "Clear Button"Send a msg when the user clear the text input using the clear button, the "Clear Selection" button must be enabled.

Dynamic Properties

Dynamic properties are those that can be overriden at runtime by sending a particular msg to the node.

Where appropriate, the underlying values set within Node-RED will be overriden by the values set in the received messages.

PropPayloadStructures
Classmsg.classString

Controls

msg.ExampleDescription
enabledtrue | falseAllow control over whether or not the text-input is enabled

Example

Example of Text Inputs TypesExample of severall Text Inputs Types rendered in a Dashboard.