Vooraf
Het thema bepaalt hoe de frontoffice eruitziet voor de burger. Je werkt in de module frontoffice van je applicatie. In oudere applicaties heet die module soms eloket.
Je past het uitzicht op drie niveaus aan:
|
Niveau |
Waar |
Wat je ermee doet |
|---|---|---|
|
Basisthema |
|
Kiezen tussen een neutraal thema en de huisstijl van de Vlaamse overheid |
|
Hoofdkleur |
|
De hoofdkleur van het neutrale thema instellen |
|
Eigen stijlregels |
|
Eigen CSS-regels toevoegen, bijvoorbeeld voor je eigen componenten |
Anders dan in de backoffice kies je het basisthema van de frontoffice niet in een SCSS-bestand, maar met een npm-pakket.
Stap 1: kies een basisthema
Het platform levert twee basisthema's voor de frontoffice, elk als eigen npm-pakket:
|
Basisthema |
Pakket |
|---|---|
|
Neutraal |
|
|
Vlaamse overheid |
|
Je neemt het pakket op in de dependencies van package.json, en je gebruikt het in src/index.js als basis voor de navigatie. Voor het thema van de Vlaamse overheid ziet dat er zo uit:
import "@skryv/core-react-vo";
import { registerDefaultRouting } from "@skryv/core-react-vo/src/config/routing";
import { registerDefaultTranslations } from "@skryv/core-react-vo/src/config/translations";
const customizedNavigation = registerDefaultRouting(navigation);
const customizedTranslation = registerDefaultTranslations(translation);
Hoe customizedNavigation en customizedTranslation verder gebruikt worden, lees je op Frontoffice aanpassen.
Van basisthema wisselen
Wil je in een bestaande applicatie wisselen tussen het neutrale thema en dat van de Vlaamse overheid, of omgekeerd?
-
Vervang in
package.jsonvan de frontoffice het pakket@skryv/react-neutraldoor@skryv/core-react-vo, of omgekeerd. -
Pas in
src/index.jsde imports aan die naar het pakket verwijzen. Voor de navigatie wordt@skryv/react-neutral/src/config/routingdan@skryv/core-react-vo/src/config/routing, of omgekeerd. -
Voer
npm installopnieuw uit en bouw de frontoffice (stap 4).
Een eigen component dat bouwstenen van het basisthema hergebruikt, zoals invoervelden uit @skryv/core-react-vo, moet je bij een wissel ook aanpassen. Zie Eigen formuliercomponenten.
Stap 2: stel de hoofdkleur in (neutraal thema)
Gebruik je het neutrale thema, dan stel je de hoofdkleur in met het bestand theme.json in de module processes:
{
"colors": {
"main": "#006080"
}
}
Het bestand staat in processes/src/main/resources/theme.json, bij de configuratie van je applicatie, en niet in de module frontoffice.
Stap 3: voeg eigen stijlregels toe
Eigen stijlregels zet je in src/theme/overrides.scss van de frontoffice. Dat bestand laad je in src/index.js in:
import "./theme/overrides.scss";
Geef je regels een selector met het prefix van je applicatie, zoals .mijnapp-. Zo raak je alleen je eigen componenten, en blijven de componenten van het basisthema ongewijzigd:
.mijnapp-aanvraag-samenvatting {
margin-bottom: 2rem;
}
Stap 4: bouw en controleer
De frontoffice wordt meegebouwd met de volledige applicatie. Wil je alleen de frontoffice compileren, dan doe je dat in de module zelf:
cd frontoffice
npm install
npx skr compile
Open daarna de frontoffice lokaal, zie Lokale setup, en controleer de kleuren, de leesbaarheid van tekst op gekleurde achtergronden en het uitzicht van formulieren.
Upgraden van een oudere platformversie
Het thema van de Vlaamse overheid steunt op de @govflanders-pakketten van de Vlaamse overheid. Na een platformupgrade kan het nodig zijn om de versies van die pakketten vast te zetten met een overrides-blok in package.json. Welke versies je nodig hebt, lees je in de release notes.
Resultaat
De frontoffice gebruikt het gekozen basisthema, eventueel met je eigen hoofdkleur, en je eigen stijlregels gelden alleen voor je eigen componenten.