Lead: Femi

Status

colour	Yellow
title	ongoing

Table of Contents

Description

...

Type	Usage
Fixed Scroll	When a fixed amount of content is loaded into a viewable container or component that is not large enough to display it all at once, a horizontal or vertical scrollbar is shown to enable the remaining content to be moved into view.
Infinite Scroll	When a large undefined amount of content is available for a viewable container or component that is not large enough to display it all at once, a horizontal or vertical scrollbar is shown to enable more content to be continually loaded into view.
Fixed Scroll + Pagination	When a large defined amount of content is available for a viewable container or component that is not large enough to display it all at once, a horizontal or vertical scrollbar is shown to enable the remaining loaded content to be moved into the current view and a list of page numbers is shown to enable discreet pages of new content to be loaded into the scrollable view.

Usage & Behaviour

Use Choose the appropriate type depending on usage types defined above(as defined above) according to the amount of content you need to display and the content area available. All default browser scroll behaviours should be enabled by default. Operating system and browser defaults such as scroll inertia, scroll wheel support, gesture support and any OS user customisations should all behave as factory designed.

General guidelines

...

Note

Currently only webkit based web browsers (such as Chrome & Safari) fully support native scrollbar custom styling to the degree required to conform to our visual design guidelines. It is therefore recommended to leave all non webkit browsers at their native scrollbar visual design language (using the CSS Overflow property) in order to aid consistency in behaviour and accessibility, rather than attempting to re-implement scrollbars across each environment. Our implementation below follows this recommendation.

General guidelines

There are five essential usability guidelines for scrolling and scrollbars:

Always offer a scrollbar if an area has scrolling content. Don't rely on auto-scrolling or on dragging, which people might not notice.
Hide scrollbars entirely if all content is visible. If people see a scrollbar, they assume there's additional content and will be frustrated if they can't scroll.
Comply with the default operating system standards in order to maintain platform familiarity.
Avoid horizontal scrolling as much as possible to improve user efficiency.
Display all important information above the fold. Users often decide whether to continue or leave based on what they can see without scrolling.

States

...

without scrolling.
Comply with the default operating system standards in order to maintain platform familiarity.

States

There are no focused or disabled states for scroll as those states are handled by the parent component in with the scroll is attached.

Interaction

Scroll interaction is governed by the chosen device, operating system and browser the application is running on. It is advised that those default interaction behaviours be unaltered primarily for conformance and accessibility reasons. The following are the ineractions recommended and required interaction recommendations common to all.

