react-dnd-layout v0.3.1

Warning!

This library is under heavy development, and is prone to breaking changes in the future. It is not safe to use for production purposes at this time.

React DnD Layout

Drag and Drop Layout Builder for React Components

npm install --save react-dnd-layout

Getting Started

import React, { Component } from 'react';
import { Editor, LayoutState, Row, Column } from 'react-dnd-layout';

const comps = {
  Row,
  Column
}

class MyComponent extends Component {

  constructor(props) {
    super(props);
    this.state = {
      layoutState: new LayoutState()
    };
    this.handleLayoutChange = this.handleLayoutChange.bind(this);
  }

  handleLayoutChange(layoutState) {
    this.setState({ layoutState });
  }

  render() {
    return (
      <Editor
        layoutState={this.state.layoutState}
        onChange={this.handleLayoutChange}
        components={components}
      />
    );
  }

}

Rendering a StaticLayout

import React, { Component } from 'react';
import { Editor, StaticLayout, Row, Column } from 'react-dnd-layout';

const components = {
  Row,
  Column
};


/*
 * layoutState is a LayoutState instance that can be saved from the editor and
 * used to hydrate the static layout.
 */

const MyComponent = ({ layoutState }) => (
  <StaticLayout
    layoutState={layoutState}
    components={components}
  />
)

Editor

The Editor is used to create the interfaces using drop and drop. It accepts the following props.

StaticLayout

The StaticLayout is used to display a static version of layouts created with the Editor. It accepts the following props.

LayoutState

LayoutState is a custom immutable.js Record used to hold the current state of the layout, including all components and their props.

To JSON

To get a raw JSON object from the LayoutState, (most likey for storage), call layoutState.toRaw();

From JSON

To convert raw JSON back to a LayoutState pass the JSON to LayoutState.fromRaw();

TODO

• Thorough Docs
• Testing
• Plugin support
• Pass info down to layout items