<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
<article class="film_review">
<h2>Jurassic Park</h2>
<section class="main_review">
<h3>Review</h3>
<p>Dinos were great!</p>
</section>
<section class="user_reviews">
<h3>User reviews</h3>
<article class="user_review">
<h4>Too scary!</h4>
<p>Way too scary for me.</p>
<footer>
<p>
Posted on
<time datetime="2015-05-16 19:00">May 16</time>
by Lisa.
</p>
</footer>
</article>
<article class="user_review">
<h4>Love the dinos!</h4>
<p>I agree, dinos are my favorite.</p>
<footer>
<p>
Posted on
<time datetime="2015-05-17 19:00">May 17</time>
by Tom.
</p>
</footer>
</article>
</section>
<footer>
<p>
Posted on
<time datetime="2015-05-15 19:00">May 15</time>
by Staff.
</p>
</footer>
</article>
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 Standard # the-article-element |