detect-element-overflow
v1.4.2
Published
A function that tells you whether a given element is overflowing its container or not. Useful for creating dropdowns and tooltips.
Downloads
1,098,255
Maintainers
Readme
Detect-Element-Overflow
A function that tells you whether a given element is overflowing its container or not. Useful for creating dropdowns and tooltips.
tl;dr
- Install by executing
npm install detect-element-overflow
oryarn add detect-element-overflow
. - Import by adding
import detectElementOverflow from 'detect-element-overflow'
. - Do stuff with it!
const collisions = detectElementOverflow(child, parent);
User guide
Detect-Element-Overflow returns an object with getter functions described below.
| Attribute name | Description | Example values |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| collidedTop | Whether or not the child element collided with the top parent's border. | true
|
| collidedBottom | Whether or not the child element collided with the bottom parent's border. | true
|
| collidedLeft | Whether or not the child element collided with the left parent's border. | true
|
| collidedRight | Whether or not the child element collided with the right parent's border. | true
|
| overflowTop | How many pixels of the child have crossed the top parent's border. Negative values specify how many pixels are between the child and the top parent's border. | 20
, -15
|
| overflowBottom | How many pixels of the child have crossed the bottom parent's border. Negative values specify how many pixels are between the child and the bottom parent's border. | 20
, -15
|
| overflowLeft | How many pixels of the child have crossed the left parent's border. Negative values specify how many pixels are between the child and the left parent's border. | 20
, -15
|
| overflowRight | How many pixels of the child have crossed the right parent's border. Negative values specify how many pixels are between the child and the right parent's border. | 20
, -15
|
License
The MIT License.