<section>: The Generic Section element - HTML: HyperText Markup Language 编辑

The HTML <section> element represents a standalone section — which doesn't have a more specific semantic element to represent it — contained within an HTML document. Typically, but not always, sections have a heading.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

As an example, a navigation menu should be wrapped in a <nav> element, but a list of search results and a map display and its controls don't have specific elements, and could be put inside a <section>.

Note: If the contents of the element would make sense syndicated as a standalone piece, the <article> element may be a better choice.

Content categoriesFlow content, Sectioning content, palpable content.
Permitted contentFlow content.
Tag omissionNone, both the starting and ending tag are mandatory.
Permitted parentsAny element that accepts flow content. Note that a <section> element must not be a descendant of an <address> element.
Implicit ARIA roleregion if the element has an accessible name, otherwise no corresponding role
Permitted ARIA rolesalert, alertdialog, application, banner, complementary, contentinfo, dialog, document, feed, log, main, marquee, navigation, none, note, presentation, search, status, tabpanel
DOM interfaceHTMLElement

Attributes

This element only includes the global attributes.

Usage notes

  • Each <section> should be identified, typically by including a heading (<h1>-<h6> element) as a child of the <section> element.
  • If it makes sense to separately syndicate the content of a <section> element, use an <article> element instead.
  • Do not use the <section> element as a generic container; this is what <div> is for, especially when the sectioning is only for styling purposes. A rule of thumb is that a section should logically appear in the outline of a document.

Example

Before

<div>
  <h1>Heading</h1>
  <p>Bunch of awesome content</p>
</div>

After

<section>
  <h1>Heading</h1>
  <p>Bunch of awesome content</p>
</section>

Specifications

SpecificationStatusComment
HTML Living Standard
The definition of '<section>' in that specification.
Living Standard
HTML 5.1
The definition of '<section>' in that specification.
Recommendation
HTML5
The definition of '<section>' in that specification.
Recommendation

Browser compatibility

BCD tables only load in the browser

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

See also

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。
列表为空,暂无数据

词条统计

浏览:76 次

字数:9632

最后编辑:7年前

编辑次数:0 次

    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文