react-offscreen(activity)

!NPM Version
!License

react-offscreen can hide components without uninstalling them

Features

- based on Suspense
- minzip only 1.2kb
- good performance
- react full context support

Installation

``bash
npm install @ivliu/react-offscreen
yarn add @ivliu/react-offscreen
pnpm add @ivliu/react-offscreen
`

Examples

$3

`typescript
import { useState } from 'react';
import ReactDOM from 'react-dom/client';
import { Activity } from '@ivliu/react-offscreen';

const Counter = () => {
const [count, setCount] = useState(0);

return

setCount(count + 1)}>{count}

ReactDOM.createRoot(document.getElementById('root')!).render();
`

$3

`typescript
import { useState } from 'react';
import ReactDOM from 'react-dom/client';
import { createPortal } from 'react-dom';
import { Activity } from '@ivliu/react-offscreen';

const Counter = () => {
const [count, setCount] = useState(0);

return createPortal(
setCount(count + 1)}>count is {count},
document.body,
);
};

const App = () => {
const [open, setOpen] = useState(false);
return (


ReactDOM.createRoot(document.getElementById('root')!).render();
`

$3

> Since Activity is implemented based on Suspense, please pay attention to placing the Suspense component under the Activity component when using it, otherwise it may cause the problem that the fallback cannot be displayed normally.

`typescript
import { useState, lazy, Suspense } from 'react';
import ReactDOM from 'react-dom/client';
import { Activity } from '@ivliu/react-offscreen';

const LazyCount = lazy(() => import('./Count'));

const Count = () => {
const [count, setCount] = useState(0);

return

setCount(count + 1)}>{count}

ReactDOM.createRoot(document.getElementById('root')!).render();
`

Rename to Activity

> In order to keep pace with the official react, we renamed Offscreen to Activity. At the same time, we will still export Offscreen

`typescript
import { useState } from 'react';
import ReactDOM from 'react-dom/client';
import { Activity, Offscreen } from '@ivliu/react-offscreen';

const Count = () => {
const [count, setCount] = useState(0);

return

setCount(count + 1)}>{count}

ReactDOM.createRoot(document.getElementById('root')!).render();
`

typescript

`typescript
import { useState } from 'react';
import ReactDOM from 'react-dom/client';
import { Activity } from '@ivliu/react-offscreen';
import type { ActivityMode } from '@ivliu/react-offscreen';

const Count = () => {
const [count, setCount] = useState(0);

return

setCount(count + 1)}>{count}

ReactDOM.createRoot(document.getElementById('root')!).render();
`

unstable hooks

> We provide hook implementation for component activation and deactivation status, but we do not plan to merge it into the main branch. If you need it, please refer to https://github.com/IVLIU/react-offscreen/tree/feat/unstable-hooks

`typescript
import React from 'react';
import ReactDOM from 'react-dom/client';
import { Offscreen, useActivated } from 'react-offscreen';

const Count = () => {
const [count, setCount] = React.useState(0);

useActivated(() => {
console.log('activated');
return () => {
console.log('deactivated')
}
});

return

setCount(count + 1)}>{count}

ReactDOM.createRoot(document.getElementById('root')!).render();
``

Notice

please use react16.8 and above versions