Working version v32.1.X v32.0.X v29.1.X
Working version v32.1.X v32.0.X v29.1.X Dutch

Iconen toevoegen in backoffice

Vooraf

Bouw je eigen schermen of componenten voor de backoffice, dan wil je daar vaak iconen in gebruiken. Je hoeft daarvoor niets te installeren: het platform bevat een Font Awesome-bibliotheek met meer dan 3.000 iconen, in de stijlen solid, regular en duotone solid.

Beschikbaar vanaf platformversie 28.0.

Je gebruikt de iconen in de templates van je eigen AngularJS-componenten. Hoe je zo'n component bouwt, lees je op Backoffice aanpassen.

Stap 1: zoek een icoon

Zoek een icoon op de website van Font Awesome. Elk icoon heeft een naam, zoals bolt of file-lines. Kies een icoon in een stijl die het platform bevat: solid, regular of duotone solid.

Stap 2: voeg het icoon toe aan je template

Je voegt een icoon toe met een <i>-element met twee klassen: de stijl en de naam van het icoon, met telkens het voorvoegsel fa-:

HTML
<i class="fa-solid fa-bolt" aria-hidden="true"></i>

Voor de stijl regular gebruik je fa-regular:

HTML
<i class="fa-regular fa-file-lines" aria-hidden="true"></i>

Gebruik rechte aanhalingstekens (") rond de klassenamen. Typografische aanhalingstekens (“ ”), die er bij het kopiëren uit een tekstverwerker of webpagina in kunnen sluipen, maken de HTML ongeldig. Het icoon verschijnt dan niet.

Voorbeeld

<i class=”fa-solid fa-bolt”></i>

image-20251201-154143.png
bolt icoon uit de font awesome bibliotheek

Stap 3: maak het icoon toegankelijk

Een icoon is voor een schermlezer onzichtbaar, of wordt voorgelezen als een betekenisloos teken. Houd daarom rekening met twee situaties:

  • Het icoon is decoratief, omdat er al tekst naast staat. Geef het aria-hidden="true" mee, zoals in de voorbeelden hierboven.

  • Het icoon staat alleen, bijvoorbeeld op een knop zonder tekst. Geef dan het omringende element een label, zodat een schermlezer weet wat de knop doet:

HTML
<button type="button" aria-label="Dossier verversen">
  <i class="fa-solid fa-rotate" aria-hidden="true"></i>
</button>

Resultaat

Het icoon verschijnt in je eigen backofficecomponent, en blijft bruikbaar voor gebruikers met een schermlezer.