ng-pluralize |
AngularJS |
---|---|
JavaScript |
Syntaxe
<ng-pluralize count="expression" when="string" [offset="number"]> ... </ng-pluralize> |
Syntaxe par élément |
<element ng-pluralize count="expression" when="string" [offset="number"]> ... </element> |
Syntaxe par attribut |
Paramètres
Nom | Description |
---|---|
element | Ce paramètre permet d'indiquer une balise. |
expression | Ce paramètre permet d'indiquer une expression correspondant à la variable à laquelle être lié. |
string | Ce paramètre permet d'indiquer la cartographie entre la catégorie plurielle et ses chaînes de caractères correspondantes. |
number | Ce paramètre permet d'indiquer le déplacement à déduire du nombre total. |
Description
Cette directive permet d'indiquer qu'un message a afficher doit s'accorder avec les règles linguistiques régionales «en-us».
Remarques
- Gestion des textes pluriels dynamiques : La directive ng-pluralize permet de gérer dynamiquement les textes pluriels en fonction d'une valeur numérique. Elle est idéale pour afficher correctement des phrases qui varient selon qu'elles concernent un seul élément ou plusieurs, comme "1 message" ou "5 messages".
- Définition des règles de pluralisation : Avec l'attribut when, on peut définir un ensemble de règles correspondant aux différentes formes de texte en fonction de la valeur. Par exemple, { 'one': '1 message', 'other': '{} messages' } permet de spécifier les textes pour les cas singulier et pluriel.
- Compatibilité avec les règles zéro et null : ng-pluralize prend en charge des règles spécifiques pour les cas où la valeur est égale à zéro ou nulle. Cela permet de gérer des phrases comme "Aucun message" ou "Pas encore de messages" sans ajouter de logique conditionnelle dans le contrôleur.
- Support des localisations complexes : La directive permet de personnaliser les textes en fonction des règles de pluralisation propres à différentes langues. En combinant ng-pluralize avec des fichiers de traduction, on peut gérer des applications multilingues facilement.
- Utilisation de la syntaxe {} pour la substitution : Dans les textes définis avec when, la syntaxe {} est utilisée pour insérer dynamiquement la valeur numérique. Par exemple, une règle comme 'other': '{} items' affichera automatiquement le nombre d'éléments dans la phrase.
- Gestion des performances : Comparée à des expressions conditionnelles répétées dans le HTML, ng-pluralize est plus performante et maintenable pour les scénarios de pluralisation. Elle réduit également le besoin d'écrire du JavaScript supplémentaire pour gérer les variations.
- Interaction avec le contrôleur AngularJS : La valeur utilisée par ng-pluralize est souvent liée au modèle AngularJS, ce qui signifie que les changements dans le contrôleur ou dans l'étendue se reflètent immédiatement dans l'interface utilisateur, rendant le contenu dynamique.
- Amélioration de la lisibilité du code : L'utilisation de ng-pluralize améliore la lisibilité du code HTML en évitant de longues chaînes de conditions ou des structures complexes. Tout le traitement des cas singuliers, pluriels, et autres variations est centralisé dans l'attribut when.
Dernière mise à jour : Dimanche, le 9 décembre 2018