Scroll Fader

<msc-scroll-fader /> is a high-performance utility web component designed to enhance the visual presentation of scrollable containers. By leveraging modern CSS scroll-driven animations, it automatically applies smooth, dynamic edge fading gradients to indicate overflow content, significantly improving user experience without compromising native scrolling fluidness.

The component adapts seamlessly to different layout structures via the direction attribute. By specifying either vertical or horizontal, developers can instantly reconfigure the internal scrolling axis and masking vectors. As users scroll through the content, the edge indicators dynamically adjust their visibility in real time, providing intuitive visual cues that guide the user's eye and maintain design continuity across diverse viewport sizes.

Let's see what can <msc-scroll-fader /> do ?

What is Lorem Ipsum?

Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since 1966, when designers at Letraset and James Mosley, the librarian at St Bride Printing Library in London, took a 1914 Cicero translation and scrambled it to make dummy text for Letraset's Body Type sheets. It has survived not only many decades, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised thanks to these sheets and more recently with desktop publishing software like Aldus PageMaker and Microsoft Word including versions of Lorem Ipsum.

Where does it come from?

Contrary to popular belief, Lorem Ipsum is not simply random text. It has roots in a piece of classical Latin literature from 45 BC, making it over 2000 years old. Richard McClintock, a Latin professor at Hampden-Sydney College in Virginia, looked up one of the more obscure Latin words, consectetur, from a Lorem Ipsum passage, and going through the cites of the word in classical literature, discovered the undoubtable source. Lorem Ipsum comes from sections 1.10.32 and 1.10.33 of "de Finibus Bonorum et Malorum" (The Extremes of Good and Evil) by Cicero, written in 45 BC. This book is a treatise on the theory of ethics, very popular during the Renaissance. The first line of Lorem Ipsum, "Lorem ipsum dolor sit amet..", comes from a line in section 1.10.32.

The standard chunk of Lorem Ipsum used since 1966 is reproduced below for those interested. Sections 1.10.32 and 1.10.33 from "de Finibus Bonorum et Malorum" by Cicero are also reproduced in their exact original form, accompanied by English versions from the 1914 translation by H. Rackham.

Why do we use it?

It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters, as opposed to using 'Content here, content here', making it look like readable English. Many desktop publishing packages and web page editors now use Lorem Ipsum as their default model text, and a search for 'lorem ipsum' will uncover many web sites still in their infancy. Various versions have evolved over the years, sometimes by accident, sometimes on purpose (injected humour and the like).

Where can I get some?

There are many variations of passages of Lorem Ipsum available, but the majority have suffered alteration in some form, by injected humour, or randomised words which don't look even slightly believable. If you are going to use a passage of Lorem Ipsum, you need to be sure there isn't anything embarrassing hidden in the middle of text. All the Lorem Ipsum generators on the Internet tend to repeat predefined chunks as necessary, making this the first true generator on the Internet. It uses a dictionary of over 200 Latin words, combined with a handful of model sentence structures, to generate Lorem Ipsum which looks reasonable. The generated Lorem Ipsum is therefore always free from repetition, injected humour, or non-characteristic words etc.

  • direction：

Basic Usage

<msc-scroll-fader /> is a web component. All we need to do is put the required script into your HTML document. Then follow <msc-scroll-fader />'s html structure and everything will be all set.

Required Script

<script type="module" src="https://unpkg.com/msc-scroll-fader/mjs/wc-msc-scroll-fader.js"> </script>

Structure

Put <msc-scroll-fader /> into HTML document. It will have different functions and looks with attribute mutation.

<msc-scroll-fader> <!-- put conteent here --> <h2>xxxx</h2> <p>xxxx</p> </msc-scroll-fader>

JavaScript Instantiation

<msc-scroll-fader /> could also use JavaScript to create DOM element. Here comes some examples.

<script type="module"> import { MscScrollFader } from 'https://unpkg.com/msc-scroll-fader/mjs/wc-msc-scroll-fader.js'; const template = document.querySelector('.my-content-template'); // use DOM api const nodeA = document.createElement('msc-scroll-fader'); nodeA.appendChild(template.content.cloneNode(true)); document.body.appendChild(nodeA); // new instance with Class const nodeB = new MscScrollFader(); nodeB.appendChild(template.content.cloneNode(true)); document.body.appendChild(nodeB); </script>

Style Customization

Developers could apply styles to decorate <msc-scroll-fader />'s looking.

<style> msc-scroll-fader { --msc-scroll-fader-mask-size-start: 16px; --msc-scroll-fader-mask-size-end: 16px; } </style>

Attribute

<msc-scroll-fader /> component exposes a curated set of attributes, enabling developers to dynamically adjust the user interface. This provides the flexibility to tailor the component’s appearance to seamlessly adapt to any given context.

direction

The direction attribute configures the scrolling axis and layout orientation of <msc-scroll-fader />. The component currently supports two standard options: vertical and horizontal, defaulting to vertical.

<msc-scroll-fader direction="vertical" > <!-- put conteent here --> <h2>xxxx</h2> <p>xxxx</p> </msc-scroll-fader>

Property

Property Name Type Description
direction String Getter / Setter direction. direction configures the scrolling axis and layout orientation of <msc-scroll-fader />. The component currently supports two standard options: vertical and horizontal, defaulting to vertical.

Reference