This is a fork of react-wrap-balancer, that focuses on integrating it into micro-frontend React SSR applications. The original implementations, works great for Next.js applications - But if we have multiply instances of React, then the <Provider> pattern isn't ideal.

This fork, uses a different approach, where a <RelayoutScript> element is used to inject the <script> tag in <head>, so the <Provider> is no longer needed.

Usage

To start using the library, install it to your project:

npm i @charlietango/react-wrap-balancer

Inject the relayoutScript() function in your HTML template:

const html = () => (
  <html>
    <head>
      <title>App</title>
      <RelayoutScript />
    </head>
    <body>
      <div id="root" />
    </body>
  </html>
);

And wrap text content with the <Balancer> component:

import Balancer from "@charlietango/react-wrap-balancer";

function Title() {
  return (
    <h1>
      <Balancer>My Awesome Title</Balancer>
    </h1>
  );
}

Client-side only

To make it work with Storybook or tests, you can initialize the relayout function only on the client-side. This needs happen before you initialize the React components.

import { initWrapBalancer } from "@charlietango/react-wrap-balancer";

initWrapBalancer();

Keywords

FAQs

What is @charlietango/react-wrap-balancer?

Is @charlietango/react-wrap-balancer popular?

Is @charlietango/react-wrap-balancer well maintained?

Package last updated on 10 Feb 2023

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install