Migrations

Migration vers la syntaxe du control flow

La syntaxe du control flow est disponible depuis Angular v17. La nouvelle syntaxe est intégrée au template : vous n'avez donc plus besoin d'importer CommonModule.

Ce schematic migre tout le code existant de votre application vers la nouvelle syntaxe du control flow.

Lancez le schematic avec la commande suivante :

ng generate @angular/core:control-flow

Options de configuration

La migration propose quelques options pour l'ajuster finement à vos besoins.

--path

Par défaut, la migration met à jour tout votre workspace Angular CLI. Vous pouvez limiter la migration à un sous-répertoire spécifique avec cette option.

--format

Par défaut, la migration reformate les templates qu'elle modifie. Désactivez cette option pour conserver la mise en forme existante de vos templates.

Changements incompatibles

Réutilisation des vues avec @for

Si une propriété utilisée dans l'expression track d'un bloc @for change mais que la référence de l'objet reste la même (modification en place), Angular met à jour les bindings de la vue (y compris les inputs des composants) au lieu de détruire et recréer l'élément.

Cela diffère de *ngFor, qui remonterait l'élément (le détruirait puis le recréerait) dans une situation similaire si la fonction trackBy renvoyait une valeur différente.