elevator.js
Finally, a "back to top" button that behaves like a real elevator, by adding elevator music to quietly soothe the awkwardness that can ensue when being smoothly scrolled to the top of the screen.
This is very serious stuff, here's a demo!
Instructions
Elevator.js is a stand alone library (no jquery, or the likes) so usage is pretty straight forward. All styling of elements is up to you. Elevator.js only handles the audio management, and the scroll functionality!
JS
Elevator.js lives entirely within the js realm, which makes things fairly simple to use.
You'll need to create a new instance of Elevator, and pass it some audio elements.
<script>
// Elevator script included on the page, already.
window.onload = function() {
var elevator = new Elevator({
mainAudio: '/src/to/audio.mp3',
endAudio: '/src/to/end-audio.mp3'
});
}
// You can run the elevator, by calling.
elevator.elevate();
</script>
You can also add an "element" option, clicking this element will invoke the "Scroll to top" functionality, we all love and crave.
<div class="elevator-button">Back to Top</div>
<script>
// Elevator script included on the page, already.
window.onload = function() {
var elevator = new Elevator({
element: document.querySelector('.elevator-button'),
mainAudio: '/src/to/audio.mp3',
endAudio: '/src/to/end-audio.mp3'
});
}
</script>
If you don't want to scroll to the top, a custom target can be specified by adding a "targetElement" option:
<div class="elevator-button">Take the elevator to the target</div>
<script>
// Elevator script included on the page, already.
window.onload = function() {
var elevator = new Elevator({
element: document.querySelector('.elevator-button'),
targetElement: document.querySelector('#elevator-target'),
mainAudio: '/src/to/audio.mp3',
endAudio: '/src/to/end-audio.mp3'
});
}
</script>
If you want to scroll to a point on the page with some extra padding on the top, simply add the "verticalPadding" option:
<div class="elevator-button">Take the elevator to the target</div>
<script>
// Elevator script included on the page, already.
window.onload = function() {
var elevator = new Elevator({
element: document.querySelector('.elevator-button'),
targetElement: document.querySelector('#elevator-target'),
verticalPadding: 100, // in pixels
mainAudio: '/src/to/audio.mp3',
endAudio: '/src/to/end-audio.mp3'
});
}
</script>
If you're really serious (boring), you don't have to use audio... and can also set a fixed time to scroll to the top
<div class="elevator-button">Back to Top</div>
<script>
// Elevator script included on the page, already.
window.onload = function() {
var elevator = new Elevator({
element: document.querySelector('.elevator-button'),
duration: 1000 // milliseconds
});
}
</script>
If you use elevator.js in combination with other code, you might want to use callbacks
<script>
window.onload = function() {
new Elevator({
element: document.querySelector('.elevator-button'),
mainAudio: '/src/to/audio.mp3',
endAudio: '/src/to/end-audio.mp3',
duration: 5000,
startCallback: function() {
// is called, when the elevator starts moving
},
endCallback: function() {
// is called, when the elevator reached target level
}
});
}
</script>
NPM
The package is also available via NPM
License
Elevator.js is covered by the MIT License.
Audio in the Demo was bought via Pond5, you will need to license your own.
Copyright (C) ~ Tim Holman ~ [email protected]
![[bugfix] move target position calculation from init to elevation-time](https://avatars.githubusercontent.com/u/12482299?v=4)
7 Mar 23, 2022
3 Jul 29, 2022
5 Dec 26, 2022
53 Dec 30, 2022
5 Oct 23, 2022
16.8k Jan 5, 2023
7 Dec 5, 2022
5 Jul 10, 2022
9 Sep 17, 2022
5 Jul 13, 2022
16 May 4, 2022
2 Apr 17, 2022
4 May 30, 2022
33 Dec 4, 2022
1 Mar 1, 2021
20 Nov 3, 2022
2 Jun 21, 2022
6 Dec 26, 2022
14 Nov 1, 2022