Ugrás a tartalomhoz

Átalakítások

A Blokkátalakítások API lehetővé teszi a blokkok átalakítási módjainak meghatározását. A Blockstudio jelenleg három típust támogat:

  • blokkról blokkra: egy blokk átalakítása egy másik blokká
  • enter: blokk beszúrása, amikor a felhasználó szöveget ír be, majd megnyomja a Enter billentyűt
  • előtag: blokk beszúrása, amikor a felhasználó szöveget ír be, majd megnyomja a Space billentyűt

Blokkról blokkra

A blokkról blokkra történő átalakítás lehetővé teszi egy blokk másik blokká alakítását.

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

Az új blokkra való átalakításkor a régi blokk attribútumai átkerülnek az új blokkba. A fenti példában a text attribútum kerül át az új blokkba. Ugyanez érvényes minden InnerBlocks tartalomra.

Fontos, hogy az átalakítás cél- és forrásblokkjának attribútumtípusai megegyezzenek. Például, ha a célblokkban van egy text azonosítójú, de number típusú attribútum, az nem jelenik meg az átalakítási listában, mert típuseltérést és megjelenítési hibát okozna.

A két blokk attribútumainak száma nem kell, hogy megegyezzen.

Enter

Az Enter-átalakítások lehetővé teszik blokk beszúrását, amikor a felhasználó bizonyos tartalmat ír be, majd megnyomja a Enter billentyűt.

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

A fenti példában a blokk akkor kerül beszúrásra, amikor a felhasználó három vagy több kötőjelet (-) ír be, majd megnyomja a Enter billentyűt.

Előtag

Az előtag-átalakítások lehetővé teszik blokk beszúrását, amikor a felhasználó bizonyos tartalmat ír be, majd megnyomja a Space billentyűt.

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

A fenti példában a blokk akkor kerül beszúrásra, amikor a felhasználó három kérdőjelet (?) ír be, majd megnyomja a Space billentyűt.