Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

React Idle

CircleCI Maintainability MIT Licensed Enterprise Web Development

Render components when browser is idle.

The idea is to allow Above The Fold content to render as soon as possible, letting the rest of the app render and update when the browser is idle.

This component uses requestAnimationFrame which is also used in React.

Demo

See a working react-idle demo and compare rendering performance between syncronous rendering and rendering on idle.

Getting started

Install react-idle using npm.

npm install @modus/react-idle --save

Usage

import * as React from 'react';
import OnIdle from '@modus/react-idle';

export default class MyView extends React.Component {
  render() {
    <section>
      <article>This is above the fold content that must render ASAP</article>
      <OnIdle>
        <aside>This heavy component can be rendered when the browser is idle</aside>
      </OnIdle>
    </section>
  }
}

Dependencies

React Idle has only one direct dependency: idlize. Since it's meant to be used with React, it expects that your project already depends on react and react-dom.

NPM will not automatically install these dependencies for you, but it will show a friendly warning message with instructions.

Configuration

Property Type Required? Description
children React Node Children you want to render on idle
placeholder React Node Placeholder component that shows before the render takes place
onRender Function Callback executed after render completes. No arguments provided.
skipSSR Boolean Use this property to prevent the children from being rendered in Server Side Rendering. Defaults to false.
syncUpdate Boolean Use this property to render updates immediately instead of triggering another onIdle process. Defaults to false.

Contributing

Testing

This project uses Jest for unit testing. To execute tests run this command:

npm test

It's useful to run tests in watch mode when developing for incremental updates.

npm run test:watch

License

This project is MIT licensed.

About

Render components when browser is idle

Resources

License

Packages

No packages published
You can’t perform that action at this time.