Skip to content

Zeigt ein nicht bearbeitbares Textfeld in der Benutzeroberfläche an. Jede empfangene msg.payload aktualisiert den neben der (optional) Beschriftung angezeigten Wert.

Eigenschaften

PropDynamicDescription
GruppeDefiniert, in welcher Gruppe des UI-Dashboards dieses Widget gerendert wird.
GrößeSteuert die Breite des Buttons in Bezug auf die übergeordnete Gruppe. Der Maximalwert ist die Breite der Gruppe.
BeschriftungDer Text, der innerhalb des Buttons angezeigt wird. HTML-Inhalt ist erlaubt.
LayoutWählen Sie, wie Sie Ihre Beschriftung (falls definiert) und den Wert anordnen möchten.
StilKontrollkästchen, um festzulegen, ob benutzerdefinierte Stile für den Text enthalten sein sollen. Wenn dies aktiviert ist, werden die unten stehenden Optionen angezeigt.
SchriftartWenn "Stil" aktiviert ist, wird dies die Schriftart des Textes definieren.
TextgrößeWenn "Stil" aktiviert ist, wird dies die Größe des Textes definieren.
TextfarbeWenn "Stil" aktiviert ist, wird dies die Farbe des Textes definieren.

Hinzufügen von Präfixen & Suffixen

Im Dashboard 1.0 gab es eine Option namens valueFormat, die es Ihnen ermöglichte, einem ui-text-Widget innerhalb der Knotenkonfiguration ein Präfix oder Suffix hinzuzufügen. Obwohl wertvoll, hatte dies viele Sicherheitslücken, daher haben wir uns mit Dashboard 2.0 entschieden, es zu entfernen.

Stattdessen verfolgen wir einen anderen Ansatz und verwenden den eingebauten "template"-Knoten von Node-RED:

Was folgendes rendert:

Hinzufügen eines Suffixes zu einem UI-Text-ElementBeispiel eines gerenderten Suffixes auf einem UI-Text-Element

Wir tun dies, weil dieser Ansatz weit über das ui-text-Widget hinaus verwendet werden kann und HTML-Inhalte in jedes Widget durch dynamische Eigenschaften injizieren kann.

HTML rendern

Das ui-text-Widget unterstützt HTML-Inhalte (über msg.payload). Dies ermöglicht es Ihnen, formatierten Text, Links, Bilder und mehr zu rendern.

Statisches HTML

Zum Beispiel, das Injizieren von:

html
<a href="https://flowfuse.com" target="_blank">FlowFuse</a>

als msg.payload würde folgendes rendern:

HTML-Inhalt im Text

msg.-Inhalt rendern

Wenn Sie den Inhalt einer msg. rendern und diesen dennoch mit HTML umwickeln möchten, können Sie den Standard-template-Knoten von Node-RED verwenden, um die HTML-Struktur zu definieren:

Mit dem Inhalt des template-Knotens auf:

HTML-Inhalt im TextBeispiel eines "template"-Knotens zur Strukturierung von HTML-Inhalten in einem Textknoten

Dynamische Eigenschaften

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.

PropPayloadStructuresExample Values
Beschriftungmsg.ui_update.labelString
Layoutmsg.ui_update.layoutString<'row-left', 'row-center', 'row-right', 'row-spread', 'col-center'>
Schriftartmsg.ui_update.fontString
Schriftgrößemsg.ui_update.fontSizeString
Farbemsg.ui_update.colorString
Klassemsg.classString

Beispiel

Beispiele für TextBeispiele für Varianten von ui-text, die in einem Dashboard gerendert werden.