Miljö
Ibland behöver innehåll i block bara visas när blocket renderas i Gutenberg-redigeraren, inte i frontend. Det här är ett användbart sätt att ge användarna information och platshållare om nödvändiga data ännu inte har angetts.
Redigerare
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 %}
Förhandsgranskning
Blockstudio lägger till ytterligare en miljövariabel som är användbar för blockutvecklare. $isPreview gör att du kan visa innehåll villkorligt i blockets förhandsgranskningsfönster när du håller pekaren över ett block i blockväljaren.
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 %}
Utanför mallar
$isEditor och $isPreview finns endast inuti mallen. Kod som körs under samma renderering men utanför mallen, till exempel en temahjälpfunktion som anropas från en mall eller ett filter som blockstudio/blocks/components/rich_text/render, kan anropa bs_is_editor() och bs_is_preview(). De returnerar samma värden som mallen får.
function theme_card_title(string $title): string {
if ($title === '' && bs_is_editor()) {
return '<span class="placeholder">Add a title</span>';
}
return esc_html($title);
}
Blocktaggar renderar alltid frontend-markup, så inuti ett block som renderas från en blocktagg returnerar båda funktionerna false, precis som $isEditor och $isPreview gör.