Pāriet uz saturu

Pārveidošana

Bloku pārveidošanas API API ļauj definēt, kā pārveidot blokus. Blockstudio pašlaik atbalsta trīs veidus:

  • bloku pārveidošana: pārveidot vienu bloku citā
  • Enter: ievietot bloku, kad lietotājs ievada tekstu un nospiež Enter
  • prefikss: ievietot bloku, kad lietotājs ievada tekstu un nospiež Space

Bloku pārveidošana

Bloku pārveidošana ļauj pārveidot vienu bloku citā.

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ārveidojot par jauno bloku, vecā bloka atribūti tiks nodoti jaunajam blokam. Iepriekš minētajā piemērā jaunajam blokam tiks nodots atribūts text. Tas pats attiecas uz visu InnerBlocks saturu.

Svarīgi ņemt vērā, ka pārveidojamā bloka un bloka, par kuru tas tiek pārveidots, atribūtu tipiem ir jābūt vienādiem. Piemēram, ja blokam, par kuru tiek pārveidots sākotnējais bloks, ir atribūts ar ID text, bet tā tips ir number, tas netiks parādīts pārveidojumu sarakstā, jo rastos tipu neatbilstība un renderēšanas kļūda.

Abu bloku atribūtu skaitam nav jābūt vienādam.

Enter taustiņš

Enter pārveidojumi ļauj ievietot bloku, kad lietotājs ievada noteiktu saturu un pēc tam nospiež taustiņu Enter.

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

Iepriekš minētajā piemērā bloks tiks ievietots, kad lietotājs ievadīs trīs vai vairāk domuzīmes (-) un pēc tam nospiedīs Enter.

Prefikss

Prefiksa pārveidojumi ļauj ievietot bloku, kad lietotājs ievada noteiktu saturu un pēc tam nospiež taustiņu Space.

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

Iepriekš minētajā piemērā bloks tiks ievietots, kad lietotājs ievadīs trīs jautājuma zīmes (?) un pēc tam nospiedīs Space.