FTUI Widget Pagetab

Das Pagetab Widget ist ein Widget für FHEM Tablet UI, welches es erlaubt, den Inhalt einer Seite durch den einer anderen zu ersetzen. Es kann zum Beispiel für ein Menü verwendet werden.

Attribute

Attribut	Beschreibung	Standard-Wert	Beispiel
data-device	FHEM Device, dessen Status das Aussehen des Widgets bestimmt		data-device="dummy1"
data-url	URL der neuen Seite, die angezeigt werden soll		data-url="content_main.html"
data-icon	Vordergrund-Icon des Widgets	fa-power-off	data-icon="mi-home"
data-background-icon	Hintergrund-Icon des Widgets	fa-circle	data-background-icon="fa-square"
data-on-background-color	Farbe des Hintergrund-Icons, wenn der gewünschte Inhalt angezeigt wird	#606060	data-on-background-color="gray"
data-off-background-color	Farbe des Vordergrund-Icons, wenn der gewünschte Inhalt nicht angezeigt wird	transparent	data-off-background-color="#cccccc"
data-on-color	Farbe des Vordergrund-Icons, wenn der gewünschte Inhalt angezeigt wird	#222222	data-on-color="yellow"
data-off-color	Farbe des Vordergrund-Icons, wenn der gewünschte Inhalt nicht angezeigt wird	#505050	data-off-color="#000000"
data-get-on	Ein Array an Stati eines Devices. Je nach Status wird ein anderes Icon aus data-icons angezeigt.		data-get-on='["Ein","Pause","Aus"]'
data-icons	Ein Array an Icons, die in Abhängigkeit von data-get-on angezeigt werden		data-icons='["mi-play_arrow","mi-pause","mi-stop"]'
data-return-time	Kehrt nach der angegebenen Zeit in Sekunden wieder zur "Startseite" zurück. Muss auf dem ersten Pagetab gesetzt werden	0 (endlos)	data-return-time="5"
data-text	Text für die Beschreibung		data-text="Home"

CSS Klassen

warn	Erzeugt einen Benachrichtigungsicon über einem Icon
activate	Lädt die verlinkte Seite eines Pagetab-Widgets automatisch, wenn der Status eines Devices einem Wert aus dem Attribut data-get-on entspricht.
labelright	Platziert die Beschreibung rechts unter dem Icon statt zentriert

Hinweise

Das Attribut data-return-time muss auf dem "Haupt-Pagetab" (dem ersten; index 0) platziert werden

Beispiele

Einfacher Link

<div data-type="pagetab"
     data-url="index.html"
     data-icon="mi-home"></div>

Einfacher Link mit Beschreibungstext

<div data-type="pagetab"
     data-url="index.html"
     data-icon="mi-home"
     data-text="home"></div>

Navigationsleiste

Ein guter Anwendungszweck für das Pagetab-Widget ist eine Navigationsleiste. Dazu braucht es allerdings mehrere Seiten:

Eine mit der Navigations selbst. Die wird später als Template auf den Zielseiten eingebunden
Eine Startseite
Eine oder mehrere Zielseiten, auf die navigiert werden kann

Menü-Seite (menu.html)

Eine Menü-Seite könnte z.B. wie folgt aussehen. Auf dieser Seite sind drei Pagetab-Widgets platziert.

Das erste ist ein ganz einfacher Link mit einem Beschreibungstext. Die Seite unter data-url wird beim Aufruf der Startseite automatisch geladen.
Das zweite Widget ändert sein Icon je nach Status-Wert des Dummies dummy1. Ist der Status 0, wird nur das Icon fa-fax angezeigt. Ist der Status größer 0, erscheint rechts über dem Icon noch ein "Warnhinweis" mit dem Status-Wert des Dummies. Außerdem ist der Beschreibungstext nach rechts gerückt.
Das dritte Widget funktioniert im Prinzip wie das zweite. Außer der Status-Wert des Dummies ist on. Dann wird die im Widget verlinkte Seite automatisch geöffnet.

<!DOCTYPE html>
<html>
<head>
</head>
<body>
<div class="sheet">
	<div class="row">
		<div data-type="pagetab"
			 data-url="pagetab01.html"
			 data-icon="fa-home"
			 data-text="home"
			 class="cell"></div>
	</div>
	<div class="row">
		<div data-type="pagetab"
			 data-device="dummy1"
			 data-get-on='["0","1"]'
			 data-icons='["fa-fax","fa-fax warn"]'
			 data-url="pagetab02.html"	
			 data-text="anrufe"
			 class="cell labelright"></div>
	</div>
	<div class="row">
		<div data-type="pagetab"
			 data-device="dummy2"
			 data-get-on='["0","(?:[1-9][0-9]*)","on"]'
			 data-icons='["fa-fax","fa-fax warn","fa-fax warn activate"]'
			 data-url="pagetab03.html"
			 class="cell"></div>
	</div>
</div>
</body>
</html>

Startseite (index.html)

Auf der Startseite müssen keine Inhalte sein. Durch das erste Pagetab-Widget wird dessen URL automatisch geladen. Allerdings ist das Menü-Template einzubinden.

<!DOCTYPE html>
<html>
<head>
    <script src="js/fhem-tablet-ui.js" defer></script>
    <title>FHEM-Tablet-UI</title>
</head>
<body>
<div class="gridster">
	<ul>
		<li data-row="1" data-col="1" data-sizex="1" data-sizey="4" data-template="menu.html"></li>
		<li data-row="1" data-col="2" data-sizex="4" data-sizey="4"></li>
	</ul>
</div>
</body>
</html>

Zielseiten (pagetab01.html, pagetab02.html, pagetab03.html)

Die Zielseiten können ganz normal gestaltet werden. Es ist nur darauf zu achten, dass auf jeder Zielseite auch das Menü-Template eingebunden wird. Eine Zielseite könnte so aussehen:

<!DOCTYPE html>
<html>
<head></head>
<body>
<div class="gridster">
	<ul>
		<li data-row="1" data-col="1" data-sizex="1" data-sizey="4" data-template="menu.html"></li>
		<li data-row="1" data-col="2" data-sizex="4" data-sizey="4" class="left-align">Pagetab02.html</li>
	</ul>
</div>
</body>
</html>

Wird nun auf eines der Icons geklickt, blendet die aktuelle Seite aus und die Zielseite wird eingeblendet.

Weblinks