npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

pjy-starport

v0.1.0

Published

Shared React component across routes with animations

Downloads

1

Readme

倘若你希望你的组件在不同的路由(页面)下使用,在切换的时候保存组件的状态并且拥有平滑的过渡动画,可以尝试下这个组件。

起源

在传统的wen应用中,切换页面,意味着组件的卸载和重新挂载,组件的生命周期会执行,内部的状态也会丢失。

我们在不同的页面使用同一个组件时可能会由于页面布局不同,UI 设计不同导致相同组件的位置、大小、样式、状态等不同,这时我们可能会希望在进行路由跳转时让两个页面使用的相同的组件有一个过渡动画直接将相同的组件流畅的传递过去,但是 DOM 结构以树的形式呈现,在不同路由下的组件有着不同的节点,即使在不同路由下使用相同的组件时也会创建两个组件实例

如上图,在 pageA 和 pageB 两个路由下都使用了 ComponentA 组件,那么就会在两个页面创建两次组件实例,当我们从 pageA 路由跳转到 pageB 路由后会不可避免的经历组件的卸载和重新挂载,执行组建的生命周期,而跳转前组件内的状态也会丢失。

尽管我们可以通过 context 或者一些全局状态管理工具(mobx/redux)来存储组件里的一些状态,并且也可以通过FLIP来模拟不同组件之间的动画,然而,FLIP 只解决了过渡的问题,我们仍然还是会有两个组件实例。在跳转过程中,组件的内部状态将会丢失。这两种实现方式都还是不够优雅,因为同一个组件还是会渲染两次,还是要经历组件卸载和重新挂载的生命周期。

思路

我们可以参考FLIP的思路,既然我们无法在组件树的不同分支之间共享组件,我们其实上可以将组件提升到根节点上,从而它们独立于路由而存在。

我们页面中的组件,只是一个代理组件,用于接收一些位置信息和一些props。而真正要渲染的组件,其实是用绝对定位悬浮在整个App下的,根据代理组件接收到的位置和样式信息,将悬浮的真正组件通过补间动画的形式移动到对应的位置。

当补间动画结束之后,我们可以通过createPortal(vue中是teleport)将真正的组件传送到对应的代理组件中

这种方法很像一种“着陆”机制,当跳转到另一路由时,组件将从原页面 “起飞” ,然后变成漂浮的状态,“飞行” 到新的位置,然后再次 “着陆”到指定路由的指定位置。

安装

npm i pjy-starport

在入口文件引入css

import 'pjy-starport/dist/main.css'

使用

pjy-starport 导出并添加 <Starport> 组件到根组件 (App.tsx)。 所有的组件调用需要在 <Starport> 组件内部。

这样做的目的是:一是为了让FloatContainer悬浮在整个App下,二是让Starport包裹住Router

import { Starport } from 'pjy-starport' 

ReactDOM.createRoot(document.getElementById('root')!).render(
   <Starport>
     <App />
   </Starport>
)

现在,准备工作已经完成。

如果我们现在需要让一个图片组件TheImage在路由切换时保留状态,具体使用方式如下:

首先,使用FloatContainer组件,包裹要渲染的组件,用slot指定要渲染的内容。

注意:一定要给Container唯一的port字符串

import { Starport, FloatContainer } from 'pjy-starport'

function App() {
  return (
    <div className='bg-black w-full text-white'>
      <Starport>
        <Router />
        {imgs.map((img, index) => {
          return (
            <FloatContainer
              key={index}
              slot={() => <TheImage src={img} />}
              port={index + 1 + ''}
            />
          )
        })}
        <FloatContainer slot={() => <Info />} port='13' />
      </Starport>
    </div>
  )
}

接着,我们就可以在即将“到达”的页面中使用FloatProxy组件来渲染FloatContainer组件的slot指定的内容了(渲染的时候slot外面会多一层div),如下。我们可以给FloatProxy传入一些props,他们会被挂载到slot外的div上(一般来说可以传入一些样式)。

import { FloatProxy } from 'pjy-starport'

const Foo = memo(() => {
  const [mode, setMode] = useState(false)
  return (
      <div flex='~ wrap' justify='center'>
        {['1', '2', '3', '4', '5', '6', '7', '8', '9', '10', '11', '12'].map(
          item => (
            <FloatProxy
              key={item}
              port={item}
              className={mode ? 'w-60 h-50' : 'w-60 h-30'}
              m='5'
              rounded='xl'
              overflow='hidden'
            />
          )
        )}
      </div>
  )
})

要注意的是:传给FloatProxy组件的port参数一定是当时指定的唯一字符串,

FloatContainer组件和FloatProxy组件的port参数要保持一致

具体案例可以参考:👉React Starport

可以看到,我们点击某张图片,触发路由切换,此时组件被移动到另一页面的指定位置,组件状态会保留,并且会有平滑的补间动画。

License

MIT License © 2022 mengqiuleo