Pereiti prie turinio

Transformacijos

Block TransformsAPI leidžia apibrėžti, kaip transformuoti blokus. Blockstudio šiuo metu palaiko tris tipus:

  • bloką į bloką: transformuokite vieną bloką į kitą bloką
  • įvedant tekstą: įterpkite bloką, kai naudotojas įveda tekstą ir paspaudžia Enter
  • priešdėlis: įterpkite bloką, kai naudotojas įveda tekstą ir paspaudžia Space

Bloko transformavimas į bloką

Transformacijos iš bloko į bloką leidžia vieną bloką paversti kitu.

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

Transformuojant į naują bloką, senojo bloko atributai perduodami naujam blokui. Pirmiau pateiktame pavyzdyje naujam blokui bus perduotas atributas text. Tas pats galioja ir visam InnerBlocks turiniui.

Svarbu atkreipti dėmesį, kad transformuojamo bloko ir bloko, į kurį transformuojama, atributų tipai turi sutapti. Pavyzdžiui, jei bloko, į kurį transformuojama, atributas turi ID text, bet tipą number, jis nebus rodomas transformacijų sąraše, nes kiltų tipų neatitiktis ir atvaizdavimo klaida.

Abiejų blokų atributų skaičius neprivalo sutapti.

Įvedant tekstą

Įvedimo transformacijos leidžia įterpti bloką, kai naudotojas įveda tam tikrą tekstą ir paspaudžia klavišą Enter.

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

Pirmiau pateiktame pavyzdyje blokas bus įterptas, kai naudotojas įves tris ar daugiau brūkšnių (-) ir paspaus Enter.

Priešdėlis

Priešdėlio transformacijos leidžia įterpti bloką, kai naudotojas įveda tam tikrą tekstą ir paspaudžia klavišą Space.

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

Pirmiau pateiktame pavyzdyje blokas bus įterptas, kai naudotojas įves tris klaustukus (?) ir paspaus Space.