1. 程式人生 > 其它 >HTML (017) HTML5 程式碼規範

HTML (017) HTML5 程式碼規範

一、使用正確的文件型別

文件型別宣告位於HTML文件的第一行:

    <!DOCTYPE html>

如果你想跟其他標籤一樣使用小寫,可以使用以下程式碼:

    <!doctype html>

二、使用小寫元素名

HTML5 元素名可以使用大寫和小寫字母。

推薦使用小寫字母:

  • 混合了大小寫的風格是非常糟糕的。
  • 開發人員通常使用小寫 (類似 XHTML)。
  • 小寫風格看起來更加清爽。
  • 小寫字母容易編寫。

不推薦:

    <SECTION>
    <p>這是一個段落。</p>
    </SECTION>

非常糟糕:

    <Section>
    <p>這是一個段落。</p>
    </SECTION>

推薦:

    <section>
    <p>這是一個段落。</p>
    </section>

三、關閉所有 HTML 元素

在 HTML5 中, 你不一定要關閉所有元素 (例如

元素),但我們建議每個元素都要新增關閉標籤。

不推薦:

    <section>
    <p>這是一個段落。
    <p>這是一個段落。
    </section>

推薦:

    <section>
    <p>這是一個段落。</p>
    <p>這是一個段落。</p>
    </section>

四、關閉空的 HTML 元素

在 HTML5 中, 空的 HTML 元素也不一定要關閉:

我們可以這麼寫:

    

也可以這麼寫:

    

在 XHTML 和 XML 中斜線 (/) 是必須的。

如果你期望 XML 軟體使用你的頁面,使用這種風格是非常好的。

五、使用小寫屬性名

HTML5 屬性名允許使用大寫和小寫字母。

我們推薦使用小寫字母屬性名:

  • 同時使用大小寫是非常不好的習慣。
  • 開發人員通常使用小寫 (類似 XHTML)。
  • 小寫風格看起來更加清爽。
  • 小寫字母容易編寫。

不推薦:

    <div CLASS="menu">

推薦:

    <div class="menu">

六、屬性值

HTML5 屬性值可以不用引號。

屬性值我們推薦使用引號:

  • 如果屬性值含有空格需要使用引號。
  • 混合風格不推薦的,建議統一風格。
  • 屬性值使用引號易於閱讀。

以下例項屬性值包含空格,沒有使用引號,所以不能起作用:

    <table class=table striped>

以下使用了雙引號,是正確的:

    <table class="table striped">

七、圖片屬性

圖片通常使用 alt 屬性。 在圖片不能顯示時,它能替代圖片顯示。

    <img src="html5.gif" alt="HTML5">

定義好圖片的尺寸,在載入時可以預留指定空間,減少閃爍。

    <img src="html5.gif" alt="HTML5" style="width:128px;height:128px">

八、空格和等號

等號前後可以使用空格。

    <link rel = "stylesheet" href = "styles.css">

但我們推薦少用空格:

    <link rel="stylesheet" href="styles.css">

九、避免一行程式碼過長

使用 HTML 編輯器,左右滾動程式碼是不方便的。

每行程式碼儘量少於 80 個字元。

十、空行和縮排

不要無緣無故新增空行。為每個邏輯功能塊新增空行,這樣更易於閱讀。

縮排使用兩個空格,不建議使用 TAB。比較短的程式碼間不要使用不必要的空行和縮排。

不必要的空行和縮排:

    <body>
    <h1>菜鳥教程</h1>
    <h2>HTML</h2>
    <p>
        菜鳥教程,學的不僅是技術,更是夢想。
        菜鳥教程,學的不僅是技術,更是夢想。
       菜鳥教程,學的不僅是技術,更是夢想,
        菜鳥教程,學的不僅是技術,更是夢想。
    </p>
    </body>

推薦:

    <body>
    <h1>菜鳥教程</h1>
    <h2></h2>
    <p>菜鳥教程,學的不僅是技術,更是夢想。
    菜鳥教程,學的不僅是技術,更是夢想。
    菜鳥教程,學的不僅是技術,更是夢想。
    菜鳥教程,學的不僅是技術,更是夢想。</p>
    </body>

表格例項:

    <table>
    <tr>
    <th>Name</th>
    <th>Description</th>
    </tr>
    <tr>
    <td>A</td>
    <td>Description of A</td>
    </tr>
    <tr>
    <td>B</td>
    <td>Description of B</td>
    </tr>
    </table>

列表例項:

    <ol>
    <li>London</li>
    <li>Paris</li>
    <li>Tokyo</li>
    </ol>

十一、省略 和 ?

在標準 HTML5 中, 和 標籤是可以省略的。

以下 HTML5 文件是正確的:

    <!DOCTYPE html>
    <head>
    <title>頁面標題</title>
    </head>
    <h1>這是一個標題</h1>
    <p>這是一個段落。</p>

