0.3.1 • Published 5 years ago

react-jsonify v0.3.1

Weekly downloads
5
License
MIT
Repository
github
Last release
5 years ago

Forked from argex/react-json.

react-json

A JSON editor packed as a React.js component, but also the simplest way of creating web forms.

Play safe with react-json forms in the playground.

React-json is like having an special input type for JSON objects, developers only need to listen to changes in the JSON instead of writing all the boilerplate needed to handle every single input of the form. It comes with top features:

  • Field type guessing for quick forms
  • Validation
  • Styles easily customizable
  • Extensible with custom field types

Examples

Do you want to edit some JSON in your app? Pass it to the Json component:

var doc = {
  hola: "amigo",
  array: [1,2,3]
};

React.render(
  <Json value={ doc } onChange={ logChange } />,
  document.body
);

function logChange( value ){
   console.log( value );
}

See this example working

A simple form creator

Do you hate creating forms? React-json handles all the dirty markup for you, and makes you focus in what is important;

var doc = {
  user: "",
  password: ""
};

// form: true
// make objects not extensible,
// fields not removable
// and inputs always visible
var settings = {
  form: true,
  fields: { password: {type: 'password'} }
};

React.render(
  <Json value={ doc } settings={ settings }/>,
  document.body
);

See this form working

Props

NameTypeDefaultDescription
valueObjectnoneRepresents the JSON object to edit, in order to use react-json as a controlled component.
defaultValueObject{}Represents the JSON object to edit, in order to use react-json as a uncontrolled component.
onChangefunctionfn(){}Callback trigger when the JSON object is updated.
settingsObject{}Fine grained customization for the component. See the settings documentation.

Docs

React JSON is highly configurable, have a look at the docs to discover how.

MIT licensed

License here