RichText
تُحفظ تعديلات RichText فورًا في سمات الكتلة، وتُسجّل ضمن سجل التراجع والإعادة في Gutenberg، بما في ذلك RichText داخل صفوف التكرار. ويحافظ الحفظ عند تحديد عدة كتل على محتوى كل كتلة وسماتها.
يتيح المكوّن RichText عرض حقل إدخال قابل للتحرير داخل المحرر وعنصر HTML ثابت في الواجهة الأمامية. وهو يستند إلى المكوّن RichText الذي يوفّره WordPress.
الاستخدام الأساسي
لاستخدام RichText بأبسط صورة، أضف السمة المناسبة إلى block.json وأضف المكوّن RichText إلى كتلتك.
{
"$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" />
يمكنك استخدام أي عدد من مكوّنات RichText في كتلتك.
الخصائص
allowedFormats
يمكنك تقييد التنسيقات المتاحة في مكوّن RichText باستخدام الخاصية 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') }}" />
نص العنصر النائب
يمكنك تعيين عنصر نائب لمكوّن RichText باستخدام الخاصية placeholder.
<RichText attribute="myRichText" placeholder="Enter some text" />
preserveWhiteSpace
ما إذا كان ينبغي الحفاظ على أحرف المسافات البيضاء في القيمة. عادةً ما تُدمج أحرف الجدولة والأسطر الجديدة والمسافات في مسافة واحدة. عند تفعيل هذا الخيار، تُحفظ فواصل الأسطر اللينة كأحرف سطر جديد، لا كعناصر لفواصل الأسطر.
<RichText attribute="myRichText" preserveWhiteSpace="true" />
الوسم
افتراضيًا، يُعرض محتوى RichText داخل عنصر p. يمكنك تغيير ذلك باستخدام الخاصية tag.
<RichText attribute="myRichText" tag="h1" />
withoutInteractiveFormatting
افتراضيًا، تكون جميع عناصر التحكم في التنسيق موجودة. يمكن استخدام هذا الإعداد لإزالة عناصر التحكم التي تجعل المحتوى تفاعليًا.
<RichText attribute="myRichText" withoutInteractiveFormatting="true" />
حقول التكرار
يعمل RichText داخل حقول التكرار. استخدم تدوين الأقواس مع فهرس الحلقة لاستهداف الصف الصحيح.
{
"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 النمط repeaterId[index].fieldId، حيث index هو رقم الصف بدءًا من الصفر في الحلقة.