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.
{
"$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"
}
]
}
}
<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
<RichText attribute="myRichText" allowedFormats="<?php echo esc_attr(wp_json_encode(['core/bold', 'core/italic'])); ?>" />
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.
<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.
<RichText attribute="myRichText" preserveWhiteSpace="true" />
tag
Secara default, konten RichText dirender di dalam elemen p. Anda dapat mengubahnya menggunakan prop tag.
<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.
<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.
{
"blockstudio": {
"attributes": [
{
"id": "items",
"type": "repeater",
"attributes": [
{
"id": "heading",
"type": "richtext"
}
]
}
]
}
}
<?php foreach ($a['items'] as $index => $item) : ?>
<RichText tag="h2" attribute="items[<?php echo $index; ?>].heading" placeholder="Enter heading" />
<?php endforeach; ?>
{% 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.