Treci la conținut

RichText

Modificările RichText sunt salvate imediat în atributele blocului și sunt incluse în istoricul de anulare și refacere al Gutenberg, inclusiv pentru RichText din rândurile repetabile. Salvarea când sunt selectate mai multe blocuri păstrează conținutul și atributele proprii fiecărui bloc.

Componenta RichText permite redarea unui câmp de introducere editabil în editor și a unui element HTML static în frontend. Se bazează pe componenta RichText oferită de WordPress.

Utilizare de bază

Pentru a folosi RichText în forma sa cea mai simplă, trebuie să adăugați atributul corespunzător în block.json și să adăugați componenta RichText în bloc.

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" />

Puteți folosi un număr nelimitat de componente RichText în blocul dumneavoastră.

Proprietăți

allowedFormats

Puteți limita formatele care pot fi folosite în componenta RichText cu ajutorul proprietății 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') }}" />

placeholder

Puteți seta un substituent pentru componenta RichText folosind proprietatea placeholder.

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

preserveWhiteSpace

Dacă se păstrează caracterele de spațiere din valoare. În mod normal, caracterele tab, newline și spațiu sunt reduse la un singur spațiu. Dacă este activată, întreruperile de rând simple vor fi salvate ca caractere newline, nu ca elemente de întrerupere a rândului.

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

tag

În mod implicit, conținutul RichText este redat într-un element p. Puteți schimba acest lucru folosind proprietatea tag.

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

withoutInteractiveFormatting

În mod implicit, sunt prezente toate comenzile de formatare. Această setare poate fi folosită pentru a elimina comenzile de formatare care ar face conținutul interactiv.

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

Câmpuri repetabile

RichText funcționează în câmpurile repetabile. Folosiți notația cu paranteze drepte și indexul buclei pentru a indica rândul corect.

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 %}

Valoarea attribute urmează modelul repeaterId[index].fieldId, unde index este numărul rândului din buclă, indexat de la zero.