# displayHeading

> Sets display typography for a landing headline.

```ts
import { displayHeading } from "@sdxc/ui/styles";
```

Sets display typography for a landing headline. Level 1 is the page H1, sized
fluidly from 42px to 72px (or `--ui-landing-display-max`) with leading that tightens
as it grows; level 2 is the band chapter at two thirds of that, so the H1:H2 ratio
holds at 1.5:1 at every width. Sizes read `cqi`, so a headline in a narrow column steps
down on its own.

## Signature

```ts
displayHeading<Node extends Element = Element>(level?: LandingDisplayLevel): MixinDescriptor<Node, [styles: CSSStyles], ElementProps>
```

Returns: A `css()` mixin ready for a heading's `mix` prop.

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `level?` | `LandingDisplayLevel` | Outline depth. Defaults to `1` (page H1). |

## Examples

```tsx
<h1 mix={[displayHeading()]}>{title}</h1>;
```

```tsx
<h2 mix={[displayHeading(2)]}>{chapter}</h2>;
```

## Used with it

The events, constants and types its module publishes, each imported from `@sdxc/ui/styles` too.

### LandingSectionSpacing

How much block padding a landing band leaves around its content.
`"hero"` is the first viewport, `"normal"` the repeating mid-page rhythm,
`"compact"` a tighter strip such as a proof row, `"cta"` a closing band.

#### Signature

```ts
type LandingSectionSpacing = "hero" | "normal" | "compact" | "cta"
```

One of `"hero"`, `"normal"`, `"compact"`, `"cta"`.

### LandingDisplayLevel

Outline depth displayHeading sizes for: `1` is the page H1,
`2` a section chapter, `3` a quieter in-band title.

#### Signature

```ts
type LandingDisplayLevel = 1 | 2 | 3
```

### LandingLeadStep

Which lead landingLead sizes: a band's, or the larger hero step.

#### Signature

```ts
type LandingLeadStep = "band" | "hero"
```

One of `"band"`, `"hero"`.

### LandingEyebrowVariant

How an eyebrow reads: `mono` a quiet uppercase label for section headers,
`quiet` a hairline pill for hero announcements, `soft` a filled muted pill,
`pill` the brand pill, `numbered` a brand-ringed pill led by its index.

#### Signature

```ts
type LandingEyebrowVariant = "mono" | "quiet" | "soft" | "pill" | "numbered"
```

One of `"mono"`, `"quiet"`, `"soft"`, `"pill"`, `"numbered"`.