Skip to content
React components that allow you to divide a page or container into nestable anchored, scrollable and resizable spaces.
TypeScript JavaScript CSS
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.GitHub Create FUNDING.yml Feb 19, 2020
.github/ISSUE_TEMPLATE Delete FUNDING.yml Feb 4, 2020
demo Added resizable/scrollable demo Jan 12, 2020
nextjsdemo Bump eslint-utils from 1.4.0 to 1.4.2 in /nextjsdemo Aug 27, 2019
react-spaces Fixed NPM readme Feb 16, 2020
.gitignore Added nextjs demo Aug 24, 2019
LICENSE Create LICENSE Jul 28, 2019
README.md Update README.md Dec 5, 2019
changelog.md Create changelog.md Jan 26, 2020
workspace.code-workspace Added workspace Aug 14, 2019

README.md

React Spaces

NPM Azure Pipelines

React Spaces allow you to divide a page or container HTML element into spaces. These spaces know how to behave in relation to each other and can also be divided into further nested spaces.

View full documentation here.

Top level spaces

Used at the top level of all other spaces.

<ViewPort />

This space will take over the full viewport of the browser window. Resizing the browser window will automatically adjust the size of this space and all the nested spaces.

<Fixed />

This space can be given a height and optionally a width (by default it will size to 100% of it's container). All nested spaces will be contained within this fixed size space.

Anchored spaces

These can be used within the top-level spaces <ViewPort /> and <Fixed /> or nested within other spaces.

<Left /> and <Right />

A space anchored to the left or right of the parent container/space. A size can be specified in pixels or as a percentage to determine its width.

<Top /> and <Bottom />

A space anchored to the top or bottom of the parent container/space. A size can be specified in pixels or as a percentage to determine its height.

There are resizable versions of these components called <LeftResizable />, <RightResizable />, <TopResizable /> and <BottomResizable /> which allow the spaces to be resized from the outer edge by dragging with the mouse.

Other

<Fill />

A space which consumes any available area left in the parent container/space taking into account any anchored spaces on every side.

<Layer />

Layers allow you to create layers within a parent space, for example:

<ViewPort>
  
  <Layer zIndex={0}>
  	<LeftResizable size="20%" /> // floating sidebar
  </Layer>
  
  <Layer zIndex={1}>
  	<Fill />
  </Layer>

</ViewPort>

<Centered />

Centres the content of a space horizontally and vertically.

<CenteredVertically />

Centres the content of a space vertically.

Getting started

To get started with React Spaces you need:

npm install react-spaces --save
import * as Spaces from 'react-spaces';

View full documentation here.

Donation

If you find this library useful, consider making a small donation to fund a cup of coffee:

You can’t perform that action at this time.