Para cargar un main.js
archivo personalizado en todas las páginas (en el modo RequireJS), esta es una buena manera:
1) Crear main.js
Crear main.js
dentro de la carpeta del tema
<theme_dir>/web/js/main.js
con este contenido:
define([
"jquery"
],
function($) {
"use strict";
// Here your custom code...
console.log('Hola');
});
En resumen : declaramos dependencias al inicio, por ejemplo "jquery"
. Definimos como parámetro de la función el nombre de la variable para usar la dependencia dentro de la función, por ejemplo "jquery" --> $
. Ponemos todo nuestro código personalizado dentro function($) { ... }
.
2) Declarar main.js
con un requirejs-config.js
archivo
Cree un requirejs-config.js
archivo dentro de la carpeta del tema:
<theme_dir>/requirejs-config.js
con este contenido:
var config = {
// When load 'requirejs' always load the following files also
deps: [
"js/main"
]
};
"js/main"
Es el camino a nuestra costumbre main.js
. La extensión ".js" no es necesaria.
Nuestro requirejs-config.js
se fusionará con otro requirejs-config.js
definido en Magento.
RequireJS cargará nuestro main.js
archivo, en cada página, resolviendo dependencias y cargando archivos de forma asíncrona.
Opcional: incluye biblioteca de terceros
Esta es la forma de incluir bibliotecas de terceros.
1) Agregue la biblioteca en web/js
:
<theme_dir>/web/js/vendor/jquery/slick.min.js
2) Abra requirejs-config.js
y agregue este contenido:
var config = {
deps: [
"js/main"
],
// Paths defines associations from library name (used to include the library,
// for example when using "define") and the library file path.
paths: {
'slick': 'js/vendor/jquery/slick.min',
},
// Shim: when you're loading your dependencies, requirejs loads them all
// concurrently. You need to set up a shim to tell requirejs that the library
// (e.g. a jQuery plugin) depends on another already being loaded (e.g. depends
// on jQuery).
// Exports: if the library is not AMD aware, you need to tell requirejs what
// to look for so it knows the script has loaded correctly. You can do this with an
// "exports" entry in your shim. The value must be a variable defined within
// the library.
shim: {
'slick': {
deps: ['jquery'],
exports: 'jQuery.fn.slick',
}
}
};
Parece más complicado de lo que realmente es.
3) Agregue la dependencia dentro de main.js
:
define([
'jquery',
'slick'
],
function($) {
// ...
});