Vai al contenuto

RichText

Le modifiche apportate con RichText vengono salvate subito negli attributi del blocco e fanno parte della cronologia di annullamento e ripristino di Gutenberg, anche per RichText nelle righe ripetitore. Se salvate mentre sono selezionati più blocchi, vengono conservati i contenuti e gli attributi di ciascun blocco.

Il componente RichText consente di renderizzare un campo di input modificabile nell’editor e un elemento HTML statico nel frontend. Si basa sul componente RichText fornito da WordPress.

Utilizzo di base

Per usare RichText nella sua forma più semplice, dovete aggiungere l’attributo appropriato al vostro block.json e aggiungere il componente RichText al blocco.

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

Potete usare un numero illimitato di componenti RichText nel vostro blocco.

Proprietà

allowedFormats

Potete limitare i formati disponibili nel componente RichText usando la prop allowedFormats.

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

Potete impostare un segnaposto per il componente RichText usando la prop placeholder.

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

preserveWhiteSpace

Indica se mantenere i caratteri di spaziatura nel valore. Normalmente, i caratteri di tabulazione, nuova riga e spazio vengono compressi in un unico spazio. Se l’opzione è attivata, le interruzioni di riga morbide vengono salvate come caratteri di nuova riga, non come elementi di interruzione di riga.

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

tag

Per impostazione predefinita, il contenuto RichText viene renderizzato all’interno di un elemento p. Potete modificarlo usando la prop tag.

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

withoutInteractiveFormatting

Per impostazione predefinita sono presenti tutti i controlli di formattazione. Questa impostazione consente di rimuovere quelli che renderebbero interattivo il contenuto.

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

Campi ripetitore

RichText funziona nei campi ripetitore. Usate la notazione con parentesi quadre e l’indice del ciclo per individuare la riga corretta.

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

Il valore attribute segue il modello repeaterId[index].fieldId, dove index è il numero di riga a partire da zero del ciclo.