完整解釋
白話:src 要從這份 HTML 的位置找到圖;alt 是圖看不到時要交付的文字資訊。
正式說法:img src 是可解析 URL;alt 是圖像替代文字,其內容取決於圖像在文件中的功能與資訊。
何時使用:每張 img;相對路徑搬動檔案夾層級後尤其要重驗。
修改前後:Before:src 指向不存在檔案,alt 只寫 hero.jpg。After:圖載入且 alt 交付等價意思。
常見混淆:alt 不是圖片 caption,也不是關鍵字清單;純裝飾圖通常用 alt=""。
名詞與最小範例
img、alt 與圖片相對路徑 Image source, alternative text, and relative URL
- 白話
- src 要從這份 HTML 的位置找到圖;alt 是圖看不到時要交付的文字資訊。
- 正式定義
- img src 是可解析 URL;alt 是圖像替代文字,其內容取決於圖像在文件中的功能與資訊。
- 何時使用
- 每張 img;相對路徑搬動檔案夾層級後尤其要重驗。
- 最小範例
- `<img src="./images/team.svg" alt="兩位顧問在白板前整理網站內容">`。
- 驗收證據
- loaded=true、currentSrc 可解析、naturalWidth>0、alt 符合用途
- 常混淆
- alt 不是圖片 caption,也不是關鍵字清單;純裝飾圖通常用 alt=""。
Micro Lab|img、alt 與圖片相對路徑
情境:首頁 hero 破圖,語音只讀出 hero-final.svg。
起始狀態:img src 指向 missing.svg,alt 是檔名。
- 將 img 切到可載入的本地 data image,設定用途導向 alt,讀取 complete/currentSrc/naturalWidth。
- 執行下方操作,觀察獨立的 DOM 與資料狀態。
- 依證據欄位重新驗收。
目前主題:img、alt 與圖片相對路徑
預期:image.complete=true、naturalWidth>0、currentSrc 為本地 fixture,alt 非檔名且說明圖片用途。
證據:loaded=true、currentSrc 可解析、naturalWidth>0、alt 符合用途
第一個檢查:先看 Network/currentSrc 找路徑,圖成功載入後再審 alt。
重設:重設回 missing src 與檔名 alt。
卡住時
- 症狀:currentSrc 有值,但 naturalWidth=0。
可能原因:URL 已解析但資源不存在或無法解碼。
先檢查:在 Network 打開該 currentSrc 的 status/response。
修正:修正相對路徑或換成可解碼的圖片檔。
本模組官方來源:MDN|The Image Embed element