Marigold
v18.0.0-beta.3
Marigold
v18.0.0-beta.3

Application

MarigoldProvider
RouterProvider

Layout

AppShellbeta
Aside
Aspect
Center
Columns
Container
Grid
Inline
Inset
Pagebeta
Panelbeta
Scrollable
Split
Stack
Tiles

Actions

Buttonupdated
ButtonGroupbeta
Link
LinkButton
ToggleButtonbeta

Form

Autocomplete
Calendar
Checkbox
ComboBox
DateField
DatePicker
DateRangePickerbeta
FileField
Form
NumberField
Radio
RangeCalendaralpha
SearchField
SegmentedControlbeta
Select
SelectListupdated
Slider
Switchupdated
TagFieldbeta
TextArea
TextField
TimeField

Collection

Cardupdated
Table
Tag
ActionBaralpha

Navigation

Accordion
Breadcrumbs
Pagination
Sidebarbeta
Tabs
TopNavigationbeta

Overlay

ActionMenualpha
ContextualHelp
Dialog
Drawer
Menuupdated
Toastbeta
Tooltip

Content

Badge
Descriptionalpha
Divider
EmptyStatebeta
Headline
Keyboardbeta
List
Loader
SectionMessage
SVG
Text
TextValuealpha
Titlealpha

Formatters

DateFormat
NumericFormat

Hooks and Utils

cn
cva
extendTheme
parseFormData
useAsyncListData
useLandmark
useListData
useResponsiveValueupdated
useTheme
VisuallyHidden
Components

Headline

The title of a content section

The <Headline> component is used to create headings for different sections of content. It is a versatile component that can be styled and structured to fit various design needs while maintaining semantic HTML structure for accessibility and SEO.

Anatomy

A <Headline> component typically consists of a headline element (like <h1>, <h2>, etc.) that serves as the title for a section of content.

Appearance

The appearance of a component can be customized using the variant and size props. These props adjust the visual style and dimensions of the component, available values are based on the active theme.

The selected theme does not has any options for"variant".

Your Tickets for Summer Festival 2025

PropertyTypeDescription
variant-The available variants of this component.
sizelevel-1 | level-2 | level-3 | level-4 | level-5 | level-6The available sizes of this component.

Usage

You should use a <Headline> when introducing a new section or page, establishing a clear visual hierarchy, or structuring content with proper semantic headlines like <h1> to <h6>. It helps guide the reader, improves accessibility for screen readers, and ensures consistent styling across the application. Use it whenever a piece of text needs to stand out as a title or headline within your layout.

Your Tickets for Summer Festival 2025

Below you’ll find all your purchased tickets and event details. Please present your QR code at the entrance. If you have any questions, contact our support team.
import { Headline, Text } from '@marigold/components';export default () => (  <div>    <Headline level="3">Your Tickets for Summer Festival 2025</Headline>    <Text>      Below you’ll find all your purchased tickets and event details. Please      present your QR code at the entrance. If you have any questions, contact      our support team.    </Text>  </div>);

Hierarchy

The hierarchy in the <Headline> component is essential for both usability and accessibility. Visually, it guides users through the content by clearly indicating the structure of a page. Larger, more prominent headlines signal more important sections, while smaller ones denote subsections.

You should use the level prop (or size) to define the headline level, which corresponds to HTML headline tags (h1, h2, etc.).

Do

Use headline levels in sequential order that matches the content structure.

Don't

Avoid skipping headline levels (e.g., from <h1> directly to <h4>) to keep your content hierarchy meaningful and accessible.

Props

Did you know? You can explore, test, and customize props live in Marigold's storybook. Watch the effects they have in real-time!
View Headline stories

Headline

Prop

Type

Accessibility props (4)

Prop

Type

Alternative components

  • <Text>: If you want to display a simple text without any headline structure.
Last update: 2 months ago

EmptyState

Inform users when there is no content to display.

Keyboard

A hint that shows the keyboard shortcut for an action.

On this page

AnatomyAppearanceUsageHierarchyPropsHeadlineAlternative components