brutusin-json-forms

WebJar for brutusin-json-forms

License	Apache-2.0
Categories	Github Development Tools Version Controls JSON Data ORM
GroupId	org.webjars.npm
ArtifactId	github-com-brutusin-json-forms
Last Version	0.0.0
Release Date	Aug 21, 2017
Type	jar
Description	brutusin-json-forms WebJar for brutusin-json-forms
Project URL	http://webjars.org
Source Code Management	https://github.com/brutusin/json-forms

Download github-com-brutusin-json-forms

Filename	Size
github-com-brutusin-json-forms-0.0.0.pom
github-com-brutusin-json-forms-0.0.0.jar	53 KB
github-com-brutusin-json-forms-0.0.0-sources.jar	22 bytes
github-com-brutusin-json-forms-0.0.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/github-com-brutusin-json-forms/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>github-com-brutusin-json-forms</artifactId>
    <version>0.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/github-com-brutusin-json-forms/
implementation 'org.webjars.npm:github-com-brutusin-json-forms:0.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/github-com-brutusin-json-forms/
implementation ("org.webjars.npm:github-com-brutusin-json-forms:0.0.0")

Apache Buildr

'org.webjars.npm:github-com-brutusin-json-forms:jar:0.0.0'

Apache Ivy

<dependency org="org.webjars.npm" name="github-com-brutusin-json-forms" rev="0.0.0">
  <artifact name="github-com-brutusin-json-forms" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='github-com-brutusin-json-forms', version='0.0.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "github-com-brutusin-json-forms" % "0.0.0"

Leiningen

[org.webjars.npm/github-com-brutusin-json-forms "0.0.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

json-forms

org.brutusin:json-forms is a javascript library that generates HTML forms from JSON Schemas.

Status

I am currently not having time to maintain this project, so first of all my apologies if some issues have been unresponded. Branch v2 contains a completely new rearchitecture of the project, that I started several months ago but left unfinished. If someone is interested in continuing my work I will be happy to guide them

---

Table of Contents:

• org.brutusin:json-forms
  • Features
  • Usage
  • Demo
  • Dynamic schemas
  • API
  • CDN
  • Support, bugs and requests
  • Authors
  • License

Features

• Dynamic schemas support
• Extensible and customizable
• No external libraries needed
• Validation
• Multiple forms per document supported

Usage

Include the main library dependencies:

<link rel="stylesheet" href='dist/css/brutusin-json-forms.min.css'/>
<script src="dist/js/brutusin-json-forms.min.js"></script>

Optionally, include the bootstrap extension (requires bootstrap):

<script src="dist/js/brutusin-json-forms-bootstrap.min.js"></script>

Create the javascript BrutusinForms instance, schema being a javascript object representing the schema structure:

var schema = {"type": "boolean"}
var BrutusinForms = brutusin["json-forms"];
var bf = BrutusinForms.create(schema);

And finally render the form inside a container with optional preloaded JSON initial data, data:

var container = document.getElementById('container');
bf.render(container, data);

Demo

http://brutusin.org/json-forms/

Dynamic schemas

This library supports dynamic schemas, that is, subschemas that can change depending on the value of other parts of the data.

This lets creating dynamic forms that vary their shape depending on the values entered by the user. This is extremely useful for big autogenerated schemas, that aggregates lots of subschemas and have functional bindings, given that it allows to show the user a simpler, non-error-prone form, also avoiding asking for unneeded data.

Dynamic schemas are built upon two main blocks:

• Custom (non-standard) schema property called dependsOn, to build the subschemas dependency graph
• Brutusin DSL for path expressions, for identifying subschemas.

dependsOn schema extension

Dynamic schema resolution

API

Static members:

Member	Description
BrutusinForms.create(schema)	BrutusinForms factory method
BrutusinForms.addDecorator(f(htmlElement, schema))	Register a callback function to be notified after an HTML element has been rendered (passed as parameter). See brutusin-json-forms-bootstrap.js for an example of bootstrap decorator.
BrutusinForms.postRender(instance)	Callback function to be notified after a BrutusinForms instance has been rendered (passed as parameter)
BrutusinForms.instances	Array containing all the BrutusinForms instances created in the document by the factory method.

Instance members:

Member	Description
bf.render(container, data)	Renders the form inside the the container, with the specified data preloaded
bf.validate()	Returns true if the input data entered by the user passes validation
bf.getData()	Returns the javascript object with the data entered by the user
bf.schemaResolver(schemaIdArray, data)	Schema resolver for dynamic schemas

CDN

http://www.jsdelivr.com/projects/brutusin.json-forms

Support bugs and requests

https://github.com/brutusin/json-forms/issues

Authors

• Ignacio del Valle Alles (https://github.com/idelvall/)

Contributions are always welcome and greatly appreciated!

License

Apache License, Version 2.0

brutusin.org

Best friendly software libraries. In loving memory of Brutus

Versions

Version
0.0.0 Aug 21, 2017