Preskoči na vsebino

Preoblikovanja

Preoblikovanja blokovAPI omogočajo določanje načinov preoblikovanja blokov. Blockstudio trenutno podpira tri različne vrste:

  • blok v blok: preoblikujte en blok v drugega
  • enter: vstavite blok, ko uporabnik vnese besedilo in pritisne Enter
  • predpona: vstavite blok, ko uporabnik vnese besedilo in pritisne Space

Preoblikovanje bloka v blok

Preoblikovanja iz bloka v blok omogočajo pretvorbo enega bloka v drugega.

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 preoblikovanju v novi blok se atributi starega bloka prenesejo v novi blok. V zgornjem primeru se v novi blok prenese atribut text. Enako velja za vso vsebino InnerBlocks.

Pomembno je, da so vrste atributov v bloku, v katerega preoblikujete, enake vrstam atributov v izvornem bloku. Če ima na primer ciljni blok atribut z ID-jem text, vendar vrste number, atribut ne bo prikazan na seznamu preoblikovanj, ker bi to povzročilo neujemanje vrst in napako pri izrisu.

Število atributov v obeh blokih je lahko različno.

Enter

Preoblikovanja ob pritisku tipke Enter omogočajo vstavljanje bloka, ko uporabnik vnese določeno vsebino in nato pritisne tipko Enter.

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

V zgornjem primeru se blok vstavi, ko uporabnik vnese tri ali več pomišljajev (-) in nato pritisne Enter.

Predpona

Preoblikovanja s predpono omogočajo vstavljanje bloka, ko uporabnik vnese določeno vsebino in nato pritisne tipko Space.

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

V zgornjem primeru se blok vstavi, ko uporabnik vnese tri vprašaje (?) in nato pritisne Space.