来源:html5doctor.com/avoiding-common-html5-mistakes/ by Richard Clark

译文:www.ued163.com/1820/译文避免常见的六种html5错误用法/ by 小易

本文根据原文对译文做了简单的一些修改,增加了一些可能引起误解的英文原文。

一、不要使用section代替div

人们在标签使用中最常见到的错误之一就是随意将HTML5的<section>等价于<div>——具体地说,就是直接用作替代品(用于样式)。在XHTML或者HTML4中,我们常看到这样的代码:

<!-- HTML 4-style code -->
<div id="wrapper">
    <div id="header">  
        <h1>My super duper page</h1>
        <!-- Header content -->
    </div>
    <div id="main">
        <!-- Page content -->
    </div>
    <div id="secondary">
        <!-- Secondary content -->
    </div>
    <div id="footer">
        <!-- Footer content -->
    </div>
</div>

而现在在HTML5 中,会是这样:

<!-​​- 请不要复制这些代码!这是错误的!-->
<section id="wrapper">
    <header>  
        <h1>My super duper page</h1>
        <!-- Header content -->
    </header>
    <section id="main">
        <!-- Page content -->
    </section>
    <section id="secondary">
        <!-- Secondary content -->
    </section>
    <footer>
        <!-- Footer content -->
    </footer>
</section>

这样使用并不正确:<section>并不是样式容器[wrapper]。<section>元素表示的是内容中用来帮助构建文档概要的语义部分。它应该包含一个头部[heading]。如果你想找一个用作页面容器的元素(就像HTML或者XHTML的风格),那么考虑如Kroc Camen所说,直接把样式写到body元素上吧。如果你仍然需要额外的样式容器,还是继续使用div吧。

基于上述思想,下面才是正确的使用HTML5和一些ARIA roles特性的例子(注意,根据你自己的设计,你也可能需要加入div)

<body>
    <header>  
        <h1>My super duper page</h1>
        <!-- Header content -->
    </header>
    <div role="main">
        <!-- Page content -->
    </div>
    <aside role="complementary">
        <!-- Secondary content -->
    </aside>
    <footer>
        <!-- Footer content -->
    </footer>
</body>

如果你还是无法确定使用哪种元素,那么我建议你参考HTML5 sectioning content element flowchart

二、只在需要的时候使用header和hgroup

写不需要写的标签当然是毫无意义的。不幸的是,我经常看到<header>和<hgroup>被无意义的滥用。你可以阅读一下关于<header><hgroup>元素的两篇文章做一个详细的了解,其中内容简单总结如下:

  • <header>元素表示的是一组介绍性或者导航性质的辅助文字,经常用作section的头部。
  • 当头部有多层结构时,比如有子头部,副标题,各种标识文字等,使用<hgroup>将h1-h6元素组合起来作为section的头部。

<header>

由于header可以在一个文档中使用多次,可能使得这样代码风格受到欢迎:

<!-​​- 请不要复制这段代码!此处并不需要header -->
<article>
    <header>  
        <h1>My best blog post</h1>
    </header>
    <!-- Article content -->
</article>

如果你的<header>元素只包含一个头部元素,那么丢弃<header>元素吧。既然<article> 元素已经保证了头部会出现在文档概要中,而<header>又不能包含多个元素(如上文所定义的),那么为什么要写多余的代码。简单点写成这样就行了:

<article>  
    <h1>My best blog post</h1>
    <!-- Article content -->
</article>

<hgroup>的错误使用

在headers这个主题上,我也经常看到hgroup的错误使用。有时候不应该同时使用<hgroup>和<header>:

  • 如果只有一个子头部
  • 如果hgroup自己就能工作的很好。

第一个问题一般是这样的:

<!-​​- 请不要复制这段代码!此处不需要hgroup -->
<header>
    <hgroup>
        <h1>My best blog post</h1>
    </hgroup>
    <p>by Rich Clark</p>
</header>

此例中,直接拿掉hgroup,让heading 裸奔吧。

<header>
    <h1>My best blog post</h1>
    <p>by Rich Clark</p>
</header>

第二个问题是另一个不必要的例子:

