Symbole

Alle Symbole kan bruges på forskellige steder i visualiseringen. Det er muligt at definere disse som en variabel eller tekst.

For at udskrive et symbol i visualiseringen, deklareres dette ved hjælp af tagget [icon:SYMBOLSTI] direkte i teksten. Symbolstien kan kopieres fra symbolbiblioteket med højreklik eller CTRL+C. Der bør, hvis muligt, kun vælges Material Symbols for at bevare visualiseringens stil.

Symbolbibliotek

Alle tilgængelige symboler kan kaldes og søges under kontekstmenuen Visualisering ▸ Symbole. Det er også muligt at importere et eget symbolsæt til biblioteket. Proceduren forklares senere.

Noter: Navnet, der vises på symbollisten, er ikke identisk med symbolstien. Hvis ingen symbolsæt angives i stien, bruges automatisk sættet Glyphicons.

Filtret i symbolbiblioteket søger også efter de gemte tags. Hvis dette opførsel ikke ønskes, kan filteret starte med et = for at søge kun i navne.

Symbolsæt Material Symbols (Standard)

Dette symbolsæt er helt dynamisk, og symbolernes stil konfigureres automatisk i overensstemmelse med visualiseringens design. Derudover bruges et udfyldt symbol automatisk, hvis symbolet skal være aktivt. Ikke alle symboler har dog en udfyldt variant.

Symbolerne afrundes automatisk, hvis knapradius er større eller lig med 16 Pixel. Hvis radius er lig med 0px, bruges de skarpe symboler. I editoren vises dog altid de normale symboler.

Note: Det anbefales at bruge symbolsættet "Material Symbols" for at give visualiseringen en ensartet stil.

Symbolsæt Material Animated

Der er udvalgte symboler fra Material Symbols, der er blevet animeret for at repræsentere værdier. Disse symboler har kun en animation med det symbol fra den struktur. Når de vælges, frigøres flere variabler.

Symbolsæt Philips Hue

Symbolerne fra Philips Hue kan bruges frit, hvis Hue-grænsefladen anvendes. Derudover er der et ekstra Hue-symbolsæt fra Home Assistant HASS-communityen. Yderligere oplysninger findes i slutningen af dette kapitel.

Symbolsæt Vejr

Dette symbolsæt viser vejrsymbolerne i visualiseringen. Disse understøttes glidende af forskellige grænseflader. Se det følgende kapitel Vejrikoner.

Symbolsæt Legacy (forældet)

Det Legacy-symbolsæt indeholder alle symboler fra den gamle visualisering. Visningsstilen for det nye grænsefladeforhold forbliver den samme. Symbolerne bør ikke længere bruges, da de ikke er optimeret til den nye grænseflade.

Diverse gamle symboler er stadig animerede:

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

Skjulte Symboler

Der findes også skjulte symboler til visualiseringen. Disse forklares yderligere i de følgende kapitler.

For at kalde symbolerne, er kun et URL-præfiks nødvendigt.

Egne Symbolsæt

Det er muligt at importere et eget symbolsæt til projektet. Hvert symbolsæt skal forberedes som en ZIP-fil. Nogle eksempeldata kan downloades her:

Pro-tip: Efter en vellykket import kan du eksportere symbolsættet som .antobj for at lette importen. Klik med højre knap på et symbolsæt og vælg Eksport.

De følgende regler definerer opbygningen og kravene til et symbolsæt. Læs dem omhyggeligt og følg dem nøje.

