react-sticky-nav

A sticky nav bar for React that stays out of your way

Usage no npm install needed!

<script type="module">
  import reactStickyNav from 'https://cdn.skypack.dev/react-sticky-nav';
</script>

README

react-sticky-nav

GitHub Actions version code size dependencies devDependencies

A sticky nav bar for React that stays out of your way.

When the scrolling is just right

Requirements

  • React
  • Something to style the <ReactStickyNav /> with, like styled-components or emotion
  • window.requestAnimationFrame. You could use a polyfill for older browsers
  • position: sticky; support. For Safari, you should add position: -webkit-sticky; to your own styles. Unfortunately this is not possible to support with React's inline style syntax.

Usage

Basic

// @jsx jsx

import React from "react";
import { css, jsx } from "@emotion/core";
import Navigation from "react-sticky-nav";

import { HamburgerMenu, Logo } from "./components";

...

const styles = css`
  background-color: white;
  box-shadow: ${open ? "none" : "0 1px 2px rgba(0, 0, 0, 0.08)"};
  height: 64px;
  position: -webkit-sticky /* This is needed for Safari support */
`;

...

ReactDOM.render(
  <Navigation css={styles} disabled={open}>
    <Logo />
    <HamburgerMenu open={open} />
  </Navigation>,
  document.getElementById("#root")
);

Render function as child

To use <ReactStickyNav />'s current position (hidden, pinned, or unfixed) in its children, you can supply <ReactStickyNav / a render function as its child:

const SizableLogo = styled(Logo)(props => ({
  height: props.large ? "128px" : "64px"
}));

ReactDOM.render(
  <Navigation css={styles} disabled={open}>
    {position => (
      <>
        <SizableLogo large={!open && position === "unfixed"} />
        <HamburgerMenu open={open} />
      </>
    )}
  </Navigation>,
  document.getElementById("#root")
);

render prop

if you wish to completely replace the default rendered <nav /> element, you can use the render prop to supply your own. In this case the prop will receive as its argument an object containing the current position: "hidden" | "pinned" | "unfixed", top: number (mutable) and a ref: React.Ref<HTMLElement> that should be attached to the main container:

import StickyNav, { styles as stickyNavStyles } from "react-sticky-nav";

const Nav = styled.nav`
  ${stickyNavStyles};
  background: papayagreen;
`;

ReactDOM.render(
  <StickyNav render={({ position, ref }) => (
    <Nav ref={ref}>My custom navbar is {position}</Nav>
  )} />,
  document.getElementById("#root")
);

Styling

The react-sticky-nav comes with very little defaults, and should be styled by supplying it with a className property that is attached some CSS.

The <ReactStickyNav /> component is a <nav /> element with the following inline styles:

  display: block;
  position: sticky;
  width: 100%;

In other words, <ReactStickyNav /> is a fixed full-width element that sticks to the top of your screen. The only functionality is that <ReactStickyNav /> will move out the viewport when scrolling down, and back in when scrolling up. This is done by controlling the top CSS property.

There are three additional classes added for the different states possible:

  1. unfixed is applied when <ReactStickyNav /> doesn't touch the top of the screen but is on the page
  2. hidden is applied when <ReactStickyNav /> is fully hidden (for example, after scrolling down or reloading page when scrolled)
  3. pinned is applied when <ReactStickyNav /> scrolling up from being hidden These classes can be used for styling (see demo for example).

Disabling

If you want to disable <ReactStickyNav />'s behaviour, supply the disabled prop. When disabled, <ReactStickyNav /> will simply stick to the top of the screen.

Ref

If you need to access the dom element, you can supply your own ref from React.createRef via the ref?: React.Ref<HTMLDivElement> prop.