Heading

A title for a page or a section.

The quick brown fox jumps over the lazy dog

Usage

Code
import { Heading } from '@leverui/components';
Code
<Heading>Account settings</Heading>

Examples

Sizes

Use the size prop to change the size of the heading component.

Heading (sm)

Heading (md)

Heading (lg)

Heading (xl)

Heading (2xl)

Heading (3xl)

Heading (4xl)

Heading (5xl)

Heading (6xl)

Highlight

Compose the Heading component with the Highlight component to highlight text.

Build Solid apps that everyone can use

Lever UI gives you ready-made components that work with a keyboard, a mouse and a screen reader.

As another element

Use the as prop to render the heading as another HTML element.

Level 1

Level 2

Level 3

Weights

Use the style prop with a font-weight value to change the weight of the heading component.

Normal

Medium

Semibold

Bold

Composition

Use the Heading component to compose other components.

Invoices for small shops

Send an invoice in a minute and see at a glance who has paid.

Guides

Semantic levels

Renders an h2 by default. size changes the look, not the heading level. Set as="h1" through as="h6" to fit your page structure. Native attributes and the ref go to that element. With asChild, your element keeps its own meaning, so use a real heading tag for a heading.

Responsive sizes

Pass an object keyed by breakpoint name, or an array of sizes in breakpoint order. Lever UI adds data-size-sm, data-size-md, data-size-lg, data-size-xl, and data-size-2xl for the breakpoints you set. The stylesheet applies them at 480, 768, 1024, 1280, and 1536 pixels.

Code
<Heading size={{ base: 'lg', md: '2xl', xl: '4xl' }}>Responsive title</Heading>

Without base, the heading inherits its font size below the first breakpoint you set. Large sizes set a letter spacing, and a smaller size at a later breakpoint does not remove it. Set your own in CSS if you need to.

Shared defaults

HeadingPropsProvider sets default props for the headings inside it. A prop on a heading wins.

Code
import { Heading, HeadingPropsProvider } from '@leverui/components';

<HeadingPropsProvider value={{ size: '2xl' }}>
  <Heading>Uses the provider size</Heading>
  <Heading size="sm">Keeps its own size</Heading>
</HeadingPropsProvider>;

Customization

Your plain CSS overrides the heading styles without !important. Target .leverui-heading and the data-size attribute. If you override the font size, also set the line height and the letter spacing.

Changing default styles

Code
.leverui-heading {
  font-weight: var(--leverui-font-weights-normal);
  font-size: var(--leverui-font-sizes-4xl);
  line-height: 2.5rem;
}

Changing heading font globally

Set --leverui-fonts-heading in your theme.

Code
:root {
  --leverui-fonts-heading: 'Playfair Display', serif;
}

Adding a new size

size takes a fixed set of values. For your own size, write a class.

Code
.heading-custom {
  font-size: 100px;
  line-height: 100px;
  letter-spacing: -2px;
}
Code
<Heading class="heading-custom">Extra large title</Heading>

The CSS theme guide lists what you can override.

Props

PropDefaultTypeDescription
size'xl''xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl' | '7xl'Heading text size.
ash2Native HTML tagHTML tag to render.
asChild—Solid render functionRender your own element with the heading's props.
unstyled—booleanTurn off the default styles. The element stays the same.