Environnement
Il est parfois nécessaire d’afficher du contenu dans vos blocs uniquement lorsqu’ils sont rendus dans l’éditeur Gutenberg, et non sur le frontend. Cette technique est très utile pour fournir aux utilisateurs des informations et des espaces réservés lorsqu’ils n’ont pas encore saisi les données nécessaires.
Éditeur
PHP
<?php if ($isEditor) : ?>
This content is only going to be rendered inside the editor.
<?php else : ?>
This content is only going to be rendered on the frontend.
<?php endif; ?>
Twig
{% if isEditor %}
This content is only going to be rendered inside the editor.
{% else %}
This content is only going to be rendered on the frontend.
{% endif %}
Aperçu
Blockstudio ajoute une autre variable d’environnement utile aux développeurs de blocs. $isPreview permet d’afficher conditionnellement du contenu dans la fenêtre d’aperçu du bloc lorsque vous survolez un bloc dans l’inserteur de blocs.
PHP
<?php if ($isPreview) : ?>
This content is only going to be rendered inside the block preview.
<?php else : ?>
This content is only going to be rendered on the frontend and editor.
<?php endif; ?>
Twig
{% if isPreview %}
This content is only going to be rendered inside the block preview.
{% else %}
This content is only going to be rendered on the frontend and editor.
{% endif %}
En dehors des modèles
$isEditor et $isPreview n’existent que dans le modèle. Le code exécuté pendant le même rendu mais en dehors du modèle, comme un helper de thème appelé depuis un modèle ou un filtre tel que blockstudio/blocks/components/rich_text/render, peut appeler bs_is_editor() et bs_is_preview(). Ils renvoient les mêmes valeurs que celles reçues par le modèle.
function theme_card_title(string $title): string {
if ($title === '' && bs_is_editor()) {
return '<span class="placeholder">Add a title</span>';
}
return esc_html($title);
}
Les balises de bloc affichent toujours le balisage de l’interface publique ; dans un bloc rendu depuis une balise de bloc, les deux fonctions renvoient donc false, comme le font $isEditor et $isPreview.