Simboli

Svi simboli mogu se koristiti na različitim mjestima u vizualizaciji. Time je moguće definirati ove kao varijablu ili tekst.

Da biste prikazali simbol na vizualizaciji, ovaj se označava direktno u tekstu pomoću oznake [icon:SYMBOLPFAD]. Putanja do simbola može se kopirati iz biblioteke simbola desnim klikom miša ili uz pomoć CTRL+C. Ako je moguće, treba koristiti samo materijalne simbole kako bi stil vizualizacije ostao isti.

Biblioteka Simbola

Svi dostupni simboli mogu se pozvati i pretraživati pod kontekstnim menijem Vizualizacija ▸ Simboli. Također je moguće uvesti vlastiti skup simbola u biblioteku. Postupak se objašnjava dalje.

Napomene: Ime koje se prikazuje na listi simbola nije identično putanji do simbola. Ako u putanji nije naveden skup simbola, automatski se koristi skup Glyphicons.

Filter u biblioteci simbola pretražuje i oznake koje su unesene. Ako se to ne želi, filter može početi sa znakom = kako bi se pretraživalo samo u imenima.

Skup Simbola Material Symbols (Standardni)

Ovaj skup simbola je potpuno dinamičan i stil simbola se automatski konfigurira prema dizajnu vizualizacije. Osim toga, automatski se koristi pun simbol ako treba da simbol bude aktivan. Međutim, ne svaki simbol ima punu varijantu.

Simboli se automatski zaobljavaju ako je polumjer prekidača veći ili jednak 16 piksela. Ako je polumjer jednak 0px, koriste se oštri simboli. U uređivaču se uvijek koriste normalni simboli.

Napomena: Preporučuje se korištenje skupa simbola "Material Symbols" kako bi se vizualizacija ujednačila.

Skup Simbola Material Animated

Postoji odabranih simbola iz Material Symbols koji su animirani kako bi prikazali vrijednosti. Ovi simboli imaju samo jednu animaciju sa simbolom strukture. Pri odabiru oslobađaju se dodatne varijable.

Skup Simbola Philips Hue

Simboli iz Philips Hue mogu se slobodno koristiti ako se koristi sučelje Hue. Osim toga, postoji dodatni skup simbola Hue zajednice Home Assistant HASS. Više informacija možete pronaći na kraju ovog poglavlja.

Skup Simbola Vrijeme

Ovaj skup simbola prikazuje simbole vremena vizualizacije. Ovi se podržavaju bez prekinuća od različitih sučelja. Pogledejte donje poglavlje Vremenske Ikonice.

Skup Simbola Legacy (zastario)

Legacy skup simbola sadrži sve simbole stare vizualizacije. Stil prikaza nove površine ostaje isti. Simboli ne bi trebali biti više korišteni jer njihovo prikazivanje nije optimizirano za novu površinu.

Različiti stari simboli su i dalje animirani:

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

Skriveni Simboli

Postoji i skrivenih simbola za vizualizaciju. Ovi se dalje objašnjavaju u donjim poglavljima.

Za pozivanje simbola potrebna je samo prefiks URL-a.

Vlastiti Skupovi Simbola

Moguće je uvesti vlastiti skup simbola u projekt. Svaki skup simbola mora biti pripremljen kao ZIP datoteka. Nekoliko primjernih podataka može se ovdje preuzeti:

Pro savjet: Nakon uspješnog uvoza, možete izvesti skup simbola kao .antobj da bi se uvoz olakšao. Kliknite desnim klikom miša na skup simbola i odaberite Izvoz.

Sljedeća pravila definiraju strukturu i zahtjeve jednog skupa simbola. Molimo pažljivo pročitajte ova pravila i strogo ih se pridržavajte.