Regler

  • Præfiks
    • Kan kun indeholde _, a–z og 0–9.
    • Store bogstaver konverteres automatisk til små bogstaver.
    • Reserverede navne som sys, src eller doc er ugyldige.
    • Må starte med et bogstav (a–z). Kun tal er ikke tilladt.
    • Efterfølgende understregninger (_) fjernes.
    • Må være mindst 3 tegn langt.
    • Flere understregninger (__) reduceres til en enkelt.
  • Symbolnavne
    • Konverteres automatisk til små bogstaver.
    • Tilladte tegn er -, _, a–z og 0–9.
    • For lange navne og præfikser bør undgås.
    • Et præfiks skal være entydigt og bør kun bruges én gang.
    • Hvis et symbol har samme navn og præfiks som et systemsymbol, kan det erstatte dette.
  • Filbegrænsninger
    • Maksimal filstørrelse efter rensning: 10 kB. Større filer afvises.
    • SVG-filer skal være rensede:
      • Linjeskift fjernes automatisk.
      • Følgende elementer slettes: <title>, <desc>, <script>, <image>, <style>, <foreignObject>.
      • Følgende attributter slettes: style, fill, stroke, color, stop-color, flood-color, lighting-color.
      • Icons med indlejrede skripter, billeder, CSS eller eksterne ressourcer afvises.
      • Hvis styles indeholder farver eller style-blokke, kan importen også afvises.
  • SVG-header-krav
    • Skal indeholde: viewBox, width og height. Manglende værdier suppleres, hvis muligt, automatisk.
    • Skal indeholde namespace: xmlns="http://www.w3.org/2000/svg". Hvis den mangler eller er forkert, suppleres den automatisk.
    • Icon-navnet skal præcist matche dimensionerne, ellers afvises iconet.
    • Dimensionerne skal være kvadratiske (bredde = højde). Standard: 24px.
    • Modsigende styles eller upassende dimensioner bør undgås.
  • Generelt
    • Dårligt lavede icons kan betydeligt bremse visningen eller endda forårsage fejl.
    • Vær opmærksom på symbolernes ophavsret.
    • Alle vektorer afrundes til tre decimaler.

Struktur

  • Fil iconset.ini er påkrævet for at genkende symbolsættet.
    • Den kan ligge i ZIP-filens rodmappe eller i en undermappe.
    • Skal være i små bogstaver (iconset.ini).
    • Symbolfilnavne er ikke case-sensitive.
  • Importen søger ikke automatisk efter SVG-filer.
    • Icon-mappen skal eksplisitt defineres i iconset.ini (skel mellem store og små bogstaver).
    • I ZIP-filskonfigurationen er en mappe kaldet icons/ defineret.
  • Undermapper
    • Undermapper i den definerede mappe (icons/) bruges som kategorier.
    • Symbolnavne skal være entydige over alle kategorier.
    • Navneregler i icon-mappen:
      • Minimum: Kun dimension og filendelse (f.eks. 24.svg).
      • Varianter som filled24.svg eller round_filled_24.svg er gyldige.
      • Filnavne med flere tal (f.eks. 24_48.svg) er ugyldige.
      • Style-varianter genkendes ved:
        • Udfyldt: Skal indeholde filled eller fill.
        • Afrundet: Skal indeholde round.
        • Skarpt: Skal indeholde sharp.
        • Afrundet og skarpt kan ikke kombineres.
      • Hvis flere regler gælder, bruges den sidst genkendte fil (valget kan virke tilfældigt).
  • Yderligere regler
    • Ingen indlejrede undermapper søges (disse kan bruges til backup eller originale filer).
    • Filer uden .svg ignoreres.
    • I en icon-mappe kan der ligge en fil kaldet tags.txt for at tilføje yderligere søgetags.
      • Tags kan adskilles med ,, ; eller linjeskift.

Specielle Symbolsæt

Der findes også forskellige specielle symbolsæt, der kan importeres som egne symbolsæt, men ikke behøver at følge de ovennævnte regler.

Hass Hue Icons

Et af disse er fra GitHub-siden hass-hue-icons. Dette er et ekstra Hue-symbolsæt fra Home Assistant HASS-communityen og må kun bruges til ikke-kommercielle projekter, da det er under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International-licensen. Derfor leveres symbolsættet ikke med Antcas Control. Symbolerne kan dog importeres som et nyt symbolsæt i projektet ved hjælp af ZIP-filen hass-hue-icons-main.zip. Vær opmærksom på projekts licensbetingelser på GitHub-webstedet.

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

Material Design Icons fra Pictogrammers

Et andet er fra Pictogrammers. For at bruge dette, skal filen mdi-###.json pakkes i en ZIP-fil og importeres. Filen kan findes og downloades i browserens udviklerkonsol. Der forsøges at kombinere outline-symboler med udfyldte. Biblioteket er næsten identisk med Material Symbols. Der er dog mange community-udvidelser. Hvis du vil integrere andre symbolsæt i biblioteket, kan du gerne kontakte os.

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

Underordnede Sider