react-micro-frontends-bridge v0.0.3-beta

react-micro-frontends-bridge

Introduction

A simple react-micro-frontends implement of MeiTuan's solution

Install & Usage

You need to install react-micro-frontends-bridge in both portal project and micro-application project.

$ npm install react-micro-frontends-bridge --save

or

$ yarn add react-micro-frontends-bridge

In your portal project

import * as React from 'react';
import * as ReactDOM from 'react-dom';
import MicroComponents from 'react-micro-frontends-bridge/lib/MicroComponents';
import {
    MFBridgeConsumer,
    MFBridgeProvider,
} from 'react-micro-frontends-bridge';

interface APPState {
    app: string;
}

export default class APP extends React.Component<any, APPState> {
    constructor(props: any) {
        super(props);
        this.state = {
            app: 'Application1',
        };
    }

    getMicroResources = async () => {
        // get all micro-application's script.
        return await new Promise<MicroComponents>(resolve => {
            window.setTimeout(() => {
                resolve({
                    Application1: 'http://localhost:62000/app1.js',
                    Application2: 'http://localhost:62000/app2.js',
                });
            }, 1000);
        });
    };

    render() {
        return (
            <MFBridgeProvider
                getMicroResources={this.getMicroResources}
                commonModules={[
                    {
                        name: 'react', // register react as a common module
                        context: require.context(
                            'react',
                            true,
                            /^.\/(lib\/)?[^\/]+\.js$/,
                        ),
                    },
                    {
                        name: 'react-dom', // register react-dom as a common module, and so on...
                        context: require.context(
                            'react-dom',
                            true,
                            /^.\/index\.js$/,
                        ),
                    },
                ]}
            >
                <div>
                    <button
                        onClick={() => this.setState({ app: 'Application1' })}
                    >
                        Goto Application1
                    </button>
                    <button
                        onClick={() => this.setState({ app: 'Application2' })}
                        style={{
                            marginLeft: 30,
                        }}
                    >
                        Goto Application2
                    </button>
                    <div
                        style={{
                            margin: 100,
                            padding: 100,
                            border: '1px solid #ddd',
                        }}
                    >
                        // use MFBridgeConsumer to render micro-application
                        <MFBridgeConsumer name={this.state.app} />
                    </div>
                </div>
            </MFBridgeProvider>
        );
    }
}

ReactDOM.render(<APP />, document.getElementById('root'));

In your micro-application project

Application1:

import * as React from 'react';
import { register } from 'react-micro-frontends-bridge';

/**
 * An independent application, maybe a component or a complicated SPA
 */
class Application1 extends React.Component {
    render() {
        return <div>Application 1</div>;
    }
}

// register this application to react-micro-frontends-bridge
register('Application1', <Application1 />);

Application2:

import * as React from 'react';
import { register } from 'react-micro-frontends-bridge';

/**
 * An independent application, maybe a component or a complicated SPA
 */
class Application2 extends React.Component {
    render() {
        return <div>Application 2</div>;
    }
}

// register this application to react-micro-frontends-bridge
register('Application2', <Application2 />);

Webpack

In your webpack's production config, you can exclude the common module like react, react-dom...

externals: [
    function(context, request, callback) {
        const libs = ['react', 'react-dom'];
        if (libs.indexOf(request.split('/', 1)[0]) !== -1) {
            callback(null, `var window.MicroResource.require('${request}')`);
        } else {
            callback();
        }
    },
];