Přejít k obsahu

RichText

Úpravy RichText se okamžitě ukládají do atributů bloku a jsou součástí historie vrácení a opakování akcí v Gutenberg, včetně RichText v řádcích opakovače. Při ukládání s vybranými několika bloky se zachová obsah a atributy každého bloku.

Komponenta RichText umožňuje vykreslit upravitelné vstupní pole v editoru a statický prvek HTML na frontendu. Je založena na komponentě RichText, kterou poskytuje WordPress.

Základní použití

Chcete-li použít RichText v nejzákladnější podobě, přidejte do svého block.json příslušný atribut a do bloku komponentu RichText.

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/rich-text",
  "title": "Native Block",
  "category": "text",
  "icon": "star-filled",
  "description": "Native Blockstudio RichText block.",
  "blockstudio": {
    "attributes": [
      {
        "id": "myRichText",
        "type": "richtext"
      }
    ]
  }
}
PHP
<RichText attribute="myRichText" />

V bloku můžete použít neomezený počet komponent RichText.

Vlastnosti

allowedFormats

Formáty dostupné v komponentě RichText můžete omezit pomocí vlastnosti allowedFormats.

PHP

PHP
<RichText attribute="myRichText" allowedFormats="<?php echo esc_attr(wp_json_encode(['core/bold', 'core/italic'])); ?>" />

Twig

Twig
<RichText attribute="myRichText" allowedFormats="{{ ['core/bold', 'core/italic']|json_encode|escape('html_attr') }}" />

zástupný text

Zástupný text komponenty RichText můžete nastavit pomocí vlastnosti placeholder.

PHP
<RichText attribute="myRichText" placeholder="Enter some text" />

preserveWhiteSpace

Určuje, zda se mají ve hodnotě zachovat znaky bílých mezer. Znak tabulátoru, nového řádku a mezery se obvykle sloučí do jediné mezery. Pokud je tato možnost zapnutá, měkké zalomení řádku se uloží jako znak nového řádku, nikoli jako prvek zalomení řádku.

PHP
<RichText attribute="myRichText" preserveWhiteSpace="true" />

tag

Ve výchozím nastavení se obsah RichText vykresluje uvnitř prvku p. Změnit to můžete pomocí vlastnosti tag.

PHP
<RichText attribute="myRichText" tag="h1" />

withoutInteractiveFormatting

Ve výchozím nastavení jsou k dispozici všechny ovládací prvky formátování. Toto nastavení lze použít k odebrání ovládacích prvků formátování, které by umožňovaly interakci s obsahem.

PHP
<RichText attribute="myRichText" withoutInteractiveFormatting="true" />

Pole opakovače

RichText funguje v polích opakovače. Pomocí hranaté notace s indexem smyčky určete správný řádek.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "items",
        "type": "repeater",
        "attributes": [
          {
            "id": "heading",
            "type": "richtext"
          }
        ]
      }
    ]
  }
}
PHP
<?php foreach ($a['items'] as $index => $item) : ?>
  <RichText tag="h2" attribute="items[<?php echo $index; ?>].heading" placeholder="Enter heading" />
<?php endforeach; ?>
Twig
{% for item in a.items %}
  <RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" placeholder="Enter heading" />
{% endfor %}

Hodnota attribute má tvar repeaterId[index].fieldId, kde index je číslo řádku od nuly v rámci smyčky.