Symbols

Alla symboler kan användas på olika ställen i visualiseringen. Det är möjligt att definiera dessa som variabel eller text.

För att skriva ut ett symbol på visualiseringen deklareras detta med hjälp av taggen [icon:SYMBOLPFAD] direkt i texten. Symbolsökvägen kan kopieras från symbolbiblioteket med höger musknapp eller med CTRL+C. Om möjligt bör endast Material Symbols väljas för att behålla visualiseringens stil.

Symbolbibliotek

Alla tillgängliga symboler kan nås och sökas under kontextmenyn Visualisering ▸ Symbols. Det är också möjligt att importera en egen symbolsats till biblioteket. Proceduren förklaras längre ner.

Anteckningar: Namnet som visas på symbolförteckningen är inte identiskt med symbolsökvägen. Om ingen symbolsats anges i sökvägen används automatiskt Glyphicons-satsen.

Filtret i symbolbiblioteket söker också efter de lagrade taggarna. Om detta beteende inte önskas kan filtret börja med ett = för att endast söka i namnen.

Symbolsats Material Symbols (Standard)

Den här symbolsatsen är helt dynamisk och symbolernas stil konfigureras automatiskt enligt visualiseringens design. Dessutom används ett ifyllt symbol automatiskt när symbolet ska vara aktivt. Inte alla symboler har dock en ifylld variant.

Symbolerna avrundas automatiskt om knappsradie är större eller lika med 16 Pixel. Om radien är lika med 0px, används skarpa symboler. I redigeraren används dock alltid normala symboler.

Anteckning: Det rekommenderas att använda symbolsatsen "Material Symbols" för att göra visualiseringen enhetlig.

Symbolsats Material Animated

Det finns valda symboler från Material Symbols som har animerats för att visa värden. Dessa symboler har endast en animation med symbolet i strukturen. Vid val aktiveras fler variabler.

Symbolsats Philips Hue

Symbolerna från Philips Hue kan användas fritt om Hue-gränssnittet används. Dessutom finns en tilläggs-Hue-symbolsats från Home Assistant HASS-communityn. Mer information hittar du i slutet av detta kapitel.

Symbolsats Väder

Den här symbolsatsen visar väder-symbolerna för visualiseringen. Dessa stöds smidigt av olika gränssnitt. Se det nedanstående kapitlet Vädersymboler.

Symbolsats Legacy (föråldrad)

Den Legacy-symbolsatsen innehåller alla symboler från den gamla visualiseringen. Visningsstilen för det nya gränssnittet förblir densamma. Symbolerna bör inte användas längre eftersom representationen inte är optimerad för det nya gränssnittet.

Diverse gamla symboler är fortfarande animerade:

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

Dolda Symboler

Det finns också dolda symboler för visualiseringen. Dessa förklaras vidare i de nedre kapitlen.

För att komma åt symbolerna krävs endast ett URL-prefix.

Egna Symbolsatsar

Det är möjligt att importera en egen symbolsats till projektet. Varje symbolsats måste förberedas som en ZIP-fil. Några exempeldata kan laddas ner här:

Pro-Tipp: Efter en lyckad import kan du exportera symbolsatsen som .antobj för att förenkla importen. Högerklicka på en symbolsats och välj Export.

Följande regler definierar strukturen och kraven för en symbolsats. Läs dessa noggrant och följ dem exakt.

