1.0.5 • Published 6 months ago

scroll-totop-button v1.0.5

Weekly downloads
-
License
ISC
Repository
github
Last release
6 months ago

Scroll-ToTop-Button

A customizable and lightweight React component to add a "Scroll to Top" button in your React applications. Enhance user experience with a smooth and modern scrolling experience.

Features

  • Smooth scrolling to the top of the page.
  • Button appears only after the user scrolls past a configurable threshold.
  • Fully customizable styles.
  • Lightweight and easy to integrate.
  • Built with TypeScript for better type safety.

Installation

Install Scroll-ToTop-Button with npm

  npm i scroll-totop-button

Usage/Examples

import React from "react";
import { scrollToTop } from "scroll-totop-button";

const App = () => {
  return (
    <div>
      <h1>My React App</h1>
      <p>Scroll down to see the button!</p>

      <ScrollToTop
        threshold={300}
        smooth={true}
        className="scroll-to-top"
        style={{
          backgroundColor: "white",
          color: "black",
          fontSize: "1.1rem",
        }}
      />
    </div>
  );
};

export default App;

Props

PropTypeDefaultDescription
thresholdnumber300The number of pixels the user must scroll before the button becomes visible.
smoothbooleantrueEnables smooth scrolling when set to true.
styleobject{}Inline styles to customize the button's appearance.
classNamestring""Add a custom class to the button for additional styling flexibility.

How It Works

The Scroll-ToTop-Button component tracks the user's scroll position and only becomes visible after the user has scrolled down past a certain threshold (default: 300px). Once clicked, it smoothly scrolls the page back to the top, improving usability for long-scrolling pages.

Advanced Usage

Using Custom Styles

<ScrollToTop
  style={{
    backgroundColor: "#4CAF50",
    color: "white",
    padding: "1rem",
    borderRadius: "50%",
    fontSize: "1.25rem",
  }}
/>

Feedback & Contributions

Have suggestions or improvements? Feel free to open an issue or submit a pull request on the GitHub

License

ISC

Build by

Malhar Chauhan

GitHub

1.0.5

6 months ago

1.0.3

6 months ago

1.0.2

6 months ago

1.0.1

6 months ago

1.0.0

6 months ago