<article>: The Article Contents element
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The <article>
HTML element represents a self-contained composition in a document, page, application, or site, which is intended to be independently distributable or reusable (e.g., in syndication). Examples include: a forum post, a magazine or newspaper article, or a blog entry, a product card, a user-submitted comment, an interactive widget or gadget, or any other independent item of content.
Try it
A given document can have multiple articles in it; for example, on a blog that shows the text of each article one after another as the reader scrolls, each post would be contained in an <article>
element, possibly with one or more <section>
s within.
Attributes
This element only includes the global attributes.
Usage notes
- Each
<article>
should be identified, typically by including a heading (<h1>
-<h6>
element) as a child of the<article>
element. - When an
<article>
element is nested, the inner element represents an article related to the outer element. For example, the comments of a blog post can be<article>
elements nested in the<article>
representing the blog post. - Author information of an
<article>
element can be provided through the<address>
element, but it doesn't apply to nested<article>
elements. - The publication date and time of an
<article>
element can be described using thedatetime
attribute of a<time>
element.
Examples
Result
Technical summary
Content categories | Flow content, sectioning content, palpable content |
---|---|
Permitted content | Flow content. |
Tag omission | None, both the starting and ending tag are mandatory. |
Permitted parents |
Any element that accepts
flow content. Note that an <article> element must not be a
descendant of an <address> element.
|
Implicit ARIA role |
article
|
Permitted ARIA roles |
application , document ,
feed , main ,
none , presentation ,
region
|
DOM interface | HTMLElement |
Specifications
Specification |
---|
HTML # the-article-element |