@illinois-toolkit/ilw-back-to-top
v1.0.0-beta
Published
Illinois Toolkit: The Illinois component back-to-top allows you to provide a simple way to skip either to the top of a page or to a designated point in the page (such as the page content area).
Downloads
158
Readme
ilw-back-to-top
Overview
This component places a button in the bottom-right corner of the screen which takes visitors back to the top of the page. It uses animation that simulates vertical scrolling while not being overwhelming for motion-sensitive viewers.
This component should be placed as close as possible to the ending </body> tag, outside of any <ilw-page> element in use.
By default, this component will take the visitor to the top edge of the page. To change the location of the top of the page, use the target attribute.
Code Examples
Placement
<body>
<ilw-page>
<!-- ... page content ... -->
</ilw-page>
<ilw-back-to-top></ilw-back-to-top>
</body>To change the location of the top of the page, use the target attribute:
<ilw-page>
<div id="my-top-of-page"></div>
</ilw-page>
<ilw-back-to-top target="my-top-of-page"></ilw-back-to-top>To change the position of the button, modify the ilw-back-to-top--right and ilw-back-to-top--bottom CSS variables. These control the distance from the button to the right and bottom edges of the screen, respectively.
ilw-back-to-top {
--ilw-back-to-top--right: 48px;
--ilw-back-to-top--bottom: 48px;
}Upgrade Process
Rename il-back-to-top to ilw-back-to-top.
External References
https://www.nngroup.com/articles/back-to-top/