Saltar al contenido

Procesamiento de recursos

Minificación

Blockstudio puede minimizar automáticamente todos los archivos CSS y JS de un bloque.

Los archivos compilados se guardarán en la carpeta _dist del bloque y se añadirán cuando se use el bloque. Al actualizar el archivo de origen, Blockstudio comprueba si existe un archivo compilado con esa marca de tiempo; si no existe, lo crea.

Para ello se utiliza la biblioteca minify.

La minificación se puede activar con el ajuste assets/minify:

PHP
add_filter('blockstudio/settings/assets/minify/css', function() {
  return true;
});

add_filter('blockstudio/settings/assets/minify/js', function() {
  return true;
});

SCSS

Si prefiere escribir sus estilos en SCSS, puede activar el procesamiento de SCSS:

PHP
add_filter('blockstudio/settings/assets/process/scss', function() {
  return true;
});

Esto activará el procesamiento de SCSS para los archivos .css.

También puede usar la extensión .scss para que los estilos se procesen automáticamente aunque el ajuste anterior no esté true.

Rutas de importación

Al usar SCSS, es posible importar otros archivos SCSS. Las rutas de importación son relativas al archivo desde el que se importan.

CSS
@import "modules.scss";

Además, se pueden definir rutas de importación personalizadas mediante el filtro blockstudio/assets/process/scss/import_paths, para importar archivos de otros directorios sin especificar la estructura de carpetas.

Las importaciones pueden omitir la extensión .scss y resolver parciales como _tokens.scss o el archivo _index.scss de un directorio.

PHP
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
  $paths[] = get_template_directory() . '/scss';
  return $paths;
});

Preludio

Si quiere tener funciones, variables, mixins o utilidades de Sass compartidas disponibles en cada archivo SCSS, puede anteponer un preludio global antes de la compilación.

Esto resulta útil con marcos de trabajo como Bootstrap, cuando quiera acceder a mixins compartidos como los puntos de interrupción sin repetir las importaciones en cada recurso del bloque.

PHP
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
  return '@import "functions";' . "\n"
    . '@import "variables";' . "\n"
    . '@import "mixins";';
}, 10, 3);

Combinado con blockstudio/assets/process/scss/import_paths, esto pone a disposición de cada archivo compilado la superficie de Sass referenciada.

Los recursos de bloque se vuelven a compilar cuando cambia la fecha de modificación de una dependencia, incluidos los archivos importados por otros parciales. Blockstudio sigue las dependencias locales @import, @use y @forward, incluidas las dependencias del preludio y las rutas de importación configuradas. Las dependencias compartidas se rastrean una sola vez y los ciclos no pueden provocar bucles durante la detección. Estos archivos también se incluyen en la lista de vigilancia de la caché en tiempo de ejecución.

Por ejemplo, al editar mixins/_wysiwyg.scss se vuelve a compilar global-styles.scss si importa scss/_wysiwyg.scss, que a su vez importa ese mixin. No es necesario modificar el archivo de entrada. Los módulos integrados de Sass y las importaciones remotas se excluyen del grafo de dependencias locales.

Módulos ES

De forma predeterminada, todos los scripts (en línea y predeterminados) de Blockstudio se cargan con type="module" aplicado. Esto permite usar la sintaxis de importación en los scripts de sus bloques sin configuración adicional.

Nota

Para profundizar en los módulos ES, visite la documentación web de MDN.

Imaginemos el siguiente código dentro de un script.js:

JavaScript
import { h, render } from "https://esm.sh/preact@10.15.1";
import htm from "https://esm.sh/htm@3.1.1";
import confetti from "https://esm.sh/canvas-confetti@1.6.0";

const html = htm.bind(h);

function App(props) {
  confetti();
  return html`<h1>Hello ${props.name}!</h1>`;
}

render(
  html`<${App} name="Hello from Preact!" />`,
  document.querySelector("#element")
);

El ejemplo anterior crearía un componente con Preact, importando todos los componentes y funciones necesarios desde un CDN compatible con ESM, en este caso esm.sh. Aunque este enfoque no tiene nada de malo, tiene el inconveniente de que debe solicitar los recursos necesarios a un sitio externo, con el riesgo de que los scripts dejen de funcionar si el CDN no está disponible.

Blockstudio incluye una forma práctica de descargar módulos ES al bloque, lo que elimina la necesidad de usar CDN ESM externos en producción.

Configuración

Para descargar un módulo al directorio de su bloque, use el prefijo npm: seguido del nombre y la versión del paquete:

JavaScript
import { h, render } from "npm:preact@10.15.1";
import htm from "npm:htm@3.1.1";
import confetti from "npm:canvas-confetti@1.6.0";

Esta sintaxis coincide con la convención del especificador Deno de npm.

Nota

El prefijo heredado blockstudio/ (e.g, blockstudio/preact@10.15.1) sigue siendo compatible con versiones anteriores, pero recomendamos usar el prefijo npm: en proyectos nuevos. Consulte la guía de migración para obtener más información.

Blockstudio comprobará automáticamente si los archivos .js modificados contienen importaciones y los descargará al directorio local del bloque. Los archivos descargados se guardarán en una carpeta modules dentro del directorio del bloque.

Al guardar, se reescribirá el archivo de script para adaptarlo al módulo alojado localmente:

JavaScript
import { h, render } from "./modules/preact/10.15.1.js";
import htm from "./modules/htm/10.15.1.js";
import confetti from "./modules/canvas-confetti/1.6.0.js";

Al trabajar en el bloque y obtener su vista previa en el editor, se seguirá usando la URL CDN (Blockstudio usa esm.sh).

Consideraciones

Versión

Normalmente, se pueden usar módulos de CDN sin indicar el número de versión. En ese caso, siempre se usará la versión más reciente. Como Blockstudio no guarda información en la base de datos, es obligatorio indicar una versión al usar módulos.

Mismos módulos

Los módulos están aislados en sus bloques. Aunque use el mismo módulo con el mismo número de versión en varios bloques, Blockstudio seguirá descargando el módulo solicitado al bloque. Esto se debe principalmente a que los bloques deben ser unidades independientes, fáciles de compartir entre otras instalaciones o sitios.

Además, se solicitará dos veces el mismo módulo si ambos bloques están presentes en una página. Este problema se puede resolver usando script-inline.js en lugar del archivo script.js. Blockstudio reescribirá cada importación para que apunte a la ubicación de la primera aparición del módulo si coinciden el nombre y el número de versión.

Cargador de CSS

También es posible importar archivos CSS con la misma sintaxis anterior.

JavaScript
import "npm:swiper@11.0.0/swiper.min.css";

El archivo CSS se descargará en la carpeta modules y se añadirá automáticamente cuando se use el bloque. Mientras la versión sea la misma, solo se añadirá una versión del archivo CSS, aunque exista en varios bloques.