Pāriet uz saturu

RichText

RichText labojumi tiek saglabāti uzreiz bloka atribūtos un iekļauti Gutenberg atsaukšanas un atjaunošanas vēsturē, tostarp RichText laukiem atkārtotāja rindās. Saglabājot, kamēr atlasīti vairāki bloki, tiek saglabāts katra bloka saturs un atribūti.

Komponents RichText ļauj redaktorā attēlot rediģējamu ievades lauku, bet priekšskatā — statisku HTML elementu. Tas ir balstīts uz komponentu Bagātināts teksts, ko nodrošina WordPress.

Pamata lietojums

Lai izmantotu RichText tā vienkāršākajā formā, pievienojiet atbilstošo atribūtu savam block.json un pievienojiet blokam komponentu 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" />

Blokā varat izmantot neierobežotu skaitu RichText komponentu.

Rekvizīti

allowedFormats

Izmantojot rekvizītu allowedFormats, varat ierobežot formātus, ko atbalsta RichText komponents.

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') }}" />

vietturis

RichText komponentam var iestatīt vietturi, izmantojot rekvizītu placeholder.

PHP
<RichText attribute="myRichText" placeholder="Enter some text" />

preserveWhiteSpace

Vai vērtībā jāsaglabā atstarpes rakstzīmes. Parasti tabulācijas, jaunas rindas un atstarpes rakstzīmes tiek sapludinātas vienā atstarpē. Ja šī opcija ir ieslēgta, mīkstās rindu pārtraukuma rakstzīmes tiks saglabātas kā jaunas rindas, nevis rindu pārtraukuma elementi.

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

tag

Pēc noklusējuma saturs RichText tiek attēlots elementā p. To var mainīt, izmantojot rekvizītu tag.

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

withoutInteractiveFormatting

Pēc noklusējuma ir pieejamas visas formatēšanas vadīklas. Ar šo iestatījumu var noņemt formatēšanas vadīklas, kas padarītu saturu interaktīvu.

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

Atkārtotāja lauki

RichText darbojas atkārtotāja laukos. Izmantojiet kvadrātiekavu pierakstu ar cikla indeksu, lai atlasītu pareizo rindu.

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ērtība attribute atbilst šablonam repeaterId[index].fieldId, kur index ir cikla rindas numurs, sākot no nulles.