Preskočiť na obsah

RichText

Úpravy RichText sa okamžite ukladajú do atribútov bloku a sú súčasťou histórie vrátenia a opakovania zmien Gutenberg vrátane RichText v riadkoch opakovača. Uložením pri výbere viacerých blokov sa zachová obsah a atribúty každého bloku.

Komponent RichText umožňuje vykresliť upraviteľné vstupné pole v editore a statický prvok HTML na frontende. Je založený na komponente RichText, ktorý poskytuje WordPress.

Základné použitie

Ak chcete používať RichText v najzákladnejšej podobe, pridajte príslušný atribút do block.json a do bloku pridajte komponent 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žiť ľubovoľný počet komponentov RichText.

Vlastnosti

allowedFormats

Formáty, ktoré možno použiť v komponente RichText, môžete obmedziť pomocou 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

Pomocou vlastnosti placeholder môžete nastaviť zástupný text komponentu RichText.

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

preserveWhiteSpace

Určuje, či sa majú vo výslednej hodnote zachovať biele znaky. Karty, nové riadky a medzery sa zvyčajne zlúčia do jednej medzery. Ak túto možnosť zapnete, mäkké zalomenia riadka sa uložia ako znaky nového riadka, nie ako prvky zalomenia riadka.

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

tag

Obsah RichText sa predvolene vykresľuje v prvku p. Toto môžete zmeniť pomocou vlastnosti tag.

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

withoutInteractiveFormatting

Predvolene sú k dispozícii všetky ovládacie prvky formátovania. Pomocou tohto nastavenia môžete odstrániť ovládacie prvky, ktoré by umožnili interakciu s obsahom.

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

Polia opakovača

RichText funguje aj v poliach opakovača. Pomocou zápisu s hranatými zátvorkami a indexu cyklu zacielite na správny riadok.

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 riadka v cykle, ktoré začína od nuly.