This widget for displaing multilines user content and may be usefull for tables. You can use markdown syntax to displaing any data. For syntax details see showdown and demo
Content of this widget always “sanitized” (will be removed: links, images, js code and dangerous html tags) for security reason.
<div style="style1" class="class1">
<div>converted from markdown html</div>
</div>
id
- integer, required widget id (must be unique on device, also used for widget sorting on page), use numeric value for widgets sorting on dashboard pages
pageId
- integer, optional (needed only when you planing use widgets on several pages), always > 0
(0
- for system page “All”) value for page ID (used for pages sorting), for example 1
or 70
. Beter way: use 10
, 20
, 30
, for easy new page inserting in future.
page
- string, optional (needed only when you planing use widgets on several pages) value for page name (widgets group name), for example kitchen
. Page name always capitalized by IoT Manager.
class1
- string, optional HTML classes list div
element. You can use Color classes, Padding classes, Other usefull classes and Bootstrap3 col-xs and col-xm grids classes, for example item no-border
style1
- string, optional HTML style for div
elements (you can use any HTML5 styles), for example padding-top:5px;padding-bottom:10px;
(descrStyle
for ON state and descrStyleOff
for OFF state)
class2
- string, optional HTML classes list for second level div
element descr
(you can use Color classes, Padding classes, Other usefull classes and Bootstrap3 col-xs and col-xm grids classes), for example assertive text-center
style2
- string, optional HTML style for second level div
element descr
(you can use any HTML5 styles), for example font-size:20px;font-weight:bold;
class3
- string, optional HTML classes list for 3rd level div
element (you can use Color classes, Padding classes, Other usefull classes and Bootstrap3 col-xs and col-xm grids classes), for example text-center
style3
- string, optional HTML style for 3rd level div
element (you can use any HTML5 styles), for example padding-top:5px;padding-bottom:5px;
topic
- string, required broker topic for this widget (must be unique at the project, and must contains unique device name), for example /IoTmanager/device01/sensor01
.
Widget get status
value from subcribed topic /IoTmanager/device01/sensor01/status
for displaying value in widget, received status
must be a JSON string {status:100}
You can show/hide any widget: send widget-config JSON contains only widget id for widget hiding (for example, { "id":"5" }
) and full config for showing.
user
- string, optional. If this field exist, then IoT Manager compare broker username and user
field. If equal, message passed, else skipped.
users
- string, optional. Userlist separate by space. If this field exist, then IoT Manager check for broker username contains in users
field. If yes, message passed, else skipped.
This feature not for security reason. For users ACL, please, use brokers feature (grant access to topics by username).
uuid
- string, optional. If exist, this config message will be parced only on device with specified UUID.
minWidth
- integer, optional. If exist, message parser compare device width and minWidth
fiels. If device_width >= minWidth
then config message passed, else skipped.
maxWidth
- integer, optional. If exist, message parser compare device width and maxWidth
fiels. If device_width <= maxWidth
then config message passed, else skipped.
Usally, status
message contains wedget value only, for example { status: 50 }
or { status: "50" }
.
But, in several cases, you can want to add some extra features:
vibrate
- execute action vibrate
when message received, for example { status: 50, vibrate: 100 }
, where 100
- vibration time in milliseconds.
toast
- execute action toast
when message received, for example { status: 50, toast: "Alert!" }
, where Alert!
- showing message.
toastLong
- execute action toastLong
when message received, for example { status: 50, toastLong: "Alert!" }
, where Alert!
- showing message.
beep
- execute action beep
when message received, for example { status: 50, beep: 1 }
, where 1
- beeper counter.
speech
- speech text, for example { status: 50, speech: 'hello' }
or try { status: 50, speech: '50' }
.
rate
- float, from 0
to 1
speech rate, for example { status: 50, speech: 'hello', rate: 0.7 }
. Default rate 1
.
locale
- string, speech locale, for example { status: 50, speech: 'hello', rate: 0.7, locale: 'fr-FR' }
. Default locale en-US
.
{
id : id,
widget : widget,
topic : prefix + "/" + deviceID + "/" + widget + id,
class1 : "item" // for padding
}
## Sample status
message
var text = '\n';
text += '\n__Sensor1 ' + x + '__';
text += '\n~~Sensor2 ' + y + '~~';
text += '\n**Sensor3 ' + z + '**';
text += '\n*Sensor4 ' + z1+ '*';
text += '\n';
text += '\n| Tables | Are | Cool |';
text += '\n| -------- |:-------------:|------:|';
text += '\n| col 2 | centered |'+x+'|';
text += '\n| col 3 | **right** |'+y+'|';
text += '\n| col 1 | ~~left~~ |'+z+'|';
text += '\n| | 4 |'+z1+'|';
text += '\n';
text += '\n# Sensor 1: '+x;
text += '\n## Sensor 2: '+y;
text += '\n### Sensor 3: '+z;
text += '\n#### Sensor 4: '+z1;
text += '\n';
status = { status: text }
Demo sketches for Arduino IDE, Platformio, NodeJS, python, bash