Skip to content

Commit

Permalink
docs(split): expands design guidelines for split layout. (#3674)
Browse files Browse the repository at this point in the history
* docs: expands design guidelines for split layout.

* Content updates and placeholder images.

* Updates content to ready for review.

* Apply suggestions from code review

* Content updates.

* Update image and fix typo.

* Update packages/documentation-site/patternfly-docs/content/design-guidelines/layouts/split.md

---------

Co-authored-by: Margot <[email protected]>
  • Loading branch information
edonehoo and mmenestr authored Sep 27, 2023
1 parent cafeebc commit 61c1d6c
Show file tree
Hide file tree
Showing 3 changed files with 28 additions and 1 deletion.
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"/>

0 comments on commit 61c1d6c

Please sign in to comment.