React OnVisible component

Live demo

Live example: https://dazld.github.io/react-on-visible/demo/

Description

This is a component that applies the css class visible to the container when the element becomes by default more than 50% visible in the browser viewport.

It only attaches to browser events on the client, so is also safe to use for server rendering.

Viewport visibility is calculated by listening to a debounced window scroll event (10ms), and once the element has been found to be visible, no further changes are applied unless the bounce prop is set to true.

API

$3

Percentage (100 based) of element that should be visible before triggering change. eg percent={80}

$3

ClassName that should be added to element once visible

$3

Callback when visibility changes. Argument is a boolean, true for visible, false for not.

$3

Whether visibility should be continuously calculated, or just until the element becomes visible. defaults to false. Go easy with this, don't expect amazing performance with many tens or hundreds of elements (getBoundingClientRect).

$3

The string representation of the html element used to wrap children. Defaults to a div

$3

The user can override default props via this function. If you want everything to bounce, for example, then can do this:
``
import OnVisible, { setDefaultProps } from 'react-on-visible';

setDefaultProps({
bounce: true,
visibleClassName: 'appear',
percent: 10
});

`

and so on.

Example

`js

import React from 'react';
import OnVisible from 'react-on-visible';

export default function someComponent(props) {
return (



I will be rendered inside a div that has class 'my-container' only until I become visible, at which point the container will have the classes 'my-container visible'

`

A further example is available in the demo folder of this project.

Changelog

$3

- Fixes Take element attributes from passed rest properties on OnVisible (https://github.com/dazld/react-on-visible/issues/29) (Thanks @Vovan-VE)

$3

- Fixes onChange bug reported in https://github.com/dazld/react-on-visible/issues/27, and remove repeated invocation of onChange, only calling it when something actually changes.

$3

- Added an option to configure the wrappingElement, instead of using div always (thanks @TomiTakussaari - https://github.com/dazld/react-on-visible/issues/23)

$3

- Added an index.d.ts file for typescript users (thanks @KromDaniel)

$3

- support react 16+ (thanks @schwers - https://github.com/dazld/react-on-visible/pull/17)
- change scheduler to use requestAnimationFrame instead of debounce (thanks @falconmick - https://github.com/dazld/react-on-visible/pull/14)
- tweak dependencies, move react to peer deps

$3

- include a fix for this.holder being null in some situations #12

$3

- added react-props package instead of using them directly from react (thanks @renoiser )

$3

- Added bounce prop and function to set default props.

$3

- added onChange` callback prop option (thanks @rdjpalmer)