Skip to content
Thomas Nesges edited this page May 25, 2015 · 4 revisions

joinedlabel verbindet mehrere Readings zu einem Feld

HTML

<div data-type="joinedlabel" 
    data-device="MCP"
    data-get='["artist","album","name"]'>

Zeigt die drei Readings MCP:artist, MCP:album und MCP:name durch ein Leerzeichen getrennt an.

<div data-type="joinedlabel" 
    data-device="MCP"
    data-glue=" - "
    data-get='["artist","album","name"]'>

Zeigt die drei Readings MCP:artist, MCP:album und MCP:name durch die Zeichenfolge " - " getrennt an.

<div data-type="joinedlabel" 
        data-device="W_XBMC"
        data-get='["W_XBMC:currentTitle","S_XBMC:currentTitle","K_XBMC:currentTitle","B_XBMC:currentTitle"]'>
</div>
<div data-device="S_XBMC"></div>
<div data-device="K_XBMC"></div>
<div data-device="B_XBMC"></div>

joinedlabel ist in der Lage Readings unterschiedlicher Devices anzuzeigen. Dazu muss das get-Array in der Notation "Device:Reading" befüllt werden. Ausserdem müssen die Nebendevices in echten Widgets oder als "Leerwidgets" angelegt werden. Der Hintergrund dafür ist die Art und Weise wie FTUI feststellt ob die Werte eines Devices gelesen werden sollen oder nicht. Zu beachten ist dabei auch, dass die Aktualisierungszeiten für die Nebendevices unterschiedlich sein können.

Attribute

get

Ein Array von Readings eines Devices oder mehrerer in der Notation "Device:Reading" (siehe oben)

glue

Zeichenfolge mit der die Readings verbunden werden. Default: " "

mask

Schablone zur Ausgabe der Readings. Kann stat glue verwendet werden. Die Schablone ist ein String, in dem alle Vorkommen von $1, $2, $3 etc. durch das korrespondierende Reading (Wert aus get) ersetzt werden. D.h. mask="$1 - $2 - $3" ist das gleiche wie glue=" - ", aber mask="$1 - $2 + $3" verbindet die letzten beiden Werte durch ein Plussymbol statt eines Bindestriches.

Daneben ist es mit mask auch möglich Prefixe und Suffixe anzugeben, die nur dann eingefügt werden, wenn das Reading nicht leer ist. Dazu wird eine erweiterte Syntax verwendet: mask="[$1: ][$2 - ][$3]". Hat das erste Reading einen Wert wird es um ": " ergänzt eingefügt. Hat das zweite Reading einen Wert wird es um " - " ergänzt eingefügt. Hat das dritte Reading einen Wert wird es ohne Ergänzung eingefügt. Hat eines der Readings keinen Wert, wird seine in eckige Klammern gefasste Umgebung nicht eingefügt.

substitution

Regex-Subsitution in der Notation "s/regex/subst/modifier", die auf den zusammengesetzten Wert - ggf. nach der Anwendung von "mask" - angewendet werden soll. "/" ist durch ein beliebiges Zeichen ersetzbar.

CSS Klassen

Alle einzelnen Werte können mittels einer CSS Klasse joinedlabel_get_# gestylt werden. Darin ist "#" durch die Stelle des Wertes im get-Array zu ersetzen (beginnend bei 1).

Clone this wiki locally