react-sticker

1.0.4 • Public • Published

React Sticker

Creates instagram style sticky headers that collide when one header scrolls into another.

If you need something like this, but this does not work out of the box for you, file an issue and I will work to add configuration options to support a wider set of use cases.

Note: This does not follow idiomatic react. The primary goal of this project is to be performant during scrolling and clean to implement.

Example
react-sticker-example

Usage

Create a parent component and put your sticky headers inside of it.

general

<Sticker useWindow={*boolean*}>
  ...
  <Sticky>...</Sticky>
</Sticker>

example

var Sticker = require('react-sticker')
var Sticky = Sticker.Sticky
 
var jsx = (
  <Sticker useWindow={true}> 
    <div>
      <Sticky><h2>First Sticky</h2></Sticky>
      <div style={{height: 500}} >Contents</div>
    </div>
    <div>
      <Sticky><h2>Second Sticky</h2></Sticky>
      <div style={{height: 500}} >Contents</div>
    </div>
    <div>
      <Sticky><h2>Third Sticky</h2></Sticky>
      <div style={{height: 500}} >Contents</div>
    </div>
  </Sticker>
)

When the Sticker container is scrolled such that the Sticky header reaches the top, the position of the Sticky element will be fixed (i.e. stuck) to the top of the screen. When the top of the second header hits the first header it will begin to push the first header out of the way, and then become sticky itself.

Multiple independent components will work as siblings but not if nested.

Styling & Scrolling

If you set useWindow={true} react-sticker should work out of the box. Otherwise you will need to make your sticker container "scrollable" with css, e.g. <Sticker style={{overflow: 'scroll', height: '100%'}}>

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 1.0.4
    4
    • latest

Version History

  • Version
    Downloads (Last 7 Days)
    • Published
  • 1.0.4
    4
  • 1.0.3
    0
  • 1.0.2
    0
  • 1.0.0
    0

Package Sidebar

Install

npm i react-sticker

Weekly Downloads

4

Version

1.0.4

License

MIT

Last publish

Collaborators

  • tannerlinsley