@ngserveio/material-forms

Find more at libraries and examples at NgServe.io.

See the Video Tutorial on YouTube

Running unit tests

Run nx test shared-ui-material-forms to execute the unit tests.

Purpose

This library offers an easier way to validate forms using the Angular Material components.

Import the NgServeMaterialFormsModule

import { NgServeMaterialFormsModule } from '@ngserveio/material-forms';
@NgModule({
  imports: [NgServeMaterialFormsModule],
})
export class SampleModule {}

Form Field Validation Component

Displays the validations messages set on a particular control. Please refer to Validation Error Messages Service for customizing and interpolation of validation messages. This component in conjunction with Validation Display Messages avoids the need for duplicative markup.

Selector

<ng-serve-form-field-validation></ng-serve-form-field-validation>

Inputs

Name	Type	Description
`fieldName`	string	The name of the field being validated. Will be used as a default parameter to interpolate in all validation messages. e.g. Message template `{{fieldName}} is required.`
`control`	AbstractControl	The control that's being validated.

Example

// Sample Component
import { Validators } from '@angular/forms';
import { FormGroupSubmit } from '@ngserveio/form-services';

@Component({
  template: 'sample-component',
})
export class SampleComponent {
  public formSamples = new FormGroupSubmit({
    firstName: new FormControl('', [Validators.required]),
  });

  public get firstName(): AbstractControl {
    return this.formSamples.get('firstName');
  }
}

<form [formGroup]="formSamples">
  <!-- Please note the firstName name here is a string as a key in the formSamples formGroup -->
  <input type="text" formControlName="firstName" />

  <!-- firstName is the AbstractControl reference in the component code -->
  <ng-serve-form-field-validation [control]="firstName" fieldName="First Name">
  </ng-serve-form-field-validation>
</form>

Form Field

The form field allows you to write less markup for displaying the label and validation and display the projected form field. Please not that the field must be of a MatFormField type.

Inputs

Name	Type	Description
`label`	string	The label of the control and will also act as the `fieldName` input for the `ng-form-field-validation` control.
`control`	AbstractControl	The control that's being validated.

Example

// Sample Component
import { Validators } from '@angular/forms';
import { FormGroupSubmit } from '@ngserveio/material-forms';

@Component({
  template: 'sample-component',
})
export class SampleComponent {
  public formSamples = new FormGroupSubmit({
    firstName: new FormControl('', [Validators.required]),
  });

  public get firstName(): AbstractControl {
    return this.formSamples.get('firstName');
  }
}

<!-- Sample Component Markup -->

<form [formGroup]="formSamples">
  <ng-serve-form-field [control]="firstName" label="First Name">
    <input matInput type="text" formControlName="firstName">
  <ng-serve-form-field>
</form>

Form

The form works in conjunction with the FormGroupSubmit. On submit of the form, the formGroup submit will mark FormGroupSubmit as submitted so validations can display based on whether or not the user has tried to submit the form.

Selector

<ng-serve-form></ng-serve-form>

Inputs

Name	Type	Default Value	Description
`saveText`	string	`Save`	The save text of the button that submits the form.
`cancelText`	string	`Cancel`	The cancel text of the button that cancels.
`formCssClass`	`string` \| `{ [name: string]: boolean }`	empty string	The css class for the form.
`showCancelButton`	boolean	true	Determines whether or not to show the cancel button.
`cancelDisabled`	boolean	false	Disable the cancel button.
`saveDisabled`	boolean	false	Disable the save button.
`saveButtonColor`	string	primary	The material color of the display button.
`saveButtonCss`	`string` \| `{ [name: string]: boolean }`	empty string	Determines the css for the save button.
`formGroup`	FormGroupSubmit	undefined	The form group that helps mark the form as submitted.

Outputs

Name	Type	Description
`cancel`	`EventEmitter<void>`	Emits when the user clicks the cancel button.
`save`	`EventEmitter<void>`	Emits a save event when the form group is valid.

Example

// Sample Component
import { Validators } from '@angular/forms';
import { FormGroupSubmit } from '@ngserveio/material-forms';

@Component({
  template: 'sample-component',
})
export class SampleComponent {
  public formSamples = new FormGroupSubmit({
    firstName: new FormControl('', [Validators.required]),
  });

  public save(): void {
    console.log(this.formSamples.value);
  }

  public cancel(): void {
    console.log("I've been canceled!  Seems to be the culture.");
  }

  public get firstName(): AbstractControl {
    return this.formSamples.get('firstName');
  }
}

<ng-serve-form [formGroup]="formSamples" (save)="save()" (cancel)="cancel()">
  <ng-serve-form-field [control]="firstName" label="First Name">
    <input matInput type="text" formControlName="firstName">
  <ng-serve-form-field>
</ng-serve-form>

Content Projection

Content Name	Required	Description
default	yes	This area MUST CONTAIN a material input control
`prefix`	no
`suffix`	no

ChangeLog.md

File Upload Components

These are components that allow for the display of and help of uploading files.

npm