npm package: @schptr/stickjs
Description: If position sticky is not working i got you
Author: Petr Suchanek
Latest version: 0.9.1

# 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

```shell
npm install @schptr/stickjs
```

Import the functions that you need

```js
import { isSticky } from "@schptr/stickjs";
```

Import css

```js
import "@schptr/stickjs/src/stick.css";
```

or add snipet below to your css files

```css
.is-sticky {
  position: fixed;
  top: var(--offsetTOP);
  left: var(--offsetLEFT);
  right: var(--offsetRIGHT);
  bottom: var(--offsetBOTTOM);
}
```

Initialize on an given element or id

```js
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

```js
{
    direction: "top",
    offset: 0,
    viewport: 0,
    keepWidth: true,
    keepHeight: true,
}
```

### direction

direction in which element will stick - "top", "bottom", "left", "right".  
Default:

```js
"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:

```js
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:

```js
0;
```

### keepWidth

If we need the element to keep exact width after sticking set it to true.  
Default:

```js
true;
```

### keepHeight

If we need the element to keep exact height after sticking set it to true.  
Default:

```js
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](https://caniuse.com/css-variables)

## Testing

```console
npm run test
```