Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Scroll to element with smooth animation. Lightweight library for Svelte. No dependencies! Pure Svelte.

NotificationsYou must be signed in to change notification settings

bartholomej/svelte-scrollto-element

Repository files navigation

Animating vertical and horizontal scrolling (for Svelte)

  • TypeScript / JavaScript
  • Useful options
  • Compatible withSvelteKit,SSR andadapter-static

Install

npm install svelte-scrollto-element --save# yarn add svelte-scrollto-element

Usage

Using programmatically

<script>import{animateScroll}from'svelte-scrollto-element';</script><aon:click={() => animateScroll.scrollToBottom()}> Scroll to bottom</a><aon:click={() => animateScroll.scrollToTop()}> Scroll to top</a><aon:click={() => animateScroll.scrollTo({element: '#my-anchor'})}> Scroll to element with</a><aon:click={() => animateScroll.scrollTo({element: '.my-element-class', offset: 200})}> Scroll to below element 200px</a><aon:click={() => animateScroll.scrollTo({element: 'footer', duration: 2000})}> Scroll to footer element over 2000ms</a>

Using as a action

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

API

Global Options

OptionRequiredDefault valueDescription
container"body"Scroll container
duration500The duration (in milliseconds) of the scrolling animation.
delay0
offset0The offset that should be applied when scrolling. This option accepts a callback function
easingcubicInOutThe easing function to be used when animating. Can pass any easing fromsvelte/easing or pass custom easing function.
onStartnoopA callback function that should be called when scrolling has started. Receives the target element and page offset as a parameter.
onDonenoopA callback function that should be called when scrolling has ended. Receives the target element and page offset as a parameter.
onAbortingnoopA callback function that should be called when scrolling has been aborted by the user (user scrolled, clicked etc.). Receives the target element and page offset as parameters.
scrollXfalseWhether or not we want scrolling on thex axis
scrollYtrueWhether or not we want scrolling on they axis

Override global options:

import{animateScroll}from'svelte-scrollto-element';animateScroll.setGlobalOptions({offset:200,onStart:(element,offset)=>{if(element){console.log('Start scrolling to element:',element);}elseif(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 withx equal to0.

scrollToBottom(options)

Shortcut of use scrollTo withx equal tocontainerHeight

Actions

Svelte action that listens forclick (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.

Credits

Initially forked fromlangbamit/svelte-scrollto which is archived now. Uses some of its code and functionality!

Privacy Policy

I DO NOT STORE ANY DATA. PERIOD.

I physically can't. I have nowhere to store it. I don't even have a server database to store it. So even if Justin Bieber asked nicely to see your data, I wouldn't have anything to show him.

That's why, with this library, what happens on your device stays on your device till disappear.

License

Initially forked fromlangbamit/svelte-scrollto which is archived now.

Proudly powered by nature 🗻, wind 💨, tea 🍵 and beer 🍺 ;)

All contents are licensed under theMIT license.

About

Scroll to element with smooth animation. Lightweight library for Svelte. No dependencies! Pure Svelte.

Topics

Resources

Stars

Watchers

Forks

Contributors4

  •  
  •  
  •  
  •  

[8]ページ先頭

©2009-2025 Movatter.jp