Proximus design system
Important information:
Using the Design System implies following some rules: the code should be valid and same as the Design System. Meaning custom HTML & CSS override are forbidden.
Please don't forget to read Usage part of each element.

Read more

The 'Read more' feature shortens content, displaying only a portion initially and revealing the rest upon user interaction, preventing interface overload.

last modified: 30/09/2021 11:10:06

Overview

There is one type of read more, available for our different modes:

The read more component is only available on:
  • Positive mode: white and grey2 background colors.
  • Negative mode: black background color.

States

  1. Default state
    State visible before click. Only a small portion of the content is displayed and the chevron is pointing downwards.
  2. Hover/Focused state
    State visible when the cursor hovers the label and chevron and triggered by keyboard navigation or click. Cursor becomes a pointer.
  3. Opened state
    State visible when clicked. The branch opens, allowing the full content inside to be revealed. "Read more" becomes "Read less" and the chevron is pointing upwards.

Anatomy

  1. Branch
    Branch is the full element with label, chevron and a faded preview of the content.

  2. Content
    The entire content is revealed once the read more link is clicked.

  3. Label
    Allows the user to display the full content of the element.

    Content of the label

    We strive to keep the consistency of our labels. Please keep "Read more" & "Read less" as is.

  4. Chevron
    Informs the user about the state of the read more. Pointing down, the content is collapsed. Pointing up, the content is expanded.

  5. Preview
    The user gets to see the beginning of the content before clicking on the read more link. A fading effect let the user know that there is more content than what is shown. The height of the preview can be adapted to your needs.

Responsiveness

Depending on your needs, you can choose to have the read more function only on mobile devices.

last modified: 30/09/2021 11:10:06

Sizes and colors

last modified: 08/11/2022 09:50:05

A Read more element can be added on long texts with container class rs-read-more-container and a minimum height of 100px with rs-maxh-s10 added on rs-read-more-content .

It can be used only on elements with following backgrounds:

  • White : default
  • Grey2 : with rs-read-more-container2 added to rs-read-more-container
  • Black : with ( rs-read-more-container-neg )added to rs-read-more-container
How does it work

Read more is a webcomponent which needs data-rslib-webcomponent-load="rslib.apps.readmore" attribute to work.

Default (on white background)

Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Proin accumsan vulputate arcu et auctor nulla vestibulum id. Sed urna dolor euismod non aliquam sit amet sodales sed ante. Aliquam et nibh at felis tempus tempus. Nam ac risus id velit hendrerit venenatis. Nullam ut erat nisi at porta ligula. Vestibulum a urna vitae risus ultrices iaculis varius ut erat. Donec et sapien mi. Maecenas sit amet lorem orci.Quisque nisl dolor aliquam non ultricies vel ornare eget odio. Quisque vulputate rutrum neque. Nunc ac metus a nisi ornare dapibus at ut urna. Nulla facilisi. Morbi arcu lorem consectetur at accumsan nec ultrices vel nunc. Nulla facilisi. Etiam quis eros tellus non faucibus nibh. Sed id nulla dui. Proin vitae tortor lacus. Phasellus placerat sodales metus at pellentesque felis luctus quis. Mauris feugiat dictum magna vitae mattis. Lorem ipsum dolor sit amet consectetur adipiscing elit. Maecenas id

Grey2 version

Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Proin accumsan vulputate arcu et auctor nulla vestibulum id. Sed urna dolor euismod non aliquam sit amet sodales sed ante. Aliquam et nibh at felis tempus tempus. Nam ac risus id velit hendrerit venenatis. Nullam ut erat nisi at porta ligula. Vestibulum a urna vitae risus ultrices iaculis varius ut erat. Donec et sapien mi. Maecenas sit amet lorem orci.Quisque nisl dolor aliquam non ultricies vel ornare eget odio. Quisque vulputate rutrum neque. Nunc ac metus a nisi ornare dapibus at ut urna. Nulla facilisi. Morbi arcu lorem consectetur at accumsan nec ultrices vel nunc. Nulla facilisi. Etiam quis eros tellus non faucibus nibh. Sed id nulla dui. Proin vitae tortor lacus. Phasellus placerat sodales metus at pellentesque felis luctus quis. Mauris feugiat dictum magna vitae mattis. Lorem ipsum dolor sit amet consectetur adipiscing elit. Maecenas id

Negative version

Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Proin accumsan vulputate arcu et auctor nulla vestibulum id. Sed urna dolor euismod non aliquam sit amet sodales sed ante. Aliquam et nibh at felis tempus tempus. Nam ac risus id velit hendrerit venenatis. Nullam ut erat nisi at porta ligula. Vestibulum a urna vitae risus ultrices iaculis varius ut erat. Donec et sapien mi. Maecenas sit amet lorem orci.Quisque nisl dolor aliquam non ultricies vel ornare eget odio. Quisque vulputate rutrum neque. Nunc ac metus a nisi ornare dapibus at ut urna. Nulla facilisi. Morbi arcu lorem consectetur at accumsan nec ultrices vel nunc. Nulla facilisi. Etiam quis eros tellus non faucibus nibh. Sed id nulla dui. Proin vitae tortor lacus. Phasellus placerat sodales metus at pellentesque felis luctus quis. Mauris feugiat dictum magna vitae mattis. Lorem ipsum dolor sit amet consectetur adipiscing elit. Maecenas id

Read more on small only

To enable it on small devices only, just add rs-read-more-label-for-small-only to label rs-read-more-label .

Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Proin accumsan vulputate arcu et auctor nulla vestibulum id. Sed urna dolor euismod non aliquam sit amet sodales sed ante. Aliquam et nibh at felis tempus tempus. Nam ac risus id velit hendrerit venenatis. Nullam ut erat nisi at porta ligula. Vestibulum a urna vitae risus ultrices iaculis varius ut erat. Donec et sapien mi. Maecenas sit amet lorem orci.Quisque nisl dolor aliquam non ultricies vel ornare eget odio. Quisque vulputate rutrum neque. Nunc ac metus a nisi ornare dapibus at ut urna. Nulla facilisi. Morbi arcu lorem consectetur at accumsan nec ultrices vel nunc. Nulla facilisi. Etiam quis eros tellus non faucibus nibh. Sed id nulla dui. Proin vitae tortor lacus. Phasellus placerat sodales metus at pellentesque felis luctus quis. Mauris feugiat dictum magna vitae mattis. Lorem ipsum dolor sit amet consectetur adipiscing elit. Maecenas id

JavaScript

How to trigger the js

As Readmore is a webcomponent, you will have to load inception.webComponentLoad(CONTEXT); first to be able to load the scripts.

CONTEXT refers to document or html element parent to data-read-more.

last modified: 12/02/2024 18:00:12

Configuration metadata

Selector: ds-read-more

Class: ReadMoreComponent

e2e testing Id: None

Use case example

NOT AVAILABLE LIVE PREVIEW

Inputs

Name Type Default Required Description
id string read0 Yes Component id
background ReadMoreBackgroundEnum undefined No Change to 'negative' or 'grey' to have respective background styles
height number 10 No The height goes from 1 to 50 and 10 should is the default

Outputs

None

Models

export enum ReadMoreBackgroundEnum { Negative = 'negative', Grey = 'grey', }