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.
{
"$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" />
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
<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') }}" />
zástupný text
Pomocou vlastnosti placeholder môžete nastaviť zástupný text komponentu RichText.
<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.
<RichText attribute="myRichText" preserveWhiteSpace="true" />
tag
Obsah RichText sa predvolene vykresľuje v prvku p. Toto môžete zmeniť pomocou vlastnosti tag.
<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.
<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.
{
"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 %}
Hodnota attribute má tvar repeaterId[index].fieldId, kde index je číslo riadka v cykle, ktoré začína od nuly.