RichText
RichTexti muudatused salvestatakse kohe ploki atribuutidesse ja lisatakse Gutenberg tagasivõtmise ja uuesti tegemise ajalukku, sealhulgas kordusridade RichText. Mitme valitud ploki salvestamisel säilib iga ploki enda sisu ja atribuudid.
Komponent RichText võimaldab redaktoris renderdada muudetava sisendi ja esiküljel staatilise elemendi HTML. See põhineb komponendil RichText, mida pakub WordPress.
Põhikasutus
RichText kasutamiseks kõige lihtsamal kujul tuleb lisada vastav atribuut objektile block.json ja lisada plokki 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" />
Plokis saate kasutada piiramatu arvu RichTexti komponente.
Omadused
allowedFormats
RichTexti komponendis kasutatavaid vorminguid saate piirata atribuudi allowedFormats abil.
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
RichTexti komponendile saate määrata kohatäite atribuudi placeholder abil.
<RichText attribute="myRichText" placeholder="Enter some text" />
preserveWhiteSpace
Kas väärtuses säilitatakse tühimärgid. Tavaliselt koondatakse tabeldusmärgid, reavahetused ja tühikud üheks tühikuks. Kui see on sisse lülitatud, salvestatakse pehmed reavahetused reavahetusmärkidena, mitte reavahetuselementidena.
<RichText attribute="myRichText" preserveWhiteSpace="true" />
silt
Vaikimisi renderdatakse komponendi RichText sisu elemendi p sees. Seda saate muuta atribuudi tag abil.
<RichText attribute="myRichText" tag="h1" />
withoutInteractiveFormatting
Vaikimisi on saadaval kõik vormingu juhtelemendid. Selle sätte abil saab eemaldada juhtelemendid, mis muudaksid sisu interaktiivseks.
<RichText attribute="myRichText" withoutInteractiveFormatting="true" />
Kordusväljad
RichText töötab kordusväljades. Õige rea sihtimiseks kasutage nurksulgudega süntaksit ja tsükli indeksit.
{
"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 %}
Väärtus attribute järgib mustrit repeaterId[index].fieldId, kus index on tsükli nullist algav reanumber.