Follow me on Twitter at @tim_deschryver | Subscribe to the Newsletter | Originally published on timdeschryver.dev.
In Angular, we have two ways to build forms, which are template-driven and reactive.
While both ways are different to use, they're both built on top of a common Forms API.
From the start of my journey with Angular, I've always used Reactive Forms.
That's because reactive forms are recommended (sold as more scalable, reusable, and testable) in the Angular docs and because most of the content created by the community is focused on using the reactive way to create forms in Angular.
Until recently, I never looked at template-driven forms. But due to circumstances that have occurred in the same week, I've decided to get more familiar with creating template-driven forms.
The first circumstance was returning to a complex form after a couple of months and having struggles with how the form was set up. Due to these struggles, I experimented with building a layer on top of the Reactive Forms API. While at first, I was pretty happy with the design, the solution was getting worse with every addition. Now that I look back at that proof of concept, I realize that I was building a poor-mans API compared to the API that template-driven forms already provide.
The second circumstance was that Ward Bell was advocating for template-driven forms on a Forms Episode of the The Angular Show podcast.
Based on Ward's experience, the examples that were talked about on the podcast (alongside a StackBlitz demo), and my findings while I was attempting to build a layer on top of the Angular Forms API, I'm now exploring and discovering the benefits of the template-driven way.
In this post, I'd like to share my experience with some practical examples.
The code used in this guide can be found on GitHub.
This guide is a Work In Process. During the next weeks, I'll probably cover validation, nested forms, how to test template-driven forms, control value accessors, and dynamic forms. If you have anything you want to see here or if you have suggestions feel free to reach out on Twitter or create an issue on GitHub.
Creating a form
If this is your first time building a template-driven form or if you just need a quick refresher, I would suggest starting by reading the Angular docs. For a more in-depth look at how template-driven forms behave and react, the Angular docs also got you covered at Data flow in template-driven forms.
A brief recap of the docs is that the HTML form
entity creates a new NgForm
instance (this is a built-in Angular directive, which uses form
as the directive's selector). Inside the form, the ngModel
directive is used to register form controls to the form instance (under the hood ngModel
creates a new FormControl
, as we can see in the source code). While adding the ngModel
attribute to a control, it's important to also assign a value to the name
attribute to correctly build up the form tree. The value given to the name
attribute is the property name inside the template model, with the form control instance as the value.
In code, this looks like this.
@Component({
template: `
<form>
<label for="text">A label</label>
<input type="text" id="text" name="formText" ngModel />
</form>
`
})
export class AppComponent {}
While the
for
attribute of the label and theid
attribute of the input control does not affect the Angular form, it's important to link the label to the control in order to make the form accessible.
This form results in the following form value.
{
"formText": ""
}
To unlock the full potential of template-driven forms, we use two-way binding to bind the template form to a TypeScript (data) model. The TypeScript model is used to process a form submission when a user submits the form, for example, to make a request to a backend. The model can be sent to the backend in its current state, or it can also be translated to a model that the backend API expects.
Because the TypeScript model is coupled to the template model, every change made to the model will also change the value of the template model and visa-versa.
To create a two-way binding we use the banana in a box syntax ([()]
), the form now looks like this.
@Component({
template: `
<form>
<label for="text">Text</label>
<input type="text" id="text" name="formText" [(ngModel)]="model.text" />
</form>
`,
})
export class AppComponent {
model = {
text: null,
}
}
The above template and model result in the following structures for the two models.
Notice the difference between the two property names:
-
formText
for the template model, because the input hasformText
as the name of the control - and
text
for the TypeScript model, because the model has thetext
property
Template Form Value | TypeScript Model Value |
---|---|
{ formText: 'some text value here' } |
{ text: 'some text value here' } |
Because the structure of the template model and the TypeScript model doesn't need to match, it unlocks significant advantages in comparison to reactive forms, which we will address later in the next sections.
Form Building Blocks
First, we need some basic controls before we're able to construct a usable form.
In this section, we'll take a look at how we can create the most common form controls and how its value translates to the two models look like.
Input Controls
The obvious and the easiest controls are the native input controls, these controls are single HTML elements that have a value. To bind the control to the TypeScript model, we can just use the ngModel
directive.
Angular makes things easier for us by already parsing the value of the input control to its corresponding type. Angular does this with a couple of directives, more specifically with control value accessors. An example of this is the number input control, the value of the number control (a string) is parsed to a number by the number value accessor.
@Component({
template: `
<form>
<label for="text">Text</label>
<input type="text" id="text" name="formText" [(ngModel)]="model.text" />
<label for="number">Number</label>
<input type="number" id="number" name="formNumber" [(ngModel)]="model.number" />
</form>
`
})
export class AppComponent {
model = {
text: null,
number: null
};
}
Template Form Value | TypeScript Model Value |
---|---|
{ formText: 'hello', formNumber: 5 } |
{ text: 'hello', number: 5 } |
Select Element
While the HTML select element doesn't have a value attribute, we can still use the ngModel
directive to bind the select element to the TypeScript model.
To assign values to the option elements, the value
attribute is used on the options.
These options can be static or can be iterated over by using the *ngFor
directive.
The value of the selected option is used as the value of the TypeScript model.
When the TypeScript model has an initial value or when it's reassigned a new value, the corresponding option will be selected automatically in the template.
@Component({
template: `
<label for="select">Select</label>
<select id="select" name="formSelect" [(ngModel)]="model.select">
<option [value]="null">Default Option</option>
<option *ngFor="let option of options" [value]="option.value">
{{ option.label }}
</option>
</select>
`
})
export class AppComponent {
model = {
select: null
};
options = [
{
value: 1,
label: 'Option One'
},
{
value: 2,
label: 'Option Two'
},
{
value: 3,
label: 'Option Three'
}
];
}
Template Form Value | TypeScript Model Value |
---|---|
{ formSelect: 2 } |
{ select: 2 } |
Checkbox List
For my checkbox lists I like to include the checkbox items in the TypeScript model, and add a selected
property on the items to know which checkboxes are selected (checked). In the template, this selected
property is bound to a checkbox control with the ngModel
directive.
All checkbox elements within the same group must have unique names, otherwise, all the control will share the same form control instance, and thus the same value.
@Component({
template: `
<label>Checkbox list</label>
<div *ngFor="let check of model.checks">
<input
type="checkbox"
[id]="'formCheckbox-' + check.id"
[name]="'formCheckbox-' + check.id"
[(ngModel)]="check.selected"
/>
<label [for]="'formCheckbox-' + check.id">{{ check.label }}</label>
</div>
`
})
export class AppComponent {
model = {
checks: [
{
id: 'check-one',
label: 'Check One',
selected: false
},
{
id: 'check-two',
label: 'Check Two',
selected: false
},
{
id: 'check-three',
label: 'Check Three',
selected: false
}
]
};
}
Template Form Value | TypeScript Model Value |
---|---|
{ formCheckbox-check-one: false, formCheckbox-check-two: true, formCheckbox-check-three: true, } |
{ checks: [ { id: 'check-one', label: 'Check One', selected: false }, { id: 'check-two', label: 'Check Two', selected: true }, { id: 'check-three', label: 'Check Three', selected: true } ] } |
In the example above, the checkbox values are represented in a flat object structure.
While this is enough for the simple cases, we can also reorganize the structure of the template model by creating nested objects.
Because the template model doesn't need to reflect the TypeScript model, it allows us to be flexible with the structures we use to shape the form.
This allows us as developers to model the template as efficiently as possible for certain use-cases.
I find it easier to group the checkboxes in a nested hierarchy to make it effortless to validate the checkbox group, e.g. when at least one checkbox needs to be checked.
The snippet below uses the ngModelGroup
directive to group the checkboxes. Behind the scenes, Angular creates a new FormGroup
instance and adds a new leaf in the template model with the given name.
This change doesn't impact the TypeScript model and is purely a change to the template model to make it easier to use, for example it becomes easier to validate.
@Component({
template: `
<label>Checkbox list</label>
<div *ngFor="let check of model.checks" ngModelGroup="formCheckbox">
<input
type="checkbox"
[id]="'formCheckbox-' + check.id"
[name]="check.id"
[(ngModel)]="check.selected"
/>
<label [for]="'formCheckbox-' + check.id">{{ check.label }}</label>
</div>
`,
})
export class AppComponent {
model = {
checks: [
{
id: 'check-one',
label: 'Check One',
selected: false,
},
{
id: 'check-two',
label: 'Check Two',
selected: false,
},
{
id: 'check-three',
label: 'Check Three',
selected: false,
},
],
}
}
This change leads to the following structures of the template model and the TypeScript model.
Template Form Value | TypeScript Model Value |
---|---|
{ formCheckbox: { check-one: false, check-two: true, check-three: true } } |
{ checks: [ { id: 'check-one', label: 'Check One', selected: false }, { id: 'check-two', label: 'Check Two', selected: true }, { id: 'check-three', label: 'Check Three', selected: true } ] } |
Radio Group
A radio group is similar to a checkbox list. The difference is that in contrast to a checkbox list, radio buttons that belong together need to have the same name
. If this is not the case, the form creates a new form control instance for each radio button with a different name. Because the radio buttons are linked to the same TypeScript model value, the radio buttons all have the same value and will all be updated when another radio button is selected. While the TypeScript model will have the correct value, this might be confusing on the side of the template model and might cause problems in the future when it needs to be validated.
@Component({
template: `
<label>Radio group</label>
<div>
<input
type="radio"
id="radio-1"
name="formRadioGroup"
[value]="1"
[(ngModel)]="model.radio"
/>
<label for="radio-1">Radio One</label>
</div>
<div>
<input
type="radio"
id="radio-2"
name="formRadioGroup"
[value]="2"
[(ngModel)]="model.radio"
/>
<label for="radio-2">Radio Two</label>
</div>
<div>
<input
type="radio"
id="radio-3"
name="formRadioGroup"
[value]="3"
[(ngModel)]="model.radio"
/>
<label for="radio-3">Radio Three</label>
</div>
`
})
export class AppComponent {
model = {
radio: null
};
}
Template Form Value | TypeScript Model Value |
---|---|
{ formRadioGroup: 1 } |
{ radio: 1 } |
Forms Controls Example
To play around with the form controls and see how changes reflect on the template model and the TypeScript model, you can take a look at the following StackBlitz.
Validators
Validation with template-driven forms is done by adding attributes (directives) to a form control.
This makes it feel like you're using the Web platform, which is always pleasant.
I can highly recommend Kara Erickson's talk Angular Form Validation to get a better understanding of Angular validators.
Built-in validators
The Angular FormsModule
comes with a set of directives that implement the native HTML form validation attributes, except for the min
and max
validators. Recently, a Pull Request was merged, so I assume that these missing validators will be available in one of the future releases.
<input required />
<input minlength="3" minlength="10" />
<input pattern="/@/" />
Dynamic Validators
To make the validators dynamic, the static value of an attribute needs to be replaced with a component variable. When the value of the variable changes, it re-triggers the validator with the new value.
Because the validator revalidates, it's effortless to create dynamic and conditional validators.
For example, to make a field required based on another form control, we bind the value of the second control to the required
attribute. When that value is truthy, the control is required, otherwise, it isn't required. In the following snippet, the name control is required when the checkbox makeNameRequired
is checked.
@Component({
template: `
<form>
<div class="checkbox-container">
<input
type="checkbox"
id="makeNameRequired"
name="makeNameRequired"
[(ngModel)]="model.makeNameRequired"
/>
<label for="makeNameRequired">Make "name" required</label>
</div>
<label for="text">Name</label>
<input
type="text"
id="text"
name="text"
[(ngModel)]="model.name"
[required]="model.makeNameRequired"
/>
</form>
`,
})
export class AppComponent {
model = {
makeNameRequired: false,
name: '',
}
}
Depending on the desired user experience, hiding the control (by using the *ngIf
directive) or disabling the control (with the disabled
attribute), also removes all of the validators of the control.
Custom Validators
While the built-in validators are providing a good starting point and are sufficient for basic forms, we need to write custom validators that fit the specific needs of our forms.
To create a custom validator we must create a new Angular directive, implementing the Validator
interface(1). The validator also needs to be registered to the Angular validators, therefore we register the directive to the Angular validators (NG_VALIDATORS
) (2).
As an example, I've created the RequiredCheckboxGroupValidatorDirective
validator.
This validator requires that at least N checkboxes need to be checked inside a checkbox group.
import { Directive, Input } from '@angular/core'
import {
AbstractControl,
ValidationErrors,
NG_VALIDATORS,
Validator,
} from '@angular/forms'
@Directive({
selector: '[requiredCheckboxGroup][ngModelGroup]',
// 2: register the custom validator as an Angular Validator
providers: [
{
provide: NG_VALIDATORS,
useExisting: RequiredCheckboxGroupValidatorDirective,
multi: true,
},
],
})
export class RequiredCheckboxGroupValidatorDirective implements Validator {
@Input() requiredCheckboxGroup = 1
// 1: implement the validate method
validate(control: AbstractControl): ValidationErrors | null {
// the value of the control is an object that holds the value of each checkbox
// the value's signature looks like this, `{ 'check-one': false, 'check-two': true }`
const selected = Object.values(control.value).filter(Boolean).length
if (selected < this.requiredCheckboxGroup) {
return {
requiredCheckboxGroup: {
requiredCheckboxes: this.requiredCheckboxGroup,
},
}
}
return null
}
}
A best practice is to extract the validate
method out of the directive, and to define it as a stand-alone validator function (ValidatorFn
). The gained benefits are that the logic inside the validator is easier to test and that it's now possible to reuse the validator in a reactive form.
import { Directive, Input } from '@angular/core'
import {
AbstractControl,
ValidationErrors,
NG_VALIDATORS,
Validator,
} from '@angular/forms'
function requiredCheckboxGroup(requiredCheckboxes: number): ValidatorFn {
return (control: AbstractControl): ValidationErrors | null => {
const selected = Object.values(control.value).filter(Boolean).length
if (selected < requiredCheckboxes) {
return {
requiredCheckboxGroup: { requiredCheckboxes },
}
}
return null
}
}
@Directive({
selector: '[requiredCheckboxGroup][ngModelGroup]',
providers: [
{
provide: NG_VALIDATORS,
useExisting: RequiredCheckboxGroupValidatorDirective,
multi: true,
},
],
})
export class RequiredCheckboxGroupValidatorDirective implements Validator {
@Input() requiredCheckboxGroup = 1
validate(control: AbstractControl): ValidationErrors | null {
return requiredCheckboxGroup(this.requiredCheckboxGroup)(control)
}
}
The validate
method needs to return a null
value when the value of the control is valid.
Otherwise, if the value is invalid, the validate
method needs to return an ValidationErrors
object with (details of) the validation errors. The returned details will be used to create user-friendly Validation Messages.
To use the RequiredCheckboxGroupValidatorDirective
validator, we can now append the directive to a control, or in this case to a model group.
<label>Pick a time</label>
<div class="flex space-x-4" ngModelGroup="times" [requiredCheckboxGroup]="1">
<div class="checkbox-container" *ngFor="let time of model.times">
<input
type="checkbox"
[id]="time.label"
[name]="time.label"
[(ngModel)]="time.selected"
/>
<label [for]="time.label">{{ time.label }}</label>
</div>
</div>
In Displaying Validation Errors (needs to be written), we'll see how we can transform this object into human-friendly messages.
Revalidate Custom Validators
There's one problem with the current version of the validator. To set the minimum required selected checkboxes, the RequiredCheckboxGroupValidatorDirective
validator uses the requiredCheckboxGroup
input property, but the validator doesn't revalidate the validity of the checkbox group when the value of the requiredCheckboxGroup
input property changes.
To trigger the validator when the value of an input property changes, we need to make several changes to the directive:
- register a change handler with the
registerOnValidatorChange
hook (1) - create a getter and a setter for the input property (2)
- invoke the change handler when an input property receives a new value in the setter (3)
import { Directive, Input } from '@angular/core'
import {
ValidatorFn,
AbstractControl,
ValidationErrors,
NG_VALIDATORS,
Validator,
} from '@angular/forms'
function requiredCheckboxGroup(requiredCheckboxes: number): ValidatorFn {
return (control: AbstractControl): ValidationErrors | null => {
const selected = Object.values(control.value).filter(Boolean).length
if (selected < requiredCheckboxes) {
return {
requiredCheckboxGroup: { requiredCheckboxes },
}
}
return null
}
}
@Directive({
selector: '[requiredCheckboxGroup][ngModelGroup]',
providers: [
{
provide: NG_VALIDATORS,
useExisting: RequiredCheckboxGroupValidatorDirective,
multi: true,
},
],
})
export class RequiredCheckboxGroupValidatorDirective implements Validator {
private _requiredCheckboxGroup = 1
private _onChange?: () => void
// 2: create a getter and a setter for the input property
@Input()
get requiredCheckboxGroup() {
return this._requiredCheckboxGroup
}
set requiredCheckboxGroup(value: number) {
this._requiredCheckboxGroup = value
// 3: invoke the change handler
if (this._onChange) {
this._onChange()
}
}
validate(control: AbstractControl): ValidationErrors | null {
return requiredCheckboxGroup(this.requiredCheckboxGroup)(control)
}
// 1: register the change handler
registerOnValidatorChange?(fn: () => void): void {
this._onChange = fn
}
}
To give another example, let's take a look at another widely used validator is a comparison validator to compare two values, for example to validate the values of two input controls e.g. password and password confirmation.
function equalTo(value: any): ValidatorFn {
return (control: AbstractControl): ValidationErrors | null => {
if (control.value !== value) {
return {
equalTo: value
};
}
return null;
};
}
@Directive({
selector: '[equalTo][ngModel]',
providers: [
{
provide: NG_VALIDATORS,
useExisting: EqualToValidatorDirective,
multi: true
}
]
})
export class EqualToValidatorDirective implements Validator {
private _equalTo: any;
private _onChange?: () => void;
@Input()
get equalTo() {
return this._equalTo;
}
set equalTo(value: any) {
this._equalTo = value;
if (this._onChange) {
this._onChange();
}
}
validate(control: AbstractControl): ValidationErrors | null {
return equalTo(this.equalTo)(control);
}
registerOnValidatorChange?(fn: () => void): void {
this._onChange = fn;
}
}
Async Validators
To validate form controls require an HTTP request to be validated, we need to create an asynchronous validator.
The async validator almost looks identical to a synchronous validator, with subtle differences:
- the validator needs to be provided to the Angular asynchronous validators,
NG_ASYNC_VALIDATORS
(instead ofNG_VALIDATORS
) - the validator needs to implement the
AsyncValidator
interface (instead ofValidator
) - the validate method needs to return an Observable containing the
ValidationErrors
ornull
. It's important to know that Angular expects that the Observable stream completes at some point.
import { Directive, Inject } from '@angular/core'
import {
NG_ASYNC_VALIDATORS,
AsyncValidator,
AbstractControl,
ValidationErrors,
} from '@angular/forms'
@Directive({
selector: '[uniqueUsername][ngModel]',
providers: [
{
provide: NG_ASYNC_VALIDATORS,
useExisting: UniqueUsernameValidatorDirective,
multi: true,
},
],
})
export class UniqueUsernameValidatorDirective implements AsyncValidator {
constructor(@Inject(UsersService) private usersService: UsersService) {}
validate(
control: AbstractControl,
): Promise<ValidationErrors | null> | Observable<ValidationErrors | null> {
return this.usersService.isUsernameTaken(control.value as string).pipe(
map((taken) => {
return taken ? { usernameTaken: true } : null
}),
)
}
}
Using the asynchronous validator isn't different from using a synchronous validator, we can just add the directive to a control.
A common pattern with asynchronous validation is to use the ngModelOptions
configuration to trigger the validators when the user leaves the input control, and not on every change.
<label for="username">Username</label>
<input
type="text"
id="username"
name="username"
[(ngModel)]="model.username"
[ngModelOptions]="{ updateOn: 'blur' }"
uniqueUsername
/>
Nice to knows
- An asynchronous validator is only invoked when all the synchronous validators of that control are valid
- While an asynchronous validator is pending, the state of the form control (and the form) isn't
valid
norinvalid
, but the control is given thepending
state
Testing Validators
Simple validators can be tested by just putting the ValidatorFn
method under test, and this might also be a good start for the more complex validators. But to test the revalidation behavior we need to write a test that uses the DOM.
To write this test we can create a host component that "hosts" the directive by using the regular Angular TestBed, and this works fine, but... I like to use Angular Testing Library because it removes some of the setup (e.g. I don't need to create a host component, nor do I have to trigger a change detection cycle), plus I also use the Angular Testing Library to test my components.
In the following two tests, we verify that the EqualToValidatorDirective
directive (written in Revalidate Custom Validators) has the expected behavior. Therefore,
- the first test verifies that the control is valid when the input control has the same value as the comparison value,
- while the second test verifies that the validity of the control gets revalidated when the comparison value changes
it('is valid when it has the same value as the comparison value', async () => {
const component = await render(EqualToValidatorDirective, {
template: `<form><input [equalTo]='compareValue' ngModel name="sut" /></form>`,
imports: [FormsModule],
componentProperties: {
compareValue: 'value1'
}
});
const model = component.fixture.debugElement.children[0].injector.get(NgForm);
const input = screen.getByRole('textbox');
userEvent.type(input, 'value2');
expect(model.controls.sut.invalid).toBeTruthy();
expect(model.controls.sut.errors).toEqual({
equalTo: 'value1'
});
userEvent.clear(input);
userEvent.type(input, 'value1');
expect(model.controls.sut.valid).toBeTruthy();
expect(model.controls.sut.errors).toBeNull();
});
it('revalidates on input change', async () => {
const component = await render(EqualToValidatorDirective, {
template: `<form><input [equalTo]='compareValue' ngModel name="sut" /></form>`,
imports: [FormsModule],
componentProperties: {
compareValue: 'value1'
}
});
const model = component.fixture.debugElement.children[0].injector.get(NgForm);
const input = screen.getByRole('textbox');
userEvent.type(input, 'value2');
expect(model.controls.sut.invalid).toBeTruthy();
expect(model.controls.sut.errors).toEqual({
equalTo: 'value1'
});
component.fixture.componentInstance.compareValue = 'value2';
expect(model.controls.sut.valid).toBeTruthy();
expect(model.controls.sut.errors).toBeNull();
});
Validators Example
The examples that we created in this section are available in the following StackBlitz.
Form Errors
In this section, we're going to take a look at how to translate the validation errors to create human-friendly messages, and how to show and hide these validation messages in our forms. But first, we need to get familiar with the states of a form control.
Control States
The most obvious state of a form control is the status
property. The value of status
can be one of the following, 'VALID'
, 'INVALID'
, 'PENDING'
(while an async validator waits on a result), or 'DISABLED'
. You can also use the shorthand properties valid
, invalid
, pending
, and disabled
, which are all booleans.
Other useful states are pristine
and its counterpart dirty
. These two states mark a control when its value has been changed by a user. The control starts in the pristine
status and when the user changes its value, the state of the control transforms to dirty
. Both properties are also booleans.
The last two useful states are untouched
and the opposite, touched
. When the user leaves a control (this triggers the blur
event), the status of the control is updated from untouched
to touched
. Again, both properties are also booleans.
The same states are also available on form groups (NgModelGroup
) and forms (NgForm
). A form also has a submitted
property, which becomes true
when the submit event is triggered.
CSS Classes
All control states have an equivalent CSS class.
To obtain the class of a state, simply prepend the state with ng-
.
This results in the following class names, .ng-valid
, .ng-invalid
, .ng-pending
, .ng-pristine
, .ng-dirty
, .ng-untouched
and .ng-touched
. Sadly, there is no .ng-submitted
class when a form has been submitted.
These class names can be used to style the control field of our forms.
For example, to change the border color to red when an invalid control is touched by the user, we can use the following styles.
input.ng-invalid.ng-touched:not(:focus),
select.ng-invalid.ng-touched:not(:focus),
textarea.ng-invalid.ng-touched:not(:focus) {
border-color: red;
}
/* all of the checkboxes inside a required checkbox group */
[requiredcheckboxgroup].ng-invalid.ng-touched input {
border-color: red;
}
Disabled State
A form control can be disabled by adding the disabled
attribute to the HTML element.
When a control is disabled, its status
will be changed to DISABLED
.
As a shortcut to check if a form control is disabled, we can also use the disabled
and enabled
properties.
It's important to know that if a control is disabled, all the validators of that control are also disabled and the value of the form model will be equal to undefined
.
Validation Messages
Now that we understand the basics of the different form control states, we can start the implementation to show validation messages to our users.
Control Errors
All the results of the validators are added to the errors
property of the form control instance.
This errors
property is an object, a key-value pair where each key is the name of a validator and the value contains the error details.
Be aware that errors
is null
when the form control is valid.
For example, for our custom validator RequiredCheckboxGroupValidatorDirective, the error key is requiredCheckboxGroup
, and details contain the number of required checkboxes.
To help users to fill in the form correctly, we need to translate the error details into a user-friendly message.
A naive implementation might look like this.
Notice that the messages are hidden until the control is touched by the user, and of course only when the control invalid.
<input type="text" name="name" ngModel required minlength="4" #name="ngModel" />
<div *ngIf="name.invalid && name.touched">
<div *ngIf="name.errors.required">Name is required.</div>
<div *ngIf="name.errors.minlength">
Name must be at least {{ name.errors.minlength.requiredLength }} characters long.
</div>
</div>
While the above solution works for simple projects, this doesn't scale in larger projects because it has some problems:
- the solution is brittle for changes, we have to manually add and remove validation messages when the validation logic of a form control is changed.
- it will lead to a bad user experience, 1) the wording of the messages won't be consistent, 2) the criteria when a message is shown is different depending on the developer who wrote the form
- creating or updating a new form will take a longer time because the form needs to be manually tied together, which also needs to be tested
To obtain a better experience for our users, we have to come up with an abstraction layer(s).
This extra layer will do two things:
- the result of the validator(s) are mapped to a validation message
- the layer determines when the message appears
If we build the layer correctly, it would be possible to use these two features independently of each other.
While this might take some time, it will drastically improve the time it takes to develop and maintain forms in the long run.
Luckily, there are already some battle-tested libraries available, Angular Material and Error Tailer by ngneat.
To give us a better understanding of the internals of such a validation layer, we're building the different pieces of the layer ourselves.
This solution is based on a similar custom-made solution that fits our specific needs.
Configuring Validation Messages
The first step towards reusable validation messages is to create a coat rack to hang up message templates.
We do this by creating a new InjectionToken
called VALIDATION_MESSAGES
.
Later on, we use the provided templates to build the validation messages.
import { InjectionToken } from '@angular/core'
export interface ValidationMessages {
[errorKey: string]: (...errorDetails: any[]) => string
}
export const VALIDATION_MESSAGES = new InjectionToken<ValidationMessages>(
'VALIDATION_MESSAGES',
)
To configure a message template, we provide the template as a factory function for each validator.
While we're configuring the Angular Modules, these templates are provided via the VALIDATION_MESSAGES
token.
For the built-in Angular validators, I like to provide these message templates in a central module.
import { VALIDATION_MESSAGES } from './validation-message'
@NgModule({
providers: [
{
provide: VALIDATION_MESSAGES,
useValue: {
required: () => 'This field is required',
email: () => 'This field must be a valid email',
minlength: (details: any) =>
`This field must have a minimum length of ${details.requiredLength}`,
maxlength: (details: any) =>
`This field must have a maximum length of ${details.requiredLength}`,
},
multi: true,
},
],
})
export class ValidatorModule {}
For the custom validators, I provide the message template in the same module wherein the validator is declared.
Because I follow the SCAM principles, coined by Lars Gyrup Brink Nielsen, this only doesn't look clean but it's also easy to use.
import { VALIDATION_MESSAGES } from './validation-message'
@NgModule({
declarations: [RequiredCheckboxGroupValidatorDirective],
exports: [RequiredCheckboxGroupValidatorDirective],
providers: [
{
provide: VALIDATION_MESSAGES,
useValue: {
requiredCheckboxGroup: (details: any) =>
`This field must have at least ${details.requiredCheckboxes} ${
details.groupName || 'items'
} selected`,
},
multi: true,
},
],
})
export class RequiredCheckboxGroupValidatorModule {}
Validate Pipe
To transform the form control errors to a validation message, we create a new Angular Pipe named ValidatePipe
. I like to use a pipe for this, just because the pipe doesn't contain any markup which makes it reusable in multiple cases.
To assemble the message, the validate pipe needs to have access to the coat rack of validation message templates. To make these templates available in the validate pipe, the VALIDATION_MESSAGES
token is injected into the pipe.
Next, the form control errors are passed to the transform
method of the validate pipe and the corresponding message templates can be looked up by using the error key and the injected messages. When the message template is found, the method is invoked with the error details.
This implementation of the ValidatePipe
pipe doesn't show all the validation messages, just the message for the first error.
When an error isn't configured, a default validation message is returned.
import { Pipe, PipeTransform, Inject } from '@angular/core'
import { ValidationMessages, VALIDATION_MESSAGES } from './validation-message'
@Pipe({ name: 'validate' })
export class ValidatePipe implements PipeTransform {
// create a key-value pair out of the provided validation messages
readonly validationMessage = this.validationMessages.reduce(
(all, entry) => ({ ...all, ...entry }),
{} as ValidationMessages,
)
constructor(
@Inject(VALIDATION_MESSAGES)
readonly validationMessages: ValidationMessages[],
) {}
transform(validationErrors: ValidationErrors | null) {
// pluck the first error out of the errors
const [error] = Object.entries(validationErrors || {})
if (!error) {
return ''
}
// create the validation message
const [errorKey, errorDetails] = error
const template = this.validationMessage[errorKey]
return template ? template(errorDetails) : 'This field is invalid'
}
}
We can now perform the first refactor to the initial implementation and replace the inline messages in the template with the validate
pipe.
This change ensures that the same validation messages are used throughout the whole application.
Because the validation messages are centralized it's also easy to change a message at a later time.
<input type="text" name="name" ngModel required minlength="4" #name="ngModel" />
<div *ngIf="name.invalid && name.touched">
{{ name.errors | validate }}
</div>
Error Component
To make sure that all the validation messages look and behave the same way, we need to create a component, ControlErrorComponent
.
The component is in charge of two things:
- it determines the markup and style of the message,
- it controls when the validation message is visible
In the template of ControlErrorComponent
, the errors are shown when a control is invalid and if it's been touched by a user.
To render the validation message, the validate
pipe is used (created in Validate Pipe).
import { Component, Input } from '@angular/core'
import { AbstractControl, NgForm } from '@angular/forms'
@Component({
selector: 'app-control-error',
template: `
<div
role="alert"
class="mt-1 text-sm text-red-600"
[hidden]="control.valid || !control.touched"
>
{{ control.errors | validate }}
</div>
`,
styles: [
`
:host {
margin: 0 !important;
}
`,
],
})
export class ControlErrorComponent {
@Input() control: AbstractControl
}
After the second refactor, the snippet now uses the ControlErrorComponent
component instead of the *ngIf
directive in the original snippet.
The abstracted ControlErrorComponent
component has the benefit that there is a uniform design and behavior, leading to a better user experience. From a technical perspective, we're protected against future design changes because we'll have to change the design only once.
<input type="text" name="name" ngModel required minlength="4" #name="ngModel" />
<app-control-error [control]="name.control">
{{ name.errors | validate }}
</app-control-error>
Error Directive
The current implementation requires that the ControlErrorComponent
component is added to a form control in order to show the message.
To solve this problem, we're introducing a new directive called ErrorDirective
.
The job of the error directive is to dynamically render the ControlErrorComponent
when a form control (or a form group) is rendered.
import {
Directive,
ComponentFactoryResolver,
AfterViewInit,
ViewContainerRef,
Optional,
} from '@angular/core'
import { NgControl, NgModelGroup } from '@angular/forms'
import { ControlErrorComponent } from './control-error.component'
import { FormFieldDirective } from './form-field.directive'
@Directive({
selector: '[ngModel], [ngModelGroup]',
})
export class ErrorDirective implements AfterViewInit {
constructor(
readonly componentFactoryResolver: ComponentFactoryResolver,
readonly viewContainerRef: ViewContainerRef,
@Optional() readonly ngModel: NgControl,
@Optional() readonly ngModelGroup: NgModelGroup,
@Optional() readonly formFieldDirective: FormFieldDirective,
) {}
ngAfterViewInit() {
setTimeout(() => {
const control = this.ngModel?.control ?? this.ngModelGroup?.control
if (control && !this.formFieldDirective) {
const componentFactory = this.componentFactoryResolver.resolveComponentFactory(
ControlErrorComponent,
)
const errorContainer = this.viewContainerRef.createComponent(
componentFactory,
)
errorContainer.instance.control = control
}
})
}
}
The way that the directive is written, the error component is added to the DOM under the input element.
This works fine for the simple controls, but it's causing troubles for form groups and checkboxes because the error might be shown in between multiple elements.
To fix this behavior, we create a second directive called FormFieldDirective
.
The idea behind this directive is the same as the ErrorDirective
directive, but instead that the validation message is added after form control, the message will be appended to the bottom of the form control's container.
import {
Directive,
ComponentFactoryResolver,
AfterViewInit,
ViewContainerRef,
Optional,
ContentChild,
ElementRef,
} from '@angular/core'
import { NgModel, NgModelGroup } from '@angular/forms'
import { ControlErrorComponent } from './control-error.component'
@Directive({
selector: '[formField]',
})
export class FormFieldDirective implements AfterViewInit {
@ContentChild(NgModel) ngModelChild?: NgModel
@ContentChild(NgModelGroup) ngModelGroupChild?: NgModelGroup
constructor(
private element: ElementRef,
private componentFactoryResolver: ComponentFactoryResolver,
private viewContainerRef: ViewContainerRef,
@Optional() private ngModelGroup: NgModelGroup,
) {}
ngAfterViewInit() {
setTimeout(() => {
const control =
this.ngModelGroup?.control ??
this.ngModelChild?.control ??
this.ngModelGroupChild?.control
if (control) {
const componentFactory = this.componentFactoryResolver.resolveComponentFactory(
ControlErrorComponent,
)
this.viewContainerRef.clear()
const errorContainer = this.viewContainerRef.createComponent(
componentFactory,
)
const host = this.element.nativeElement as HTMLElement
host.style.flexWrap = 'wrap'
host.appendChild(errorContainer.location.nativeElement)
errorContainer.instance.control = control
}
})
}
}
To use the form field directive we have to add the formField
attribute to the form control container.
We could also use the ControlErrorComponent
like before, but I find this solution to be more in-line with the ErrorDirective
.
<div class="checkbox-container" formField>
<input type="checkbox" id="tac" name="tac" ngModel required />
<label for="tac">I agree with the terms and conditions</label>
</div>
After the last refactor, we don't have any code in our forms to display the validation messages.
<input type="text" name="name" ngModel required minlength="4" />
Form Helpers
So far we're only marking the invalid form controls and are only showing validation messages when a user has touched the form control.
But the user also expects feedback when she submits the form.
To implement this feature, we have options.
The first one is to add a new condition to the Error Component and check if the form has been submitted by using the submitted
property on the form. Besides this, to add the red border color to invalid controls, a submitted
class should also be added to the form. That's why having a .ng-submitted
class would be useful, sadly this is not (yet?) the case.
The second option is to touch all form controls when a user submits the form.
This is simply done by invoking the markAllAsTouched
method of the form.
Errors Example
A demo about form control states and validation messages can be found in the following StackBlitz.
Dynamic Forms
To my surprise, creating dynamic (nested) forms with template-driven forms is straightforward.
I say this because this was always something that I've trouble with when I was using reactive forms.
Let's take a look at the following example to create a team and add, remove, and reorder team members dynamically.
To give you a better idea, the team form looks like this.
The code snippet below is trimmed down to only contain the basics, the key features are highlighted and will be discussed afterward.
import { Component, Output, ViewChild, EventEmitter } from '@angular/core';
import { NgForm } from '@angular/forms';
@Component({
template: `
<form #form="ngForm" (submit)="submit()">
<!-- iterate over all members of the model -->
<fieldset
*ngFor="let member of model.members;"
>
<label [for]="'first-name-' + member.id">First name</label>
<!-- input elements have a unique id and name -->
<input
type="text"
[id]="'first-name-' + member.id"
[name]="'first-name-' + member.id"
[(ngModel)]="member.firstName"
required
/>
<label [for]="'last-name-' + member.id">Last name</label>
<input
type="text"
[id]="'last-name-' + member.id"
[name]="'last-name-' + member.id"
[(ngModel)]="member.lastName"
required
/>
<button
type="button"
(click)="removeClicked(member.id)"
[hidden]="model.members.length === 1"
>
Remove member
</button>
</fieldset>
<button>Submit Form</button>
<button
type="button"
(click)="addClicked()"
[hidden]="model.members.length > 5"
>
Add team member
</button>
</form>
`
})
export class DynamicComponentFlat {
@Output() submitEmitter = new EventEmitter<any>();
@ViewChild(NgForm) form!: NgForm;
model: Team = {
members: [
{
id: Date.now().toString(),
firstName: 'Emily',
lastName: 'Earnshaw',
}
]
};
addClicked() {
// mutate the model by adding a new member
this.model.members.push({
id: Date.now().toString(),
lastName: '',
firstName: '',
});
}
removeClicked(id: string) {
// mutate the model by removing the member by id
this.model.members = this.model.members.filter((m) => m.id !== id);
}
submit() {
if (this.form.valid) {
this.submitEmitter.emit(this.model);
} else {
this.form.form.markAllAsTouched();
}
}
}
In Creating a Form, we've already learned that the form in the DOM is a representation of the TypeScript model.
That's why we can simply iterate over a collection of our model to create a nested form and bind the properties of the items to form controls by using two-way binding.
Every mutation made to that collection (model.members
in the example) will immediately be applied to the DOM structure.
To mutate the collection variable, we can use one of the Array prototype methods or reassign the variable to a new value.
Nested Forms
The template used in the example form uses a flat form model structure, but the (nested) form could also be rewritten as a nested form model. This isn't required, but it has advantages that might be useful in some scenarios.
One advantage is that because a nested form is a FormGroup
, you can use all its features. For example, the reset
method to reset all the form controls of the form group to clear all of the form control values, this reset is also reflected in the TypeScript model.
Another advantage is that you can add a validator to the form group. While this is also possible with a flat structure, it requires more effort to add the validator.
To convert a flat form to a nested form, you need to wrap the form controls with a parent element that has the ngModelGroup
directive.
In the example below, the id
s of the team members are used as form group keys to distinguish the multiple team member form groups. The example also adds an extra members
group around the team members to be able to reset all the team members at once.
@Component({
template: `
<form #form="ngForm" (submit)="submit()">
<!-- technically this is not needed, but it's added here to showcase the reset -->
<ng-container ngModelGroup="members">
<!-- iterate over all members of the model -->
<fieldset
*ngFor="let member of model.members;"
[ngModelGroup]="member.id"
>
<label for="first-name">First name</label>
<!-- input elements have a unique id but
the name is the same because it belongs to another group -->
<input
type="text"
id="first-name"
name="first-name"
[(ngModel)]="member.firstName"
required
/>
<label for="last-name">Last name</label>
<input
type="text"
id="last-name"
name="last-name"
[(ngModel)]="member.lastName"
required
/>
<button
type="button"
(click)="removeClicked(member.id)"
[hidden]="model.members.length === 1"
>
Remove member
</button>
<button
type="button"
(click)="memberResetClicked(member.id)"
>
Reset
</button>
</fieldset>
</ng-container>
<button>Submit Form</button>
<button
type="button"
(click)="addClicked()"
[hidden]="model.members.length > 5"
>
Add team member
</button>
<button
type="button"
(click)="teamResetClicked()"
>
Reset Team
</button>
<button
type="button"
(click)="formResetClicked()"
>
Reset Form
</button>
</form>
`,
})
export class DynamicComponentGrouped {
@Output() submitEmitter = new EventEmitter<any>();
@ViewChild(NgForm) form!: NgForm;
model: Team = {
members: [
{
id: Date.now().toString(),
firstName: 'Emily',
lastName: 'Earnshaw',
},
],
};
addClicked() {
this.model.members.push({
id: Date.now().toString(),
lastName: '',
firstName: '',
});
}
removeClicked(id: string) {
this.model.members = this.model.members.filter((m) => m.id !== id);
}
teamResetClicked() {
this.teamMembersControl.reset();
}
memberResetClicked(id: string) {
this.teamMembersControl.get(id)?.reset();
}
formResetClicked() {
this.model = {
members: [],
};
}
get teamMembersControl() {
return this.form.form.get('members') as FormGroup;
}
submit() {
if (this.form.valid) {
this.submitEmitter.emit(this.model);
} else {
this.form.form.markAllAsTouched();
}
}
}
Dynamic Nested Forms Example
The full example can be found in the following StackBlitz.
The example also includes the code to reorder the team members and extra validation.
Sub-Form Components
So far, we've only seen a form that is hosted in a single component.
This practice is not always convenient, and it might be better to extract some logic by splitting up the component. You refactor the component when it becomes an unmanageable mess or when a part of the form needs to be reusable.
That's where sub-form components come into play, and there are two different solutions to create these.
The best resource out there about advanced form topics is the talk Angular Forms by Kara Erickson.
Injecting the Control Container
The simplest and fastest solution is to pass the ControlContainer
from the parent component to the sub-form component. As the name ControlContainer
implies, it's a container that serves to group multiple form control instances. Both NgForm
and NgModelGroup
are control containers.
To make the parent's form accessible in the sub-form, you must inject the control container as a view provider in the sub-form component.
@Component({
template: '...',
viewProviders: [
{
provide: ControlContainer,
// when the sub-form is a child of a form
useExisting: NgForm,
// when the sub-form is a child of a model group
useExisting: NgModelGroup
}
]
})
export class SubFormComponent {}
Because the sub-form can be a child of a form or a model group, you have to use the correct parent instance. This makes the sub-form component not as reusable as we'd hoped because we don't know if the sub-form will be used as a child of one of the two parent containers. In an ideal world, we want the sub-form to be used in both cases.
A less brittle solution is to always provide the correct control container (duh...!).
To do this, we can reuse this snippet that I took from Ward Bell.
The formViewProvider
always returns the proper parent instance. The provider first tries to return the NgModelGroup
but falls back to a NgForm
if the NgModelGroup
does not exist.
export const formViewProvider: Provider = {
provide: ControlContainer,
useFactory: _formViewProviderFactory,
deps: [
[new Optional(), NgForm],
[new Optional(), NgModelGroup]
]
};
export function _formViewProviderFactory(
ngForm: NgForm, ngModelGroup: NgModelGroup
) {
return ngModelGroup || ngForm || null;
}
Which is used in the sub-form component.
@Component({
template: '...',
viewProviders: [formViewProvider]
})
export class SubFormComponent {}
Once the control container is injected, you can continue to create the form in the sub-component.
As an example, take a look at the refactored version of the team form.
In the example, the team members are extracted into a team member sub-component.
@Component({
selector: 'app-team',
template: `
<form (submit)="submit()">
<label for="team-name">Team name</label>
<input
type="text"
id="team-name"
name="team-name"
[(ngModel)]="model.name"
required
/>
<app-team-members
[members]="model.members"
(add)="addTeamMember()"
(remove)="removeTeamMember($event)"
>
</app-team-members>
</form>
`,
})
export class TeamComponent {
@Output() submitEmitter = new EventEmitter<any>();
@ViewChild(NgForm) form!: NgForm;
model: Team = {
name: '',
members: [
{
id: Date.now().toString(),
firstName: 'Emily',
lastName: 'Earnshaw',
},
],
};
addTeamMember() {
this.model.members.push({
id: Date.now().toString(),
lastName: '',
firstName: '',
});
}
removeTeamMember(memberId: string) {
this.model.members = this.model.members.filter((m) => m.id !== memberId);
}
submit() {
if (this.form.valid) {
this.submitEmitter.emit(this.model);
} else {
this.form.form.markAllAsTouched();
}
}
}
The team member component looks like this.
As you can see, besides injecting the control container, this solution doesn't change how (sub-) forms are built.
@Component({
selector: 'app-team-members',
viewProviders: [formViewProvider],
template: `
<fieldset
*ngFor="let member of members"
[ngModelGroup]="member.id"
#memberForm="ngModelGroup"
>
<label [for]="'first-name-' + member.id">First name</label>
<input
type="text"
[id]="'first-name-' + member.id"
name="first-name"
[(ngModel)]="member.firstName"
required
/>
<label [for]="'last-name-' + member.id">Last name</label>
<input
type="text"
[id]="'last-name-' + member.id"
name="last-name"
[(ngModel)]="member.lastName"
required
/>
<button
type="button"
(click)="remove.emit(member.id)"
[hidden]="members.length === 1"
>
Remove member
</button>
<button
type="button"
(click)="memberResetClicked(memberForm)"
>
Reset
</button>
</fieldset>
<button>Submit Form</button>
<button
type="button"
(click)="add.emit()"
[hidden]="members.length > 5"
>
Add team member
</button>
`,
})
export class TeamMemberComponent {
@Input() members: TeamMember[] = [];
@Output() add = new EventEmitter<void>();
@Output() remove = new EventEmitter<string>();
memberResetClicked(memberForm: NgModelGroup) {
memberForm.reset();
}
}
Control Value Accessor
While the control container approach is simple, it isn't as robust as a Control Value Accessor (or CVA in short).
The control container ties the sub-form specifically to template-driven forms. This isn't a big deal if your team only uses template-driven forms, but it might be a problem when your components are shared across multiple teams, which might use the reactive forms API.
Another benefit of Control Value Accessors is that a Control Value Accessor can also be implemented as an Angular directive.
Depending on the project you're working on, these benefits don't outweigh the extra complexity of a Control Value Accessor.
To create a Control Value Accessor you must implement the ControlValueAccessor
interface.
I won't go into the details of Control Value Accessors, but here's how a simple typeahead implementation looks like.
To register the Control Value Accessors, you must provide the component or directive to the NG_VALUE_ACCESSOR
multi-token.
The component or directive, provides an implementation for the writeValue
, registerOnChange
, registerOnTouched
, and optionally setDisabledState
methods from the ControlValueAccessor
interface to bind the Angular API to a DOM element.
@Directive({
selector: 'input[type=text][ngModel][typeaheadItems]',
host: {
'(input)': 'inputInputted($event)',
'(focus)': 'inputFocussed($event)',
'(blur)': 'inputBlurred($event)',
},
providers: [
{
provide: NG_VALUE_ACCESSOR,
multi: true,
useExisting: TypeaheadDirective,
},
],
})
export class TypeaheadDirective implements ControlValueAccessor {
@Input() typeaheadItems?: { value: any; label: string }[];
selectedItem: { value: any; label: string } | null = null;
onChange = (_: any) => {};
onTouched = () => {};
factory = this.componentFactoryResolver.resolveComponentFactory(
TypeaheadItemsComponent
);
menuItemsRef?: ComponentRef<TypeaheadItemsComponent>;
constructor(
readonly elementRef: ElementRef,
readonly componentFactoryResolver: ComponentFactoryResolver,
readonly viewContainerRef: ViewContainerRef
) {}
@HostListener('document:click', ['$event'])
documentClicked(event: MouseEvent) {
if (event.target !== this.elementRef.nativeElement) {
this.menuItemsRef?.instance.itemSelected.unsubscribe();
this.menuItemsRef?.destroy();
if (!this.selectedItem) {
this.writeValue(null);
}
}
}
inputInputted(event: Event) {
this.populateItems((event.target as HTMLInputElement).value);
this.onChange(null);
this.selectedItem = null;
}
inputFocussed(event: Event) {
this.menuItemsRef = this.viewContainerRef.createComponent(this.factory);
this.populateItems((event.target as HTMLInputElement).value);
this.menuItemsRef.instance.itemSelected.subscribe({
next: (value: { value: any; label: string }) => this.itemClicked(value),
});
}
inputBlurred() {
this.onTouched();
}
itemClicked(item: { value: any; label: string }) {
this.onChange(item.value);
this.writeValue(item);
}
writeValue(obj: any): void {
// update the value of the input element when the model's value changes
this.elementRef.nativeElement.value = obj && obj.label ? obj.label : '';
this.selectedItem = obj;
}
registerOnChange(fn: any): void {
// register the `onChange` hook to update the value of the model
this.onChange = fn;
}
registerOnTouched(fn: any): void {
// register the `onTouched` hook to mark when the element has been touched
this.onTouched = fn;
}
setDisabledState?(isDisabled: boolean): void {
// disable the native element when the form or control is disabled
this.elementRef.nativeElement.disabled = isDisabled;
}
private populateItems(value: string) {
if (this.menuItemsRef) {
this.menuItemsRef.instance.data =
this.typeaheadItems?.filter((v) => v.label.includes(value)) || [];
}
}
}
Next, you can consume the Control Value Accessor as you would with a native/Angular control.
Meaning that you can simply add the ngModel
attribute to the Control Value Accessor.
<label for="team-level">Team level</label>
<!-- if the CVA is a directive -->
<input
type="text"
id="team-level"
name="team-level"
required
[(ngModel)]="model.level"
[typeaheadItems]="levels"
/>
<!-- if the CVA is a component -->
<app-typeahead
name="team-level"
required
[(ngModel)]="model.level"
[typeaheadItems]="levels"
></app-typeahead>
Sub-Form Components Example
As always, the example of this section is also available as a StackBlitz project.
The code used in this guide can be found on GitHub. This guide is a Work In Process. During the next weeks, I'll probably cover validation, nested forms, how to test template-driven forms, control value accessors, and dynamic forms. If you have anything you want to see here or if you have suggestions feel free to reach out on Twitter or create an issue on GitHub.
Follow me on Twitter at @tim_deschryver | Subscribe to the Newsletter | Originally published on timdeschryver.dev.
Top comments (4)
Hi @timdeschryver ,
Thanks for the greatest template-driven-forms tutorial that I saw, I recommend it to all the folks that I know ๐
I wanted to let you know that there's some problem with
Forms Controls Example
chapter - it doesn't have the expected link/preview here, and it's kinda broken (for me?) on your personal site. Looks like the same is true for other blitzes as well. And also the remark aboutIn Displaying Validation Errors (needs to be written)...
is not relevant anymore, I guess, as this chapter is already written and it's cool ๐Btw, this stackblitz-generated link for the mentioned Github repo worked for me - stackblitz.com/github/timdeschryve...
Hi, I'm glad to hear that!
Could you try the stackblitzes again? They seem to work for me, although they're not focusing the correct file (that's something I will fix).
Also, thank for "In Displaying Validation Errors" - this will be fixed later today ๐
Thanks Tim! I have double-checked and actually you're right - the blitzes work in Chrome. The reason it didn't work for me is that my default browser is Brave - in Brave it looks like that:
As for dev.to - I don't see the blitzes in Chrome here as well:
Thanks for the reply ๐
I'll see if I can tweak my dev.to publisher to include the stackblit links in the future.