RichText
RichText pakeitimai iškart išsaugomi bloko atributuose ir įtraukiami į Gutenberg anuliavimo bei pakartojimo istoriją, taip pat ir kartotuvo eilučių RichText. Išsaugojus, kai pasirinkti keli blokai, išsaugomas kiekvieno bloko turinys ir atributai.
Komponentas RichText leidžia redaktoriuje pateikti redaguojamą įvesties lauką, o viešojoje svetainės dalyje – statinį elementą HTML. Jis pagrįstas komponentu RichText, kurį teikia WordPress.
Pagrindinis naudojimas
Norėdami naudoti RichText paprasčiausiu būdu, pridėkite atitinkamą atributą prie block.json ir komponentą RichText prie savo bloko.
{
"$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" />
Savo bloke galite naudoti neribotą RichText komponentų skaičių.
Savybės
allowedFormats
RichText komponente naudojamus formatus galite apriboti naudodami ypatybę 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') }}" />
placeholder
RichText komponentui galite nustatyti vietos rezervavimo tekstą naudodami ypatybę placeholder.
<RichText attribute="myRichText" placeholder="Enter some text" />
preserveWhiteSpace
Ar išsaugoti tarpų simbolius reikšmėje. Paprastai tabuliacijos, naujos eilutės ir tarpo simboliai sutraukiami į vieną tarpą. Įjungus šią parinktį, minkštieji eilučių lūžiai išsaugomi kaip naujos eilutės simboliai, o ne kaip eilučių lūžio elementai.
<RichText attribute="myRichText" preserveWhiteSpace="true" />
žyma
Pagal numatytuosius nustatymus RichText turinys pateikiamas elemente p. Tai galite pakeisti naudodami ypatybę tag.
<RichText attribute="myRichText" tag="h1" />
withoutInteractiveFormatting
Pagal numatytuosius nustatymus pateikiami visi formatavimo valdikliai. Šiuo nustatymu galima pašalinti formatavimo valdiklius, dėl kurių turinys tampa interaktyvus.
<RichText attribute="myRichText" withoutInteractiveFormatting="true" />
Kartotuvo laukai
RichText veikia kartotuvo laukuose. Naudokite laužtinių skliaustų žymėjimą su ciklo indeksu, kad nurodytumėte reikiamą eilutę.
{
"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 %}
Reikšmė attribute atitinka šabloną repeaterId[index].fieldId, kuriame index yra nuliniais skaičiais indeksuotas eilutės numeris iš ciklo.