İçeriğe geç

RichText

RichText düzenlemeleri hemen bloğun özniteliklerinde saklanır ve tekrarlayıcı satırlarındaki RichText dâhil Gutenberg geri alma ve yineleme geçmişine eklenir. Birden fazla blok seçiliyken kaydetmek, her bloğun kendi içeriğini ve özniteliklerini korur.

RichText bileşeni, düzenleyicide düzenlenebilir bir giriş alanının, ön uçta ise statik bir HTML öğesinin oluşturulmasını sağlar. RichText bileşenini WordPress temel alır.

Temel kullanım

RichText bileşenini en temel biçimde kullanmak için block.json öğenize uygun özniteliği eklemeniz ve bloğunuza RichText bileşenini eklemeniz gerekir.

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

Bloğunuzda sınırsız sayıda RichText bileşeni kullanabilirsiniz.

Özellikler

allowedFormats

allowedFormats özelliğini kullanarak RichText bileşeninde kullanılabilecek biçimleri sınırlayabilirsiniz.

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

yer tutucu

placeholder özelliğini kullanarak RichText bileşeni için bir yer tutucu ayarlayabilirsiniz.

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

preserveWhiteSpace

Değerdeki boşluk karakterlerinin korunup korunmayacağı. Normalde sekme, satır sonu ve boşluk karakterleri tek bir boşlukta birleştirilir. Etkinleştirilirse yumuşak satır sonları, satır sonu öğeleri olarak değil, satır sonu karakterleri olarak kaydedilir.

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

tag

Varsayılan olarak RichText içeriği bir p öğesinin içinde oluşturulur. Bunu tag özelliğini kullanarak değiştirebilirsiniz.

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

withoutInteractiveFormatting

Varsayılan olarak tüm biçimlendirme denetimleri bulunur. Bu ayar, içeriği etkileşimli hâle getirecek biçimlendirme denetimlerini kaldırmak için kullanılabilir.

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

Tekrarlayıcı alanlar

RichText, tekrarlayıcı alanların içinde çalışır. Doğru satırı hedeflemek için döngü diziniyle birlikte köşeli parantez gösterimini kullanın.

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

attribute değeri, repeaterId[index].fieldId kalıbını izler; burada index döngüdeki sıfır tabanlı satır numarasıdır.