萬盛學電腦網

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

HTML 代碼逐行翻譯解析:從結構到語意的實戰範例

實戰代碼片段

<div id="primary" class="content-area-404">
  <main id="main" class="site-main" role="main">
    <section class="error-404 not-found">
      <header class="page-header">
        <h1 class="page-title">404 - 頁面未找到</h1>
      </header>
      <div class="page-content">
        <p>抱歉,您尋找的頁面不存在。</p>
        <a href="/" class="button">返回首頁</a>
      </div>
    </section>
  </main>
</div>

逐行語意翻譯與解析

行號代碼語意翻譯關鍵點
1<div id="primary" class="content-area-404">主要內容容器,ID 唯一識別,類別用於 404 頁面樣式id=唯一、class=可複用、語意類別命名
2<main id="main" class="site-main" role="main">頁面主內容區標記,role="main" 強化無障礙地標HTML5 <main> 隱含 role=main,重複無害
3<section class="error-404 not-found">獨立內容區塊:404 錯誤頁面,雙類別便於 CSS 模組化<section> 需有標題,此處由 h1 提供
4<header class="page-header">區塊頭部區域,包含標題等介紹性內容非頁面級 header,屬於 section 內部
5<h1 class="page-title">404 - 頁面未找到</h1>頁面主標題,唯一 h1,對 SEO 與無障礙關鍵每頁僅一個 h1,內容描述頁面主旨
6</header>關閉 header 區塊配對閉合
7<div class="page-content">一般性內容容器,無特殊語意避免濫用 div,有語意優先用語意標籤
8<p>抱歉,您尋找的頁面不存在。</p>段落文字說明錯誤原因友善錯誤訊息,避免技術術語
9<a href="/" class="button">返回首頁</a>行動呼籲連結,回到網站根目錄class="button" 由 CSS 賦予按鈕外觀
10</div>關閉 page-content
11</section>關閉 error-404 區塊
12</main>關閉主內容區
13</div>關閉 primary 容器

語意化標籤對照表

標籤語意典型用途ARIA Role (隱含)
<header>頁面/區塊頭部Logo、導航、標題banner (頁面級)
<nav>導航連結群組主選單、麵包屑、分頁navigation
<main>文件主要內容文章、產品詳情、儀表板main
<section>主題性內容群組章節、標籤頁面板、FAQ 區塊region (需 aria-label)
<article>獨立完整內容部落格文、新聞、商品卡片article
<aside>側邊/輔助內容側邊欄、廣告、相關連結complementary
<footer>頁面/區塊底部版權、聯絡、站點地圖contentinfo (頁面級)
<div>無語意通用容器樣式掛載、JS 掛鉤、排版包裹無
<span>行內無語意容器文字片段樣式、圖示包裹無

無障礙增強屬性

  • role="main|navigation|search|dialog|alert...":補充語意(HTML5 標籤多已隱含)
  • aria-label="關閉選單":無可見文字時提供可存取名稱
  • aria-labelledby="id":引用其他元素作為標籤
  • aria-describedby="id":引用補充說明元素
  • aria-hidden="true":隱藏純裝飾內容不被螢幕閱讀器讀取

開發工具輔助翻譯

  • 瀏覽器 DevTools → Elements 面板:滑鼠懸停標籤顯示 ARIA 屬性、計算樣式
  • VS Code 擴充:HTMLHint、Web Accessibility 即時提示語意問題
  • W3C Validator:驗證 HTML 語法與語意正確性
copyright © 萬盛學電腦網 all rights reserved