---
title: "Article"
description: "A readable page body with an optional title and standfirst."
category: "Layout & Navigation"
slug: article
url: /components/article
since: "0.2.0"
status: "stable"
---

# Article

A readable page body with an optional title and standfirst.

## Import

```svelte
import { Article } from '@elluzion/iv-ui';
```

## Preview

Headings, paragraphs, lists, and code receive the typeset automatically.

```svelte
<script lang="ts">
	import { Article } from '@elluzion/iv-ui';
</script>

<Article title="Release notes" description="What changed in the console this week.">
	<p>
		The focus ring now follows the keyboard on every overlay. Dialogs open with a short scale, and
		the entry animation is skipped when reduced motion is requested.
	</p>
	<h2>Fixes</h2>
	<ul>
		<li>Select keeps the active option visible while filtering.</li>
		<li>Toast timers no longer close a newer message.</li>
	</ul>
	<pre><code>showToast('Deployed to production', 'success');</code></pre>
</Article>
```

## Usage

- Body content is wrapped in `iv-prose`, so plain HTML inherits the typeset.
- `title` and `description` render a centered header with a hairline rule.
- `maxWidth` narrows the body measure; the default is 880px.

## Examples

### Measure

`maxWidth` tightens the reading column without touching the header.

```svelte
<script lang="ts">
	import { Article } from '@elluzion/iv-ui';
</script>

<Article
	title="A narrow measure"
	description="520px keeps the line length comfortable."
	maxWidth={520}
>
	<p>
		The body column is narrowed independently of the header. Use it for release notes,
		documentation, or any surface that is mostly prose. Headings, lists, and code keep the same
		typeset.
	</p>
	<p>Short lines are easier to scan; long lines lose the reader between returns.</p>
</Article>
```

### Props

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `title` | `string` | `''` | Article heading. |
| `description` | `string` | `''` | Standfirst shown below the heading. |
| `maxWidth` | `number` | `880` | Maximum measure in pixels. |
| `className` | `string` | `''` | Extra classes merged onto the root element. |

`class`, `id`, `style`, `aria-*`, and `data-*` are forwarded through rest props.

### Snippets

| Snippet | Type | Description |
| --- | --- | --- |
| `children` | `Snippet` | Content rendered inside the component. |

### Tokens used

`--iv_article-width` · `--iv_border` · `--iv_font-sans` · `--iv_foreground` · `--iv_foreground-dim` · `--iv_leading-heading` · `--iv_leading-prose` · `--iv_spacing-2xl` · `--iv_spacing-sm` · `--iv_text-label` · `--iv_text-xl` · `--iv_tracking-tight` · `--iv_weight-bold`

See the [token reference](/foundations/tokens.md) for values.

### CSS hooks

`.iv-article` · `.iv-body` · `.iv-description` · `.iv-header` · `.iv-title`

## Accessibility

- The component renders a semantic `<article>` element.
- Keep heading levels in order inside the body; `title` renders an `h1`.
- Links and code inside the body keep the prose focus and contrast treatment.

## Related

- [Card](/components/card.md)
- [Tabs](/components/tabs.md)
- [Accordion](/components/accordion.md)
- [Separator](/components/separator.md)