Deze stijlgids richt zich op het opstellen van effectieve paginabeschrijvingen en tooltips voor de gebruikersinterface van een product. Beide elementen zijn cruciaal voor duidelijkheid en context, waardoor gebruikers efficiënt kunnen navigeren en interacteren met het platform.
Kernprincipes
| Principe |
Wat het betekent |
| Helderheid en eenvoud |
Gebruik eenvoudige taal zonder jargon en technische complexiteit. Houd de boodschappen kort en to the point. |
| Consistentie |
Gebruik consistente terminologie in alle beschrijvingen en tooltips. Volg dezelfde toon, tijd en stijl door het hele platform. |
| Gebruikersgerichte taal |
Schrijf vanuit het perspectief van de gebruiker en leg de nadruk op acties of voordelen. Vermijd interne systeemtermen, tenzij ze gebruikersgericht zijn. |
| Toegankelijkheid |
Zorg ervoor dat tekst begrijpelijk is voor alle gebruikers, inclusief niet-moedertaalsprekers. Gebruik de naamval voor leesbaarheid. |
Paginabeschrijvingen
Een paginabeschrijving geeft een korte uitleg van het doel van een pagina en helpt gebruikers de belangrijkste handelingen die ze daar kunnen uitvoeren te begrijpen.
Best Practices
| Richtlijn |
Wat te doen |
| Vat het doel van de pagina samen |
Richt je op wat gebruikers op de pagina kunnen bereiken. |
| Limietlengte |
Blijf bij 1–2 zinnen. Vermijd te gedetailleerde beschrijvingen. |
| Gebruik actiegerichte taal |
Begin met werkwoorden of uitdrukkingen die beschrijven wat de gebruiker kan doen. |
| Vermijd herhaling |
Herhaal de paginatitel niet en dupliceer geen andere UI-elementen. |
Voorbeelden
| Page |
Beschrijving |
| Categoriebeheerpagina |
"Organiseer en beheer je kennisbasiscategorieën om je inhoud effectief te structureren." |
| Uploadpagina voor bestanden |
"Upload bestanden om ze aan artikelen toe te voegen of te delen met je team." |
| Pagina met machtigingsinstellingen |
"Definieer toegangsrechten voor lezersgroepen om de zichtbaarheid van inhoud te reguleren." |
Een tooltip biedt extra context of verduidelijking over een specifiek UI-element wanneer gebruikers eroverheen zweven.
Best Practices
| Richtlijn |
Wat te doen |
| Wees beknopt |
Beperk de tooltips tot één korte zin (minder dan 15 woorden). |
| Waarde toevoegen |
Geef informatie die niet direct zichtbaar is in de gebruikersinterface. Herhaal geen labels of beschrijvingen die al duidelijk zijn. |
| Gebruik tegenwoordige tijd |
Focus op de huidige staat of actie die de gebruiker heeft. |
| Wees specifiek |
Pas tooltips aan op de functionaliteit van het element. Vermijd vage of generieke zinnen. |
Voorbeelden
| Element |
Tooltip |
| Veld toegestane domeinen |
"Voer domeinen in zodat gebruikers met overeenkomende e-mailadressen zich kunnen registreren." |
| Exportknop |
"Download de huidige gegevens als CSV-bestand." |
| SEO-instellingen |
"Optimaliseer je artikel voor zoekmachines door een meta-beschrijving en trefwoorden toe te voegen." |
| Aspect |
Paginabeschrijvingen |
Tooltips |
| Doel |
Geef een samenvatting van het doel van de pagina. |
Bied extra richtlijnen voor specifieke UI-elementen. |
| Plaatsing |
Onder de paginatitel of kop. |
Verschijnt wanneer je met de muis over een specifiek element gaat. |
| Lengte |
1–2 zinnen. |
Een korte zin of één zin. |
| Toon |
Neutraal en verklarend. |
Contextueel en instructief. |
Checklist: Paginabeschrijvingen
- Legt het duidelijk het doel van de pagina uit?
- Is het kort en makkelijk te lezen?
- Geeft het de gebruiker een aanwijzing voor wat ze op de pagina kunnen bereiken?
- Voorkomt het redundantie met andere UI-elementen?
- Biedt het waarde die verder gaat dan wat zichtbaar is in de UI?
- Is het beknopt en specifiek voor het element, zonder overweldigend te zijn?
- Gebruikt het de tegenwoordige tijd?
- Voorkomt het dat het label of de titel van het element wordt herhaald?
- Is het vrij van jargon of complexe terminologie?
- Is het grammaticaal correct en correct gepunctueerd?