Symbolen

Alle Symbolen kunnen op verschillende plaatsen in de visualisatie worden gebruikt. Zo is het mogelijk om deze als variabele of tekst te definiëren.

Om een symbool in de visualisatie weer te geven, wordt dit middels tag [icon:SYMBOLPAD] rechtstreeks in de tekst gedefinieerd. Het symboolpad kan met behulp van rechtermuisknop of met CTRL+C uit de symbolenbibliotheek worden gekopieerd. Er moet, indien mogelijk, alleen het materiaal Symbols worden gekozen, zodat de stijl van de visualisatie gelijk blijft.

Symbolenbibliotheek

Alle beschikbare symbolen kunnen onder het contextmenu Visualisatie ▸ Symbolen worden opgeroepen en doorzocht. Het is ook mogelijk om een eigen set symbolen in de bibliotheek te importeren. De procedure wordt hieronder uitgelegd.

Opmerking: De naam die in de lijst met symbolen wordt weergegeven, is niet identiek aan het symboolpad. Wordt er geen set symbolen in het pad opgegeven, dan wordt automatisch de set Glyphicons gebruikt.

De filter in de symbolenbibliotheek zoekt ook naar de opgeslagen tags. Wanneer dit gedrag niet gewenst is, kan de filter met een = beginnen om alleen in de namen te zoeken.

Set Material Symbols (standaard)

Deze set symbolen is volledig dynamisch en de stijl van de symbolen wordt automatisch overeenkomstig het ontwerp van de visualisatie geconfigureerd. Bovendien wordt een gevuld symbool automatisch gebruikt wanneer het symbool actief moet zijn. Niet elk symbool heeft echter een gevulde variant.

De symbolen worden automatisch afgerond als de schakelknop-radius groter of gelijk is aan 16 pixels. Is de radius gelijk aan 0px, dan worden de scherpe symbolen gebruikt. In de editor worden echter altijd de normale symbolen gebruikt.

Opmerking: Het wordt aanbevolen om de set "Material Symbols" te gebruiken om de visualisatie uniform te laten zijn.

Set Material Animated

Er zijn geselecteerde symbolen van Material Symbols die geanimeerd zijn om waarden weer te geven. Deze symbolen hebben alleen een animatie met het symbool van de structuur. Bij selectie worden dan verdere variabelen vrijgegeven.

Set Philips Hue

De symbolen van Philips Hue kunnen vrij worden gebruikt wanneer de Hue-schnittstelle wordt ingezet. Bovendien is er een aanvullende set symbolen van de community van Home Assistant HASS. Verdere informatie vindt u aan het einde van dit hoofdstuk.

Set Weer

Deze set symbolen toont de weer-symbolen van de visualisatie. Deze worden naadloos ondersteund door diverse Schnittstellen. Zie het onderstaande hoofdstuk Weer-Icons.

Set Legacy (verouderd)

De set Legacy bevat alle symbolen van de oude visualisatie. De weergavestijl van het nieuwe oppervlak blijft hierbij gelijk. De symbolen moeten niet meer worden gebruikt, omdat de weergave niet voor het nieuwe oppervlak is geoptimaliseerd.

Diverse oude symbolen zijn nog steeds geanimeerd:

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

Verborgen Symbolen

Er zijn ook verborgen symbolen voor de visualisatie. Deze worden in de volgende hoofdstukken verder uitgelegd.

Om de symbolen op te roepen, is alleen een URL-voorvoegsel nodig.

Eigen Sets Symbolen

Het is mogelijk om een eigen set symbolen in het project te importeren. Elke set symbolen moet als ZIP-bestand worden voorbereid. Enkele voorbeeldgegevens kunnen hier worden gedownload:

Pro-Tip: Na een succesvolle import kunt u de set symbolen als .antobj exporteren om de import te vereenvoudigen. Klik hiertoe met de rechtermuisknop op een set symbolen en kies Exporteren.

De volgende regels definiëren de structuur en eisen van een set symbolen. Lees deze aandachtig door en houd u er strikt aan.

