These nodes require node.js version 12 or more recent. The last version to support node v8 was 2.30.0. Show From version 2.10.0 you can create and install widget nodes like other Node-RED nodes. See the Wiki for more information. For the latest updates see the CHANGELOG.md NOTE: This project is based on Angular v1 - As that is now no longer maintained, this project should be considered to be on "life support". Small patches will be applied on a best can do basis, but there will be no major feature upgrades, and underlying security breakage may occur. Pre-requisitesThe Node-RED-Dashboard requires Node-RED to be installed. InstallTo install the stable version use the 7 option and search for 8, or run the following command in your Node-RED user directory - typically 9:
Restart your Node-RED instance and you should have UI nodes available in the palette and a new 0 tab in the right side panel. The UI interface is available at http://localhost:1880/ui (if the default settings are used).If you want to try the latest version from github, you can install it by
SettingsThe default url for the dashboard is based off your existing Node-RED httpRoot path with /ui added. This can be changed in your Node-RED settings.js file.
You can also add your own express middleware to handle the http requests by using the 1 property in settings.js. For example
You can also add middleware to the websocket connection using
Note: both of these also accept an array of functions if you need to pass in multiple middleware actions. Setting your own ioMiddleware will disable the default cross domain origin check. You can also set the dashboard to be read only by 2. This does not stop the user interacting with the dashboard but does ignore all updates coming from the dashboard.Finally you can customise the default Group name (for i18n) by setting
You can of course combine any combination of these properties LayoutThe dashboard layout should be considered as a grid. Each group element has a width - by default 6 'units' (a unit is 48px wide by default with a 6px gap). Each widget in the group also has a width - by default, 'auto' which means it will fill the width of the group it is in, but you can set it to a fixed number of units. The layout algorithm of the dashboard always tries to place items as high and to the left as they can within their container - this applies to how groups are positioned on the page, as well as how widgets are positioned in a group. Given a group with width 6, if you add six widgets, each with a width of 2, then they will be laid out in two rows - three widgets in each. If you add two groups of width 6, as long as your browser window is wide enough, they will sit alongside each other. If you shrink the browser, at some point the second group will shift to be below the first, in a column. It is advisable to use multiple groups if possible, rather than one big group, so that the page can dynamically resize on smaller screens. FeaturesThe widget layout is managed by a 0 tab in the sidebar of the Node-RED editor.Layout
Site
Theme
You can also choose to use the basic Angular Material themes instead if you like, either just within any ui_templates or for the whole Dashboard. This will only affect angular components so some of the charts and so on may need extra work. Note: For users creating their own templates the following CSS variable names are available to help pick up the theme colours.
WidgetsDon't forget there are also extra ui widgets available on the Node-RED flows website. Search for node-ui- or contrib-ui- . Group labels are optional. Most widgets can have a label and value - both of these can be specified by properties of the incoming msg if required, and modified by angular filters. For example the label can be set to 5, or the value could be set to 6 to round the value to one decimal place and append a % sign.Each node may parse the 7 to make it suitable for display. This converted version is exposed as the variable called 8, (see example above).Any widget can be disabled by passing in a 9 property set to 0. Note: this doesn't stop the widget receiving messages but does stop inputs being active and does re-style the widget.Most widgets and the ui group can have a CSS class or multiple CSS class names. This permits the user to override styles one or more widgets and their inner contents. e.g to colourise a warning toast, add the CSS class 1 to the notification widget and add a ui-template (set to "Add to site head section")...
Additionally, any widget that has a Class field can be dynamically updated by passing in a 2 string property set to one or more class names.Most ui widgets can also be configured by using a 3 message - see config-fields.md for further details.
Tip: The Text widget will accept html - so you can use it together with the fa-icons we already use to create indicator type widgets. IconsThe dashboard has 4 sets of icons built in. They are And one that can only be used if you have a permanent connection to the internet
Again note you have to add 3 to the icon name in the icon set of your choice. You may also optionally specify a size in standard px or em notation. Default is 24px. You must also add a ui_template node that loads the necessary iconify library into the header of the dashboard. It should contain
Once you have done that then you can also use them more generally, for example
You may also create your own set of icons using Icofont. Once downloaded you can serve them locally via Node-RED and add them to the head of the dashboard page by using a ui_template node : e.g.
then you can use then as per above by adding the icofont- prefix e.g. 4Or just use them in a template 1And finally via an image - https://{myserver/path/image.png} You can use them in any of the Icon fields. You may also be able to use some of them for example in labels via their inline style eg 5Loading the DashboardDue to the size of the dashboard libraries it can take a long time to load if you are running on wireless network. It is possible add a custom loading page if you wish. To do so add a file called 6 to the 7 folder. A simple example could be 2Securing the DashboardYou can use the 8 property in your Node-RED settings.js file to secure the Dashboard as it is created the same way as other HTTP nodes are. The details can be found at the bottom of this page in the docs http://nodered.org/docs/securityMultiple UsersThis Dashboard does NOT support multiple individual users. It is a view of the status of the underlying Node-RED flow, which itself is single user. If the state of the flow changes then all clients will get notified of that change. Messages coming from the dashboard do have a 9, and updates like change of tab, notifications, and audio alerts will be directed only to that session. Delete the 0 to send to all sessions.Discussions and suggestionsUse the Node-RED Discourse Forum: https://discourse.nodered.org/c/dashboard or the Dashboard-ui channel in Slack to ask questions or to discuss new features. The current work in progress list is shown in the Github Project. ContributingBefore raising a pull-request, please read our contributing guide. This project adheres to the Contributor Covenant 1.4. By participating, you are expected to uphold this code. Please report unacceptable behavior to any of the project's core team. Developers 3The plugin uses the 1 folder if it exists. Make sure it has been deleted if you want to use the non-minified version while developing. After finishing changes to the front-end code in the src folder, you can use 2 to update and rebuild the minified files and update the appcache manifest.
Bagaimana cara kerja Nodejs?Cara Kerja Node.js
Node.js menggunakan operasi I/O non-blocking. Artinya, saat client mengirim permintaan ke web server, event loop single-threaded Node JS akan mengambil permintaan tersebut lalu mengirimkannya ke worker thread untuk diproses.
Node JS cocok untuk apa?Penggunaan Node.js
Node.js biasanya digunakan dalam pemrograman seperti aplikasi yang menggunakan program interface (API) JavaScript Object Notation (JSON), aplikasi single-page, dan aplikasi yang melakukan streaming data.
Apakah Node JS itu Framework?Setelah belajar Node js di artikel ini, tentunya Anda sudah paham apa itu Node js. Intinya, Node js adalah framework JavaScript open source yang sering digunakan untuk mengembangkan aplikasi web karena efisiensinya dalam mengelola data.
Siapa yang membuat Node JS?Node.js pertama kali diciptakan oleh Ryan Dahl pada tahun 2009. Ryan Dahl merupakan seorang pengembang dari Joyent, ia memiliki ketertarikan dengan penerapan single-threaded pada bahasa pemrogaman sisi server. Setelah mencoba menggunakan Haskell, C dan Lua, akhirnya ia memilih Javascript sebagai bahasa untuk Node.js.
|