<embed> 是一個歷史悠久的元素,用於嵌入外部資源(如 PDF、Flash、音訊、視訊、SVG 等)。HTML5 將其標準化,但隨著 Web 技術演進,<embed> 已逐漸被更語意化、功能更強的原生元素取代。本文詳細說明其屬性、已知侷限,並提供現代最佳替代方案。
| 屬性 | 值 | 說明 |
|---|---|---|
src | URL | 嵌入資源的位址(必填) |
type | MIME 型別 | 資源類型,如 application/pdf、video/mp4、image/svg+xml。瀏覽器據此決定用何種外掛/原生播放器處理。 |
width / height | 像素或百分比 | 顯示區域寬高 |
alt (非標準) | 文字 | 部分瀏覽器支援作為替代文字,但無標準保證 |
getMedia.php?id=123)無副檔名,即便指定 type="audio/mpeg" 也無法播放。<video>/<audio> 有 controls 屬性,使用者無法暫停、調整音量、拖曳進度。onerror 等事件可供攔截處理。<embed> 成為攻擊向量。<track> 字幕、無鍵盤操作邏輯、螢幕閱讀器難以解讀。| 嵌入內容類型 | 推薦元素 | 關鍵優勢 |
|---|---|---|
| 視訊 (MP4, WebM, Ogg) | <video> | 原生控制列、字幕、多解析度切換、硬體加速、Media Session API 整合 |
| 音訊 (MP3, AAC, Ogg, WAV) | <audio> | 原生控制列、Web Audio API 串接、背景播放支援 |
| PDF 文件 | <iframe> 或 <object> | 可控制是否允許腳本、列印、下載;PDF.js 可純前端渲染 |
| SVG 向量圖 | 內嵌 <svg> 或 <img> | 可用 CSS/JS 操作內部節點、無額外請求、無障礙友善 |
| 互動式 3D/遊戲 | <canvas> + WebGL / WebGPU | 完全可程式化、高效能、支援 VR/AR (WebXR) |
| 外部網頁應用 | <iframe> + sandbox | 隔離安全上下文、可控權限、CSP 保護 |
<!-- 舊寫法:無控制列、無法指定多來源、無字幕 -->
<embed src="movie.mp4" type="video/mp4" width="640" height="360">
<!-- 新寫法:完整播放體驗 -->
<video width="640" height="360" controls preload="metadata" poster="poster.jpg">
<source src="movie.av1.mp4" type="video/mp4; codecs=av01.0.05M.08">
<source src="movie.hevc.mp4" type="video/mp4; codecs=hev1.1.6.L93.B0">
<source src="movie.mp4" type="video/mp4">
<source src="movie.webm" type="video/webm">
<track kind="subtitles" src="subtitles.vtt" srclang="zh-Hant" label="繁體中文" default>
您的瀏覽器不支援 HTML5 視訊播放。
</video>
<embed> 是 Web 早期外掛時代的遺物。現代 Web 開發應**優先使用語意化原生元素**(<video>, <audio>, <iframe>, <canvas>),並搭配 <source> 多格式回退、<track> 無障礙字幕、CSP 與 sandbox 安全策略,構建更安全、無障礙、效能更優的嵌入體驗。