fancy_listing

Description

This tile is a more sophisticated version of listing tile offering colored labels and centering options. Each entry is an object containing three keys: label, text and description. Therefore, data (i.e. content) is just a list of such objects.

Content

"data" = [
    {"label": "<label1>", "text": "<entry1>", "description": "<desc1>" },
    {"label": "<label2>", "text": "<entry2>", "description": "<desc2>" }
]

where:

label

Smaller label displayed on the left which can be colored.

text

A textual entry to be displayed next to the label.

description

Subtitle displayed below text element.

Example:

curl http://localhost:7272/api/v0.1/<api_key>/push
     -X POST
     -d "tile=fancy_listing"
     -d "key=<tile_id>"
     -d 'data=[{"label": "My label 1", "text": "Lorem ipsum", "description": "such description" },
               {"label": "My label 2", "text": "Dolor sit", "description": "yet another" },
               {"label": "My label 3", "text": "Amet", "description": "" }]'

Configuration

value = {
    "vertical_center": <BOOLEAN>,
    "<position>": {
        "label_color": "<color>",
        "center": <BOOLEAN>
    },
}

where:

vertical_center

Centers vertically all the entries (along with their labels).

New in version 1.3.0.

position

Tells which entry (starting from 1) should be a subject to label_color and center (specified as subkeys of position).

label_color

Sets the color of label for the entry given with position. Color can be specified in a hexadecimal form (#RRGGBB) or by name (e.g. green).

center

Centers horizontally entry’s text and description (it does not affect label’s position).

New in version 1.3.0.

Example:

curl http://localhost:7272/api/v0.1/<api_key>/tileconfig/<tile_id>
     -X POST
     -d 'value={"vertical_center": true,
                "1": {"label_color": "red", "center": true},
                "3": {"label_color": "green", "center": true }}'