Gå til indhold

Transformationer

Med Block Transforms API kan du definere, hvordan blokke transformeres. Blockstudio understøtter i øjeblikket tre forskellige typer:

  • blok til blok: transformér en blok til en anden blok
  • enter: indsæt en blok, når brugeren skriver tekst og trykker på Enter
  • præfiks: indsæt en blok, når brugeren skriver tekst og trykker på Space

Blok til blok

Transformationer fra blok til blok gør det muligt at transformere en blok til en anden blok.

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 blokken transformeres til den nye blok, overføres den gamle bloks attributter til den nye blok. I eksemplet ovenfor overføres attributten text til den nye blok. Det samme gælder alt indhold i InnerBlocks.

Det er vigtigt at bemærke, at attributtyperne skal være ens for blokken, der transformeres til, og blokken, der transformeres fra. Hvis blokken, der transformeres til, f.eks. har en attribut med id’et text, men typen number, vises den ikke på transformationslisten, da det ville medføre en typekonflikt og en gengivelsesfejl.

De to blokke behøver ikke at have samme antal attributter.

Enter

Enter-transformationer gør det muligt at indsætte en blok, når brugeren skriver bestemt indhold og derefter trykker på tasten Enter.

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

I eksemplet ovenfor indsættes blokken, når brugeren skriver tre eller flere bindestreger (-) og derefter trykker på Enter.

Præfiks

Præfikstransformationer gør det muligt at indsætte en blok, når brugeren skriver bestemt indhold og derefter trykker på tasten Space.

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

I eksemplet ovenfor indsættes blokken, når brugeren skriver tre spørgsmålstegn (?) og derefter trykker på Space.