Directives είναι κλάσεις που προσθέτουν συμπεριφορά ή τροποποιούν στοιχεία στο DOM. Το Angular έχει τρεις τύπους: components (directives με template), structural directives (αλλάζουν την διάταξη DOM) και attribute directives (αλλάζουν την εμφάνιση/συμπεριφορά).
Προσθέτουν ή αφαιρούν στοιχεία και έχουν πρόθεμα :
*<p *ngIf="isLoggedIn">Welcome back!</p> <!-- add/remove based on condition -->
<li *ngFor="let item of items; let i = index"> <!-- repeat an element per item -->
{{ i }}: {{ item.name }}
</li>
<div [ngSwitch]="status">
<p *ngSwitchCase="'active'">Active</p>
<p *ngSwitchDefault>Unknown</p>
</div>
(Το σύγχρονο Angular προσφέρει επίσης τη νεότερη σύνταξη @if / @for control-flow που αντικαθιστά *ngIf/*ngFor.)
Τροποποιούν ένα υπάρχον στοιχείο χωρίς να το προσθέτουν/αφαιρούν:
<div [ngClass]="{ active: isActive, error: hasError }">...</div> <!-- toggle classes -->
<div [ngStyle]="{ color: textColor }">...</div> <!-- dynamic styles -->
<input [(ngModel)]="name" /> <!-- two-way binding -->
import { Directive, ElementRef, HostListener } from "@angular/core";
@Directive({ selector: "[appHighlight]" }) // used as <p appHighlight>
export class HighlightDirective {
constructor(private el: ElementRef) {}
@HostListener("mouseenter") onEnter() {
this.el.nativeElement.style.background = "yellow"; // change the host element
}
@HostListener("mouseleave") onLeave() {
this.el.nativeElement.style.background = "";
}
}
Μια προσαρμοσμένη directive λαμβάνει αναφορά στο στοιχείο-ξενιστή και μπορεί να ανταποκριθεί σε συμβάντα — εδώ, επισήμανση στο hover. Χρησιμοποιείται ως <p appHighlight>Text</p>.
<p *ngIf="x">...</p>
<!-- desugars to: -->
<ng-template [ngIf]="x"><p>...</p></ng-template>
Το * είναι συντομογραφία που τυλίγει το στοιχείο σε <ng-template> — γι' αυτό τα structural directives μπορούν να προσθέσουν/αφαιρέσουν το στοιχείο εντελώς.
Τα directives είναι ο τρόπος με τον οποίο το Angular χειρίζεται το DOM δηλωτικά.
Τα ενσωματωμένα structural (*ngIf/*ngFor/@if/@for) και attribute (ngClass/ngStyle/ngModel) directives καλύπτουν τις περισσότερες ανάγκες και τα προσαρμοσμένα directives σας επιτρέπουν να ενσωματώσετε επαναχρησιμοποιήσιμη συμπεριφορά DOM (highlight, tooltip, click-outside).
Η κατανόηση των τριών κατηγοριών — και ότι τα components είναι τα ίδια directives με templates — είναι το κέντρο του μοντέλου template του Angular.