Saltar al contenido

Recursos del campo de código

Además de los estilos y scripts estáticos en forma de archivos, Blockstudio también admite bloques de recursos dinámicos mediante el campo de código. Según el caso de uso, se pueden limitar al bloque.

Uso básico

En el caso más sencillo, puede mostrar manualmente el contenido del campo de código en su plantilla.

PHP

PHP
<div useBlockProps>
  <h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>

Twig

Twig
<div useBlockProps>
  <h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>

Selector con ámbito

Para evitar conflictos con otros bloques, puede usar la variable %selector% dentro del campo de código junto con useBlockProps en su plantilla de renderizado.

En los campos de código, %selector% apunta a la instancia individual del bloque. En los archivos CSS y SCSS, %selector% apunta a la clase compartida del bloque.

Ejemplo

Imaginemos que queremos apuntar a la etiqueta h1 del ejemplo anterior desde nuestro campo de código.

CSS
%selector% h1 {
  color: red;
}

Ahora, Blockstudio hará tres cosas:

  • Creará un ID único para esa instancia del bloque
  • Reemplazará %selector% por el ID único
  • Añadirá el mismo selector al elemento marcado con useBlockProps

El resultado final será algo parecido a esto:

HTML
<div data-assets="c9abe0d95c2b">
  <h1>My block</h1>
</div>
<style>
  [data-assets='c9abe0d95c2b'] h1 {
    color: red;
  }
</style>

Renderizado automático

Tener que renderizar manualmente la etiqueta de estilo puede resultar engorroso. Para simplificar este proceso, puede usar el atributo asset dentro del campo de código.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "code",
        "label": "Custom CSS",
        "language": "css",
        "asset": true
      }
    ]
  }
}

Esto creará automáticamente etiquetas style para los bloques de código marcados como css y las moverá al encabezado del documento. Para los campos cuyo idioma esté marcado como javascript, se crearán etiquetas script en su lugar y se colocarán al final del cuerpo.

En las extensiones

Al usar campos de código dentro de extensiones, el atributo asset no es necesario. Blockstudio renderizará automáticamente el contenido del campo de código como un recurso si el idioma es css o javascript.

Ejemplo

JSON
{
  "$schema": "https://blockstudio.dev/schema/extend",
  "name": "core/*",
  "blockstudio": {
    "extend": true,
    "attributes": [
      {
        "id": "customCss",
        "type": "code",
        "label": "Custom css",
        "language": "css"
      }
    ]
  }
}

No se necesita configuración adicional. Lo anterior mostrará un campo de código para cada bloque core/* en la barra lateral y renderizará automáticamente su contenido como un recurso en la página.

SCSS

Los campos de código admiten la compilación de SCSS. Configure el idioma como scss y Blockstudio compilará el valor mediante ScssPhp antes de renderizarlo como CSS.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "styles",
        "label": "Styles",
        "language": "scss",
        "asset": true
      }
    ]
  }
}

Las funciones de SCSS, como variables, anidamiento y mixins, funcionan:

Scss
%selector% {
  $primary: #3b82f6;

  h1 {
    color: $primary;
  }

  &:hover {
    background: lighten($primary, 40%);
  }
}

En el editor, SCSS se compila en tiempo real en el servidor para que vea el resultado mientras escribe. En la interfaz, la compilación se realiza durante el renderizado del bloque.