Preskočiť na obsah

Transformácie

Rozšírenie Transformácie blokov API vám umožňuje definovať spôsoby transformácie blokov. Blockstudio v súčasnosti podporuje tri rôzne typy:

  • blok na blok: transformácia jedného bloku na iný
  • Enter: vloženie bloku po zadaní textu a stlačení klávesu Enter
  • predpona: vloženie bloku po zadaní textu a stlačení klávesu Space

Blok na blok

Transformácie z bloku na blok umožňujú previesť jeden blok na iný.

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/transforms",
  "title": "Native Transforms",
  "icon": "star-filled",
  "description": "Native Blockstudio Transforms.",
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "block",
          "blocks": [
            "blockstudio/transforms-2",
            "blockstudio/transforms-3"
          ]
        }
      ]
    },
    "attributes": [
      {
        "id": "text",
        "type": "text",
        "label": "Text"
      }
    ]
  }
}

Pri transformácii na nový blok sa doň prenesú atribúty pôvodného bloku. V uvedenom príklade sa do nového bloku prenesie atribút text. To isté platí pre všetok obsah InnerBlocks.

Je dôležité, aby typy atribútov bloku, na ktorý sa transformuje, a bloku, z ktorého sa transformuje, boli rovnaké. Ak má napríklad cieľový blok atribút s ID text a typom number, v zozname transformácií sa nezobrazí, pretože by to spôsobilo nesúlad typov a chybu pri vykresľovaní.

Počet atribútov v oboch blokoch nemusí byť rovnaký.

Enter

Transformácie Enter umožňujú vložiť blok, keď používateľ napíše určitý obsah a potom stlačí kláves Enter.

JSON
{
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "enter",
          "regExp": "/^-{3,}$/"
        }
      ]
    }
  }
}

V uvedenom príklade sa blok vloží, keď používateľ napíše tri alebo viac pomlčiek (-) a potom stlačí Enter.

Predpona

Transformácie predponou umožňujú vložiť blok, keď používateľ napíše určitý obsah a potom stlačí kláves Space.

JSON
{
  "blockstudio": {
    "transforms": {
      "from": [
        {
          "type": "prefix",
          "regExp": "???"
        }
      ]
    }
  }
}

V uvedenom príklade sa blok vloží, keď používateľ napíše tri otázniky (?) a potom stlačí Space.