Svelte-scrollto

Animating vertical and horizontal scrolling

Install

npm install --save-dev svelte-scrollto
# or
yarn add -D svelte-scrollto

Usage

<script>
  import * as animateScroll from "svelte-scrollto";
</script>

<a on:click={() => animateScroll.scrollToBottom()}> Scroll to bottom </a>
<a on:click={() => animateScroll.scrollToTop()}> Scroll to top </a>
<a on:click={() => animateScroll.scrollTo({element: 'scroll-to-element-selector'})}> Scroll to element </a>
<a on:click={() => animateScroll.scrollTo({element: 'scroll-to-element-selector', offset: 200})}> Scroll to below element 200px </a>
<a on:click={() => animateScroll.scrollTo({element: 'scroll-to-element-selector', duration: 2000})}> Scroll to element over 2000ms </a>

Using as a action

<script>
  import { scrollto } from "svelte-scrollto";
</script>
<!-- Parameter is element selector or options -->
<a use:scrollto={'#scroll-element'}> Scroll to element </a>

API

Global Options

Override global options:

import * as animateScroll from "svelte-scrollto";

animateScroll.setGlobalOptions({
    offset: 200,
    onStart: (element, offset) => {
        if(element) {
            console.log("Start scrolling to element:", element);
        } else if(offset) {
            console.log("Start scrolling to page offset: (${offset.x}, ${offset.y})");
        }
    }
})

Functions

scrollTo(options)

Accepts all global options and:

• element: The element you want scroll to
• x: The offset we want to scrolling on the x axis
• y: The offset we want to scrolling on the y axis

scrollToTop(options)

Shortcut of use scrollTo with x equal to 0.

scrollToBottom(options)

Shortcut of use scrollTo with x equal to containerHeight

Actions

Svelte action that listens for click (touchstart) events and scrolls to elements with animation.

• scrollto

• scrolltotop

• scrolltobottom

Troubleshooting

If you want to use Lazy and want to scroll to elements, you need to give your lazy components (images, v.v..) fixed dimensions, so the browser known the size of the not loaded elements before scrolling.