Regler

  • Prefix
    • Får endast innehålla _, a–z och 0–9.
    • Versaler omvandlas automatiskt till gemener.
    • Reserverade namn som sys, src eller doc är ogiltiga.
    • Måste börja med en bokstav (a–z). Endast siffror är inte tillåtna.
    • Efterföljande understreck (_) tas bort.
    • Måste vara minst 3 tecken långt.
    • Dubbla understreck (__) reduceras till ett enda.
  • Symbolnamn
    • Omvandlas automatiskt till gemener.
    • Tillåtna tecken är -, _, a–z och 0–9.
    • Undvik långa namn och prefix.
    • Ett prefix måste vara unikt och bör endast användas en gång.
    • Om ett symbol har samma namn och prefix som ett system-symbol kan det ersätta detta.
  • Filbegränsningar
    • Maximal filstorlek efter rensning: 10 kB. Större filer avvisas.
    • SVG-filer måste vara rensade:
      • Radbrytningar tas automatiskt bort.
      • Följande element tas bort: <title>, <desc>, <script>, <image>, <style>, <foreignObject>.
      • Följande attribut tas bort: style, fill, stroke, color, stop-color, flood-color, lighting-color.
      • Symboler med inbäddade skript, bilder, CSS eller externa resurser avvisas.
      • Om Styles innehåller färger eller Style-block kan importen också avvisas.
  • SVG-header-krav
    • Måste innehålla: viewBox, width och height. Saknade värden kompletteras automatiskt om möjligt.
    • Måste innehålla namnutrymmet: xmlns="http://www.w3.org/2000/svg". Om det saknas eller är felaktigt kompletteras det automatiskt.
    • Symbolnamnet måste exakt matcha dimensionerna, annars avvisas symbolen.
    • Dimensionerna måste vara kvadratiska (bredd = höjd). Standard: 24px.
    • Undvik motsägelsefulla Styles eller oegentliga dimensioner.
  • Allmänt
    • Dåligt skapade symboler kan kraftigt sakta ner representationen eller till och med göra den felaktig.
    • Var noga med att uppmärksamma symbolernas upphovsrätt.
    • Alla vektorer avrundas till tre decimaler.

Struktur

  • Filen iconset.ini är obligatorisk för att identifiera symbolsatsen.
    • Den kan ligga i ZIP-filens rotkatalog eller i en underkatalog.
    • Måste vara i gemener (iconset.ini).
    • Symbolfilnamn är inte case-sensitive.
  • Importen söker inte automatiskt efter SVG-filer.
    • Symbolkatalogen måste explicit definieras i iconset.ini (observera stor-/liten bokstav).
    • I ZIP-fil-mallen har en katalog med namnet icons/ definierats.
  • Underkataloger
    • Underkataloger i den definierade katalogen (icons/) används som kategorier.
    • Symbolnamn måste vara unika över alla kategorier.
    • Namnregler i symbolkatalogen:
      • Minimum: Endast dimension och filändelse (t.ex. 24.svg).
      • Varianter som filled24.svg eller round_filled_24.svg är giltiga.
      • Filnamn med flera siffror (t.ex. 24_48.svg) är ogiltiga.
      • Style-varianter identifieras genom:
        • Iffyllt: Måste innehålla filled eller fill.
        • Rund: Måste innehålla round.
        • Skarp: Måste innehålla sharp.
        • Rund och skarp kan inte kombineras.
      • Om flera regler gäller används den senast identifierade filen (valet kan verka slumpmässigt).
  • Ytterligare regler
    • Inga inbäddade under-underkataloger undersöks (dessa kan användas för backup eller original).
    • Filer utan .svg ignoreras.
    • I en symbolkatalog kan en fil med namnet tags.txt ligga för att lägga till ytterligare taggar för sökning.
      • Taggar kan separeras med ,, ; eller radbrytningar.

Specialsymbolsatsar

Det finns också diverse special-symbolsatsar som kan importeras likt egna symbolsatsar, men som inte behöver konfigureras enligt ovanstående regler.

Hass Hue Icons

En av dessa är från Gibhub-sidan hass-hue-icons. Detta är en tilläggs-Hue-symbolsats från Home Assistant HASS-communityn och får endast användas för icke-kommersiella projekt, eftersom den står under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International-licensen. Därför levereras inte symbolsatsen med Antcas Control. Symbolerna kan dock när som helst importeras till projektet som en ny symbolsats med ZIP-filen hass-hue-icons-main.zip. Observera projekts licensvillkor på Github-webbplatsen.

Källa: https://github.com/arallsopp/hass-hue-icons.

Material Design Icons av Pictogrammers

En annan är från Pictogrammers. För detta måste filen mdi-###.json packas i en ZIP-fil och importeras. Filen kan hittas och laddas ner i webbläsarens utvecklarverktygskonsol. Det försöker kombinera outline-symboler med ifyllda. Biblioteket är nästan likt Material Symbols. Det finns dock många community-utökningar. Om du vill integrera andra symbolsatsar i biblioteket kan du gärna fråga oss.

Källa: https://pictogrammers.com/library/mdi/

Undersidor