Liigu sisu juurde

Teisendused

Plokkide teisendused API võimaldab määrata, kuidas plokke teisendada. Blockstudio toetab praegu kolme tüüpi:

  • plokist plokiks: teisenda plokk teiseks plokiks
  • sisestusklahv: lisa plokk, kui kasutaja sisestab teksti ja vajutab klahvi Enter
  • eesliide: lisa plokk, kui kasutaja sisestab teksti ja vajutab klahvi Space

Plokist plokiks

Plokist plokiks teisendused võimaldavad teisendada ühe ploki teiseks plokiks.

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

Uude plokki teisendamisel kantakse vana ploki atribuudid uude plokki üle. Ülaltoodud näites kantakse uude plokki üle atribuut text. Sama kehtib kogu InnerBlocks sisu kohta.

Oluline on märkida, et teisendatava lähteploki ja sihtploki atribuutide tüübid peavad ühtima. Näiteks kui sihtploki atribuudil on ID text, kuid tüüp number, siis seda teisendusloendis ei kuvata, sest see põhjustaks tüübikonflikti ja renderdamisvea.

Kahe ploki atribuutide arv ei pea olema sama.

Sisestusklahv

Sisestusklahvi teisendused võimaldavad lisada ploki, kui kasutaja sisestab kindla teksti ja vajutab seejärel klahvi Enter.

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

Ülaltoodud näites lisatakse plokk, kui kasutaja sisestab kolm või enam sidekriipsu (-) ja vajutab seejärel klahvi Enter.

Eesliide

Eesliite teisendused võimaldavad lisada ploki, kui kasutaja sisestab kindla teksti ja vajutab seejärel klahvi Space.

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

Ülaltoodud näites lisatakse plokk, kui kasutaja sisestab kolm küsimärki (?) ja vajutab seejärel klahvi Space.