New Custom Pages (2017): Difference between revisions
Stefan Ritt (talk | contribs) No edit summary |
Stefan Ritt (talk | contribs) No edit summary |
||
| Line 145: | Line 145: | ||
which results in this page: | which results in this page: | ||
[[File:Custom17. | [[File:Custom17.png]] | ||
Revision as of 05:08, 9 November 2017
A new scheme of custom pages making use of modern HTML5 techniques has been introduced in 2017. This page describes all new elements and gives some example pages.
Required Elements
For the new custom pages to work, following elements in a custom HTML page are required:
- Including
midas.js - Including
mhttpd.js - Including style sheet
midas.css - Setting the class of the HTML body to
mcss - Calling
mhttpd_init('name')on page load wherenameis the name of the page shown on the left menu bar - Using
divelements with various pre-defined id's and names
modbvalue
The special HTML div tag (abbreviation stands for Midas ODB VALUE) <div name="modbvalue" data-odb-path="/Some/Path"> is now automatically replaced by the value in the ODB found at the given path. Updates are one once per second, which can be changed by passing a second argument to mhttpd_init('name', interval) where interval is in milliseconds. Following options are valid for this tag:
| Option | Example | Meaning |
|---|---|---|
| name | name="modbvalue" | Tells the framework to replace this tag with an ODB value |
| data-odb-path | data-odb-path = "/Runinfo/Run number" | Path to the value in the ODB |
| data-odb-editable | data-odb-editable="1" | If set, the value is not only shown, but is also clickable for in-line editing. Hitting return send the new value to the ODB. |
| data-format | data-format="f3" | Specify format of data shown. See table below for options. |
Following format specifiers are possible together with an modbvalue tag data-format="...":
| Option | Example | Meaning |
|---|---|---|
| d | 1234 | Shows a number in decimal encoding |
| x | 0x4D2 | Shows a number in hexadecimal encoding |
| b | 10011010010b | Shows a number in binary encoding. Options d, x, b can be combined, like data-format="dxb"
|
| f<x> | 1.234 | Shows a floating point number with <x> digits after the decimal. A value of f0 shows only the integer part. |
| p<x> | 1.23 | Shows a floating point number with <x> significant digits of precision, independent of the decimal. For example a value of p2 can render a number to 12000 or to 0.00012 |
modbbutton
This tag generates a push-button which can set a certain ODB entry to a specific value. To set the "Run number" to 100, one can use the following tag:
<button name="modbbutton" class="mbutton" data-odb-path="/Runinfo/Run number" data-odb-value="100">
modbbar
The following tag:
>div name="modbbar" style="width: 500px" data-odb-path="/Runinfo/Run number" data-max-value="10"
data-color="lightgreen"<</div>
shows a horizontal bar with a total length of 500px. Depending on the ODB value "Run number". If "Run number" is 10, then the bar is filled all the way to the right, if "Run number" is 5, the far is only filled 50% to the right.
Complete Example
Following code shows an example page (contained in resources/a_example.html in the MIDAS distribution) of a custom page implementing most of the new features.
<!DOCTYPE html>
<html class="mcss">
<head>
<meta charset="UTF-8">
<link rel="stylesheet" href="midas.css">
<script src="midas.js"></script>
<script src="mhttpd.js"></script>
<title>Example</title>
</head>
<body class="mcss" onload="mhttpd_init('Test')">
<!-- header and side navigation will be filled in mhttpd_start -->
<div id="mheader"></div>
<div id="msidenav"></div>
<div id="mmain">
<table class="mtable">
<tr>
<th colspan="2" class="mtableheader">Status</th>
</tr>
<tr>
<td style="width: 200px;">
Run number:
</td>
<td>
<div name="modbvalue" data-odb-path="/Runinfo/Run number" data-odb-editable="1"></div>
</td>
</tr>
<tr>
<td>
Last run start:
</td>
<td>
<div name="modbvalue" data-odb-path="/Runinfo/Start time"></div>
</td>
</tr>
<tr>
<td>
Last run stop:
</td>
<td>
<div name="modbvalue" data-odb-path="/Runinfo/Stop time"></div>
</td>
</tr>
<tr>
<td>
Indicator:
</td>
<td>
<div name="modbbar" style="width: 500px" data-odb-path="/Runinfo/Run number" data-max-value="10"
data-color="lightgreen"></div>
</td>
</tr>
<tr>
<td colspan="2" style="text-align: center;">
<button name="modbbutton" class="mbutton" data-odb-path="/Runinfo/Run number" data-odb-value="1">Set run
number to 1
</button>
</button>
<button name="modbbutton" class="mbutton" data-odb-path="/Runinfo/Run number" data-odb-value="5">Set run
number to 5
</button>
</button>
<button name="modbbutton" class="mbutton" data-odb-path="/Runinfo/Run number" data-odb-value="10">Set run
number to 10
</button>
</button>
</td>
</tr>
</table>
</div>
</body>
</html>
which results in this page:
