萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

5 大強大 HTML5 API 實戰指南:全螢幕、可見性、媒體裝置、電池狀態與預載入

為什麼要掌握原生 HTML5 API?

框架會過時,Web Platform API 是永久資產。這 5 個 API 解決真實產品痛點,無需依賴第三方庫,體積極小、效能極佳、標準化程度高。

1. Fullscreen API:沉浸式體驗一鍵啟動

適用場景

  • 影音播放器全螢幕
  • 簡報/投影片模式
  • 遊戲/Canvas 應用
  • 資料視覺化全屏探索

跨瀏覽器完整封裝

// 全螢幕工具模組
const Fullscreen = {
  // 檢查支援度
  isSupported: () => document.fullscreenEnabled ||
    document.webkitFullscreenEnabled ||
    document.mozFullScreenEnabled ||
    document.msFullscreenEnabled,

  // 進入全螢幕
  async request(element = document.documentElement) {
    if (!this.isSupported()) throw new Error('Fullscreen API not supported');
    try {
      if (element.requestFullscreen) return await element.requestFullscreen();
      if (element.webkitRequestFullscreen) return await element.webkitRequestFullscreen();
      if (element.mozRequestFullScreen) return await element.mozRequestFullScreen();
      if (element.msRequestFullscreen) return await element.msRequestFullscreen();
      throw new Error('No fullscreen method found');
    } catch (err) {
      if (err.name === 'TypeError') throw new Error('Element not in document or iframe without allowfullscreen');
      throw err;
    }
  },

  // 退出全螢幕
  async exit() {
    if (document.exitFullscreen) return await document.exitFullscreen();
    if (document.webkitExitFullscreen) return await document.webkitExitFullscreen();
    if (document.mozCancelFullScreen) return await document.mozCancelFullScreen();
    if (document.msExitFullscreen) return await document.msExitFullscreen();
  },

  // 狀態監聽
  onChange(handler) {
    const events = ['fullscreenchange', 'webkitfullscreenchange', 'mozfullscreenchange', 'MSFullscreenChange'];
    events.forEach(e => document.addEventListener(e, handler));
    return () => events.forEach(e => document.removeEventListener(e, handler));
  },

  // 當前全螢幕元素
  get element() {
    return document.fullscreenElement ||
      document.webkitFullscreenElement ||
      document.mozFullScreenElement ||
      document.msFullscreenElement;
  },

  // 是否處於全螢幕
  get isFullscreen() { return !!this.element; }
};

// 使用範例
const video = document.getElementById('player');
document.getElementById('fsBtn').addEventListener('click', async () => {
  try {
    if (Fullscreen.isFullscreen) await Fullscreen.exit();
    else await Fullscreen.request(video);
  } catch (e) { console.error(e); }
});

Fullscreen.onChange(() => {
  document.getElementById('fsBtn').textContent = Fullscreen.isFullscreen ? '⛶ 退出全螢幕' : '⛶ 進入全螢幕';
});

關鍵細節

  • 必須在用戶手勢事件(click、keydown)中調用,否則被瀏覽器攔截
  • iframe 需 allow="fullscreen" 屬性
  • iOS Safari 需 webkitRequestFullscreen() 且不支援 document.exitFullscreen(),需用 webkitExitFullscreen()

2. Page Visibility API:頁面生命週期感知

核心用途

  • 頁面隱藏時:暫停影音、停止輪播、斷開 WebSocket、暫停計時器、儲存草稿
  • 頁面顯示時:恢復播放、重新連線、同步資料、刷新 Token

標準化實作(已去除前綴)

// 現代瀏覽器統一支援 document.hidden / visibilitychange
document.addEventListener('visibilitychange', () => {
  if (document.hidden) {
    console.log('📴 頁面隱藏:暫停資源消耗任務');
    videoPlayer?.pause();
    carousel?.stopAutoPlay();
    ws?.close();
    clearInterval(timerId);
    saveDraft();
  } else {
    console.log('📺 頁面顯示:恢復任務');
    videoPlayer?.play().catch(() => {}); // 自動播放策略可能阻擋
    carousel?.startAutoPlay();
    ws?.connect();
    timerId = setInterval(pollUpdates, 30000);
    syncData();
  }
});

// 頁面卸載前同步(配合 beforeunload/pagehide)
window.addEventListener('pagehide', e => {
  if (e.persisted) { // bfcache 情況
    saveDraft(); // 輕量同步
  }
});

狀態值對照

document.visibilityState含義
visible頁面至少部分可見(非最小化、非背景分頁)
hidden頁面完全不可見(最小化、背景分頁、鎖屏)
prerender頁面正在預渲染(極少見)
unloaded頁面正在卸載(舊規範)

3. MediaDevices API (getUserMedia):攝影機/麥克風零插件存取

權限流程

  1. HTTPS 必須(localhost 例外)
  2. 調用 navigator.mediaDevices.getUserMedia(constraints)
  3. 瀏覽器彈出權限提示,用戶授權
  4. 回傳 MediaStream,接給 <video> 或 AudioContext

