这篇“怎么使用React+TS+IntersectionObserver实现视频懒加载和自动播放功能”文章的知识点大部分人都不太理解，所以小编给大家总结了以下内容，内容详细，步骤清晰，具有一定的借鉴价值，希望大家阅读完这篇文章能有所收获，下面我们一起来看看这篇“怎么使用React+TS+IntersectionObserver实现视频懒加载和自动播放功能”文章吧。

IntersectionObserver

IntersectionObserver 是浏览器内置的 API，用于监听元素是否交叉或超出了视口（viewport）的变化。这个 API 提供了一种异步观察目标元素的机制，在元素进入或离开视口时触发回调函数。

以下是 IntersectionObserver API 的基本语法：

const observer = new IntersectionObserver(callback, options);

其中

callback

options

创建 IntersectionObserver 对象后，我们就可以监听目标元素：

observer.observe(target); // target 是被观察的目标元素

组件卸载时，应取消监听：

observer.unobserve(target);

如果监听了多个元素，可以停止监听所有目标元素：

observer.disconnect();

上面的

disconnect()

现在，你应该已经了解了 IntersectionObserver API。下面，我们将通过编写一个可扩展的组件来实现效果图演示的功能。

视频播放控制组件

首先，我们定义一个

VideoProps

Video

interface VideoProps {
  src: string;
  width?: number;
  height?: number;
  className?: string;
}

接下来，我们定义

Video

src

width

height

className

const Video: React.FC<VideoProps> = ({
  src,
  width = 400,
  height = 300,
  className,
}) => {
  // ...
};

在

Video

useRef

videoRef

const videoRef = useRef<HTMLVideoElement>(null);

然后，我们使用

useEffect

IntersectionObserver

useEffect(() => {
  const video = videoRef.current;
  const options = {
    rootMargin: "0px",
    threshold: 0.5, // 指定交叉比例为 50% 时触发回调函数
  };
  // 创建 IntersectionObserver 实例
  const observer = new IntersectionObserver(([entry]) => {
    // ...
  }, options);
  // 监听 video 元素
  if (video) {
    observer.observe(video);
  }
  // 组件卸载时取消监听
  return () => {
    observer.unobserve(video as Element);
  };
}, []);

在

IntersectionObserver

if (entry.isIntersecting) {
  // 当视频进入视口时，开始播放视频
  if (video?.readyState === 4) {
    // 视频已经加载完毕
    video?.play();
  } else {
    // 监听视频加载完成事件
    if (video?.dataset.src) {
      // 将 data-src 的值赋给 src 属性
      video.src = video.dataset.src;
      delete video.dataset.src;
      video?.addEventListener("loadedmetadata", () => {
        video?.play();
      });
    }
  }
} else {
  // 当视频离开视口时，暂停视频播放
  video?.pause();
}

注意，示例代码中使用了

video?.readyState === 4

readyState

如果视频还没有加载完毕，我们就需要等到它加载完成后再开始播放。为了实现这一点，我们在

data-src

src

data-src

if (video?.dataset.src) {
  // 将 data-src 的值赋给 src 属性
  video.src = video.dataset.src;
  delete video.dataset.src;
  video?.addEventListener("loadedmetadata", () => {
    video?.play();
  });
}

下面是最终的代码：

/**
 * @description 视频组件
 * @param {string} src 视频地址
 * @param {number} width 视频宽度
 * @param {number} height 视频高度
 * @param {string} className 自定义类名
 * @returns {JSX.Element}
 * @example
 *   import Video from '@/components/Video';
 *   <Video src="<https://www.w3schools.com/html/mov_bbb.mp4>" />
 */
import React, { useRef, useEffect } from "react";
interface VideoProps {
  src: string;
  width?: number | string;
  height?: number | string;
  className?: string;
}
const Video: React.FC<VideoProps> = ({
  src,
  width = 400,
  height = 300,
  className,
}) => {
  const videoRef = useRef<HTMLVideoElement>(null);
  useEffect(() => {
    const video = videoRef.current;
    const options = {
      rootMargin: "0px", // 用于指定目标元素与根元素（视口）的边缘间的偏移量，以便确定何时触发回调函数。
      threshold: 0.5, // 指定交叉比例为 50% 时触发回调函数
    };
    // 创建 IntersectionObserver 实例
    const observer = new IntersectionObserver(([entry]) => {
      if (entry.isIntersecting) {
        // 当视频进入视口时，开始播放视频
        if (video?.readyState === 4) {
          // 视频已经加载完毕
          video?.play();
        } else {
          // 监听视频加载完成事件
          if (video?.dataset.src) {
            // 将 data-src 的值赋给 src 属性
            video.src = video.dataset.src;
            delete video.dataset.src;
            video?.addEventListener("loadedmetadata", () => {
              video?.play();
            });
          }
        }
      } else {
        // 当视频离开视口时，暂停视频播放
        video?.pause();
      }
    }, options);
    // 监听 video 元素
    if (video) {
      observer.observe(video);
    }
    // 组件卸载时取消监听
    return () => {
      observer.unobserve(video as Element);
    };
  }, []);
  return (
    <video
      loop
      muted
      controls
      playsInline
      width={width}
      ref={videoRef}
      data-src={src} // 添加 data-src 属性
      height={height}
      className={className}
    />
  );
};
export default Video;