Ugrás a tartalomhoz

RichText

A RichText módosításai azonnal mentődnek a blokk attribútumai közé, és bekerülnek a Gutenberg visszavonási és ismétlési előzményeibe, az ismétlősorokban lévő RichText tartalommal együtt. Ha több kijelölt blokk mellett mented a módosításokat, minden blokk saját tartalma és attribútumai megmaradnak.

A RichText komponens szerkeszthető beviteli mezőt jelenít meg a szerkesztőben, az előtérben pedig statikus HTML elemet. Az WordPress által biztosított RichText komponens alapján készült.

Alapvető használat

A RichText legegyszerűbb használatához add hozzá a megfelelő attribútumot a block.json elemhez, és illeszd be a RichText komponenst a blokkodba.

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" />

Korlátlan számú RichText komponenst használhatsz a blokkodban.

Tulajdonságok

allowedFormats

A RichText komponensben használható formátumokat a allowedFormats tulajdonsággal korlátozhatod.

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

helyőrző

A RichText komponens helyőrzőjét a placeholder tulajdonsággal állíthatod be.

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

preserveWhiteSpace

Megadja, hogy meg kell-e őrizni az értékben szereplő szóközkaraktereket. A tabulátor-, újsor- és szóközkarakterek általában egyetlen szóközzé olvadnak össze. Ha engedélyezed, a lágy sortörések sortörés elem helyett újsorkarakterként mentődnek.

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

tag

Alapértelmezés szerint a RichText tartalma egy p elemen belül jelenik meg. Ezt a tag tulajdonsággal módosíthatod.

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

withoutInteractiveFormatting

Alapértelmezés szerint minden formázásvezérlő megjelenik. Ezzel a beállítással eltávolíthatod a tartalmat interaktívvá tevő formázásvezérlőket.

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

Ismétlőmezők

A RichText ismétlőmezőkben is működik. A megfelelő sor megcélzásához használd a ciklus indexével ellátott szögletes zárójeles jelölést.

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 %}

A attribute érték a repeaterId[index].fieldId mintát követi, ahol a index a ciklus nullától kezdődő sorszáma.