生產級封裝(含裝置選擇、錯誤處理、鏡像修正)

async function initCamera(videoEl, { facingMode = 'user', width = 1280, height = 720 } = {}) {
  try {
    const stream = await navigator.mediaDevices.getUserMedia({
      video: { facingMode, width: { ideal: width }, height: { ideal: height } },
      audio: false
    });
    videoEl.srcObject = stream;
    await videoEl.play();
    return stream;
  } catch (err) {
    const messages = {
      NotAllowedError: '用戶拒絕攝影機權限',
      NotFoundError: '找不到攝影機裝置',
      NotReadableError: '攝影機被其他應用佔用',
      OverconstrainedError: '裝置不支援指定解析度',
      SecurityError: '非安全上下文(需 HTTPS)'
    };
    throw new Error(messages[err.name] || err.message);
  }
}

// 列舉裝置供用戶選擇
async function listVideoInputs() {
  const devices = await navigator.mediaDevices.enumerateDevices();
  return devices.filter(d => d.kind === 'videoinput').map(d => ({
    deviceId: d.deviceId,
    label: d.label || `攝影機 ${d.deviceId.slice(0,4)}`,
    facing: /front|user/i.test(d.label) ? 'user' : 'environment'
  }));
}

// 鏡像修正(前置鏡頭預覽鏡像,錄製/截圖不鏡像)
function applyMirrorFix(videoEl, isFrontCamera) {
  videoEl.style.transform = isFrontCamera ? 'scaleX(-1)' : 'none';
}

4. Battery Status API:行動裝置電量感知

⚠️ 現狀:僅 Firefox/Chrome(已移除)/Safari(未實作)部分支援,生產環境請謹慎使用,視為漸進增強。

// 檢測支援度
if ('getBattery' in navigator) {
  navigator.getBattery().then(battery => {
    // 靜態資訊
    console.log('🔋 充電中:', battery.charging);        // boolean
    console.log('🔋 電量:', Math.round(battery.level * 100) + '%'); // 0.0-1.0
    console.log('🔋 剩餘秒數:', battery.dischargingTime); // 秒,充電時為 Infinity
    console.log('🔋 充滿秒數:', battery.chargingTime);     // 秒,滿電時為 0

    // 動態監聽
    battery.addEventListener('chargingchange', () => {
      console.log('充電狀態變更:', battery.charging ? '充電中' : '放電中');
      if (!battery.charging && battery.level < 0.2) enablePowerSaveMode();
    });
    battery.addEventListener('levelchange', () => {
      console.log('電量變更:', Math.round(battery.level * 100) + '%');
    });
  });
}

// 省電模式範例
function enablePowerSaveMode() {
  document.documentElement.classList.add('power-save');
  // CSS: .power-save * { animation: none !important; transition: none !important; }
  // JS: 停止輪詢、降低影片品質、暫停非關鍵 WebWorker
}

5. Link Prefetching / Preloading / Prerendering:資源預載入策略

類型語法用途優先級快取行為
DNS Prefetch<link rel="dns-prefetch" href="//cdn.example.com">提前解析跨域 DNS低無
Preconnect<link rel="preconnect" href="https://api.example.com">DNS + TCP + TLS 握手高無
Prefetch<link rel="prefetch" href="/next-page">下一頁 HTML/資源(低優先級,閒時)低HTTP 快取
Preload<link rel="preload" as="script" href="critical.js">當前頁關鍵資源(高優先級,立即)高Memory Cache → HTTP Cache
Prerender<link rel="prerender" href="/checkout">完整預渲染下一頁(極高資源消耗)最高獨立渲染器進程

實戰策略

<head>
  <!-- 關鍵第三方域名 -->
  <link rel="preconnect" href="https://fonts.googleapis.com" crossorigin>
  <link rel="preconnect" href="https://api.payment.com" crossorigin>

  <!-- 關鍵字體/腳本 -->
  <link rel="preload" as="font" type="font/woff2" href="/fonts/NotoSansTC.woff2" crossorigin>
  <link rel="preload" as="script" href="/js/app.critical.js">

  <!-- 預測用戶下一步 -->
  <link rel="prefetch" href="/dashboard">
  <link rel="prefetch" href="/pricing">
</head>

黃金法則: Preload 當前頁必需資源(LCP 圖片、關鍵 CSS/JS)、Prefetch 高機率下一頁、Preconnect 必連第三方域、Prerender 僅用於極高確定性轉換(如結帳流程)。

總結

這 5 個 API 覆蓋沉浸式體驗、生命週期感知、媒體裝置存取、硬體狀態感知、資源載入策略五大核心場景。它們不是「花俏功能」,而是構建專業級、體貼用戶、資源高效 Web 應用的基礎設施。建議建立團隊內部「Web API 速查卡」,新專案評估時檢視清單,該用原生 API 時堅決不引入第三方庫。

copyright © 萬盛學電腦網 all rights reserved