50 lines
1.5 KiB
TypeScript
50 lines
1.5 KiB
TypeScript
import { default as React } from 'react';
|
|
export interface ClientOnlyProps {
|
|
/**
|
|
* The children to render when the JS is loaded.
|
|
*/
|
|
children: React.ReactNode;
|
|
/**
|
|
* The fallback component to render if the JS is not yet loaded.
|
|
*/
|
|
fallback?: React.ReactNode;
|
|
}
|
|
/**
|
|
* Render the children only after the JS has loaded client-side. Use an optional
|
|
* fallback component if the JS is not yet loaded.
|
|
*
|
|
* @example
|
|
* Render a Chart component if JS loads, renders a simple FakeChart
|
|
* component server-side or if there is no JS. The FakeChart can have only the
|
|
* UI without the behavior or be a loading spinner or skeleton.
|
|
*
|
|
* ```tsx
|
|
* return (
|
|
* <ClientOnly fallback={<FakeChart />}>
|
|
* <Chart />
|
|
* </ClientOnly>
|
|
* )
|
|
* ```
|
|
*/
|
|
export declare function ClientOnly({ children, fallback }: ClientOnlyProps): import("react/jsx-runtime").JSX.Element;
|
|
/**
|
|
* Return a boolean indicating if the JS has been hydrated already.
|
|
* When doing Server-Side Rendering, the result will always be false.
|
|
* When doing Client-Side Rendering, the result will always be false on the
|
|
* first render and true from then on. Even if a new component renders it will
|
|
* always start with true.
|
|
*
|
|
* @example
|
|
* ```tsx
|
|
* // Disable a button that needs JS to work.
|
|
* let hydrated = useHydrated()
|
|
* return (
|
|
* <button type="button" disabled={!hydrated} onClick={doSomethingCustom}>
|
|
* Click me
|
|
* </button>
|
|
* )
|
|
* ```
|
|
* @returns True if the JS has been hydrated already, false otherwise.
|
|
*/
|
|
export declare function useHydrated(): boolean;
|