Simboluri

Toate simbolurile pot fi utilizate în diverse locuri pe vizualizare. Astfel, este posibil să le definiți ca variabilă sau text.

Pentru a afișa un simbol pe vizualizare, acesta se declară direct în text cu tag-ul [icon:SYMBOLPFAD]. Calea simbolului poate fi copiată din biblioteca de simboluri folosind click dreapta sau CTRL+C. Dacă este posibil, ar trebui să se aleagă doar Material Symbols pentru a menține stilul vizualizării.

Bibliotecă De Simboluri

Toate simbolurile disponibile pot fi accesate și căutate sub meniul de context Vizualizare ▸ Simboluri. Este, de asemenea, posibil să importați un set propriu de simboluri în bibliotecă. Procedura este explicată mai jos.

Notă: Numele afișat pe lista de simboluri nu este identic cu calea simbolului. Dacă nu se specifică un set de simboluri în cale, se utilizează automat setul Glyphicons.

Filtrul din biblioteca de simboluri căută și după etichetele asociate. Dacă acest comportament nu este dorit, filtrul poate începe cu un = pentru a căuta doar în nume.

Set De Simboluri Material Symbols (Standard)

Acelastă set de simboluri este complet dinamic și stilul simbolurilor se configurează automat în funcție de design-ul vizualizării. De asemenea, un simbol umplut este utilizat automat dacă simbolul trebuie să fie activ. Nu toate simbolurile au însă o variantă umplută.

Simbolurile sunt rotunjite automat dacă raza butonului este mai mare sau egală cu 16 Pixel. Dacă raza este egală cu 0px, se utilizează simbolurile ascuțite. În editor, se utilizează întotdeauna simbolurile normale.

Notă: Se recomandă utilizarea setului de simboluri "Material Symbols" pentru a menține o vizualizare uniformă.

Set De Simboluri Material Animated

Există simboluri selectate din Material Symbols care au fost animate pentru a reprezenta valori. Aceste simboluri au doar o animație cu simbolul din structură. La selectare, alte variabile vor fi activate.

Set De Simboluri Philips Hue

Simbolurile de la Philips Hue pot fi utilizate liber dacă se utilizează interfața Hue. De asemenea, există un set suplimentar de simboluri Hue din comunitatea Home Assistant HASS. Informații suplimentare găsiți la sfârșitul acestui capitol.

Set De Simboluri Vreme

Acelastă set de simboluri afișează simbolurile de vreme ale vizualizării. Acestea sunt suportate fără probleme de diverse interfețe. Vezi capitolul următor Vreme-Icons.

Set De Simboluri Legacy (învechit)

Setul de simboluri Legacy conține toate simbolurile vechi ale vizualizării. Stilul de afișare al noii interfețe rămâne același. Simbolurile nu ar trebui să mai fie utilizate, deoarece reprezentarea lor nu este optimizată pentru noua interfață.

Diverse simboluri vechi sunt încă animate:

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

Simboluri Ascunse

Există și simboluri ascunse pentru vizualizare. Acestea sunt explicate în capitolele următoare.

Pentru a apela simbolurile, este necesar doar un prefix de URL.

Seturi Proprii De Simboluri

Este posibil să importați un set propriu de simboluri în proiect. Fiecare set de simboluri trebuie să fie pregătit ca fișier ZIP. Unii date exemple pot fi descărcate aici:

Sfat Pro: După importarea reușită, puteți exporta setul de simboluri ca .antobj pentru a simplifica importul. Faceți clic cu butonul drept pe un set de simboluri și alegeți Export.

Regulile următoare definesc structura și cerințele unui set de simboluri. Vă rugăm să le citiți cu atenție și să respectați exact.

