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.
- Enregistrement des ressources : conventions de nommage des fichiers et comportement de mise en file d’attente
- Traitement : compilation SCSS, imports de modules ES et minification
- Champ de code : édition de code en ligne via le type de champ de code
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.
$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 ...>',
];
typeeststylepour CSS etmodulepour JavaScript. Les ressources JavaScript de Blockstudio, fondées sur des fichiers, utilisent des modules ES, y compris pour les scripts intégrés.handleest l’identifiant de ressource stable utilisé par le moteur de rendu de Blockstudio et le filtreblockstudio/assets/disable. Il n’a pas besoin d’être mis en file d’attente dans WordPress.urlest l’URL résolue de la ressource compilée existante, version comprise, ou l’URL source lorsqu’aucun fichier compilé n’existe. Elle estnullpour les ressources intégrées.inlinedistingue la sortie<style>/<script>intégrée des fichiers externes.scoperépertorie les contextes d’application de la ressource :frontendeteditorpour les fichiers partagés, et un seul pour les fichiers de vue ou d’éditeur.htmlcontient 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.