Preskoči na vsebino

RichText

Urejanja RichText se takoj shranijo v atribute bloka in so vključena v zgodovino razveljavitev in ponovitev za Gutenberg, vključno z RichText znotraj vrstic polja za ponavljanje. Če shranjujete, ko je izbranih več blokov, se ohranijo vsebina in atributi vsakega bloka.

Komponenta RichText omogoča izris urejevalnega vnosa v urejevalniku in statičnega elementa HTML na spletnem mestu. Temelji na komponenti RichText, ki jo zagotavlja WordPress.

Osnovna uporaba

Če želite RichText uporabiti v najosnovnejši obliki, morate v block.json dodati ustrezen atribut in v blok dodati komponento RichText.

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

V bloku lahko uporabite neomejeno število komponent RichText.

Lastnosti

allowedFormats

Formate, ki jih lahko uporabite v komponenti RichText, lahko omejite z lastnostjo allowedFormats.

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

označba mesta

Za komponento RichText lahko nastavite označbo mesta z lastnostjo placeholder.

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

preserveWhiteSpace

Ali naj se v vrednosti ohranijo presledni znaki. Običajno se tabulatorji, znaki za novo vrstico in presledki združijo v en presledek. Če je možnost vklopljena, se mehki prelomi vrstic shranijo kot znaki za novo vrstico in ne kot elementi za prelom vrstice.

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

oznaka

Privzeto se vsebina RichText izriše znotraj elementa p. To lahko spremenite z lastnostjo tag.

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

withoutInteractiveFormatting

Privzeto so na voljo vsi kontrolniki za oblikovanje. S to nastavitvijo lahko odstranite kontrolnike za oblikovanje, zaradi katerih bi vsebina postala interaktivna.

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

Polja za ponavljanje

RichText deluje znotraj polj za ponavljanje. Uporabite zapis z oglatimi oklepaji in indeks zanke, da izberete pravo vrstico.

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

Vrednost attribute sledi vzorcu repeaterId[index].fieldId, pri čemer je index številka vrstice v zanki, ki se začne z ničlo.