ParsleyJS est une librairie Javascript permettant de contrôler la saisie de ses formulaires. Elle est livrée avec de nombreuses traductions de ses messages d’erreurs. Si vous gérez les dépendances de votre projet avec RequireJS, voici comment charger élégamment les traductions de Parsley.
Configuration des dépendances avec RequireJS
On indique à RequireJS le path vers les modules « parsley », « parsleyfr » et « parsleyfrextra ». Puis, on utilise les shims pour définir 2 nouvelles dépendances du module « parsley » :
- parsleyfr
- parsleyfrextra
require.config({
paths: {
"jquery": "libs/jquery/dist/jquery",
"underscore": "libs/underscore/underscore",
"backbone": "libs/backbone/backbone",
"parsley": "libs/parsleyjs/dist/parsley",
"parsleyfr": "libs/parsleyjs/src/i18n/fr",
"parsleyfrextra": "libs/parsleyjs/src/i18n/fr.extra",
},
shim: {
"parsley": {
deps: ["parsleyfr", "parsleyfrextra"]
},
}
});
Déclaration d’une dépendance à Parsley
Ensuite, dans nos modules qui dépendent de Parsley, on indique normalement la dépendance dans la fonction « define ».
define([
"backbone",
"underscore",
"parsley"
],
function(Backbone, _) {
}
);
Grâce aux shims, RequireJS va charger les modules « parsleyfr » et « parsleyfrextra » avant le module « parsley ». Vous pourrez ensuite changer la locale de vos contrôles de formulaires en appelant la méthode « setLocale » de ParsleyJS.
window.Parsley.setLocale('fr');
Un peu de lecture
- Un très bon article pour comprendre AMD et RequireJS : https://www.devbridge.com/articles/understanding-amd-requirejs/
- La doc de Parsley : http://parsleyjs.org/doc/index.html