@primer/react-brand
Version:
Primer Brand is a GitHub's design system for creating React-based marketing websites and digital experiences.
41 lines (25 loc) • 2.19 kB
Markdown
---
title: Section
description: Use a Section to group and structure related content on a page.
keywords: ['layout', 'container', 'content', 'structure', 'page']
---
## Anatomy
- **Container:** Wraps the content to ensure proper alignment and responsiveness across different viewports.
- **Padding:** Customizable padding at the top and bottom of the section to suit different content needs.
- **Background:** Options to customize the background with colors or images.
## Usage
The Section component is a versatile layout tool. It serves as a container that can be customized to fit various design needs.
Use the Section component to create distinct blocks of related content within a page, enhancing both the structure and the layout. Use it to break up long pages into more digestible segments, making the content more approachable for users.
### Content Grouping
Use the Section component to group related elements together, such as one or more subsections containing text, images, links and other compositions that share a common theme.
### Semantics and headings
The Section component is a semantic element used to create a new section within a page. It should include a heading to title the section. You may use the [section intro component](../SectionIntro/index.md) or rely top-level components like Hero that already provide the required heading. Ensure that the heading level is appropriate for the content hierarchy.
### Visual Separation
Use different backgrounds and paddings to visually differentiate different sections within a page, aiding in content hierarchy and navigation.
### Grids and responsive design
The container maintains content margins and allows the use of the Grid to consistently align elements across different viewport sizes.
## Related components
- [SectionIntro](../SectionIntro/index.md): to add a heading and optional description to the section.
- [Stack](../../layout/Stack/index.md): to enable layout of its immediate children along the vertical or horizontal axis.
- [Grid](../../layout/Grid/index.md): to create flexible and responsive grid-based layouts.
- [Box](../../layout/Box/index.md): to apply one-off styles to an element.