Pravila

  • Prefiks
    • Može sadržavati samo _, a–z i 0–9.
    • Velika slova se automatski pretvaraju u mala slova.
    • Rezervirana imena kao što su sys, src ili doc su nevažeća.
    • Moraju početi slovom (a–z). Samo brojevi nisu dozvoljeni.
    • Dodani donji crtice (_) se uklanjaju.
    • Moraju imati najmanje 3 znaka.
    • Više donjih crtica (__) se reduciraju na jedan.
  • Imena Simbola
    • Automatski se pretvaraju u mala slova.
    • Dozvoljeni znaci su -, _, a–z i 0–9.
    • Dugim imenima i prefiksima treba izbjegavati.
    • Prefiks mora biti jedinstven i treba ga koristiti samo jednom.
    • Ako simbol ima isto ime i isti prefiks kao sistemski simbol, može zamijeniti taj simbol.
  • Ograničenja Datoteka
    • Maksimalna veličina datoteke nakon čišćenja: 10 kB. Veće datoteke se odbacuju.
    • SVG datoteke moraju biti očistjene:
      • Razmaci u linijama se automatski uklanjaju.
      • Sljedeća elementa se brišu: <title>, <desc>, <script>, <image>, <style>, <foreignObject>.
      • Sljedeća atributa se brišu: style, fill, stroke, color, stop-color, flood-color, lighting-color.
      • Ikone sa ugrađenim skriptama, slikama, CSS-om ili vanjskim resursima se odbacuju.
      • Ako stili sadrže boje ili blokove stilova, uvoz također može biti odbijen.
  • Zahtjevi SVG Zastavice
    • Moraju sadržavati: viewBox, width i height. Nedostajuće vrijednosti se, ako je moguće, automatski dopunjuju.
    • Moraju sadržavati namespace: xmlns="http://www.w3.org/2000/svg". Ako je nedostaje ili pogrešan, automatski se dopunjava.
    • Ime ikone mora točno odgovarati dimenzijama, inače se ikona odbacuje.
    • Dimenzije moraju biti kvadratične (širina = visina). Standard: 24px.
    • Suprotstavljeni stili ili nepodudarne dimenzije treba izbjegavati.
  • Opće
    • Loše izgrađene ikone mogu značajno usporiti prikazivanje ili čak uzrokovati pogreške.
    • Obavezno pazite na autorska prava simbola.
    • Svi vektori se zaokružuju na tri decimalna mjesta.

Struktura

  • Datoteka iconset.ini je obavezna za prepoznavanje skupa simbola.
    • Može se nalaziti u korijenskom direktoriju ZIP datoteke ili u poddirektoriju.
    • Moraju biti u malim slovima (iconset.ini).
    • Imena datoteka simbola nisu osjetljiva na velika/mala slova.
  • Uvoz ne traži automatski SVG datoteke.
    • Direktorij ikona mora biti eksplicitno definiran u iconset.ini (pazite na velika/mala slova).
    • U predlošku ZIP datoteke je definiran direktorij nazvan icons/.
  • Poddirektoriji
    • Poddirektoriji u definiranom direktoriju (icons/) služe kao kategorije.
    • Imena simbola moraju biti jedinstvena kroz sve kategorije.
    • Pravila imena u direktoriju simbola:
      • Minimum: Samo dimenzija i nastavak datoteke (npr. 24.svg).
      • Varijante kao što su filled24.svg ili round_filled_24.svg su važeće.
      • Datoteke imena sa više brojeva (npr. 24_48.svg) su nevažeća.
      • Varijante stilova se prepoznaju kroz:
        • Pun: Moraju sadržavati filled ili fill.
        • Zaobljen: Moraju sadržavati round.
        • Oštar: Moraju sadržavati sharp.
        • Zaobljen i oštar se ne mogu kombinirati zajedno.
      • Ako se više pravila primjenjuju, koristi se datoteka koja je prepoznata posljednja (izbor može izgledati slučajno).
  • Dodatna Pravila
    • Nema unutarnjih pod-poddirektorija koji se pretražuju (ovih se može koristiti za backupove ili originale).
    • Datoteke bez .svg se ignoriraju.
    • U direktoriju simbola može postojati datoteka nazvana tags.txt kako bi se dodale dodatne oznake za pretraživanje.
      • Oznake se mogu razdvojiti sa ,, ; ili razmacima u linijama.

Posebni Skupovi Simbola

Postoji i različitih posebnih skupova simbola koji se mogu uvesti kao vlastiti skupovi simbola, ali ne moraju biti konfigurirani prema gornjim zahtjevima.

Hass Hue Ikone

Jedan od njih je sa GitHub stranice hass-hue-icons. Ovaj je dodatni skup simbola Hue zajednice Home Assistant HASS i može se koristiti samo za nekomercijalne projekte, jer stoji pod Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International licencom. Zato ovaj skup simbola nije dostupan sa Antcas Control. Međutim, simbole možete uvesti u projekt kao novi skup simbola bilo kada uz pomoć ZIP datoteke hass-hue-icons-main.zip. Pazite na uvjete licencije projekta na GitHub web stranici.

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

Material Design Ikone od Pictogrammers

Drugi je od Pictogrammers. Za to, datoteka mdi-###.json mora biti pakirana u ZIP datoteku i uvezena. Datoteku možete pronaći i preuzeti u razvojnoj konzoli pretraživača. Pokušava se kombinirati outline simbole sa punim simbolima. Biblioteka je gotovo identična Material Symbols. Međutim, postoji mnogo proširenja zajednice. Ako želite integrirati druge skupove simbola u biblioteku, možete nas slobodno pitati.

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

Podređene Stranice