Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(split): expands design guidelines for split layout. #3674

Merged
merged 9 commits into from
Sep 27, 2023
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,31 @@
id: Split
section: layouts
---
Use a **Split** layout to position items horizontally in a container, with one item filling the remaining horizontal space as the viewport is resized.

The **split** layout positions items horizontally in a container, with one item filling the remaining horizontal space as the viewport is resized.

## Elements

<img src="./img/split-example.png" alt="Example image showing an example of a split layout." width="3330px"/>

1. **Split**: The split container, which holds all split items.
1. **Split item**: An individual section of content to be placed in the split layout.

## Usage
Use the split layout when content should be flexible and may change dynamically.

## Variations

### Multiple items that fill space

You can specify which split item fills the remaining horizontal space in the layout. More than one item can be set to fill, and they will share the remaining space equally.

### Items that wrap

You can wrap split items to ensure that they fit among other content as the screen is resized. To implement wrappable items, refer to the related [React](/layouts/split#wrappable) and [HTML](/layouts/split/html#wrappable) examples.

### Gutters around items

To adjust spacing between split items, you can apply gutters.

<img src="./img/split-gutter.png" alt="Example image showing a split layout with gutters." width="3330px"/>
Loading