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 padding
padding
"base" | "none"
Default: 'base'

Adjust the padding of all edges.

  • base: applies padding that is appropriate for the element. Note that it may result in no padding if this is the right design decision in a particular context.
  • none: removes all padding from the element. This can be useful when elements inside the Section need to span to the edge of the Section. For example, a full-width image. In this case, rely on s-box with a padding of 'base' to bring back the desired padding for the rest of the content.
Was this section helpful?

Anchor to slotsSlots

Anchor to children
children
HTMLElement

The content of the Section.

Was this section helpful?

Code

<s-section heading="Online store dashboard">
<s-paragraph>View a summary of your online store’s performance.</s-paragraph>
</s-section>

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.
  • Built-in spacing is added between nested sections, as well as between heading and content.
  • Level 1: Display as responsive cards with background color, rounded corners, and shadow effects. Includes outer padding that can be removed when content like s-table needs to expand to the full width of the section.
  • Nested sections: Don't have any background color or effects by default.
Was this section helpful?

Anchor to examplesExamples

Component examples

Anchor to example-basic-usageBasic usage

Anchor to example-top-level-section-with-form-elementsTop-Level Section with Form Elements

Demonstrates a level 1 section with a heading and multiple form fields. This example shows how sections provide visual hierarchy and structure for input elements.

Anchor to example-nested-sections-with-visual-level-differencesNested Sections with Visual Level Differences

Illustrates how sections can be nested to create a hierarchical layout, with each nested section automatically adjusting its visual style. This example demonstrates the automatic visual leveling of nested sections.

Anchor to example-section-with-accessibility-labelSection with Accessibility Label

Shows how to add an accessibility label to a section, providing an additional hidden heading for screen readers while maintaining a visible heading.

Anchor to example-full-width-content-layoutFull-width Content Layout

Demonstrates using a section with padding="none" to create a full-width layout, ideal for displaying tables or other content that requires edge-to-edge rendering.

Was this section helpful?

Top-Level Section with Form Elements

<s-section heading="Customer information">
<s-text-field label="First name" value="John" />
<s-text-field label="Last name" value="Doe" />
<s-email-field label="Email" value="john@example.com" />
</s-section>