Siirry sisältöön

Muunnot

Lohkomuunnokset API avulla voit määrittää tapoja lohkojen muuntamiseen. Blockstudio tukee tällä hetkellä kolmea tyyppiä:

  • lohkosta lohkoksi: muunna lohko toisentyyppiseksi lohkoksi
  • enter: lisää lohko, kun käyttäjä kirjoittaa tekstiä ja painaa näppäintä Enter
  • etuliite: lisää lohko, kun käyttäjä kirjoittaa tekstiä ja painaa näppäintä Space

Lohkosta lohkoksi

Lohkosta lohkoksi -muunnoksilla voit muuntaa lohkon toisentyyppiseksi lohkoksi.

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

Kun lohko muunnetaan uudeksi lohkoksi, vanhan lohkon määritteet siirretään uuteen lohkoon. Yllä olevassa esimerkissä määrite text siirretään uuteen lohkoon. Sama koskee kaikkea InnerBlocks-sisältöä.

On tärkeää huomata, että määritteiden tyyppien on oltava samat muunnettavassa lohkossa ja lohkossa, johon muunnetaan. Jos esimerkiksi lohkossa, johon muunnetaan, on määrite, jonka tunnus on text mutta tyyppi number, se ei näy muunnosluettelossa, sillä tyyppien ristiriita aiheuttaisi renderöintivirheen.

Lohkojen määritteiden määrän ei tarvitse olla sama.

Enter

Enter-muunnoksilla voit lisätä lohkon, kun käyttäjä kirjoittaa tiettyä sisältöä ja painaa sitten näppäintä Enter.

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

Yllä olevassa esimerkissä lohko lisätään, kun käyttäjä kirjoittaa vähintään kolme tavuviivaa (-) ja painaa sitten näppäintä Enter.

Etuliite

Etuliitemuunnoksilla voit lisätä lohkon, kun käyttäjä kirjoittaa tiettyä sisältöä ja painaa sitten näppäintä Space.

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

Yllä olevassa esimerkissä lohko lisätään, kun käyttäjä kirjoittaa kolme kysymysmerkkiä (?) ja painaa sitten näppäintä Space.