Benachrichtigung ui-notification Added In: v0.5.0
Im Dashboard 1.0 als "Toast" bekannt, zeigt dieses Widget Text/HTML in einem kleinen Fenster an, das für eine definierte Dauer (timeout) und an einem definierten Ort auf dem Bildschirm (position) erscheint.
Wenn Sie möchten, dass die Benachrichtigung unbegrenzt angezeigt wird, können Sie timeout auf 0 setzen. Es wird nicht möglich sein, die Benachrichtigung manuell zu schließen, es sei denn, Sie setzen auch allowDismiss oder allowConfirm auf true.
Eigenschaften
| Prop | Dynamic | Description |
|---|---|---|
| UI | Im Gegensatz zu den meisten Widgets werden Benachrichtigungen von einer "UI" und nicht von einer Gruppe verwaltet. Dadurch können Benachrichtigungen auf allen Seiten angezeigt werden. | |
| Position | Die Position auf dem Bildschirm, an der die Benachrichtigung angezeigt wird. | |
| Farbe | Die Farbe, die für den Benachrichtigungsrahmen verwendet werden soll. | |
| Timeout | Anzahl der Sekunden, bevor die Benachrichtigung automatisch geschlossen wird. | |
| Countdown-Leiste anzeigen | Ob eine abnehmende Fortschrittsleiste angezeigt werden soll, um die verbleibende Zeit anzuzeigen, bevor die Benachrichtigung geschlossen wird. | |
| Manuelle Schließung zulassen | Zeigt einen Button für Benutzer an, um die Benachrichtigung zu schließen. Andernfalls wird sie nur nach dem Timeout geschlossen. | |
| Manuelle Schließung zulassen - Button-Beschriftung | Wenn "Manuelle Schließung zulassen" aktiviert ist, ist dies die Beschriftung für den Button. | |
| Manuelle Bestätigung zulassen | Zeigt einen Button für Benutzer an, um die Benachrichtigung zu bestätigen. Andernfalls wird sie nur nach dem Timeout geschlossen. | |
| Manuelle Bestätigung zulassen - Button-Beschriftung | Wenn "Manuelle Bestätigung zulassen" aktiviert ist, ist dies die Beschriftung für den Button. | |
| Rohdaten akzeptieren | Ob Sie rohes HTML übergeben, das clientseitig verarbeitet werden soll. | |
| Klasse | Fügt dem Widget CSS-Klassen hinzu |
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.
| Prop | Payload | Structures | Example Values |
|---|---|---|---|
| Deaktivierter Zustand | msg.enabled | Boolean | |
| Bestätigung zulassen | msg.ui_update.allowConfirm | Boolean | |
| Schließung zulassen | msg.ui_update.allowDismiss | Boolean | |
| Farbe | msg.ui_update.color | String | |
| Bestätigungsbutton-Text | msg.ui_update.confirmText | String | |
| Schließungsbutton-Text | msg.ui_update.dismissText | String | |
| Anzeigedauer (Timeout) | msg.ui_update.displayTime | Number | |
| Position | msg.ui_update.position |
| |
| Fortschrittsleistenfarbe | msg.ui_update.progressColor | String | |
| Rohes HTML akzeptieren | msg.ui_update.raw | Boolean | |
| Countdown-Leiste anzeigen | msg.ui_update.showCountdown | Boolean |
Steuerungen
| msg. | Example | Description |
|---|---|---|
| anzeigen | true | false | Ermöglicht die Steuerung darüber, ob die Benachrichtigung sichtbar ist. |
Beispiel
Beispiel einer gerenderten Benachrichtigung in einem Dashboard mit einer Fortschrittsleiste, die anzeigt, wie lange es noch dauert, bis sie automatisch geschlossen wird.
Diese Benachrichtigung wurde mit einem msg.payload von:
<h3>Generierte Benachrichtigung</h3><p>Dies ist benutzerdefiniertes HTML, das in <b>Node-RED</b> eingefügt wurde</p>An alle Clients senden
Benachrichtigungen sind standardmäßig darauf beschränkt, an einen einzelnen Benutzer/Client gesendet zu werden. Im Dashboard 2.0 wird diese Einschränkung durch msg._client definiert. Sie können mehr darüber hier lesen.
Wenn Sie eine Benachrichtigung an alle verbundenen Clients senden möchten, können Sie den msg._client-Wert mit einem "Änderungs"-Knoten entfernen, der so konfiguriert ist, dass die _client-Eigenschaft "gelöscht" wird.