Angular Dynamic Form Generator

Richard Knight 51a48883ee Adding types and examples 6 lat temu
_notes 1d1b90ec92 Adding metadata generation utilities 6 lat temu
e2e 4fe4114fe8 chore: initial commit from @angular/cli 6 lat temu
src 3e082bdadc Adding some simple examples 6 lat temu
.editorconfig 4fe4114fe8 chore: initial commit from @angular/cli 6 lat temu
.gitignore 4fe4114fe8 chore: initial commit from @angular/cli 6 lat temu
README.md 51a48883ee Adding types and examples 6 lat temu
angular.json d5ae6eec55 Clarity icons now working 6 lat temu
karma.conf.js 1e1f528f58 Upgrade to Angular 6 6 lat temu
ng-dynaform.code-workspace af95f7a4e9 Testing callbacks from deeply nested groups 6 lat temu
package-lock.json 9182bf4588 Starting bare-bones documentation in README 6 lat temu
package.json 9182bf4588 Starting bare-bones documentation in README 6 lat temu
protractor.conf.js 4fe4114fe8 chore: initial commit from @angular/cli 6 lat temu
tsconfig.json 1e1f528f58 Upgrade to Angular 6 6 lat temu
tslint.json 1e1f528f58 Upgrade to Angular 6 6 lat temu
yarn.lock 1e1f528f58 Upgrade to Angular 6 6 lat temu

README.md

NgDynaform

A Dynamic Form Builder for Angular.

Field options

Common field metadata

All fields support the following metadata. The missing properties will be 'filled oin' by dynaform's field-specific models, allowing forms to specifiued tersely.

Options metadata (selects, radios, checkbutton groups, etc)

Supply an array of values, an array of [value, label] pairs, or an array of { value: , label: } objects. If you supply a aimple array of values, each value is used as both the value and label.

Available types

  • Text
  • Textarea
  • Select
  • Radio
  • Checkbox
  • Checkbutton
  • Password
  • Hidden

Example

{
	firstName: {},
	lastName: {},
	telephoneNumber: {},
	country: { type: 'select', options: ['France', 'Germany', 'Italy', 'Norway', 'Spain', 'UK'] }
}

Grouping related controls using containers

Related cpontrols can be grouped in containers.

Seeding groups with shared options

Repeating groups

The built-in model mapper

TO ADD.

Property Description Default / Notes
name The FormControl name - DERIVED AUTOMATICALLY Derived from the key of the control's metadata object
type The control's type Text
label The controls's label UnCamelCased and spaced version of name
value The control's initial value Empty string
checkedValue Value when checked* Checkboxes / Checkbuttons only
default Default value
placeholder Optional placeholder text
class CSS classes to apply Single class (string) or array of classes (string[])
id CSS id to apply
disabled Whether field is disbled
change Name of function in host component to call when value changes
source Location of data in model Same name and path. Used by model-mapper.
before Ordering instruction - move before
after Ordering instruction - move after
validators Array of validator functions - following Angular FormControl API
asyncValidators Array of async validator functions - following Angular FormControl API
valFailureMessages Validation failure messages - display appropriate message if validation fails