📖 Introductie
De Labels Helper biedt een centrale manier om teksten en foutmeldingen op te halen op basis van sleutels. Hiermee wordt consistente messaging en meertalige ondersteuning gerealiseerd.
👉 Ondersteunt dynamische placeholders en automatische taalbepaling.
📦 Functionaliteit
🏷️ Labels
-
getLabel(key, vars) → Haalt label op en vervangt placeholders (
{0}, {1}, ...)
⚙️ Werking
De helper bepaalt automatisch de juiste taal en vervangt dynamische waarden in teksten.
👉 De helper voert de volgende stappen uit:
- Bepaalt taal via
core.User.getLanguageId()
- Mapt naar
nl of en
- Zoekt label in interne dictionary
- Vervangt placeholders
1. Taalbepaling
- 1033 → English
- 1043 → Dutch
- Default → English
2. Placeholder verwerking
-
{0}, {1} worden vervangen door waarden uit vars
🌍 Ondersteunde talen
| LanguageId |
Taal |
| 1033 |
en (English) |
| 1043 |
nl (Dutch) |
| default |
en |
📚 Beschikbare labels
-
LBL001 → Phone number is not correct
-
LBL002 → Mobile phone number is not correct
-
LBL003 → Postal code is not correct
-
LBL004 → Chamber of Commerce number is not correct
-
LBL005 → House number is not correct
-
LBL006 → Address could not be found based on postcode + house number
💡 Voorbeelden
Enkel label
const msg1 = core.Labels.getLabel("LBL003", ["1234AB"]);
// "Postalcode 1234AB is not correct."
Meerdere placeholders
const msg2 = core.Labels.getLabel("LBL006", ["1234AB", "10"]);
// "Address could not be found based on postalcode 1234AB and housenumber 10."
⚠️ Belangrijke aandachtspunten
-
Fallback taal
Als taal niet gevonden wordt → English
-
Placeholder index
Moet overeenkomen met array volgorde
-
Key bestaat niet
Return kan undefined of fallback waarde zijn
⚠️ Zorg dat alle labels in alle talen beschikbaar zijn om inconsistent gedrag te voorkomen.
📊 Samenvatting
✅ Centrale label repository
✅ Meertalige ondersteuning
✅ Dynamische placeholder vervanging
✅ Consistente foutmeldingen