mui-scroll-trigger v0.1.1

Basically, this component turns this...

import useScrollTrigger from '@mui/material/useScrollTrigger';
import Grow from '@mui/material/Grow

function HideOnScroll(props) {
  const { children } = props;

  const trigger = useScrollTrigger({ threshold: 400 });

  return (
    <Grow in={!trigger}>
      {children}
    </Grow>
  );
}

export default function App() {
  return (
    <HideOnScroll>
      <div>Hello</div>
    </HideOnScroll>
  )
}

...into this...

import ScrollTrigger from 'mui-scroll-trigger'

export default function App() {
  return (
    <ScrollTrigger threshold={400}>
      <div>Hello</div>
    </ScrollTrigger>
  )
}

🎉 🥳 👯‍♀️

...but with more options.

Want to use a different transition? The transition prop accepts any of the MUI v5 transitions as lowercase strings.

<ScrollTrigger transition="zoom">
  <div>Zoomed Hello</div>
</ScrollTrigger>

You can control whether the child element will transition in or out once the threshold is met with the onScroll prop. It accepts either "hide" or "show" and defaults to "hide".

<ScrollTrigger onScroll="show">
  <div>I will appear once the scroll threshold is met</div>
</ScrollTrigger>

You can conditionally disable the transition (ie. when a modal is open) and preserve it's current state with the disabled prop.

<ScrollTrigger disabled={someCondition}>
  <div>I will not transition while `someCondition` is true</div>
</ScrollTrigger>

Props

* required prop

Any other props (eg. easing, timeout) will be passed directly to the chosen MUI transition component. This means you can also use any of the props of the Transition component from react-transition-group.

The ignoreDirection (disableHysteresis), target and threshold props work just like in the MUI useScrollTrigger hook.

License

© benmneb

ISC License

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.