Hoppa till innehåll

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
<?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

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
<?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

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.

PHP
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.