Skip to main content

Section

Groups related content into clearly-defined thematic areas. Sections have contextual styling that automatically adapts based on nesting depth. They also adjust heading levels to maintain a meaningful and accessible page structure.

Anchor to propertiesProperties

Anchor to accessibilityLabel
accessibilityLabel
string

A label used to describe the section that will be announced by assistive technologies.

When no heading property is provided or included as a children of the Section, you must provide an accessibilityLabel to describe the Section. This is important as it allows assistive technologies to provide the right context to users.

Anchor to heading
heading
string

A title that describes the content of the section.

Anchor to id
id
string

A unique identifier for the element.

Was this section helpful?

Anchor to slotsSlots

Anchor to primary-action
primary-action
HTMLElement

The primary action for the section. Accepts a single Button element.

Anchor to secondary-actions
secondary-actions
HTMLElement

The secondary actions for the section. Accepts multiple Button elements.

Was this section helpful?

Code

<s-section heading="Rewards">
<s-button slot="primary-action" variant="primary">
Redeem
</s-button>
<s-button slot="secondary-actions" variant="secondary">
My rewards
</s-button>
<s-paragraph>
Earn 10 points for every $1 spent. Redeem 100 points for $10 off your
next purchase.
</s-paragraph>
</s-section>

Preview

An example of the Section component shows a header, some text, a primary action, and a secondary action.

Anchor to useful-forUseful for

  • Organizing your page in a logical structure based on nesting levels.
  • Creating consistency across pages.
Was this section helpful?

Anchor to considerationsConsiderations

  • When adding headings inside sections they automatically use a specific style, which helps keep the content organized and clear.
Was this section helpful?