RichText
RichText labojumi tiek saglabāti uzreiz bloka atribūtos un iekļauti Gutenberg atsaukšanas un atjaunošanas vēsturē, tostarp RichText laukiem atkārtotāja rindās. Saglabājot, kamēr atlasīti vairāki bloki, tiek saglabāts katra bloka saturs un atribūti.
Komponents RichText ļauj redaktorā attēlot rediģējamu ievades lauku, bet priekšskatā — statisku HTML elementu. Tas ir balstīts uz komponentu Bagātināts teksts, ko nodrošina WordPress.
Pamata lietojums
Lai izmantotu RichText tā vienkāršākajā formā, pievienojiet atbilstošo atribūtu savam block.json un pievienojiet blokam komponentu 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" />
Blokā varat izmantot neierobežotu skaitu RichText komponentu.
Rekvizīti
allowedFormats
Izmantojot rekvizītu allowedFormats, varat ierobežot formātus, ko atbalsta RichText komponents.
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') }}" />
vietturis
RichText komponentam var iestatīt vietturi, izmantojot rekvizītu placeholder.
<RichText attribute="myRichText" placeholder="Enter some text" />
preserveWhiteSpace
Vai vērtībā jāsaglabā atstarpes rakstzīmes. Parasti tabulācijas, jaunas rindas un atstarpes rakstzīmes tiek sapludinātas vienā atstarpē. Ja šī opcija ir ieslēgta, mīkstās rindu pārtraukuma rakstzīmes tiks saglabātas kā jaunas rindas, nevis rindu pārtraukuma elementi.
<RichText attribute="myRichText" preserveWhiteSpace="true" />
tag
Pēc noklusējuma saturs RichText tiek attēlots elementā p. To var mainīt, izmantojot rekvizītu tag.
<RichText attribute="myRichText" tag="h1" />
withoutInteractiveFormatting
Pēc noklusējuma ir pieejamas visas formatēšanas vadīklas. Ar šo iestatījumu var noņemt formatēšanas vadīklas, kas padarītu saturu interaktīvu.
<RichText attribute="myRichText" withoutInteractiveFormatting="true" />
Atkārtotāja lauki
RichText darbojas atkārtotāja laukos. Izmantojiet kvadrātiekavu pierakstu ar cikla indeksu, lai atlasītu pareizo rindu.
{
"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 %}
Vērtība attribute atbilst šablonam repeaterId[index].fieldId, kur index ir cikla rindas numurs, sākot no nulles.