RichText
Úpravy RichText se okamžitě ukládají do atributů bloku a jsou součástí historie vrácení a opakování akcí v Gutenberg, včetně RichText v řádcích opakovače. Při ukládání s vybranými několika bloky se zachová obsah a atributy každého bloku.
Komponenta RichText umožňuje vykreslit upravitelné vstupní pole v editoru a statický prvek HTML na frontendu. Je založena na komponentě RichText, kterou poskytuje WordPress.
Základní použití
Chcete-li použít RichText v nejzákladnější podobě, přidejte do svého block.json příslušný atribut a do bloku komponentu 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žít neomezený počet komponent RichText.
Vlastnosti
allowedFormats
Formáty dostupné v komponentě RichText můžete omezit pomocí 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
Zástupný text komponenty RichText můžete nastavit pomocí vlastnosti placeholder.
<RichText attribute="myRichText" placeholder="Enter some text" />
preserveWhiteSpace
Určuje, zda se mají ve hodnotě zachovat znaky bílých mezer. Znak tabulátoru, nového řádku a mezery se obvykle sloučí do jediné mezery. Pokud je tato možnost zapnutá, měkké zalomení řádku se uloží jako znak nového řádku, nikoli jako prvek zalomení řádku.
<RichText attribute="myRichText" preserveWhiteSpace="true" />
tag
Ve výchozím nastavení se obsah RichText vykresluje uvnitř prvku p. Změnit to můžete pomocí vlastnosti tag.
<RichText attribute="myRichText" tag="h1" />
withoutInteractiveFormatting
Ve výchozím nastavení jsou k dispozici všechny ovládací prvky formátování. Toto nastavení lze použít k odebrání ovládacích prvků formátování, které by umožňovaly interakci s obsahem.
<RichText attribute="myRichText" withoutInteractiveFormatting="true" />
Pole opakovače
RichText funguje v polích opakovače. Pomocí hranaté notace s indexem smyčky určete správný řádek.
{
"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 řádku od nuly v rámci smyčky.