Siirry sisältöön

RichText

RichText-muokkaukset tallennetaan heti lohkon attribuutteihin, ja ne sisältyvät Gutenbergn kumoamis- ja uudelleentekohistoriaan, myös toistinrivien RichText-sisältö. Tallennettaessa usean valitun lohkon sisältö ja attribuutit säilyvät lohkokohtaisina.

Komponentilla RichText voi renderöidä editoriin muokattavan syötekentän ja julkiselle sivulle staattisen HTML-elementin. Se perustuu RichText-komponenttiin RichText WordPress tarjoaa.

Peruskäyttö

Jotta voit käyttää RichText-komponenttia yksinkertaisimmillaan, lisää sopiva attribuutti komponenttiisi block.json ja lisää lohkoosi komponentti 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" />

Voit käyttää lohkossasi rajattomasti RichText-komponentteja.

Ominaisuudet

allowedFormats

Voit rajoittaa RichText-komponentissa käytettäviä muotoiluja ominaisuudella 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

Voit asettaa RichText-komponentille paikkamerkin ominaisuudella placeholder.

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

preserveWhiteSpace

Määrittää, säilytetäänkö arvon välilyöntimerkit. Tavallisesti sarkaimet, rivinvaihdot ja välilyönnit yhdistetään yhdeksi välilyönniksi. Jos tämä on käytössä, pehmeät rivinvaihdot tallennetaan rivinvaihtomerkkeinä rivinvaihtoelementtien sijaan.

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

tag

Oletuksena RichText-sisältö renderöidään p-elementin sisälle. Voit muuttaa tätä ominaisuudella tag.

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

withoutInteractiveFormatting

Oletuksena kaikki muotoilun ohjaimet ovat käytettävissä. Tällä asetuksella voi poistaa muotoilun ohjaimia, jotka tekisivät sisällöstä vuorovaikutteista.

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

Toistinkentät

RichText toimii toistinkenttien sisällä. Käytä hakasuljenotaatiota ja silmukan indeksiä oikean rivin kohdistamiseen.

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

Arvo attribute noudattaa kaavaa repeaterId[index].fieldId, jossa index on silmukan nollasta alkava rivinumero.