Przejdź do treści

Przekształcenia

Przekształcenia blokówAPI umożliwiają określenie sposobów przekształcania bloków. Blockstudio obsługuje obecnie trzy typy:

  • blok w blok: przekształć jeden blok w inny
  • enter: wstaw blok, gdy użytkownik wpisze tekst i naciśnie Enter
  • prefiks: wstaw blok, gdy użytkownik wpisze tekst i naciśnie Space

Blok w blok

Przekształcenia blok w blok pozwalają przekształcić jeden blok w inny.

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

Podczas przekształcania w nowy blok atrybuty starego bloku zostaną przekazane do nowego bloku. W powyższym przykładzie atrybut text zostanie przekazany do nowego bloku. To samo dotyczy całej zawartości InnerBlocks.

Należy pamiętać, że typy atrybutów bloku źródłowego i docelowego muszą być takie same. Na przykład jeśli blok docelowy ma atrybut o ID text, ale typie number, nie pojawi się on na liście przekształceń, ponieważ spowodowałoby to niezgodność typów i błąd renderowania.

Liczba atrybutów w obu blokach nie musi być taka sama.

Enter

Przekształcenia Enter pozwalają wstawić blok, gdy użytkownik wpisze określoną treść, a następnie naciśnie klawisz Enter.

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

W powyższym przykładzie blok zostanie wstawiony, gdy użytkownik wpisze co najmniej trzy łączniki (-), a następnie naciśnie Enter.

Prefiks

Przekształcenia prefiksowe pozwalają wstawić blok, gdy użytkownik wpisze określoną treść, a następnie naciśnie klawisz Space.

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

W powyższym przykładzie blok zostanie wstawiony, gdy użytkownik wpisze trzy znaki zapytania (?), a następnie naciśnie Space.