Dokumentace / Univerzální seznam

Univerzální seznam

Tabulka nebo seznam z JSON API, RSS, kalendáře nebo z vlastních Hodnot, s filtry a řazením.

CS

Univerzální seznam

Univerzální seznam načte kolekci záznamů, vybere z nich pole, aplikuje filtry a řazení a vykreslí výsledek jako tabulku nebo šablonovaný seznam. Nemusíte tak čekat na specializovaný widget pro každou službu.

Hodí se například na seznam úkolů, jídelníček, stav zásilek, sportovní výsledky, přehled čidel, výběr událostí z kalendáře nebo články z RSS.

Zdroj dat

V hlavičce prvku zvolte jeden ze čtyř zdrojů. Ostatní nastavení zůstane zachované, takže mezi zdroji můžete přepínat bez ztráty konfigurace.

JSON z URL

Zadejte veřejnou adresu https:// a do pole Cesta k řádkům (JSON Pointer) napište cestu k poli záznamů. Pro odpověď

{
  "updated_at": "2026-07-30T10:00:00+02:00",
  "data": {
    "tasks": [
      { "title": "Vynést koš", "due": "2026-07-31", "done": false }
    ]
  }
}

zadáte cestu /data/tasks. Prázdná cesta znamená celý dokument.

Cesta se zapisuje podle standardu JSON Pointer: segmenty odděluje /, znak ~1 zastupuje / a ~0 zastupuje ~. Prvek pole vyberete jeho pořadím, například /tags/0. Zástupné znaky ani výrazy podporované nejsou.

Cesta musí vést na pole objektů nebo pole jednoduchých hodnot. Pokud vede na jediný objekt a chcete jej zobrazit jako jeden řádek, zapněte Objekt jako řádek.

RSS / Atom

Stačí vyplnit adresu feedu. Každý článek se převede na řádek s poli /title, /summary, /published_at, /author, /source a /url. HTML z perexu se převede na čistý text.

Kalendář (iCal)

Zadejte veřejnou adresu https:// nebo webcal:// a rozsah pomocí polí Dní zpět a Horizont (dní). Každá událost se převede na řádek s poli /title, /description, /location, /start, /end, /all_day a /calendar.

Hodnoty

Pole Režim Hodnot nabízí dvě možnosti:

  • Více Hodnot jako řádky — tlačítkem Přidat Hodnotu vyberte až 50 Hodnot. Každá vytvoří jeden řádek s poli /name, /value a /updated_at. U každé lze zadat vlastní popisek nebo dynamický název s proměnnými {{nazev}}.
  • Jedna Hodnota s JSON — obsah vybrané Hodnoty se dekóduje jako JSON a dál se použije Cesta k řádkům stejně jako u JSON z URL. Vhodné, když do jedné Hodnoty ukládá seznam například Home Assistant nebo MQTT.

Cache a test

Cache určuje, jak často se smí vzdálený zdroj znovu stáhnout; volit lze od 15 minut do 24 hodin. Časové pásmo se použije pro všechna datumová pole a filtry.

Tlačítko Otestovat zdroj načte data a vypíše počet nalezených řádků, ukázku prvních záznamů a seznam objevených polí. Kliknutím na nalezené pole rovnou vytvoříte odpovídající sloupec.

Podporované jsou pouze veřejně dostupné adresy. Vlastní hlavičky ani přihlašování nejsou k dispozici. Adresa se ukládá nešifrovaně v konfiguraci Obrazovky, proto do ní nevkládejte dlouhodobé tajné tokeny.

Sloupce

Tlačítkem Přidat sloupec vytvořte 1 až 12 sloupců. Pořadí změníte přetažením za úchyt, kartu lze také kopírovat a mazat.

Každý sloupec má:

  • Název — text v hlavičce tabulky.
  • ID — identifikátor pro filtry, řazení a šablonu. Používejte malá písmena, číslice a pomlčku. Při přejmenování se odkazy ve filtrech, řazení i šabloně automaticky upraví.
  • Cesta k datům — JSON Pointer relativně k jednomu řádku, například /title.
  • Formát — způsob zobrazení hodnoty.
  • Šířka — pružná váha 1 až 10, pevná šířka v pixelech, nebo procenta z dostupné plochy.
  • Zarovnání, Prefix, Suffix, Náhrada za prázdné a Max. znaků.

Formáty buněk

Formát Chování
Text Jednořádkový text, nové řádky se nahradí mezerou.
Číslo Přijme číslo nebo jednoznačně numerický text. Nastavit lze desetinná místa, desetinný znak a oddělovač tisíců.
Datum, Datum a čas, Čas Přijímá ISO 8601 a u číselných polí i Unix timestamp. Formát data vyberete z předvoleb.
Relativní datum dnes, zítra, včera, za 3 dny, před 2 dny.
Relativní čas právě teď, před 12 min, za 2 h.
Ano / Ne Rozpozná true, 1, ano, yes, on a jejich opaky. Texty lze změnit.
Seznam hodnot Spojí pole jednoduchých hodnot zvoleným oddělovačem, nejvýše 20 položek.
Automaticky Podle typu dat zvolí číslo, ano/ne nebo text. Nepřevádí text vypadající jako datum a zachovává úvodní nuly.

