2.2.8

生命週期事件

最後更新


本頁說明 when 的五個回呼何時觸發、各來源對應的底層事件,以及 ready 回呼內的呼叫時序限制。

回呼一覽


回呼HTML5 video/audioYouTubeVimeoFlexPlyr 同時做的事
readyloadedmetadataonReadyready() resolve設定時長、進度歸零、套用音量與靜音
playingplaying狀態 1play啟動 100ms 進度輪詢;1 秒後隱藏面板
pausepause狀態 2pause停止輪詢、顯示面板
endended狀態 0ended停止輪詢、面板重設、進度跳回 0
destroyeddestroy() 移除 DOM 後同左同左—

舊版的 event 物件仍可使用,等同 when(見棄用項目)。

範例


點擊播放、暫停後再按 destroy(),下方 log 會依序列出觸發的回呼:
  1. <div style="max-width: 480px; aspect-ratio: 16 / 9"><div id="player"></div></div>
  2. <button id="destroy">destroy()</button>
  3. <script>
  4. const player = new FPlyr({
  5. id: "player",
  6. video: "https://cdn.pixabay.com/video/2023/11/28/191159-889246512_tiny.mp4",
  7. when: {
  8. ready: () => console.log("ready"),
  9. playing: () => console.log("playing"),
  10. pause: () => console.log("pause"),
  11. end: () => console.log("end"),
  12. destroyed: () => console.log("destroyed"),
  13. },
  14. });
  15. document.getElementById("destroy").onclick = () => player.destroy();
  16. </script>
即時預覽 · @pardnchiu/flexplyr@2.2.9

ready 早於內部狀態


ready 是 #stateReady() 的第一行(src/js/model/player.js:397),此時 #isVideo/#isYoutube 等來源旗標尚未設定(:406)。所有公開方法都依這些旗標分流,所以在 ready 內同步呼叫會落空:
  1. <div style="max-width: 480px; aspect-ratio: 16 / 9"><div id="player"></div></div>
  2. <script>
  3. const player = new FPlyr({
  4. id: "player",
  5. video: "https://cdn.pixabay.com/video/2023/11/28/191159-889246512_tiny.mp4",
  6. when: {
  7. ready: () => {
  8. console.log("inside ready:", String(player.isPaused()));
  9. setTimeout(() => console.log("next tick:", player.isPaused()));
  10. },
  11. },
  12. });
  13. </script>
即時預覽 · @pardnchiu/flexplyr@2.2.9

需要在就緒時操作播放器,把呼叫包進 setTimeout。

相關頁面


EN