Skip to content

Commit

Permalink
Merge pull request #2 from unify-ui-dev/dev
Browse files Browse the repository at this point in the history
update readme
  • Loading branch information
Johnkat-Mj authored Sep 18, 2024
2 parents e551416 + cc82f0f commit f51abcc
Showing 1 changed file with 70 additions and 1 deletion.
71 changes: 70 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,70 @@
packages/flexipop/README.md
# Flexipop

An ultra-compact positioning engine inspired by [Nanopop](https://www.npmjs.com/package/nanopop), but we decided to create our own solution. The main reason? We wanted something tailored specifically to our [library's](https://github.com/unify-ui-dev/flexilla) needs, while also taking the opportunity to learn new techniques and improve our problem-solving skills.

This library thrives on simplicity and efficiency.

> [!IMPORTANT]
> This package is a part of the `flexilla` library's ecosystem.

## When to opt for FLEXIPOP over PopperJS?

If you are considering `flexipop` over `PopperJS`, it's likely due to similar reasons as [Nanopop](https://github.com/simonwep/nanopop/tree/master).

Choose `FLEXIPOP` for a small, powerful, and efficient positioning solution.


## Usage

Installation

```bash
npm i flexipop
```

Usage

```js
import { CreatePopper } from 'flexipop'

new CreatePopper(
referenceElement,//HTMLElement
popperElement,//HTMLElement
{
// options here
}
)
```

### HTML Markup

```html
<div data-reference-el></div>
<div data-popper-el>Left-start</div>
```


### CSS

> ⚠ The popperElement must have set `position` to `fixed`.


## Usage with position absolute

```js
import { CreatePopper } from 'flexipop/with-absolute'

new CreatePopper(
referenceElement,//HTMLElement
popperElement,//HTMLElement
{
// options here
}
)
```

> [!IMPORTANT]
> ⚠ The popperElement must have set `position` to `absolute`.
> The popperElement and referenceElement must be in a same parend container, and the container must have position set to `relative`

0 comments on commit f51abcc

Please sign in to comment.