React DVD Screensaver

DVD-era nostalgia in React.

Demo

Try the project on Stackblitz

npm i react-dvd-screensaver

Use hook

To add a DVD screensaver effect to your React components, you can use the useDvdScreensaver hook. This hook provides you with references for both the parent (container) and the child (moving element), along with the number of times the child has hit the edges of the container.

import { useDvdScreensaver } from 'react-dvd-screensaver'

...

const { containerRef, elementRef } = useDvdScreensaver();

return (
  <div ref={containerRef}>
    <MyScreensaverComponent ref={elementRef} />
  </div>
)

Pass the ref objects for parent and child to their respective components. Just remember to set the dimensions for both of them, where the childRef component naturally is smaller than the parent so there is room for it to move around.

| Hook returns following:|| | ------------- | ------------- | |parentRef: refObject| Ref of the parent container component| |elementRef: refObject| Ref of the element to animate| |impactCount: number| Number of times the element has hit the container edges|

Hook Options

The hook accepts the following parameters:

| Option | Type | Description | | ------------- | -------|-----| |speed| number | Speed of the animation | |freezeOnHover| boolean | Whether to pause the animation on hover | |hoverCallback| Function | Callback function triggered on hover |

Component

For easier implementation, you can also use the DvdScreensaver component to wrap any child component with the DVD screensaver effect.

import { DvdScreensaver } from 'react-dvd-screensaver'

...

return (
  <div className="screensaver-container">
    <DvdScreensaver>
      <MyScreensaverComponent />
    </DvdScreensaver>
  </div>
)

The component inherits the parent container's dimensions by default, but you can also specify dimensions or styling directly via props.

Props

| Prop | Type | Description | | ------------- | ------| -----| |className| string | Optional CSS class for the container | |freezeOnHover| boolean | Pause animation when hovered | |height| number | Optional height for the container | |width| number | Optional width for the container | |hoverCallback|Function | Callback function triggered on hover | |impactCallback|(count: number) => void|Callback function triggered on impact with edges | |speed|number`| Speed of the animation |

License

MIT