Liigu sisu juurde

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.

JSON
{
  "$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"
      }
    ]
  }
}
PHP
<RichText attribute="myRichText" />

Plokis saate kasutada piiramatu arvu RichTexti komponente.

Omadused

allowedFormats

RichTexti komponendis kasutatavaid vorminguid saate piirata atribuudi allowedFormats abil.

PHP

PHP
<RichText attribute="myRichText" allowedFormats="<?php echo esc_attr(wp_json_encode(['core/bold', 'core/italic'])); ?>" />

Twig

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.

PHP
<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.

PHP
<RichText attribute="myRichText" preserveWhiteSpace="true" />

silt

Vaikimisi renderdatakse komponendi RichText sisu elemendi p sees. Seda saate muuta atribuudi tag abil.

PHP
<RichText attribute="myRichText" tag="h1" />

withoutInteractiveFormatting

Vaikimisi on saadaval kõik vormingu juhtelemendid. Selle sätte abil saab eemaldada juhtelemendid, mis muudaksid sisu interaktiivseks.

PHP
<RichText attribute="myRichText" withoutInteractiveFormatting="true" />

Kordusväljad

RichText töötab kordusväljades. Õige rea sihtimiseks kasutage nurksulgudega süntaksit ja tsükli indeksit.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "items",
        "type": "repeater",
        "attributes": [
          {
            "id": "heading",
            "type": "richtext"
          }
        ]
      }
    ]
  }
}
PHP
<?php foreach ($a['items'] as $index => $item) : ?>
  <RichText tag="h2" attribute="items[<?php echo $index; ?>].heading" placeholder="Enter heading" />
<?php endforeach; ?>
Twig
{% 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.