Skip to content

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.

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.

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5
Heading 6

Regular text

Code Editor
<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

Heading 1 (default size 'xx-large')

Heading 1 style 'x-large'

Heading 1 style small

Code Editor
<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):

Heading style x-large (using 'size')

Heading style x-large (using <small>)

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

Heading styles in vanilla HTML

Heading style xx-large

Heading style x-large

Heading style large

Heading style small

Heading style basis

Additional Heading modifiers

.dnb-h--xx-large small

.dnb-h--x-large small

.dnb-h--large small

.dnb-h--medium small

.dnb-lead small

Example of margin collapsing

Only the largest margin takes effect.

Spacing with bottom margin: small

Spacing with top margin: large

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