Přejít k obsahu

Transformace

Block Transforms API umožňuje definovat způsoby transformace bloků. Blockstudio aktuálně podporuje tři různé typy:

  • blok na blok: transformuje jeden blok na jiný
  • enter: vloží blok, když uživatel zadá text a stiskne Enter
  • prefix: vloží blok, když uživatel zadá text a stiskne Space

Transformace bloku na blok

Transformace bloku na blok umožňují změnit jeden blok na jiný.

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"
      }
    ]
  }
}

Při transformaci na nový blok se atributy původního bloku předají novému bloku. V příkladu výše se atribut text předá novému bloku. Totéž platí pro veškerý obsah InnerBlocks.

Je důležité, aby typy atributů bloku, na který se transformuje, odpovídaly typům atributů bloku, ze kterého se transformuje. Pokud má například cílový blok atribut s ID text, ale typem number, v seznamu transformací se nezobrazí, protože by došlo k neshodě typů a chybě při vykreslování.

Počet atributů se u obou bloků nemusí shodovat.

Enter

Transformace Enter umožňují vložit blok, když uživatel napíše určitý obsah a poté stiskne klávesu Enter.

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

V příkladu výše se blok vloží, když uživatel napíše tři nebo více pomlček (-) a poté stiskne Enter.

Prefix

Transformace Prefix umožňují vložit blok, když uživatel napíše určitý obsah a poté stiskne klávesu Space.

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

V příkladu výše se blok vloží, když uživatel napíše tři otazníky (?) a poté stiskne Space.