Scroll to given elements with smooth animation
npm install svelte-scrolling[![npm][npm-shields]](https://www.npmjs.com/package/svelte-scrolling)
[![license][license-shields]](https://github.com/valmisson/svelte-scrolling/blob/main/LICENSE)
Scroll to given elements with smooth animation.
bash
yarn add svelte-scrolling
`Usage
`html
`Actions
####
scrollTo={reference | options}This action listens for click (touchstart) events and scrolls to elements with smooth animation. The element to scroll to must be referenced using the
scrollRef action or id.Accepts as parameter only the element reference or all global options:
-
ref: Element reference.To set the global options, the
ref property is required####
scrollRef={reference}This action adds a reference to the elements that
scrollTo should scroll.Accepts as parameter a string with the name to reference the element
Functions
####
scrollTop(options?)Scroll to the top of the page
####
scrollBottom(options?)Scroll to the end of the page
####
scrollLeft(options?)Scroll to the end of left the page
####
scrollRight(options?)Scroll to the end of right the page
####
scrollElement(reference, options?)Scroll to element with smooth animation.
####
scrollPosition(position, options?)Scroll to a position on the page
API
$3
| Property | Default | Description |
|:--------:|:-------:|:-----------:|
|
duration | 500 | Duration (in milliseconds) of the animation. |
| offset | 0 | Offset that should be applied when scrolling. |
| easing | cubicInOut | Easing function to be used when animating. Use any easing from [svelte/easing][svelte-easing] or a custom easing function. |
| passive | false | A boolean value that, if true, indicates that the function specified by listener will never call preventDefault(). |
| onStart | noop | A callback function that should be called when scrolling has started. Receives the element, offset, duration and endPosition as a parameter. |
| onDone | noop | A callback function that should be called when scrolling has started. Receives the element, offset, duration and endPosition as a parameter. |$3
`html
``Copyright (c) 2021-present, Valmisson Grizorte
[npm-shields]: https://img.shields.io/npm/v/svelte-scrolling.svg
[license-shields]: https://img.shields.io/badge/license-MIT-green
[svelte-easing]: https://svelte.dev/docs/svelte/svelte-easing