Vue3 实现双盒子定位Overlay的示例_vue.js

在 Vue 3 中，使用 <Teleport> 可以很优雅的把某个组件渲染到根节点之外的节点，同时使其渲染的内容不丧失响应式和对应的生命周期函数调用。那么基于此，用 <Teleport> 实现相对于某一元素的 Overlay 。实际上，这篇文章跟 Vue3 的关系不大，只是通过 Vue3 讲解一类 Overlay 的设计方法。

原理

要实现相对于某一元素的 Overlay 需要依靠两个元素，Origin 和 Panel，Origin 表示相对于的元素，而 Panel 表示 Overlay 本身，实现方法主要有两种。

文本流定位法，基于 position 的 absolute 和 relative 特性，将 Panel 形成相对于 Origin 的位置来定位的方式。
Overlay 基于 Origin 做固定偏移的双盒子定位法，也就是本文需要讲解的方法。
实现首先，通过<Teleport>，能够建立顶层 Overlay，也就是在根节点创建一个新的节点。

				?

									setup(_, ctx) {

									 const originRef = ref<HTMLElement>();

									 const panelRef = ref<HTMLElement>();

									 const panelStyle = ref<CSSProperties>({ position: 'absolute' });

									 // ...

									 return () => (

									  <>

									   <div ref={originRef}>origin</div>

									   <Teleport to="#cdk-overlay-anchor">

									     <div style={{ position: 'fixed', top: 0, left: 0, right: 0, bottom: 0, height: '100vh', width: '100vw' pointerEvents: 'none'}}>

									      <div ref={panelRef} style={panelStyle.value}>

									       <div style={{height: '100px', width: '100px' border: '1px solid black'}} />

									      </div>

									     </div>

									   </Teleport>

									  </>

									 );

									}

拿到这两者的 dom ref 后，需要通过实时计算 Origin 的盒子的大小和位置，来获得 Panel 的相对偏移。在 Vue 中，元素只有在 mounted 后才能获取得到，所以可以通过 composition-api 的 onMouted 来获取具体元素。然后再在生命周期中进行计算。

计算两个盒子的相对位置

如何计算 Origin 的大小和位置，以及获取其变化后的监听。Origin 的大小和位置，通过 getBoundingClientRect 这一 API 来获取，这一就可以开始计算 Overlay 的相对位置。假设我们要把 Overlay 放在 Origin 的正下方，计算函数应该是这样的。

				?

									const panelStyle = ref<CSSProperties>({ position: 'absolute' });

									onMounted(() => {

									 const origin = originRef.value;

									 const panel = panelRef.value;

									 if (!origin || !panel) {

									  return ;

									 }

									 const calculate = () => {

									  const rect = origin.getBoundingClientRect();

									  // 原点为 origin 元素的底边中央正下方

									  const originX = rect.left + (rect.width / 2);

									  const originY = rect.bottom;

									  // panel的坐标为到原点的偏移

									  const panelRect = panel.getBoundingClientRect();

									  const panelX = originX - panelRect.width / 2;

									  const panelY = originY;

									  // 设置 panel 数据，触发节点变更

									  panelStyle.value.left = `${panelX}px`;

									  panelStyle.value.top = `${panelY}px`;

									 };

									});

当然，你还可以计算各个不同方向的 Panel 坐标（比如，正左、正上、正下等），排列组合一下，一共有种27不同的情况（每个点依赖于两个变量 X 和 Y；每个变量有三种不同的情况，左、中、右，或者，上、中、下）。

监听盒子的变化

在这里，我们将使用浏览器自带的API 来对他们进行监听。通过 MutationObserver 和 ResizeObserver，可以很轻松的监听 Origin 和 Panel 的大小和位置变化。

首先是监听 Origin 的大小和位置变化，这里采用的是 MutationObserver，因为导致位置变化的原因只能是 style，所以只需要监听 style 的变化即可。

				?

									const origin$ = new MutationObserver(calculate);

									origin$.observe(origin, {

									 // 只需要拿到 attribute 的 style 的变化即可

									 attributeFilter: ['style'],

									});

Panel 只需要监听其大小的变化，大小变化有一个更加完美的API， ResizeObserver。

				?

									const panel$ = new ResizeObserver(calculate);

									panel$.observe(panel);

然后，需要在dom销毁前取消监听。

				?

									// dom销毁前取消监听

									onBeforeUnmount(() => {

									 origin$.disconnect();

									 panel$.disconnect();

									});

监听窗口事件

为了能够正确的获取变化，我们需要监听两个事件：resize 和 scroll.

				?

									// 为了能够在滚动事件捕获前进行计算，带有滚动条的子元素也会因此触发计算

									window.addEventListener('scroll', calculate, true);

									window.addEventListener('resize', calculate);

									最后，仍然要在销毁前取消事件。

									// dom销毁前取消监听

									onBeforeUnmount(() => {

									 window.removeEventListener('scroll', calculate, true);

									 window.removeEventListener('resize', calculate);

									});