Path: blob/main/files/en-us/web/html/element/div/index.md
6529 views
------{{HTMLSidebar}}
The <div> HTML element is the generic container for flow content. It has no effect on the content or layout until styled in some way using {{glossary("CSS")}} (e.g. styling is directly applied to it, or some kind of layout model like Flexbox is applied to its parent element).
{{EmbedInteractiveExample("pages/tabbed/div.html","tabbed-standard")}}
As a "pure" container, the <div> element does not inherently represent anything. Instead, it's used to group content so it can be easily styled using the {{htmlattrxref("class")}} or {{htmlattrxref("id")}} attributes, marking a section of a document as being written in a different language (using the {{htmlattrxref("lang")}} attribute), and so on.
Attributes
This element includes the global attributes.
Note: The
alignattribute is obsolete; do not use it anymore. Instead, you should use CSS properties or techniques such as CSS Grid or CSS Flexbox to align and position<div>elements on the page.
Usage notes
The
<div>element should be used only when no other semantic element (such as {{HTMLElement("article")}} or {{HTMLElement("nav")}}) is appropriate.
Accessibility concerns
The <div> element has an implicit role of generic, and not none. This may affect certain ARIA combination declarations that expect a direct descendant element with a certain role to function properly.
Examples
A simple example
The result looks like this:
{{EmbedLiveSample("A_simple_example", 650, 60)}}
A styled example
This example creates a shadowed box by applying a style to the <div> using CSS. Note the use of the {{htmlattrxref("class")}} attribute on the <div> to apply the style named "shadowbox" to the element.
HTML
CSS
Result
{{EmbedLiveSample("A_styled_example", 650, 120)}}
Technical summary
| Content categories | Flow content, palpable content. |
|---|---|
| Permitted content |
Flow content. Or (in {{glossary("WHATWG")}} HTML): If the parent is a {{HTMLElement("dl")}} element: one or more {{HTMLElement("dt")}} elements followed by one or more {{HTMLElement("dd")}} elements, optionally intermixed with {{HTMLElement("script")}} and {{HTMLElement("template")}} elements. |
| Tag omission | {{no_tag_omission}} |
| Permitted parents |
Any element that accepts
flow content. Or (in {{glossary("WHATWG")}} HTML): {{HTMLElement("dl")}} element. |
| Implicit ARIA role | No corresponding role |
| Permitted ARIA roles | Any |
| DOM interface | {{domxref("HTMLDivElement")}} |
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
Semantic sectioning elements: {{HTMLElement("section")}}, {{HTMLElement("article")}}, {{HTMLElement("nav")}}, {{HTMLElement("header")}}, {{HTMLElement("footer")}}
{{HTMLElement("span")}} element for styling of phrasing content