Welcome to the Angular version of the Angular Template Driven Validation library. This library is being built from scratch by the open source team. We are using TypeScript and targeting the template driven validation that will specially help to AngularJS developers and others.
As with template driven validation, this library is a work in progress. Please check out our list of issues to see all the things we are implementing. Feel free to make comments there.
This is a domain model centric approach to angular template-driven validation Learn more on the ng-tdv website.
- Demo
- Versions
- Why ng-tdv
- Features
- Installation
- Warning
- Getting started
- Constraints JSON
- Built-In Validators
- Adding custom validators
- Develop
- Support
- License
- Credits
View all the ng-tdv directives in action at https://stackblitz.com/edit/ng-tdv
Angular | ng-tdv |
---|---|
v8.x | v0.x |
The domain model centric validation is more important to manage a large scale application that's why we have wanted to create such type validation that will help you terrible. Characterizing the validation rules on each every field with the default Angular validators contaminates the markup with your business rules and makes them quite difficult to keep up. This is particularly valid for bigger applications, where you may have repeating models like customers or products in different forms, but require slightly different markup and therefore can't simply reuse a current structure. What's far and away more terrible: Usually you already have the validation logic in your back-end, but there is no easy way to share this information with the UI.
ng-tdv solves these issues by extracting the validation constraints from the markup to a JSON structure. You define the constraints per type and field, tell ng-tdv that a form (or just a part of the form) belongs to a certain type and ng-tdv automatically validates the form fields.
ng-tdv gives you the following advantages:
- cleaner form markup
- reusable validation constraints for your models -> easier to maintain
- possibility to generate the constraints from the models you already have in your back-end
- an easy way to display validation messages per form field
- Model centric validation
- Custom binding to property or object
- Pattern matching validation support
- Required validation support
- Min, Max validation support
- Range validation support
- Email validation support
- Custom validation support
You need to have an Angular project with the supported Angular version. We strongly recommend using Angular CLI for this.
npm install ng-tdv --save
yarn install ng-tdv --save
Library is under active development and may have API breaking changes for subsequent major versions after 1.0.0.
You need to have an Angular project with the supported Angular version. We strongly recommend using Angular CLI for this. Once installed you need to import our main module NgTdvModule
and angular FormsModule
module
import { NgTdvModule } from 'ng-tdv';
import { FormsModule } from '@angular/forms';
@NgModule({
declarations: [AppComponent],
imports: [NgTdvModule, FormsModule],
bootstrap: [AppComponent]
})
export class AppModule {}
The JSON object to define the validation rules has the following structure:
TypeName {
FieldName {
ValidatorName {
<ValidatorArguments>
message: 'error message'
}
}
}
- TypeName The type of object (string)
- FieldName The name of the field to validate (string)
- ValidatorName The name of the validator (string) see below in the Built-In Validators section for the default validators
- ValidatorArguments arguments which are passed to the validator, see below for the optional and required arguments for the built-in validators
- Message the message which should be shown if the validation fails (can also be a message key if angular-translate is used)
Example:
"Person": {
"firstName": {
"size": {
"min": 2,
"max": 20,
"message": "First name must be between 2 and 20 characters."
}
}
},
"Address": {
"email": {
"email": {
"message": "Must be a valid E-Mail address."
}
},
"zipCode": {
"size": {
"min": "4",
"max": "6",
"message": "Zip code must be between 4 and 6 characters."
}
}
}
Checks the minimal and maximal length of the value.
Arguments:
- min The minimal string length (number, optional, default 0)
- max The maximal string length (number, optional)
Checks that the value is a string and not shorter / longer than the specified number of characters.
Arguments:
- number The minimal / maximal string length (number, required)
Checks that the value is a number above/below or equal to the specified number.
Arguments:
- value The minimal / maximal value of the number (number, required)
Marks the field as required.
Validates the input using the specified regular expression.
Arguments:
- value The regular expression (string/RegExp, required)
Checks that the field contains a valid e-mail address. It uses the same regular expression as Angular is using for e-mail validation.
Checks that the value is a number with the specified number of integral/fractional digits.
Arguments:
- integer The integral part of the number (number, required)
- fraction The fractional part of the number (number, required)
Checks that the value is a valid URL. It uses the same regular expression as Angular for the URL validation.
Implementing custom validation logic is easy
"productQuantity": {
"custom": ()=> {
return true;
},
"required": {
"message": "Product Quantity required",
},
},
Clone and install dependencies:
git clone https://github.com/mdshohelrana/ng-tdv.git
cd ng-tdv
npm install
Ask a question on Stack Overflow and tag it with ng-tdv
.
MIT © mdshohelrana
Thanks a lot to all contributors