@codeforges/ng-forms
v0.1.0
Published
Angular 4+ Dynamic form builder, decorate your models to generate forms or create them manually
Downloads
5
Maintainers
Readme
ng-forms (WIP)
This module will make your form building in Angular 4+ easier. Dynamically create reactive forms, as simple as adding a component and provide with required inputs.
Should help reduce repeatable tasks when building forms.
The goal is not only make dynamic forms easy to build but even make the process more automated.
Imagine a situation when you have new user form
you have a backend endpoint and some interface describing the fields,
now the idea is to feed the interface ( better class ) to the ng-forms
and it should build the whole new user form for you.
How to use:
Add a this to your AppModule:
@NgModule({
imports: [
NgFormsModule
],
})
export AppModule
Now you can use the component:
<ng-forms [inputs]="getInputs()" (submit)="doSomeThing($event)"></ng-forms >
Automated usage:
The easiest way to use ng-dynamic-form
is to add decorators to your models and extend from DynamicFormModel
// Your model
export class BookModel extends NgDynamicFormsModel {
private uuid: string;
@NgFormField({ fieldType: FormFieldType.TEXT })
private name: string;
@NgFormField({ fieldType: FormFieldType.TEXT_AREA })
private description: string;
@NgFormField({
fieldType: FormFieldType.SELECT,
selectOptionKeys: {labelKey: 'name', valueKey: 'id'}
})
private authors: {id: string, name: string}[];
constructor(name: string, description: string, authors: { id: string; name: string }[]) {
super();
this.name = name;
this.description = description;
this.authors = authors;
}
}
now in your component you can do the following:
@Component({
selector: 'my-example-book-form',
template: '<ng-forms-material [inputs]="getInputs()"></ng-forms-material>'
})
class ExampleComponent {
private book: BookModel = new BookModel(
'Test book',
'',
[
{id: '1', name: 'Roger'},
{id: '2', name: 'Roger2'}
]
);
public getInputs(): BaseInput[] {
// For demo purpose BookModel is instantiated here , it can also be a injectable
return this.book.getFormFields();
}
}
That is it , the getFormFields()
will return an array of FormInputs , it will scan your Model for decorated properties
and will use them to build the form.
Manual way
If you need more flexibility you can create the form fields Manual. Lets change the first example a bit.
@Component({
selector: 'my-example-book-form',
template: '<ng-forms-material [inputs]="getInputs()"></ng-forms-material>'
})
class ExampleComponent {
public getInputs(): BaseInput[] {
// For demo purpose BookModel is instantiated here , it can also be a injectable
return [
new TextInput('book-name'),
new TextAreaInput('book-description'),
];
}
}
Templates
You can override and create custom templates for your forms. Ive made a couple of build in Themes. For example see material design theme.
To use it simply replace the <ng-forms>
with <ng-forms-material>
More input coming up, feel free to ask. Npm coming up.