Codeblokken in Document360 tonen standaard hun volledige inhoud, wat betekent dat een blok met een lang script of configuratiebestand alles eronder ver naar beneden op de pagina kan duwen. Dit maakt artikelen moeilijker te navigeren en kan lezers ontmoedigen om de volgende inhoud te lezen. Het toevoegen van een verticale scrollbar lost dit op door het codeblok op een vaste pixelhoogte te beperken, lezers scrollen binnen het blok zelf, en de rest van het artikel blijft op zijn plaats.
Wanneer dit te gebruiken
Gebruik deze aanpassing wanneer je wilt:
- Voorkom dat lange codeblokken de paginalay-out domineren en de omliggende inhoud verbergen.
- Houd de lengte van het artikel voorspelbaar, vooral in referentiedocumentatie of API-gidsen met meerdere codevoorbeelden.
- Verbeter de leeservaring op pagina's waar code en proza naast elkaar moeten bestaan zonder dat het een het ander overweldigt.
Voordat je begint
- Je hebt toegang nodig tot instellingen () > kennisbanksite > site-aanpassing > aangepaste CSS en JavaScript in het kennisbankportaal.
- Bepaal de pixelhoogte waarop je je codeblokken wilt beperken voordat je begint.
280pxis een redelijke standaard die ongeveer 10–12 regels code toont voordat het scrollen begint.
Pas een verticale scrollbalk toe op alle artikelen
Gebruik deze aanpak om de scrollbalk toe te passen op elk codeblok op je hele kennisbasis. Selecteer het CSS-fragment dat overeenkomt met de versie van je kennisbanksite.
- Navigeer naar Instellingen () > Kennisbanksite > Site-aanpassing > Aangepaste CSS & JavaScript in het kennisbankportaal.
- Selecteer in het linker navigatiepaneel het tabblad CSS en plak het volgende fragment:
article .code-toolbar {
height: 280px;
overflow-x: hidden !important;
overflow-y: auto !important;
}
- Vervang de hoogtewaarde door de gewenste pixelgrootte.
- Klik op Opslaan.
OPMERKINGWanneer je het Knowledge Base site 2.0-fragment gebruikt, wordt het bovenste pictogram van de verticale scrollbalk in het codeblok verborgen.
Uitkomst

Best practices
- Begin met 280px. Deze hoogte toont ongeveer 10–12 regels code voordat de scrollbalk wordt geactiveerd, wat voldoende context is voor de meeste lezers om de codestructuur in één oogopslag te begrijpen.
- Test na het opslaan. Open een artikel met een lang codeblok op je kennisbanksite en controleer of de scrollbalk correct verschijnt en werkt voordat je publiceert.
- Beschouw de leeservaring naast de lengte. Zeer korte hoogtes (onder de 150px) kunnen code moeilijk te volgen maken. Zeer hoge hoogtes (meer dan 400px) kunnen het nut van een dop tenietdoen. Pas aan op basis van de gebruikelijke lengte van code in je artikelen.