Regels

  • Voorvoegsel
    • Mag alleen _, a–z en 0–9 bevatten.
    • Hoofdletters worden automatisch in kleine letters omgezet.
    • Gereserveerde namen zoals sys, src of doc zijn ongeldig.
    • Moet beginnen met een letter (a–z). Alleen cijfers zijn niet toegestaan.
    • Achtervoegsel streepjes (_) worden verwijderd.
    • Moet ten minste 3 tekens lang zijn.
    • Meervoudige streepjes (__) worden tot één gereduceerd.
  • Symbolennamen
    • Worden automatisch in kleine letters omgezet.
    • Toegestane tekens zijn -, _, a–z en 0–9.
    • Te lange namen en voorvoegsels moeten worden vermeden.
    • Een voorvoegsel moet uniek zijn en mag alleen één keer worden gebruikt.
    • Als een symbool dezelfde naam en hetzelfde voorvoegsel heeft als een systeemsymbool, kan het dit vervangen.
  • Bestandsbeperkingen
    • Maximale bestandsgrootte na opschonen: 10 kB. Grotere bestanden worden afgewezen.
    • SVG-bestanden moeten zijn opgeschoond:
      • Regelomschakelingen worden automatisch verwijderd.
      • De volgende elementen worden verwijderd: <title>, <desc>, <script>, <image>, <style>, <foreignObject>.
      • De volgende attributen worden verwijderd: style, fill, stroke, color, stop-color, flood-color, lighting-color.
      • Icons met ingebouwde scripts, afbeeldingen, CSS of externe bronnen worden afgewezen.
      • Als styles kleuren of style-blokken bevatten, kan de import ook worden afgewezen.
  • SVG-headervereisten
    • Moet bevatten: viewBox, width en height. Ontbrekende waarden worden, indien mogelijk, automatisch aangevuld.
    • Moet de namespace bevatten: xmlns="http://www.w3.org/2000/svg". Als deze ontbreekt of foutief is, wordt hij automatisch aangevuld.
    • De naam van het symbool moet precies overeenkomen met de afmetingen, anders wordt het symbool afgewezen.
    • De afmetingen moeten vierkant zijn (breedte = hoogte). Standaard: 24px.
    • Wijderspruchtige styles of ongeschikte afmetingen moeten worden vermeden.
  • Algemeen
    • Slecht gemaakte icons kunnen de weergave sterk vertragen of zelfs fouten veroorzaken.
    • Let er absoluut op de auteursrechten van de symbolen.
    • Alle vectoren worden afgerond tot drie decimalen.

Structuur

  • Het bestand iconset.ini is verplicht om de set symbolen te herkennen.
    • Het kan in het rootmap van de ZIP-bestand of in een submap liggen.
    • Moet in kleine letters zijn (iconset.ini).
    • Symbolenbestandsnamen zelf zijn niet hoofdlettergevoelig.
  • De import zoekt niet automatisch naar SVG-bestanden.
    • De map met symbolen moet expliciet in iconset.ini worden gedefinieerd (hoofdletters/kleine letters onderscheiden).
    • In de ZIP-bestandsjabloon is een map genaamd icons/ gedefinieerd.
  • Submappen
    • Submappen in de gedefinieerde map (icons/) dienen als categorieën.
    • Symbolennamen moeten uniek zijn over alle categorieën heen.
    • Naamregels in de map met symbolen:
      • Minimum: Alleen afmeting en bestandsnaam (bijv. 24.svg).
      • Varianten zoals filled24.svg of round_filled_24.svg zijn geldig.
      • Bestandsnamen met meerdere cijfers (bijv. 24_48.svg) zijn ongeldig.
      • Style-varianten worden herkend door:
        • Gevuld: Moet filled of fill bevatten.
        • Rond: Moet round bevatten.
        • Scherp: Moet sharp bevatten.
        • Rond en scherp kunnen niet met elkaar worden gecombineerd.
      • Als meerdere regels van toepassing zijn, wordt het laatst herkende bestand gebruikt (de selectie kan willekeurig lijken).
  • Verdere regels
    • Geen geneste sub-submappen worden doorzocht (deze kunnen voor back-ups of originele bestanden worden gebruikt).
    • Bestanden zonder .svg worden genegeerd.
    • In een map met symbolen kan een bestand genaamd tags.txt liggen om aanvullende tags voor zoeken toe te voegen.
      • Tags kunnen worden gescheiden door ,, ; of regelomschakelingen.

Speciale Sets Symbolen

Er zijn ook diverse speciale sets symbolen die zoals de eigen sets symbolen kunnen worden geïmporteerd, maar niet aan de bovenstaande voorschriften hoeven te voldoen.

Hass Hue Icons

Een daarvan is die van de Gibhub-pagina hass-hue-icons. Dit is een aanvullende set symbolen van de community van Home Assistant HASS en mag alleen voor niet-commerciële projecten worden gebruikt, omdat deze onder de Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International-licentie valt. Daarom wordt de set symbolen niet met Antcas Control meegeleverd. De symbolen kunnen echter op elk moment met het ZIP-bestand hass-hue-icons-main.zip als nieuwe set symbolen in het project worden geïmporteerd. Let hierbij op de licentievoorwaarden van het project op de Github-website.

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

Material Design Icons van Pictogrammers

Een ander is die van Pictogrammers. Hiervoor moet het bestand mdi-###.json in een ZIP-bestand worden gezet en geïmporteerd. Het bestand kan in de ontwikkelaarsconsole van de browser worden gevonden en gedownload. Er wordt gepoogd om de outline-symbolen met de gevulde te combineren. De bibliotheek is bijna gelijk aan die van Material Symbols. Er zijn echter veel community-extensies. Als u andere sets symbolen in de bibliotheek wilt integreren, kunt u ons graag vragen.

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

Ondergeschikte Paginan