Subhead
ready
This page may be removed. Primer plans to move all Rails component documentation to Lookbook.
Description
Use Subhead as the start of a section. The :heading slot will render an <h2> font-sized text.
- Optionally set the
:descriptionslot to render a short description and the:actionsslot for a related action. - Use a succinct, one-line description for the
:descriptionslot. For longer descriptions, omit the description slot and render a paragraph below theSubhead. - Use the actions slot to render a related action to the right of the heading. Use
Primer::ButtonComponentorPrimer::Beta::Link.
Accessibility
The :heading slot defaults to rendering a <div>. Update the tag to a heading element with the appropriate level to improve page navigation for assistive technologies.
Learn more about best heading practices (WAI Headings)
Arguments
| Name | Default | Description |
|---|---|---|
spacious | BooleanWhether to add spacing to the Subhead. | |
hide_border | BooleanWhether to hide the border under the heading. | |
system_arguments | Hash |
Slots
heading
The heading
| Name | Default | Description |
|---|---|---|
tag | SymbolOne of | |
danger | BooleanWhether to style the heading as dangerous. | |
system_arguments | Hash |
actions
Actions
| Name | Default | Description |
|---|---|---|
system_arguments | Hash |
description
The description
| Name | Default | Description |
|---|---|---|
system_arguments | Hash |