Angular Dynamic Form Generator

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

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)

Oprions can be specified as an array of values, an array of [value, label] pairs, or an array of objects with the structure { value: 'VAL', label: 'My label' }. If you supply a a simple 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