#Import

import { Heading } from '@dnb/eufemia/components'
import { H1, H2, H3, H4, H5, H6 } from '@dnb/eufemia/elements'

#Description

Eufemia comes with three levels of heading styles:

• .dnb-h--xx-large (Heading xx-large)
• .dnb-h--x-large (Heading x-large)
• .dnb-h--large (Heading large)

Additional, you can use these style modifiers if needed:

• .dnb-h--medium
• .dnb-h--basis
• .dnb-h--small
• .dnb-h--x-small

Optional, you could use .dnb-lead (equivalent to .dnb-h--medium) to style a heading as well. But only if that would make sense in the particular context.

The sizes are aligned to the font-size definitions.

#Relevant links

• Source code
• Docs code

#Think semantics first

You should think semantics first once you choose what level of heading you use. Always try to start with an <h1>. When the heading levels are properly defined, you can go ahead and define the sizes (styles).

If you have to use a paragraph (<p>) or a arbitrary heading, and it has to look like a specific heading, you can use these classes:

• .dnb-h--xx-large
• .dnb-h--x-large
• .dnb-h--large
• etc.

Read more about best practices for typography.

#Automated heading levels

There is also Heading, a component to create automated semantic headings within a boundary of some rules.

import { Heading } from '@dnb/eufemia/components'

#Heading styles in React

import { H1, H2, ... } from '@dnb/eufemia'

#Demos

#The most basic use of headings

Just using the H1, H2, etc. components will give you the basic headings.

<H1>Heading 1</H1>
<H2>Heading 2</H2>
<H3>Heading 3</H3>
<H4>Heading 4</H4>
<H5>Heading 5</H5>
<H6>Heading 6</H6>
<P>Regular text</P>

#Heading typography using React JSX

The visual size of a heading can be customized using the size property with values: xx-large | x-large | large | medium | basis | small | x-small

<H1>Heading 1 (default size 'xx-large')</H1>
<H1 size="x-large">Heading 1 style 'x-large'</H1>
<H1 size="small">Heading 1 style small</H1>

By using the <small> element, we decrease the size one level (default size is xx-large):

<H1 size="x-large">Heading style x-large (using 'size')</H1>
<H1>
  <small>Heading style x-large (using &lt;small&gt;)</small>
</H1>

#Prose max width

The proseMaxWidth prop allows you to limit the width of heading text based on character count, creating optimal reading line lengths:

<H2>
  This is a regular heading without any width constraints. It will extend
  to the full width of its container.
</H2>
<H2 proseMaxWidth={40}>
  This heading uses proseMaxWidth={40} to limit its width to
  approximately 40 characters.
</H2>
<H2 proseMaxWidth={20}>
  This heading uses proseMaxWidth={20} for an even narrower reading
  width.
</H2>
<H2 proseMaxWidth>
  This heading uses proseMaxWidth with its default value.
</H2>

#Heading styles in vanilla HTML

#Additional Heading modifiers

#Example of margin collapsing

Only the largest margin takes effect.

<H1 size="small" top bottom="small">
  Spacing with bottom margin: small
</H1>
<P top="large" bottom="small">
  Spacing with top margin: large
</P>