Reguli

  • Prefix
    • Poate conține doar _, a–z și 0–9.
    • Literele mari sunt convertite automat în litere mici.
    • Numele rezervate precum sys, src sau doc sunt invalide.
    • Trebuie să înceapă cu o literă (a–z). Numerele nu sunt permise.
    • Sublinierile finale (_) sunt eliminate.
    • Trebuie să aibă cel puțin 3 caractere lungime.
    • Sublinierile multiple (__) sunt reduse la unul singur.
  • Nume De Simboluri
    • Sunt convertite automat în litere mici.
    • Caracterele permise sunt -, _, a–z și 0–9.
    • Numele prea lungi și prefixele trebuie evitate.
    • Un prefix trebuie să fie unic și ar trebui utilizat doar o dată.
    • Dacă un simbol are același nume și același prefix ca un simbol de sistem, poate înlocui acestuia.
  • Restricții De Fișier
    • Mărimea maximă a fișierului după curățire: 10 kB. Fișierele mai mari sunt respinse.
    • Fișierele SVG trebuie să fie curățate:
      • Sari de linie sunt eliminate automat.
      • Următoarele elemente sunt șterse: <title>, <desc>, <script>, <image>, <style>, <foreignObject>.
      • Următoarele atribute sunt șterse: style, fill, stroke, color, stop-color, flood-color, lighting-color.
      • Iconurile cu scripturi, imagini, CSS sau resurse externe încorporate sunt respinse.
      • Dacă stilurile conțin culori sau blocuri de stil, importul poate fi, de asemenea, respins.
  • Cerințe De Antet SVG
    • Trebuie să conțină: viewBox, width și height. Valorile lipsă sunt completate automat, dacă este posibil.
    • Trebuie să conțină spațiul de nume: xmlns="http://www.w3.org/2000/svg". Dacă lipseste sau este incorect, acesta este completat automat.
    • Numele iconului trebuie să se potrivească exact cu dimensiunile, altfel iconul este respins.
    • Dimensiunile trebuie să fie pătrate (lățime = înălțime). Standard: 24px.
    • Stilurile contradictorii sau dimensiunile nepotrivite trebuie evitate.
  • General
    • Iconuri slab create pot încetini semnificativ afișarea sau chiar pot provoca erori.
    • Asigurați-vă că respectați drepturile de autor ale simbolurilor.
    • Toate vectorii sunt rotunjiți la trei zecimale.

Structură

  • Fișierul iconset.ini este obligatoriu pentru a identifica setul de simboluri.
    • Acesta poate fi în directorul rădăcină al fișierului ZIP sau într-un subdirector.
    • Trebuie să fie în litere mici (iconset.ini).
    • Numele fișierelor de simboluri nu sunt sensibile la majuscule.
  • Importul nu căută automat fișiere SVG.
    • Directorul de iconuri trebuie definit explicit în iconset.ini (respectați majusculele și minusculele).
    • În șablonul fișierului ZIP a fost definit un director numit icons/.
  • Subdirectoare
    • Subdirectoarele din directorul definit (icons/) servesc ca categorii.
    • Numele simbolurilor trebuie să fie unice în toate categoriile.
    • Reguli de nume în directorul de simboluri:
      • Minimum: Doar dimensiune și extensie de fișier (de exemplu, 24.svg).
      • Variante precum filled24.svg sau round_filled_24.svg sunt valide.
      • Numele de fișiere cu mai multe numere (de exemplu, 24_48.svg) sunt invalide.
      • Variantele de stil sunt recunoscute prin:
        • Umplut: Trebuie să conțină filled sau fill.
        • Rotunjit: Trebuie să conțină round.
        • Ascuțit: Trebuie să conțină sharp.
        • Rotunjit și ascuțit nu pot fi combinați împreună.
      • Dacă mai multe reguli se aplică, fișierul detectat în ultimul rând este utilizat (alegerea poate părea aleatoare).
  • Alte Reguli
    • Nu se căută subdirectoare imbricate (acestea pot fi utilizate pentru backup-uri sau originale).
    • Fișierele fără .svg sunt ignorate.
    • Într-un director de simboluri poate exista un fișier numit tags.txt pentru a adăuga etichete suplimentare la căutare.
      • Etichetele pot fi separate prin ,, ; sau Sari De Linie.

Seturi Speciale De Simboluri

Există și diverse seturi speciale de simboluri care pot fi importate ca seturile proprii de simboluri, dar nu trebuie configurate conform specificațiilor de mai sus.

Hass Hue Icons

Unul dintre acestea este cel de pe pagina GitHub hass-hue-icons. Acesta este un set suplimentar de simboluri Hue din comunitatea Home Assistant HASS și poate fi utilizat doar pentru proiecte non-comerciale, deoarece se află sub licența Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International. Din acest motiv, setul de simboluri nu este inclus cu Antcas Control. Simbolurile pot fi însă importate oricând în proiect ca un nou set de simboluri folosind fișierul ZIP hass-hue-icons-main.zip. Aveți grijă la condițiile de licență ale proiectului pe pagina web GitHub.

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

Material Design Icons de la Pictogrammers

Un alt set este cel de la Pictogrammers. Pentru aceasta, fișierul mdi-###.json trebuie ambalat într-un fișier ZIP și importat. Fișierul poate fi găsit și descărcat din consola de dezvoltare a browserului. Se încearcă combinarea simbolurilor de contur cu cele umplute. Biblioteca este aproape identică cu Material Symbols. Cu toate acestea, există multe extinderi ale comunității. Dacă doriți să integrați alte seturi de simboluri în bibliotecă, vă rugăm să ne contactați.

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

Pagini Subordonate