@schptr/stickjs

STICKJS

Do you find css sticky position annoying? If yes we are on the same boat, this small package will programically add sticky functionality through plain javascript to your desired element and even a little bit more.

Usage

Install as an npm package

npm install @schptr/stickjs

Import the functions that you need

import { isSticky } from "@schptr/stickjs";

Import css

import "@schptr/stickjs/src/stick.css";

or add snipet below to your css files

.is-sticky {
  position: fixed;
  top: var(--offsetTOP);
  left: var(--offsetLEFT);
  right: var(--offsetRIGHT);
  bottom: var(--offsetBOTTOM);
}

Initialize on an given element or id

import { isSticky } from "@schptr/stickjs"; //Import function

let options = { direction: "bottom", offset: 50 }; //Define options
let element = document.getElementById("sticky-element"); //Define element

isSticky(element, options); //Initialize stickyjs

Use cases

• Making element sticky in any given direction
• Offsetting a sticky element to match gaps, paddings or margins
• Checking if elements are in viewport
• Highlighting element if different element is in viewport

Options

{
    direction: "top",
    offset: 0,
    viewport: 0,
    keepWidth: true,
    keepHeight: true,
}

direction

direction in which element will stick - "top", "bottom", "left", "right".
Default:

"top";

offset

If we do not want element to stick exactly on screen end in given direction we can set an offset in pixels.
Default:

0;

viewport

sometimes we do not want the element to stick on devices with lower resosution, viewport is the least ammount of pixels of width that trigger sticky behaviour. If the viewer width is less then given number, element will not stick.
Default:

0;

keepWidth

If we need the element to keep exact width after sticking set it to true.
Default:

true;

keepHeight

If we need the element to keep exact height after sticking set it to true.
Default:

true;

Functions

isSticky

parameters:

target (element or id), options

initializes sthe script on given element or id with passed or default options, returns void

isOverOffset

prameters:

target (element), anchor and options

returns true if element is over offset and sticky behaviour should be triggered

stick

parameters:

target (element), options

makes element sticky by adding class, makes sure width and height are kept as position property is changed if needed, returns void

unstick

parameters:

target (element), options

removes sticky behaviour from element

inYViewport

parameters:

target (element)

return true when element is in Y viewport (visible on screen)

inXViewport

parameters:

target (element)

return true when element is in X viewport (visible on screen)

activeIfInViewport

parameters:

target (element), isXAxis (default false), activeClass (default "active")

adds an class to target if in viewport, set isXAxis to true if you need to check for X axis instead of Y

activeIfOtherInViewport

parameters:

target (element), other (element), isXAxis (default false), activeClass (default "active")

adds an class to target if other element is in viewport, set isXAxis to true if you need to check for X axis instead of Y

Browser compatibility

Stickjs is supported by all of the modern browsers. The least compatible are css variables that are still widely supported, more on that topic here

Testing

npm run test