Hoppa till innehåll

Omvandlingar

Med hjälp av Block Transforms API kan du definiera sätt att omvandla block. Blockstudio stöder för närvarande tre olika typer:

  • block till block: omvandla ett block till ett annat block
  • enter: infoga ett block när användaren skriver text och trycker på Enter
  • prefix: infoga ett block när användaren skriver text och trycker på Space

Block till block

Omvandlingar från block till block gör att du kan omvandla ett block till ett annat.

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

När blocket omvandlas till det nya blocket skickas det gamla blockets attribut vidare till det nya blocket. I exemplet ovan skickas attributet text vidare till det nya blocket. Detsamma gäller allt innehåll i InnerBlocks.

Det är viktigt att attributtyperna är desamma för blocket som omvandlas och blocket som omvandlingen sker till. Om blocket som omvandlingen sker till exempelvis har ett attribut med ID:t text men typen number visas det inte i omvandlingslistan, eftersom det skulle orsaka en typkonflikt och ett renderingsfel.

Antalet attribut behöver inte vara detsamma i de två blocken.

Enter

Enter-omvandlingar gör att du kan infoga ett block när användaren skriver ett visst innehåll och sedan trycker på tangenten Enter.

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

I exemplet ovan infogas blocket när användaren skriver tre eller fler bindestreck (-) och sedan trycker på Enter.

Prefix

Prefixomvandlingar gör att du kan infoga ett block när användaren skriver ett visst innehåll och sedan trycker på tangenten Space.

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

I exemplet ovan infogas blocket när användaren skriver tre frågetecken (?) och sedan trycker på Space.