react-lazy-import

0.2.1 • Public • Published

react-lazy-import

A simple higher order component for easy code splitting.

Features

  • Supports import()
  • Supports react-router v4
  • Ability to add <LoadingComponent />
  • Ability to Add <ErrorComponent />

Quick example

import createLazyContainer from 'react-lazy-import';
 
const MyComponent = createLazyContainer(() => import('./MyComponent'));
 
const App = () => {
  return (
    <div>
      My lazy component:
      <MyComponent />
    </div>
  );
}

Complete example

JavaScript

// Greeter.jsx
import React from 'react';
 
const Greeter = ({ name }) => (
  <div>Hello {name}, I am lazy loaded</div>
);
 
export default Greeter;
// App.jsx
import React from 'react';
import { render } from 'react-dom';
import createLazyContainer from 'react-lazy-import';
 
const Loading = () => <div>Loading...</div>;
const Error = () => <div>Error!</div>;
 
const Greeter = createLazyContainer(() => import('./Greeter'), Loading, Error);
 
const App = () => {
  return (
    <div>
      My lazy component:
      <Greeter name="Jason" />
    </div>
  );
}
 
render(<App />, document.getElementById('app'));

TypeScript

// Greeter.tsx ...
// App.tsx
import * as React from 'react';
import createLazyContainer from 'react-lazy-import';
 
const Loading: React.SFC<{}= () => <div>Loading...</div>;
const Error: React.SFC<{}= () => <div>Error!</div>;
 
interface IGreeterProps {
  name: string;
}
 
// TypeScript currently doesn't support `import()` 
// so we need to use `System.import()` alias
// This won't be needed in the future (TypeScript v2.4)
declare const System: {
  import: (path: string) => Promise<any>;
};
 
 
const Greeter = createLazyContainer<IGreeterProps>(() => System.import('./Greeter'), Loading, Error);
 
const App = () => {
  return (
    <div>
      My lazy component:
      <Greeter name="Jason" />
    </div>
  );
}

Usage with react-router

...
 
import { Route, Switch } from 'react-router-dom';
 
const Loading: React.SFC<{}= () => <div>Loading...</div>;
const Error: React.SFC<{}= () => <div>Error!</div>;
 
const Home = createLazyContainer(() => import('./Home'), Loading, Error);
const About = createLazyContainer(() => import('./About'), Loading, Error);
const Contact = createLazyContainer(() => import('./Contact'), Loading, Error);
const NotFound = createLazyContainer(() => import('./NotFound'), Loading, Error);
 
class App extends React.Component {
  render () {
    return (
      <Switch>
        <Route exact path='/' component={Home} />
        <Route path='/About' component={About} />
        <Route path='/Contact' component={Contact} />
        <Route component={NotFound} />
      </Switch>
    );
  }
}
 
...
 

API

createLazyContainer(loader, [loadingComponent], [errorComponent])

  • loader: () => Promise<React.ComponentClass>

    Function returning promise which returns a React component.

  • loadingComponent (optional)

    React component which is rendered while your component is loading.

  • errorComponent (optional)

    React component which is rendered when loader fails to load your component

Package Sidebar

Install

npm i react-lazy-import

Weekly Downloads

24

Version

0.2.1

License

MIT

Unpacked Size

122 kB

Total Files

10

Last publish

Collaborators

  • martynaskadisa