@dgillen27/react-top-detecting-navbar-test

2.0.2 • Public • Published

react-top-detecting-navbar

npm (scoped)

Installation

$ npm install @dgillen27/react-top-detecting-navbar

Basic Usage

import TopDetectingNavbar from "@dgillen27/react-top-detecting-navbar";

function App() {
  return <TopDetectingNavbar></TopDetectingNavbar>;
}

Default styles

The TopDetectingNavbar may be passed a base className and topClassName so you can style this component as you would like, I highly recommend using className and topClassName. However, if you choose not to pass a className or a topClassName, these are your default styles for the component The default styles are really just intended to give you a reference point for when you first start working with the package.

const defaultStyle = {
  height: "66px",
  width: "100vw",
  backgroundColor: "grey",
  position: "fixed"
};

const defaultTopStyle = {
  height: "66px",
  width: "100vw",
  backgroundColor: "white",
  position: "fixed"
};

Passing Props

These styles can be overwritten if you pass in props! TopDetectingNavBar accepts six different options as props:

Prop Prop Type Purpose
className String Assign a className to the navbar
topClassName String Assign a className to the navbar when it is at the top of the page
height Number Assign a height to style of the the navbar in px
width Number Assign a width to style of the the navbar in vw
backgroundColor String Assign a backgruondColor to the style of the navbar
topBackgroundColor String Assign a backgruondColor to the style of the navbar when it is at the top of the page

Note: If you are declaring a topClassName, you need to declare a className as well

Advanced Usage/Passing Props

  • If you pass in a className, height, backgroundcolor, and topBackgroundColor will be ignored.
  • Passing in a className with no topClassName will give the component the className of the className that you pass it.
  • If you have passed a className and topClassName, the component at the top of the page will recieve a className of both (i.e. className="hello" topClassName="world" the component will have a className of "hello world") if you are not at the top of the page, it will only recieve the className of "hello".

Passing in classNames

import TopDetectingNavbar from "react-top-detecting-navbar";

function App() {
  return (
    <TopDetectingNavbar className="hello" topClassName="world">
      <h1>Your content here</h1>
    </TopDetectingNavbar>
  );
}

className at the top of the page will be "hello world"

className anywhere else on the page will be "hello"

Passing in style props

import TopDetectingNavbar from "react-top-detecting-navbar";

function App() {
  return (
    <TopDetectingNavbar
      height={66}
      width={100}
      backgroundColor="red"
      topBackgroundColor="blue"
    >
      <h1>Your content here</h1>
    </TopDetectingNavbar>
  );
}

License

MIT ©

Package Sidebar

Install

npm i @dgillen27/react-top-detecting-navbar-test

Weekly Downloads

1

Version

2.0.2

License

MIT

Unpacked Size

13.4 kB

Total Files

11

Last publish

Collaborators

  • dgillen27