如何在amp-story-player加载故事内容时添加加载器
给amp-story-player 添加自定义加载器的实现方法
核心实现思路
不需要完全从零开发加载逻辑,依托amp-story-player本身暴露的生命周期钩子和原生占位规则,覆盖两类核心加载场景即可解决问题:一是首次进入页面时播放器的初始加载过程,二是用户滑动切换、加载后续故事的二次加载过程。
具体操作步骤
配置初始加载占位
amp-story-player 标签内部的直接子元素,在播放器还未完成首次资源拉取、没把故事内容渲染到容器内时,会直接展示这部分内容,等首个故事加载完成后自动替换。这部分占位内容要写得足够轻量,不要阻塞渲染。
参考代码结构:<amp-story-player style="width: 100%; max-width: 400px; aspect-ratio: 9/16"> <!-- 直接写在标签内部的占位,会在加载阶段自动展示 --> <div class="initial-loading-box"> <span class="loading-spinner"></span> <p>内容加载中,请稍候</p> </div> <!-- 后续接真实的故事链接入口 --> <a href="/stories/story-1.html"></a> <a href="/stories/story-2.html"></a> </amp-story-player>监听状态事件实现切换加载遮罩
首次加载的占位被替换后,用户切换到下一个待加载故事时,不会再触发初始占位的显示,这时候需要通过组件抛出的生命周期事件控制自定义的浮层加载器:- 当组件触发开始加载故事的事件时,显示覆盖在播放器上方的加载遮罩
- 当组件触发故事加载完成、可正常交互的事件时,隐藏加载遮罩
参考代码逻辑:
const storyPlayer = document.querySelector('amp-story-player'); const loadingOverlay = document.querySelector('.player-loading-overlay'); // 捕获开始加载新故事的事件 storyPlayer.addEventListener('ampStoryPlayer:loadStory', () => { loadingOverlay.classList.add('active'); }); // 捕获故事加载完成的事件 storyPlayer.addEventListener('ampStoryPlayer:storyLoaded', () => { loadingOverlay.classList.remove('active'); }); // 加载失败时的兜底处理 storyPlayer.addEventListener('ampStoryPlayer:storyLoadError', () => { loadingOverlay.innerHTML = '<p>内容加载失败,请点击重试</p>'; });体验优化注意点
- 加载动画的视觉风格要和站点整体设计保持一致,避免突兀的样式破坏沉浸感
- 占位和遮罩本身的文件体积要控制在10KB以内,不要因为加载器本身拖慢首屏速度
- 加载器只是体验兜底,可配合预取下一个故事核心资源的逻辑,把实际等待时长压缩到用户无感知的范围
内容的提问来源于stack exchange,提问作者informer
相关产品推荐
相关产品推荐

