node-red-contrib-uibuilder
Version:
Easily create data-driven web UI's for Node-RED. Single- & Multi-page. Multiple UI's. Work with existing web development workflows or mix and match with no-code/low-code features.
54 lines (45 loc) • 2.46 kB
HTML
<script type="text/html" data-help-name="uib-sender">
<p>
An easy method of sending messages to your uibuilder front-end from anywhere in your flows
and a method of easily getting a response back again.
</p>
<p>
See <a href="./uibuilder/techdocs/#/sender-node" target="_blank">Documentation: Using the sender node</a> for more detail.
</p>
<h3>Inputs</h3>
<dl class="message-properties">
<dt class="optional">payload <span class="property-type">string | buffer</span></dt>
<dd> Optionally, the payload of the message to send to all connected client browser tabs. </dd>
<dt class="optional">topic <span class="property-type">string</span></dt>
<dd> Optionally, the MQTT topic to use. Takes preference over the topic defined in settings.</dd>
</dl>
<h3>Outputs</h3>
<p>
If <code>Pass input msg to output?</code> is set, the input message is sent to the output.
</p>
<p>
If <code>Allow return messages?</code> is set, any message send from the matching uibuilder front-end app
and containing the right <code>_uib.originator</code> property is sent to the output.
</p>
<h3>Node Settings</h3>
<dl class="message-properties">
<dt>URL <span class="property-type">string (dropdown)</span></dt>
<dd>An existing uibuilder node.</dd>
<dt>Name <span class="property-type">string</span></dt>
<dd>A short description shown in the admin interface.</dd>
<dt>Topic <span class="property-type">string</span></dt>
<dd>A topic name to use if the incoming msg does not contain one.</dd>
<dt>Pass input msg to output? <span class="property-type">boolean</span></dt>
<dd>
If selected, an output port will appear and any input msg will be also delivered to the output.
This allows you to use the node in-line with a flow.
</dd>
<dt>Allow return messages? <span class="property-type">boolean</span></dt>
<dd>
If selected, an output port will appear.
This allows you to get return messages back from your uibuilder front-end app.
When returning a message, include the <code>_uib.originator</code> property with a value of
the sender node's node ID. You can get that by sending a message through the sender node.
</dd>
</dl>
</script>