RichText
Промените в RichText се съхраняват веднага в атрибутите на блока и се записват в историята за отмяна и повторение на Gutenberg, включително за RichText в редовете на повтарящи се полета. Записването при избрани няколко блока запазва съдържанието и атрибутите на всеки блок поотделно.
Компонентът RichText позволява изобразяването на редактируемо поле за въвеждане в редактора и статичен елемент HTML във фронтенда. Той е базиран на компонента RichText, предоставен от WordPress.
Основна употреба
За да използвате RichText в най-основната му форма, трябва да добавите подходящия атрибут към block.json и да добавите компонента RichText към блока си.
{
"$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"
}
]
}
}
<RichText attribute="myRichText" />
Можете да използвате неограничен брой компоненти RichText в блока си.
Свойства
allowedFormats
Можете да ограничите форматите, които се използват в компонента RichText, чрез пропа allowedFormats.
PHP
<RichText attribute="myRichText" allowedFormats="<?php echo esc_attr(wp_json_encode(['core/bold', 'core/italic'])); ?>" />
Twig
<RichText attribute="myRichText" allowedFormats="{{ ['core/bold', 'core/italic']|json_encode|escape('html_attr') }}" />
заместител
Можете да зададете контейнерен текст за компонента RichText чрез пропа placeholder.
<RichText attribute="myRichText" placeholder="Enter some text" />
preserveWhiteSpace
Дали да се запазват знаците за интервали в стойността. Обикновено знаците за табулация, нов ред и интервал се свеждат до един интервал. Ако е включена, меките прекъсвания на реда се запазват като знаци за нов ред, а не като елементи за прекъсване на ред.
<RichText attribute="myRichText" preserveWhiteSpace="true" />
етикет
По подразбиране съдържанието на RichText се изобразява в елемент p. Можете да промените това чрез пропа tag.
<RichText attribute="myRichText" tag="h1" />
withoutInteractiveFormatting
По подразбиране са налични всички контроли за форматиране. Тази настройка може да се използва за премахване на контроли за форматиране, които биха направили съдържанието интерактивно.
<RichText attribute="myRichText" withoutInteractiveFormatting="true" />
Полета за повтарящи се записи
RichText работи в полета за повтарящи се записи. Използвайте нотация със скоби и индекса на цикъла, за да зададете целевия ред.
{
"blockstudio": {
"attributes": [
{
"id": "items",
"type": "repeater",
"attributes": [
{
"id": "heading",
"type": "richtext"
}
]
}
]
}
}
<?php foreach ($a['items'] as $index => $item) : ?>
<RichText tag="h2" attribute="items[<?php echo $index; ?>].heading" placeholder="Enter heading" />
<?php endforeach; ?>
{% for item in a.items %}
<RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" placeholder="Enter heading" />
{% endfor %}
Стойността attribute следва шаблона repeaterId[index].fieldId, където index е нулево базираният номер на реда в цикъла.