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.
{
"$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" />
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
<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') }}" />
yer tutucu
placeholder özelliğini kullanarak RichText bileşeni için bir yer tutucu ayarlayabilirsiniz.
<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.
<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.
<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.
<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.
{
"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 %}
attribute değeri, repeaterId[index].fieldId kalıbını izler; burada index döngüdeki sıfır tabanlı satır numarasıdır.