Aller au contenu

Transformations

L’extension Block Transforms API vous permet de définir des façons de transformer des blocs. Blockstudio prend actuellement en charge trois types :

  • bloc en bloc : transformer un bloc en un autre bloc
  • entrée : insérer un bloc lorsque l’utilisateur saisit du texte et appuie sur Enter
  • préfixe : insérer un bloc lorsque l’utilisateur saisit du texte et appuie sur Space

Transformation de bloc en bloc

Les transformations de bloc en bloc vous permettent de transformer un bloc en un autre bloc.

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

Lors de la transformation en nouveau bloc, les attributs de l’ancien bloc sont transmis au nouveau. Dans l’exemple ci-dessus, l’attribut text est transmis au nouveau bloc. Il en va de même pour tout le contenu InnerBlocks.

Il est important de noter que les types d’attributs doivent être identiques pour le bloc source et le bloc cible. Par exemple, si le bloc cible possède un attribut dont l’ID est text, mais dont le type est number, il n’apparaîtra pas dans la liste des transformations, car cela entraînerait une incompatibilité de type et une erreur de rendu.

Le nombre d’attributs des deux blocs n’a pas besoin d’être identique.

Entrée

Les transformations à la saisie vous permettent d’insérer un bloc lorsque l’utilisateur saisit un contenu donné, puis appuie sur la touche Enter.

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

Dans l’exemple ci-dessus, le bloc est inséré lorsque l’utilisateur saisit au moins trois tirets (-), puis appuie sur Enter.

Préfixe

Les transformations par préfixe vous permettent d’insérer un bloc lorsque l’utilisateur saisit un contenu donné, puis appuie sur la touche Space.

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

Dans l’exemple ci-dessus, le bloc est inséré lorsque l’utilisateur saisit trois points d’interrogation (?), puis appuie sur Space.