Objekt ani pole se bez odpovídajícího formátu nevykreslí; zobrazí se Náhrada za prázdné.

Filtry

Tlačítkem Přidat filtr vytvořte až 10 pravidel. Pole Režim určuje, zda musí platit všechna, nebo stačí alespoň jedno. Přepínačem Ignorovat diakritiku ovlivníte textová porovnání.

Filtr pracuje s původní hodnotou sloupce, tedy před prefixem, suffixem a formátováním. Podle zvoleného typu jsou dostupné operátory:

  • Text — rovná se, nerovná se, obsahuje, neobsahuje, začíná na, končí na, je prázdné, není prázdné.
  • Číslo — <, <=, =, !=, >=, >, mezi, mimo.
  • Datum — před, před nebo v, ve stejný den, po nebo v, po, mezi.

U datumových filtrů lze místo konkrétního data zapsat today, now nebo relativní zápis today+7, today-1, now+2h. Pod filtry se průběžně vypisuje slovní shrnutí celého pravidla.

Filtr odkazující na smazaný sloupec je chyba konfigurace; editor na něj upozorní a widget v takovém případě nezobrazí žádné řádky.

Řazení a limit

Přidat lze až tři řadicí klíče, které se vyhodnocují v uloženém pořadí. U každého zvolte sloupec, směr a datový typ. Prázdné a neplatné hodnoty jsou vždy na konci bez ohledu na směr; při úplné shodě rozhoduje původní pořadí ze zdroje.

Limit řádků nastavíte od 1 do 50. Filtry i řazení proběhnou vždy před limitem, takže se opravdu zobrazí prvních N vyhovujících záznamů.

Tabulka

Ve vzhledu Tabulka se každý sloupec vykreslí do vlastního sloupce s volitelnou hlavičkou.

Zapnout lze vodorovné čáry, svislé čáry a střídání pozadí řádků. Samostatně nastavíte font, velikost a barvu hlavičky i buněk, pozadí hlavičky a barvu čar.

Šířky se počítají z dostupné plochy: nejdřív se odečtou sloupce s pevnou šířkou, poté procentní a zbytek se rozdělí mezi pružné podle jejich váhy. Pokud se sloupce nevejdou, proporcionálně se zmenší až na minimum 20 px; žádný sloupec se automaticky nesmaže.

Buňka je vždy jednořádková a text se ořízne na šířku sloupce.

Seznam se šablonou

Ve vzhledu Seznam se každý záznam vykreslí podle Šablony řádku. Šablona může mít nejvýše tři řádky a 500 znaků:

{{ukol}}
{{termin}} · {{stav}}

Použít lze zástupné symboly {{id-sloupce}} pro libovolný nakonfigurovaný sloupec a dále {{poradi}} s pořadím vykresleného řádku a {{pocet}} s celkovým počtem záznamů po filtru. Editor zobrazí dostupné symboly jako tlačítka a kliknutím je vloží na pozici kurzoru. Neznámý symbol se nahradí prázdným textem a editor jej označí.

První řádek používá Hlavní font, druhý a třetí Doplňkový font. Nastavit lze mezeru mezi položkami, rámeček, zaoblení a pozadí položky.

Šablona nepodporuje podmínky, cykly, funkce ani HTML.

Nadpis, prázdný stav a přetečení

Volitelný Text nadpisu se vykreslí nad obsahem a zabírá místo uvnitř plochy widgetu.

Pokud po filtru nezbude žádný záznam, zobrazí se Text při prázdném výsledku, nebo se widget může celý skrýt.

Vykreslí se jen celé řádky; poslední částečný se nezobrazí. Se zapnutým Zobrazit +N se poslední dostupný řádek použije pro počet skrytých záznamů. Zapnutý Indikátor staré cache přidá vykřičník, pokud se zdroj nepodařilo právě obnovit a použila se dříve uložená data.

Omezení

Zpracuje se nejvýše 1000 zdrojových řádků a vykreslí nejvýše 50. Odpověď vzdáleného zdroje může mít nejvýše 2 MiB, obsah jedné Hodnoty s JSON nejvýše 1 MiB.

Při dočasném výpadku zdroje se použijí poslední úspěšně načtená data, nejdéle 24 hodin stará. Pokud nejsou k dispozici, widget zobrazí neutrální text Data nejsou dostupná; v editoru se navíc vypíše konkrétní důvod.

Aktualizace: 2026-08-01