Към съдържанието

RichText

Промените в RichText се съхраняват веднага в атрибутите на блока и се записват в историята за отмяна и повторение на Gutenberg, включително за RichText в редовете на повтарящи се полета. Записването при избрани няколко блока запазва съдържанието и атрибутите на всеки блок поотделно.

Компонентът RichText позволява изобразяването на редактируемо поле за въвеждане в редактора и статичен елемент HTML във фронтенда. Той е базиран на компонента RichText, предоставен от WordPress.

Основна употреба

За да използвате RichText в най-основната му форма, трябва да добавите подходящия атрибут към block.json и да добавите компонента 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" />

Можете да използвате неограничен брой компоненти RichText в блока си.

Свойства

allowedFormats

Можете да ограничите форматите, които се използват в компонента RichText, чрез пропа 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') }}" />

заместител

Можете да зададете контейнерен текст за компонента RichText чрез пропа placeholder.

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

preserveWhiteSpace

Дали да се запазват знаците за интервали в стойността. Обикновено знаците за табулация, нов ред и интервал се свеждат до един интервал. Ако е включена, меките прекъсвания на реда се запазват като знаци за нов ред, а не като елементи за прекъсване на ред.

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

етикет

По подразбиране съдържанието на RichText се изобразява в елемент p. Можете да промените това чрез пропа tag.

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

withoutInteractiveFormatting

По подразбиране са налични всички контроли за форматиране. Тази настройка може да се използва за премахване на контроли за форматиране, които биха направили съдържанието интерактивно.

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

Полета за повтарящи се записи

RichText работи в полета за повтарящи се записи. Използвайте нотация със скоби и индекса на цикъла, за да зададете целевия ред.

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

Стойността attribute следва шаблона repeaterId[index].fieldId, където index е нулево базираният номер на реда в цикъла.