FTUI Widget Swiper

Aus FHEMWiki
Version vom 14. Januar 2018, 02:09 Uhr von Ulm32b (Diskussion | Beiträge) (Erstdokumentation)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

Das Swiper Widget ist ein Widget für FHEM Tablet UI, mit dem durch Wischen ein Wechsel zwischen verschiedenen Seiten erfolgt. Am unteren Rand verdeutlicht eine Paginierung, auf welcher Seite man sich aktuell befindet; auch eine direkte Auswahl einzelner Seiten ist hier möglich. Des Weiteren können optional Navigationspfeile links und rechts eingeblendet werden. Ein Wechsel zwischen den Seiten kann automatisiert erfolgen (Slide-Show).

Swiper-FTUI.jpg

Attribute

Attribut Beschreibung Standard-Wert Beispiel
data-width Breite 100% data-width="1200px"
data-height Höhe 100% data-height="650px"
data-autoplay Zeit in ms (!), nach der zur nächsten Seite weitergeschaltet wird (null -> nicht aktiv) data-autoplay="5000"
data-device Device, über welches der Seitenwechsel gesteuert werden kann (s.u.)
data-get Reading, welches die aufzurufende Seite bestimmt (s.u.)
data-tabclass Erlaubt es, mehrere Swiper auf einer Seite zu steuern (s.u.) "swipertab"

CSS Klassen

Klasse Beschreibung
nopagination Die Paginierung am unteren Bildrand wird nicht angezeigt
navbuttons Navigationspfeile links und rechts werden angezeigt
swipertab Kennzeichnung des steuernden Devices, welches die Seite aufruft (s.u.)

HTML

<div data-type="swiper">
<ul>
	<li>
            <!-- Seite 1 -->
	</li>

	<li>
            <!-- Seite 2 -->
	</li>

	<li>
            <!-- Seite 3 -->
	</li>
<ul>
</div>

Seitenaufruf über device:reading

Swipertabs-FTUI.png

    <div data-type="swiper"  data-height="160px" data-width="300px"
         data-device="AvReceiverZ2" data-get="input"
         data-states='["Airplay","Webradio","BD/DVD","PHONO"]'
         class="top-space-2x nopagination">
         <ul>
            <li class="noswipe"><div class="row-3-3 container bg-gray center large">Airplay</div></li>
            <li class="noswipe"><div class="row-3-3 container bg-gray center large">Webradio</div></li>
            <li class="noswipe"><div class="row-3-3 container bg-gray center large">BD/DVD</div></li>
            <li class="noswipe"><div class="row-3-3 container bg-gray center large">PHONO</div></li>
         </ul>
     </div>
     <div data-type="switch" data-icon="fa-apple" data-device="AvReceiverZ2" data-get="input" data-set="input" data-get-on='Airplay' data-get-off='!on' data-set-off='' data-off-background-color="#2a2a2a" data-off-color="#505050" data-on-background-color="#2a2a2a" data-on-color="orange" class="swipertab small inline"></div>
     <div data-type="switch" data-icon="fa-bars"  data-device="AvReceiverZ2" data-get="input" data-set="input" data-get-on='Webradio' data-get-off='!on' data-set-off='' data-off-background-color="#2a2a2a" data-off-color="#505050" data-on-background-color="#2a2a2a" data-on-color="orange" class="swipertab small inline"></div>
     <div data-type="switch" data-icon="fa-dot-circle-o"  data-device="AvReceiverZ2" data-get="input" data-set="input" data-get-on='BD/DVD' data-get-off='!on' data-set-off='' data-off-background-color="#2a2a2a" data-off-color="#505050" data-on-background-color="#2a2a2a" data-on-color="orange" class="swipertab small inline"></div>
     <div data-type="switch" data-icon="fa-circle"  data-device="AvReceiverZ2" data-get="input" data-set="input" data-get-on='PHONO' data-get-off='!on' data-set-off='' data-off-background-color="#2a2a2a" data-off-color="#505050" data-on-background-color="#2a2a2a" data-on-color="orange" class="swipertab small inline"></div>

Mittels class="swipertab" bei den Switches reagiert der Swiper auf deren setOn-Events und wechselt auf die entsprechende n-te Seite (2-ter Switch -> 2-te Seite usw.). Gibt es auf einer Seite mehrere Swiper, kann man mit data-tabclass eine andere Class anstatt swipertab definieren. Vor der Implmentierung der vorstehend beschriebenen Navigation zwischen verschiedenen Seiten sollte die Alternative FTUI Widget Pagebutton erwogen werden.

Hinweise

Die Farben der Paginierung am unteren Seitenrand sind, abhängig vom Hintergrund, u.U. nur schwer erkennbar. Vom Standard abweichende Farben können in der css/fhem-tablet-ui-user.css definiert werden:

.swiper-pagination-bullet {
    background: #444 !important;
}
.swiper-pagination-bullet-active {
    background: #eee !important;
}

Links

Beispiel