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.
Content categoriesFlow content, sectioning content, palpable contentPermitted contentFlow content.Tag omissionNone, both the starting and ending tag are mandatory.Permitted parentsAny element that accepts flow content. Note that an <article>
element must not be a descendant of an <address>
element.Implicit ARIA rolearticle
Permitted ARIA rolesapplication
, document
, feed
, main
, none
, presentation
, region
DOM interfaceHTMLElement
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. Note that thepubdate
attribute of<time>
is no longer a part of the W3C HTML5 standard.
Examples
<article class="film_review">
<header>
<h2>Jurassic Park</h2>
</header>
<section class="main_review">
<p>Dinos were great!</p>
</section>
<section class="user_reviews">
<article class="user_review">
<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">
<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>