Symboly

Všechny symboly lze použít na různých místech ve vizualizaci. Takže je možné definovat je jako proměnnou nebo text.

Chcete-li zobrazit symbol ve vizualizaci, je deklarován přímo v textu pomocí tagu [icon:SYMBOLPFAD]. Cestu k symbolu lze zkopírovat z knihovny symbolů pomocí pravého tlačítka myši nebo CTRL+C. Mělo by se, pokud je to možné, vybrat pouze materiálové symboly, aby styl vizualizace zůstal stejný.

Knihovna symbolů

Všechny dostupné symboly lze otevřít a prohledávat v kontextovém menu Vizualizace ▸ Symboly. Je také možné importovat vlastní sadu symbolů do knihovny. Postup je vysvětlen níže.

Poznámky: Jméno, které se zobrazuje v seznamu symbolů, není totožné s cestou k symbolu. Pokud není v cestě uvedena sada symbolů, automaticky se použije sada Glyphicons.

Filtr ve knihovně symbolů hledá také podle uložených tagů. Pokud se tento chování nechcete, můžete filtr začít znakem =, aby se hledalo pouze v názvech.

Sada symbolů Material Symbols (výchozí)

Tato sada symbolů je zcela dynamická a styl symbolů se automaticky konfiguruje podle designu vizualizace. Navíc se automaticky používá vyplněný symbol, pokud má být symbol aktivní. Ne každý symbol však má vyplněnou variantu.

Symboly se automaticky zaoblí, pokud je poloměr tlačítka větší nebo roven 16 Pixel. Je-li poloměr roven 0px, používají se ostré symboly. V editoru se však vždy používají normální symboly.

Poznámka: Doporučuje se použít sadu „Material Symbols“, aby byla vizualizace jednotná.

Sada symbolů Material Animated

Některé symboly z Material Symbols byly animovány, aby zobrazovaly hodnoty. Tyto symboly mají pouze jednu animaci s symbolem struktury. Při výběru se pak uvolní další proměnné.

Sada symbolů Philips Hue

Symboly z Philips Hue lze volně používat, pokud se používá rozhraní Hue. Kromě toho existuje další sada symbolů Hue od komunity Home Assistant HASS. Další informace naleznete na konci tohoto kapitolu.

Sada symbolů Počasí

Tato sada symbolů zobrazuje symboly počasí ve vizualizaci. Tyto jsou hladce podporovány různými rozhraními. Podívejte se na následující kapitolu Počasí-Icons.

Sada symbolů Legacy (zastaralá)

Sada Legacy obsahuje všechny symboly staré vizualizace. Styl zobrazení nové rozhraní zůstává stejný. Symboly by se neměly používat, protože jejich zobrazování nebylo optimalizováno pro nové rozhraní.

Některé staré symboly jsou stále animované:

  • legacy/door
  • legacy/door_2
  • legacy/lock
  • legacy/shutter
  • legacy/shutter_blinds
  • legacy/window
  • legacy/window_tilt

Skryté symboly

Existují také skryté symboly pro vizualizaci. Ty jsou dále vysvětleny v následujících kapitolách.

K volání symbolů je nutná pouze předpona URL.

Vlastní sady symbolů

Je možné importovat vlastní sadu symbolů do projektu. Každá sada symbolů musí být připravena jako ZIP soubor. Některé ukázkové data lze stáhnout zde:

Profesionální tip: Po úspěšném importu můžete sadu symbolů exportovat jako .antobj, aby se usnadnil import. Klikněte pravým tlačítkem myši na sadu symbolů a vyberte Export.

Následující pravidla definují strukturu a požadavky na sadu symbolů. Prosím, přečtěte si je pečlivě a dodržujte je přesně.

