Aller au contenu

Ressources

Blockstudio fournit un pipeline de ressources sans configuration pour vos blocs. Déposez des fichiers CSS, SCSS ou JavaScript à côté de votre bloc : ils seront compilés, minifiés et mis en file d’attente automatiquement.

Examiner les ressources d’un bloc

bs_block_assets('theme/card') renvoie les ressources frontend et de la zone de canevas de l’éditeur découvertes pour un bloc Blockstudio enregistré. Appelez-le après l’enregistrement du bloc, à partir de init. Les blocs inconnus, les blocs non-Blockstudio et ceux sans ressources renvoient []. Cette fonction auxiliaire ne rend pas le bloc, ne met rien en file d’attente et ne déclenche aucune compilation.

PHP
$assets = bs_block_assets('theme/card');

// Each entry has this shape:
[
  'type' => 'style',
  'handle' => 'blockstudio-theme-card-style-css',
  'url' => '/wp-content/blockstudio/cache/.../style-123.css?ver=123',
  'inline' => false,
  'scope' => ['frontend', 'editor'],
  'html' => '<link ...>',
];
  • type est style pour CSS et module pour JavaScript. Les ressources JavaScript de Blockstudio, fondées sur des fichiers, utilisent des modules ES, y compris pour les scripts intégrés.
  • handle est l’identifiant de ressource stable utilisé par le moteur de rendu de Blockstudio et le filtre blockstudio/assets/disable. Il n’a pas besoin d’être mis en file d’attente dans WordPress.
  • url est l’URL résolue de la ressource compilée existante, version comprise, ou l’URL source lorsqu’aucun fichier compilé n’existe. Elle est null pour les ressources intégrées.
  • inline distingue la sortie <style>/<script> intégrée des fichiers externes.
  • scope répertorie les contextes d’application de la ressource : frontend et editor pour les fichiers partagés, et un seul pour les fichiers de vue ou d’éditeur.
  • html contient la balise prête à l’emploi du moteur de rendu normal des ressources. Le contenu intégré, CSS limité au périmètre du bloc, les couches de style UI et les filtres de désactivation à l’exécution sont traités comme dans la sortie ordinaire d’un bloc.

Les fichiers SCSS manquants, vides, désactivés et non compilés sont omis. Les ressources du document parent de l’administration et de l’éditeur de blocs, mises en file d’attente par WordPress, sont exclues. La liste se limite aux fichiers propres au bloc qui ont été détectés. Elle ne couvre pas toutes les dépendances : les blocs imbriqués, les valeurs de champs de code, les handles mis en file d’attente par WordPress, les imports de modules CSS, Tailwind et les environnements d’exécution partagés de UI/Interactivity peuvent dépendre du contenu rendu. Utilisez Aperçu autonomeRender::document() pour un aperçu autonome complet. Utilisez bs_block_fields() pour examiner les définitions des champs enregistrées.