嘗試一下 »

不推薦省略 和 標籤。

元素是文件的根元素,用於描述頁面的語言: ```html ``` 宣告語言是為了方便螢幕閱讀器及搜尋引擎。

省略 或 在 DOM 和 XML 軟體中會崩潰。

省略 在舊版瀏覽器 (IE9)會發生錯誤。

十二、省略 ?

在標準 HTML5 中, 標籤是可以省略的。

預設情況下,瀏覽器會將 之前的內容新增到一個預設的 元素上。

    <!DOCTYPE html>
    <html>
    <title>頁面標題</title>
    <body>
    <h1>這是一個標題</h1>
    <p>這是一個段落。</p>
    </body>
    </html>

嘗試一下 »

注意:現在省略 head 標籤還不推薦使用。

十三、元資料

HTML5 中

元素是必須的,標題名描述了頁面的主題:</p> <pre><code class="language-html"> <title>菜鳥教程</title> 標題和語言可以讓搜尋引擎很快了解你頁面的主題: <!DOCTYPE html> <html lang="zh"> <head> <title>菜鳥教程</title> </head> </code></pre> <h2 id="十四html-註釋">十四、HTML 註釋</h2> <p>註釋可以寫在 <!-- 和 --> 中:</p> <pre><code class="language-html"> <!-- 這是註釋 --> </code></pre> <p>比較長的評論可以在 <!-- 和 --> 中分行寫:</p> <pre><code class="language-html"> <!-- 這是一個較長評論。 這是 一個較長評論。這是一個較長評論。 這是 一個較長評論 這是一個較長評論。 這是 一個較長評論。 --> </code></pre> <p>長評論第一個字元縮排兩個空格,更易於閱讀。</p> <h2 id="十五樣式表">十五、樣式表</h2> <p>樣式表使用簡潔的語法格式 ( type 屬性不是必須的):</p> <pre><code class="language-html"> <link rel="stylesheet" href="styles.css"> </code></pre> <p>短的規則可以寫成一行:</p> <pre><code class="language-html"> p.into {font-family: Verdana; font-size: 16em;} </code></pre> <p>長的規則可以寫成多行:</p> <pre><code class="language-html"> body { background-color: lightgrey; font-family: "Arial Black", Helvetica, sans-serif; font-size: 16em; color: black; } </code></pre> <ul> <li>將左花括號與選擇器放在同一行。</li> <li>左花括號與選擇器間新增一個空格。</li> <li>使用兩個空格來縮排。</li> <li>冒號與屬性值之間新增一個空格。</li> <li>逗號和符號之後使用一個空格。</li> <li>每個屬性與值結尾都要使用分號。</li> <li>只有屬性值包含空格時才使用引號。</li> <li>右花括號放在新的一行。</li> <li>每行最多 80 個字元。</li> </ul> <p>注意:在逗號和冒號後新增空格是常用的一個規則。</p> <h2 id="十六在-html-中載入-javascript">十六、在 HTML 中載入 JavaScript</h2> <p>使用簡潔的語法來載入外部的指令碼檔案 ( type 屬性不是必須的 ):</p> <pre><code class="language-html"> <script src="myscript.js"> </code></pre> <h2 id="十七使用-javascript-訪問-html-元素">十七、使用 JavaScript 訪問 HTML 元素</h2> <p>一個糟糕的 HTML 格式可能會導致 JavaScript 執行錯誤。</p> <p>以下兩個 JavaScript 語句會輸出不同結果:</p> <pre><code class="language-html"> var obj = getElementById("Demo") var obj = getElementById("demo") </code></pre> <p><a href="https://www.runoob.com/try/try.php?filename=tryhtml_syntax_javascript" target="_blank">嘗試一下<br> »</a></p> <p>HTML 中 JavaScript 儘量使用相同的命名規則。</p> <p><a href="https://www.runoob.com/js/js-conventions.html" target="_blank">訪問 JavaScript 程式碼規範</a>。</p> <h2 id="十八使用小寫檔名">十八、使用小寫檔名</h2> <p>大多 Web 伺服器 (Apache, Unix) 對大小寫敏感: london.jpg 不能通過 London.jpg 訪問。</p> <p>其他 Web 伺服器 (Microsoft, IIS) 對大小寫不敏感: london.jpg 可以通過 London.jpg 或 london.jpg<br> 訪問。</p> <p>你必須保持統一的風格,我們建議統一使用小寫的檔名。</p> <h2 id="十九副檔名">十九、副檔名</h2> <ul> <li>HTML 檔案字尾可以是 <strong>.html</strong> (或 <strong>.htm</strong> )。</li> <li>CSS 檔案字尾是 <strong>.css</strong> 。</li> <li>JavaScript 檔案字尾是 <strong>.js</strong> 。</li> </ul>