Angular9 单页多视频滚动自动播放与互斥暂停实现
Angular9 单页多视频滚动联动播放实现方案
核心实现思路
采用Angular自定义结构指令封装通用联动逻辑,搭配浏览器原生IntersectionObserver做视口检测,替代传统scroll事件监听,从根源避免滚动卡顿问题;通过指令内的静态属性做跨实例的播放状态协调,保证同一时刻仅单个视频处于播放状态。
第一步:改造原有重复的模板代码
原模板中4个结构完全一致的视频块可以通过*ngFor遍历渲染,避免重复冗余代码:
- 先在组件中定义视频数据源:
// 业务组件内的属性定义 videoList = [ { id: 1, url: '第一个视频的实际地址' }, { id: 2, url: '第二个视频的实际地址' }, { id: 3, url: '第三个视频的实际地址' }, { id: 4, url: '第四个视频的实际地址' } ]
- 替换原模板中写死的视频块,给每个video元素挂上自定义指令标识:
<div class="video_content left" *ngFor="let video of videoList"> <span style="font-weight:bold">{{ video.id }}</span> <video width="213" height="120" controls class="video_tag" appVideoAutoPlay > <source [src]="video.url" type="video/mp4" /> </video> </div>
第二步:编写联动逻辑的自定义指令
指令的核心能力包含两点:
- 检测绑定的video元素的可视区域露出比例,当露出占比超过60%时判定为进入可视区
- 全局维护唯一的正在播放的视频实例,当新视频满足播放条件时,先暂停之前的播放实例,再播放当前视频;当视频滚出可视区时自动暂停
兼容Angular9的指令实现代码:
import { Directive, ElementRef, OnDestroy, OnInit } from '@angular/core'; @Directive({ selector: '[appVideoAutoPlay]' }) export class VideoAutoPlayDirective implements OnInit, OnDestroy { // 跨指令实例共享的当前播放视频引用 private static currentPlayingVideo: HTMLVideoElement | null = null; private intersectionObserver: IntersectionObserver; constructor(private elementRef: ElementRef<HTMLVideoElement>) {} ngOnInit(): void { this.intersectionObserver = new IntersectionObserver((entries) => { entries.forEach(entry => { // 露出比例超过60%时触发播放逻辑 if (entry.intersectionRatio >= 0.6) { this.triggerPlay(); } else { this.triggerPause(); } }) }, { // 配置检测阈值,覆盖全露出/半露出/完全滚出的场景 threshold: [0, 0.6, 1] }); this.intersectionObserver.observe(this.elementRef.nativeElement); } /** 处理视频播放逻辑 */ private triggerPlay(): void { const targetVideo = this.elementRef.nativeElement; // 若当前已有其他视频在播放,优先暂停 if (VideoAutoPlayDirective.currentPlayingVideo && VideoAutoPlayDirective.currentPlayingVideo !== targetVideo) { VideoAutoPlayDirective.currentPlayingVideo.pause(); } // 调用播放方法,捕获浏览器自动播放策略的拦截异常,避免控制台报错 targetVideo.play().catch(() => {}); // 更新全局播放状态引用 VideoAutoPlayDirective.currentPlayingVideo = targetVideo; } /** 处理视频暂停逻辑 */ private triggerPause(): void { const targetVideo = this.elementRef.nativeElement; targetVideo.pause(); // 若被暂停的是全局记录的播放实例,清空状态引用 if (VideoAutoPlayDirective.currentPlayingVideo === targetVideo) { VideoAutoPlayDirective.currentPlayingVideo = null; } } ngOnDestroy(): void { // 组件销毁时断开观察,避免内存泄漏 this.intersectionObserver.disconnect(); } }
版本适配与常见踩坑说明
- 指令的注册:只需要在对应业务模块的
declarations数组中声明一次VideoAutoPlayDirective,所有挂了appVideoAutoPlay标识的video元素都能自动生效,不需要在每个使用场景重复写逻辑 - 自动播放策略兼容:部分浏览器会拦截没有用户交互场景下的自动播放,代码中通过
.catch()捕获拦截异常,不会造成控制台未捕获报错;如果需要适配严格的自动播放策略,可以在用户首次点击页面时给全局video元素标记允许自动播放 - 避免scroll监听的性能损耗:不要用window.scroll事件手动计算元素位置做可视判定,
IntersectionObserver是浏览器原生的异步检测能力,长列表滚动时不会造成明显的性能掉帧 - 状态兼容:用户手动通过video的controls控件操作播放/暂停时,只要没有触发元素进入/离开视口的判定,指令不会强行覆盖用户的操作状态
内容的提问来源于stack exchange,提问作者Saad Ahmed
相关产品推荐
相关产品推荐

