@nero2201/node-red-dashboard-2-ui-header 1.0.3

A FlowFuse Dashboard 2.0 node that renders configurable content (text, buttons, dropdowns) directly into the dashboard header, next to the page title, on every page.

npm install @nero2201/node-red-dashboard-2-ui-header

node-red-dashboard-2-ui-header

A header node for FlowFuse Dashboard 2.0. It behaves like a small group whose elements (text, buttons, dropdowns) are rendered in the header next to the page title — on every page of the dashboard.

How It Works (Brief)

  • The node is ui-base-scoped (no Group/Page) → the Baseline layout renders it globally on all pages.
  • Content is mounted via Vue Teleport into fixed app bar targets:
    • #app-bar-title → left, directly next to the page title (Position: Left)
    • #app-bar-actions → right in the app bar (Position: Right)
  • Items are configured directly in the node (core widgets cannot be nested in a foreign group).

Item Types

Type Behavior
Text Static text, or Dynamic → displays the latest msg.payload
Button Sends { payload, topic } into the flow on click
Dropdown Sends { payload: value, topic } on selection. Options: value=Label (one per line)

Installation (Local Development)

# in the plugin directory
npm install
npm run build      # generates resources/ui-header.umd.js

# install into Node-RED user directory
cd ~/.node-red
npm install /Users/ben/Coding_root/nodered/ui-header

Then restart Node-RED. After changes to the /ui directory, run npm run build again.

Usage

  1. Drag the ui header node from the palette.
  2. Select the dashboard (ui-base) and position.
  3. Add items (Text/Button/Dropdown).
  4. Deploy → content appears in the header.
  5. Buttons/dropdowns emit msg objects; messages sent to the node's input update Dynamic text items.

Changelog

1.0.3

  • Editor: item settings are now collapsible for a cleaner overview when many items are configured.
  • Editor: page visibility list is now full width and properly aligned.
  • Editor: the Dynamic checkbox is aligned with the other input rows.
  • Editor: added a width setting for dropdowns; the font-size input is more compact.
  • Dashboard: button icons can now be updated dynamically via msg.ui_update.icon (addressed by the item's topic).
  • Dashboard: the header now stays on a single row and scrolls horizontally (thin, auto-hiding scrollbar) when space is tight, instead of clipping content.
  • Dashboard: dropdowns keep a sensible default width and no longer stretch across the app bar.

1.0.1 – 1.0.2

  • Repository/metadata fixes and README translated to English.

1.0.0

  • Initial release: header node for FlowFuse Dashboard 2.0 with text, button, dropdown and template items, dynamic styling and per-page visibility.

Node Info

Version: 1.0.3
Updated 2 days ago
License: Apache-2.0
Rating: 5.0 1

Categories

Actions

Rate:

Downloads

368 in the last week

Nodes

  • ui-header

Keywords

  • node-red
  • node-red-dashboard-2
  • dashboard
  • header
  • appbar

Maintainers