<!-​​- 请不要复制这段代码!此处不需要header -->
<header>
    <hgroup>
        <h1>My company</h1>
        <h2>Established 1893</h2>
    </hgroup>
</header>

如果<header>唯一的子元素是<hgroup>,那还要<header>干神马?如果<header>中没有其他的元素(比如多个<hgroup>),还是直接拿掉<header>吧。

<hgroup>
  <h1>My company</h1>
  <h2>Established 1893</h2>
</hgroup>

关于

更多的例子和解释,请参阅相关文章

三、不要把所有列表式的链接放在nav里

随着HTML5引入了30个新元素(截止到原文发布时),我们在构造语义化和结构化的标签时的选择也变得有些不慎重。也就是说,我们不应该滥用超语义化的元素。不幸的是,nav就是这样一个被滥用的例子。nav元素的规范描述如下:

The nav element represents a section of a page that links to other pages or to parts within the page: a section with navigation links.

Not all groups of links on a page need to be in a nav element — the element is primarily intended for sections that consist of major navigation blocks. In particular, it is common for footers to have a short list of links to various pages of a site, such as the terms of service, the home page, and a copyright page. The footer element alone is sufficient for such cases; while a nav element can be used in such cases, it is usually unnecessary.

User agents (such as screen readers) that are targeted at users who can benefit from navigation information being omitted in the initial rendering, or who can benefit from navigation information being immediately available, can use this element as a way to determine what content on the page to initially skip or provide on request (or both).

nav元素表示页面中链接到其他页面或者本页面其他部分的区块;包含导航连接的区块。

注意:不是所有页面上的链接都需要放在nav元素中——这个元素本意是用作主要的导航区块。举个具体的例子,在footer中经常会有众多的链接,比如服务条款,主页,版权声明页等等。footer元素自身已经足以应付这些情况,虽然nav元素也可以用在这里,但通常我们认为是不必要的。

WHATWG HTML spec

关键的词语是“主要的”导航。当然我们可以互相喷上一整天什么叫做“主要的”。而我个人是这样定义的:

  • 主要的导航(Primary navigation)
  • 站内搜索(Site search)
  • 二级导航(略有争议)(Secondary navigation (arguably))
  • 页面内导航(比如很长的文章)(In-page navigation (within a long article, for example))

既然并没有绝对的对错,所以根据一个非正式投票以及我自己的解释,以下的情况,不管你放不放,我反正不放在<nav>中:

  • 分页控制(Pagination controls)
  • 社交链接(虽然有些社交链接也是主要导航,比如“关于”“收藏”)(Social links (although there may be exceptions where social links are the major navigation, in sites like About me or Flavours, for example))
  • 博客文章的标签(Tags on a blog post)
  • 一篇博客中的博客分类(Categories on a blog post)
  • 三级导航(Tertiary navigation)
  • 过长的footer(Fat footers)

如果你不确定是否要将一系列的链接放在<nav>中,问你自己:“它是主要的导航吗?”为了帮助你回答这个问题,考虑以下首要原则:

  • 如果使用<section>和<hx>也同样合适,那么不要用<nav> — Hixie on IRC
  • 为了方便访问,你会在某个“快捷跳转”中给这个<nav>标签加一个链接吗?

如果这些问题的答案是“不”,那就跟<nav>鞠个躬,然后独自离开吧。

四、figure元素的常见错误

<figure>以及<figcaption>的正确使用,确实是难以驾驭。让我们来看看一些常见的错误。

不是所有的图片都是<figure>上文中

我曾告诉各位不要写不必要的代码。这个错误也是同样的道理。我看到很多网站把所有的图片都写作figure。看在图片的份上请不要给它加额外的标签了。你只是让你自己蛋疼,而并不能使你的页面内容更清晰。

规范中将<figure>描述为“一些流动的内容,有时候会有包含于自身的标题说明。一般在文档流中会作为独立的单元引用。”这正是figure的美妙之处——它可以从主内容页移动到sidebar中,而不影响文档流。这些问题也包含在之前提到的HTML5 element flowchart中。

如果纯粹只是为了呈现的图,也不在文档其他地方引用,那就绝对不是

。其他视情况而定,但一开始可以问自己:“这个图片是否必须和上下文有关?”如果不是,那可能也不是
(也许是个