@ngserveio/material-forms
TypeScript icon, indicating that this package has built-in type declarations

8.1.1 • Public • Published

@ngserveio/material-forms

Find more at libraries and examples at NgServe.io.

Read More At: Angular Tutorial - Part 1: Reusable Validation Messages Angular Material Tutorial - Part 2: Creating a Reusable Form Field Component

See the Video Tutorial on YouTube

Angular Reactive Forms Validation with @ngserveio/validation-messages

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.

Package Sidebar

Install

npm i @ngserveio/material-forms

Weekly Downloads

82

Version

8.1.1

License

MIT

Unpacked Size

104 kB

Total Files

25

Last publish

Collaborators

  • ngserve