Input device	Discrete scroll	Continuous scroll
Keyboard	Focus on (scrollable area) + Up & Down keys Focus on (scrollable area) + PageUp & PageDown keys Focus on (scrollable area) + Home & End keys	Focus on (scrollable area) + Hold Up & Down keys
Mouse	Click on (scroll component - above or below scroll component button)	Click on (scroll component button) + drag Hover over (scrollable area) + Scroll wheel
Trackpad	Click on (scroll component - above or below scroll component button	Click on (scroll component button) + drag gesture Hover over (scrollable area) + Scroll gesture

Best practices

For best results all default browser scroll behaviours are enabled by default. Operating system and browser defaults such as scroll inertia, scroll wheel support, gesture support and any user customisations should all behave as factory designedfollow all the usage guidelines detailed in this document. For more best practices tips and suggestions, see below.

Avoid scroll hijacking - . Applications that implement scroll hijacking take control of the scroll and override a basic function of the web browser. Scroll hijacking is best avoided because the user no longer has full control of the page scroll and thus is unable to predict its behaviour. User’s expectation of a website’s scrolling interaction shouldn’t be destroyed for the sake of narrative experience.
Make sure the browser back button works properly - . When users follow a link, and then click the Back button, they expect to return to the same spot on the original page. Traditionally, using a browser’s back button will generally set the scroll position back to the previous position rather than to the top of the page. However, some modern development frameworks do not offer this functionality by default. Losing their previous position forces users to have to scroll through content they have already seen and manually find their previous position, hence endeavour to make sure this feature is enabled.
Use sticky navigation - . Long scrolling can make navigation problematic for users: if the navigation bar (container menu, table menu etc) loses its visibility when users scroll down, they will have to scroll all the way back up when deep within the page or table. The solution for this problem is a sticky navigation menu: it’s best to keep the navigation persistently visible, so that navigating to different areas of the app is fast and easy for users.
Provide visual feedback when loading new content- . Visibility of the system’s status remains among the most important principles in user interface design. When using the infinite scroll type, in which your app dynamically loads content, users need a clear sign that the application is doing this. Keep them informed; use a progress indicator to show that new content is loading and will soon appear on the page.

...

Zeplin link	Screen thumbnail
https://zpl.io/bo9RLGX

Code

Note
Scroll is enabled by applying the appropriate CSS Overflow property value in a content area.

Html macro

sanitize	false

::-webkit-scrollbar:vertical {
width: 7px;
}

::-webkit-scrollbar:horizontal {
height: 7px;
}

::-webkit-scrollbar-thumb {
border-radius: 7px;
background-color: #999999;
}

::-webkit-scrollbar-thumb:vertical {
width: 7px;
}

::-webkit-scrollbar-thumb:horizontal {
height: 7px;
}

::-webkit-scrollbar-thumb:hover {
border: solid 1px #007aff;
}

::-webkit-scrollbar-thumb:active {
border: solid 1px #005cbf;
}

body {
scrollbar-arrow-color: #FF3300;
scrollbar-3dlight-color: #999999;
scrollbar-highlight-color: #999999;
scrollbar-face-color: #999999;
scrollbar-shadow-color: #999999;
scrollbar-darkshadow-color: #999999;
scrollbar-track-color: #ddd;
}
</style>

<div class="card">
<div class="card-header">Scroll Text Area <button id="toggleMarkup" type="button" class="btn btn-sm btn-outline-primary btn btn-fixed-width float-right m-0" onclick="$('pre').toggle()">Toggle Markup</button></div>
<div class="card-body">
<form>
<div class="form-group row">
<label for="inputKey" class="col-lg-2 col-form-label col-form-label-sm">Regular</label>
<div class="col-lg-4">
<textarea class="form-control form-control-sm" placeholder="Guiding Text">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla eu lacus in orci semper interdum congue ac leo. Nam dictum eleifend velit, eget aliquet ex sodales et. Ut convallis massa in justo tristique malesuada. Pellentesque eros ex, viverra et blandit id, aliquet vel libero. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Morbi scelerisque enim non erat tincidunt, quis consectetur ipsum cursus. Fusce finibus posuere consequat. Duis luctus, tellus at pretium gravida, nunc turpis finibus mauris, ac imperdiet neque tellus non nunc. Morbi finibus rhoncus lacus a sagittis. Aenean dictum, turpis et molestie ullamcorper, justo tortor mattis lectus, laoreet egestas lacus lacus a nunc. Nullam velit risus, scelerisque eget justo non, feugiat mollis ex. Nullam ac rutrum odio. Fusce blandit sed ligula sit amet convallis. Suspendisse ac dignissim massa, nec interdum leo.

Mauris luctus metus ac finibus volutpat. Quisque suscipit at lacus quis cursus. In sagittis ex eget pulvinar luctus. Nulla nec rhoncus nulla. Donec risus odio, pulvinar at commodo eu, congue euismod nulla. Proin massa nulla, placerat nec odio vel, gravida venenatis ligula. Maecenas mattis risus id odio viverra, quis pulvinar urna mollis.

Integer sodales molestie dapibus. Aenean sit amet eros vel tortor imperdiet interdum. Vestibulum in lectus ex. Fusce nec vehicula lorem. Nullam varius quam eget velit faucibus ornare. Nullam vulputate augue vitae malesuada finibus. Proin eget turpis justo. Quisque eu lacus sit amet leo tempor posuere sit amet vitae dolor. Vivamus et mauris turpis. Etiam blandit dapibus diam. Maecenas non lacinia tellus. Proin at nunc lacinia, lacinia nisl in, fermentum nisl. Nulla sed venenatis erat.

Nulla ultrices est dui, ac ornare enim commodo in. Nunc pulvinar dictum risus at auctor. Mauris vitae lorem sodales, dignissim elit non, sollicitudin lorem. Vestibulum quis dictum quam. In fringilla egestas erat a sollicitudin. Duis risus nisl, facilisis at nunc ac, ultricies vestibulum justo. Suspendisse sed metus varius, faucibus nisl a, faucibus magna. Donec lectus diam, hendrerit et lectus sed, accumsan tincidunt neque.

Curabitur eros massa, fringilla tempor fringilla sed, lobortis euismod ligula. Donec et condimentum est. Nullam consequat sem id convallis ullamcorper. Ut ac laoreet ipsum, vel varius nisl. Fusce auctor lorem ac malesuada sollicitudin. Ut sodales fermentum dolor, quis lobortis nisl. Suspendisse tempus enim ac nulla placerat, pretium dignissim tellus molestie. Vivamus ut tempus elit. Donec mollis lectus vitae diam dictum, eu pretium enim aliquam. Proin congue dictum eleifend. Mauris convallis purus sollicitudin leo tempus, nec porta ante tempor. Sed at scelerisque quam. Vestibulum viverra turpis et feugiat pulvinar. Nam suscipit lacinia diam in pharetra. Vestibulum rutrum tincidunt auctor. Phasellus pharetra neque vitae eleifend dictum.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla eu lacus in orci semper interdum congue ac leo. Nam dictum eleifend velit, eget aliquet ex sodales et. Ut convallis massa in justo tristique malesuada. Pellentesque eros ex, viverra et blandit id, aliquet vel libero. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Morbi scelerisque enim non erat tincidunt, quis consectetur ipsum cursus. Fusce finibus posuere consequat. Duis luctus, tellus at pretium gravida, nunc turpis finibus mauris, ac imperdiet neque tellus non nunc. Morbi finibus rhoncus lacus a sagittis. Aenean dictum, turpis et molestie ullamcorper, justo tortor mattis lectus, laoreet egestas lacus lacus a nunc. Nullam velit risus, scelerisque eget justo non, feugiat mollis ex. Nullam ac rutrum odio. Fusce blandit sed ligula sit amet convallis. Suspendisse ac dignissim massa, nec interdum leo.