RichText
RichText-muokkaukset tallennetaan heti lohkon attribuutteihin, ja ne sisältyvät Gutenbergn kumoamis- ja uudelleentekohistoriaan, myös toistinrivien RichText-sisältö. Tallennettaessa usean valitun lohkon sisältö ja attribuutit säilyvät lohkokohtaisina.
Komponentilla RichText voi renderöidä editoriin muokattavan syötekentän ja julkiselle sivulle staattisen HTML-elementin. Se perustuu RichText-komponenttiin RichText WordPress tarjoaa.
Peruskäyttö
Jotta voit käyttää RichText-komponenttia yksinkertaisimmillaan, lisää sopiva attribuutti komponenttiisi block.json ja lisää lohkoosi komponentti 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" />
Voit käyttää lohkossasi rajattomasti RichText-komponentteja.
Ominaisuudet
allowedFormats
Voit rajoittaa RichText-komponentissa käytettäviä muotoiluja ominaisuudella 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
Voit asettaa RichText-komponentille paikkamerkin ominaisuudella placeholder.
<RichText attribute="myRichText" placeholder="Enter some text" />
preserveWhiteSpace
Määrittää, säilytetäänkö arvon välilyöntimerkit. Tavallisesti sarkaimet, rivinvaihdot ja välilyönnit yhdistetään yhdeksi välilyönniksi. Jos tämä on käytössä, pehmeät rivinvaihdot tallennetaan rivinvaihtomerkkeinä rivinvaihtoelementtien sijaan.
<RichText attribute="myRichText" preserveWhiteSpace="true" />
tag
Oletuksena RichText-sisältö renderöidään p-elementin sisälle. Voit muuttaa tätä ominaisuudella tag.
<RichText attribute="myRichText" tag="h1" />
withoutInteractiveFormatting
Oletuksena kaikki muotoilun ohjaimet ovat käytettävissä. Tällä asetuksella voi poistaa muotoilun ohjaimia, jotka tekisivät sisällöstä vuorovaikutteista.
<RichText attribute="myRichText" withoutInteractiveFormatting="true" />
Toistinkentät
RichText toimii toistinkenttien sisällä. Käytä hakasuljenotaatiota ja silmukan indeksiä oikean rivin kohdistamiseen.
{
"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 %}
Arvo attribute noudattaa kaavaa repeaterId[index].fieldId, jossa index on silmukan nollasta alkava rivinumero.