github.com/Jaspero/schema-forms

@jaspero/form-builder

Installation

To install this library, run:

$ npm install --save @jaspero/form-builder

Provide services and values

• Provide necessary services

• StorageService - Used for storing files when FileComponent, ImageComponent or GalleryComponent are used.
• DbService - Used for fetching referenced relations from your server in runtime

• Provide necessary values

• STORAGE_URL - Root URL for fetching files from your server
• ROLE - Segments and fields can be conditionally shown/hidden if the value of the role matches what is expected in the schema

Third party dependencies

tinymce: A WYSIWYG editor.

• Install tinymce npm i --save tinymce
• Add the following to the assets array in angular.json

{
  "glob": "**/*",
  "input": "node_modules/tinymce/themes/silver",
  "output": "/themes/silver"
},
{
  "glob": "**/*",
  "input": "node_modules/tinymce/skins/ui/oxide",
  "output": "/skins/ui/oxide"
},
{
  "glob": "**/*",
  "input": "node_modules/tinymce/skins/content/default",
  "output": "/skins/content/default"
}

• Add the tinymce script to the scripts array in angular.json "./node_modules/tinymce/tinymce.min.js"

Styles

In order to make the generated forms customizable, this library doesn't provide any default styles. This means that the styles need to be loaded in the root of your application. A good starting point are the example styles provided here.

Composing Forms

Definitions

This configuration is used for defining addition field based options. Changing the label or what component is used to represent the field in the form. The Definitions interface looks like this:

Property	Type	Description	Default
label	string	Label of the field	uses the name of the property
hint	string	Shows a hint below the field if defined	-
defaultValue	any	What the value of the field should be if empty	-
component	object	{type: string, configuration: any} - The type defines the field to use and the configuration is used for any additional component specific options	What ever is the default for the property type

Component Types

Name	Selector	Description	Configuration Options
Input	input	A simple input	{type: 'text', 'number', 'email'}

Example

{
  "name": {
    "label": "Name",
    "defaultValue": "John"
  },
  "age": {
    "label": "Age",
    "component": {
      "type": "slider"
    }
  }
}

Adding custom fields

• Create a new component that extends FieldComponent. You should inject COMPONENT_DATA in order to receive FieldData, most importantly the underlining FormControl.
• Map the newly added component through the CUSTOM_FIELDS provider e.g.

  providers: [{
      provide: CUSTOM_FIELDS
      useValue: {
          'new-component': NewComponent
      }
  }]
  

• You can now use the new field in a forms definitions.

Handling Array

The form builder supports both arrays of primitives and object arrays.

Object Arrays

The following is required to render an object array:

• An object array defined in the schema:

  {
    "addresses": {
     "type": "array",
     "items": {
       "type": "object",
       "properties": {
         "city": {
           "type": "string"
         },
         "address": {
           "type": "string"
         }
       }
     }
    }
  }
  

• A dedicated segment with an array property:

  {
    "segments": [{
      "array": "/addresses",
      "fields": [
        "/city",
        "/address"
      ] 
    }]
  }
  

• You can also optionally define options for each field in the definitions:

  {
    "definitions": {
      "addresses/city": {
        "label": "City"
      }  
    }    
  } 
  

Primitive Arrays

Primitive arrays can be displayed in two variations as a dedicated segment or as a field.

If the property is defined with out an items value. It's expected to be used as a field. In that case the following components can be used:

• select in combination with {multiple: true}
• chips
• draggable-list

If an items value is defined then it's expected to be rendered as its own segments.

License

MIT © Jaspero Ltd