Pravidla

  • Předpona
    • Může obsahovat pouze _, a–z a 0–9.
    • Velká písmena se automaticky převádějí na malá.
    • Rezervovaná jména jako sys, src nebo doc jsou neplatná.
    • Musí začínat písmenem (a–z). Pouze čísla nejsou povolena.
    • Zadní podtržítka (_) se odstraní.
    • Musí být alespoň 3 znaky dlouhá.
    • Více podtržítka (__) se zredukují na jedno.
  • Názvy symbolů
    • Automaticky se převádějí na malá písmena.
    • Povolené znaky jsou -, _, a–z a 0–9.
    • Příliš dlouhá jména a předpony by se měly vyhnout.
    • Předpona musí být jednoznačná a měla by se používat pouze jednou.
    • Pokud má symbol stejné jméno a stejnou předponu jako systémový symbol, může jej nahradit.
  • Omezení souborů
    • Maximální velikost souboru po úpravě: 10 kB. Větší soubory jsou odmítnuty.
    • SVG soubory musí být upravené:
      • Řádky se automaticky odstraní.
      • Následující prvky se odstraní: <title>, <desc>, <script>, <image>, <style>, <foreignObject>.
      • Následující atributy se odstraní: style, fill, stroke, color, stop-color, flood-color, lighting-color.
      • Ikony s vloženými skripty, obrázky, CSS nebo externími zdroji jsou odmítnuty.
      • Pokud styly obsahují barvy nebo bloky stylů, může být import také zamítnut.
  • Požadavky na záhlaví SVG
    • Musí obsahovat: viewBox, width a height. Chybějící hodnoty se, pokud je to možné, automaticky doplní.
    • Musí obsahovat namespace: xmlns="http://www.w3.org/2000/svg". Pokud chybí nebo je špatně, automaticky se doplní.
    • Jméno ikony musí přesně odpovídat rozměrům, jinak bude ikona odmítnuta.
    • Rozměry musí být čtvercové (šířka = výška). Výchozí: 24px.
    • Vyhněte se rozporuplným stylům nebo nevhodným rozměrům.
  • Obecné
    • Špatně vytvořené ikony mohou výrazně zpomalit zobrazení nebo dokonce způsobit chyby.
    • Dbejte na autorská práva symbolů.
    • Všechny vektory se zaokrouhlují na tři desetinná místa.

Struktura

  • Soubor iconset.ini je povinný, aby bylo možné sadu symbolů rozpoznat.
    • Může být umístěn v kořenovém adresáři ZIP souboru nebo v podadresáři.
    • Musí být v malých písmenech (iconset.ini).
    • Názvy souborů s ikonami samy o sobě nejsou citlivé na velikost písmen.
  • Import automaticky nevytváří SVG soubory.
    • Adresář s ikonami musí být explicitně definován v iconset.ini (dodržujte velikost písmen).
    • Ve šabloně ZIP souboru byl definován adresář s názvem icons/.
  • Podadresáře
    • Podadresáře v definovaném adresáři (icons/) slouží jako kategorie.
    • Názvy symbolů musí být jedinečné ve všech kategoriích.
    • Pravidla pro pojmenování v adresáři s ikonami:
      • Minimum: Pouze rozměry a přípona souboru (například 24.svg).
      • Varianty jako filled24.svg nebo round_filled_24.svg jsou platné.
      • Názvy souborů s více čísly (například 24_48.svg) nejsou platné.
      • Varianty stylu jsou rozpoznány podle:
        • Vyplněno: Musí obsahovat filled nebo fill.
        • Zaobleno: Musí obsahovat round.
        • Ostré: Musí obsahovat sharp.
        • Zaobleno a ostré nelze kombinovat.
      • Pokud platí více pravidel, použije se poslední rozpoznaná soubor (výběr může působit náhodně).
  • Další pravidla
    • Nehledají se žádné vnořené podpodadresáře (tyto lze použít pro zálohy nebo originály).
    • Soubory bez .svg se ignorují.
    • V adresáři s ikonami může být soubor s názvem tags.txt, aby se přidaly další tagy pro vyhledávání.
      • Tagy lze oddělit ,, ; nebo řádky.

Speciální sady symbolů

Existují také různé speciální sady symbolů, které lze importovat jako vlastní sady symbolů, ale nemusí být nakonfigurovány podle výše uvedených předpisů.

Hass Hue Icons

Jedním z nich je hass-hue-icons ze stránek Gibhub. Jedná se o další sadu symbolů Hue od komunity Home Assistant HASS a může být použita pouze pro nekomerční projekty, protože je licencována pod Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International-Licence. Proto není tato sada symbolů dodávána s Antcas Control. Symboly však lze kdykoli importovat do projektu jako novou sadu symbolů pomocí ZIP souboru hass-hue-icons-main.zip. Při tom zvažte licenci projektu na webové stránce Github.

Zdroj: https://github.com/arallsopp/hass-hue-icons.

Material Design Icons od Pictogrammers

Dalším je ten od Pictogrammers. K tomu musí být soubor mdi-###.json zabalen do ZIP souboru a importován. Soubor lze nalézt a stáhnout v konzoli pro vývojáře prohlížeče. Pokusíme se kombinovat obrysové symboly s vyplněnými. Knihovna je téměř stejná jako Material Symbols. Existuje však mnoho rozšíření komunity. Pokud chcete integrovat jiné sady symbolů do knihovny, můžete nás rádi kontaktovat.

Zdroj: https://pictogrammers.com/library/mdi/

Podřízené Stránky