Lewati ke konten

RichText

Edit RichText langsung disimpan dalam atribut blok dan menjadi bagian dari riwayat urung dan ulang Gutenberg, termasuk RichText di dalam baris repeater. Menyimpan saat beberapa blok dipilih akan mempertahankan konten dan atribut masing-masing blok.

Komponen RichText memungkinkan perenderan input yang dapat diedit di dalam editor dan Elemen HTML statis di frontend. Komponen ini didasarkan pada komponen RichText yang disediakan WordPress.

Penggunaan Dasar

Untuk menggunakan RichText dalam bentuk paling dasar, tambahkan atribut yang sesuai ke block.json dan tambahkan komponen RichText ke blok Anda.

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

Anda dapat menggunakan RichText dalam jumlah tak terbatas di blok Anda.

Properti

allowedFormats

Anda dapat membatasi format yang dapat digunakan dalam komponen RichText dengan 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

Anda dapat menetapkan placeholder untuk komponen RichText menggunakan prop placeholder.

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

preserveWhiteSpace

Apakah karakter spasi kosong dalam nilai perlu dipertahankan. Biasanya karakter tab, baris baru, dan spasi digabungkan menjadi satu spasi. Jika diaktifkan, jeda baris lunak akan disimpan sebagai karakter baris baru, bukan sebagai elemen jeda baris.

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

tag

Secara default, konten RichText dirender di dalam elemen p. Anda dapat mengubahnya menggunakan prop tag.

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

withoutInteractiveFormatting

Secara default, semua kontrol pemformatan tersedia. Pengaturan ini dapat digunakan untuk menghapus kontrol pemformatan yang membuat konten menjadi interaktif.

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

Bidang Repeater

RichText berfungsi di dalam bidang repeater. Gunakan notasi tanda kurung siku dengan indeks loop untuk menargetkan baris yang benar.

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

Nilai attribute mengikuti pola repeaterId[index].fieldId, dengan index sebagai nomor baris berbasis nol dari loop.