Syntaxe
<element ng-bind-template="expression"></element>
|
Paramètres
Nom |
Description |
element |
Ce paramètre permet d'indiquer une balise. |
expression |
Ce paramètre permet d'indiquer une ou plusieurs expressions à évaluer, chacun entouré de «{{» et «}}». |
Description
Cette directive permet d'indiquer que le contenu du texte doit être remplacé par un gabarit.
Remarques
- Affichage de texte combinant plusieurs expressions : La directive ng-bind-template permet d'afficher une combinaison de plusieurs expressions
AngularJS dans une seule chaîne de texte. Contrairement à ng-bind, elle gère plusieurs variables ou calculs dans une seule liaison.
- Alternative aux accolades multiples : Plutôt que d'utiliser plusieurs accolades {{ }} dans une portion de texte, ng-bind-template centralise le rendu
dans un seul attribut, rendant le code plus lisible et évitant le flash de contenu non traité.
- Évaluations dynamiques des expressions : Les expressions AngularJS utilisées dans ng-bind-template sont évaluées dynamiquement. Toute modification
d'une des expressions liées entraînera une mise à jour automatique du contenu de l'élément.
- Prévention du flash de contenu non traité (FOUC) : À l'instar de ng-bind, ng-bind-template supprime le flash de contenu non traité visible avant la
compilation d'AngularJS, offrant une meilleure expérience utilisateur.
- Pas de support pour le HTML : Comme ng-bind, cette directive affiche uniquement du texte brut, même si les expressions renvoient du contenu contenant des
balises HTML. Pour afficher du HTML, il faut utiliser ng-bind-html avec
ngSanitize.
- Utile pour des phrases dynamiques : ng-bind-template est particulièrement utile lorsque des phrases entières doivent être construites dynamiquement à partir
de plusieurs expressions, par exemple : "Bonjour, {{nom}}. Aujourd'hui, nous sommes le {{date}}".
- Amélioration des performances : En regroupant les expressions dans une seule directive, ng-bind-template peut être plus performant que plusieurs accolades
imbriquées, car AngularJS n'ajoute qu'un seul watcher pour surveiller les changements.
- Compatibilité avec divers types d'éléments HTML : Comme les autres directives de liaison de données (ng-bind et ng-bind-html),
ng-bind-template peut être utilisée sur n'importe quel élément HTML comme <div>,
<p>, ou <span>, mais elle est généralement réservée aux éléments contenant du texte.
Dernière mise à jour : Dimanche, le 9 décembre 2018