# Egna block i 3 filer

Ingen JavaScript, inget byggsteg, ingen standardkod.

## Definiera fält i JSON

Lägg till en `blockstudio`-nyckel i block.json. Definiera attribut med typer som `text`, `toggle` och `color`. Blockstudio genererar automatiskt redigerarens UI, med 27 fälttyper, från textfält till upprepningsfält och kodredigerare, samt fälttyper som du själv registrerar.

Fullständigt stöd för JSON Schema ger komplettering och validering i VS Code, PhpStorm och alla kompatibla redigerare.

Varje fält kan ange ett `default` för nya block och ett `fallback` som mallen får när fältet är tomt.

[Referens för fälttyper](https://blockstudio.dev/sv/docs/blocks/attributes/field-types/)

block.json

```
{
  "name": "starter/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      { "id": "heading", "type": "text", "label": "Heading" },
      { "id": "showCta", "type": "toggle", "label": "Show CTA" },
      { "id": "background", "type": "color", "label": "Background" }
    ]
  }
}
```

## Arbetsflöde med tre filer

block.json för fält, en mall för markup och en valfri formatmall.

## React i PHP

RichText, InnerBlocks och useBlockProps fungerar direkt i PHP, Twig eller Blade.

## SCSS och Tailwind

Använd CSS, SCSS eller Tailwind. SCSS stöder importsökvägar och en gemensam inledning, och när du redigerar en nästlad del kompileras alla filer som importerar den på nytt.

## 27 fälttyper

Text, färg, bild, upprepare, väljare, kodredigerare med mera, konfigureras i JSON.

## JSON Schema

Komplettering och validering i VS Code, PhpStorm och kompatibla redigerare.

## Tre mallspråk

PHP, Twig och Blade delar samma variabler och komponenter.

## npm-importer

Importera paket i script.js; lokalt i produktion och med stöd av CDN i redigeraren.

## Interactivity API

Aktivera WordPress Interactivity API med en enda flagga.

## React-komponenter i PHP-mallar

Använd `<RichText />` för redigering direkt på sidan och statisk frontend-HTML, `<InnerBlocks />` för underordnade block och `useBlockProps` för omslaget, allt i en enda mall.

I redigeraren blir dessa riktiga React-komponenter. På frontend renderas de som serverbaserad HTML, utan att någon JavaScript skickas till besökarna.

[Utforska komponenter](https://blockstudio.dev/sv/docs/blocks/react-components/)

index.php

```
<div useBlockProps class="container">
  <RichText
    class="text-xl font-semibold"
    tag="h1"
    attribute="headline"
    placeholder="Enter headline"
  />

  <?php if ($a['showCta']): ?>
    <a href="<?= esc_url($a['ctaUrl']) ?>">
      <?= esc_html($a['ctaLabel']) ?>
    </a>
  <?php endif; ?>

  <InnerBlocks class="mt-4 p-4 border" />
</div>
```

## Skriv i PHP, Twig eller Blade

Använd det mallspråk du känner till. PHP fungerar direkt, Twig körs när Timber har installerats och Blade körs på `illuminate/view` 8 till 12 via `Blockstudio\Blade_Renderer`. Variablerna, komponenterna och beteendet förblir desamma.

`$a` (attribut), `$b` (block), `$c` (kontext) och `$innerBlocks` finns tillgängliga i alla språk.

Twig-mallar får också hela kontexten Timber. Blade renderar även sidor, mönster och Site Editor-mallar. Den äldre omslutaren `jenssegers/blade` fungerar inte med `illuminate/view` 10 och senare, så använd `Blade_Renderer` i stället.

[Mallens språk](https://blockstudio.dev/sv/docs/blocks/templating/blade/)

index.twig

```
<div useBlockProps class="card">
  <RichText tag="h2" attribute="title" placeholder="Card title" />
  {% if a.image %}
    <img src="{{ a.image.url|esc_url }}"
      alt="{{ a.image.alt|esc_attr }}" />
  {% endif %}
  <div class="card__body">{{ a.description|esc_html }}</div>
  <InnerBlocks allowedBlocks='["core/button"]' />
</div>
```

## Villkorsstyrd logik och dynamiska alternativ

Visa och dölj fält med operatorer som `==`, `!=`, `includes`, `empty` och jämförelser. Kombinera villkor med OR-logik.

Alternativ kan bero på ett annat fält. Lägg till `{attributes.post_type.value}` i populate-argumenten så läses listan in på nytt när det fältet ändras. Lägg till `fetch: true` för att söka bland inlägg medan redaktören skriver.

Dela en alternativlista mellan block med `type: custom` och filtret `blockstudio/blocks/attributes/populate`, och registrera egna globala villkor, till exempel en köpkontroll, via `blockstudio/blocks/conditions`.

[Villkorsstyrd logik](https://blockstudio.dev/sv/docs/blocks/attributes/conditional-logic/)

block.json

```
{
  "name": "starter/posts",
  "title": "Posts",
  "blockstudio": {
    "attributes": [
      {
        "id": "post_type",
        "type": "select",
        "label": "Post type",
        "options": [
          { "value": "page", "label": "Pages" },
          { "value": "post", "label": "Posts" }
        ]
      },
      {
        "id": "selected_post",
        "type": "select",
        "label": "Post",
        "populate": {
          "type": "query",
          "query": "posts",
          "arguments": { "post_type": "{attributes.post_type.value}" }
        }
      },
      {
        "id": "style",
        "type": "select",
        "label": "Style",
        "populate": { "type": "custom", "custom": "cardStyles" },
        "conditions": [[
          { "type": "purchasedProduct", "operator": "==", "value": "yes" }
        ]]
      }
    ]
  }
}
```

## Repetitionsfält som förblir hanterbara

Ange `min` och `max`, starta nya block med `default` rader och fäll ihop befintliga rader med `minimized`. `textMinimized` märker en hopfälld rad med ett av dess egna fält, till exempel ett namn.

Rader accepterar alla fälttyper utom flikar, även nästlade repetitionsfält. Ett villkor i en rad kontrollerar ett fält utanför den med `"context": "main"`, och `<RichText />` och `<MediaPlaceholder />` redigerar en enskild rad när deras `attribute` pekar på `repeaterId[index].fieldId`.

[Mönster för repetitionsfält](https://blockstudio.dev/sv/guides/field-patterns/#repeater-patterns)

block.json

```
{
  "name": "starter/team",
  "title": "Team",
  "blockstudio": {
    "attributes": [
      {
        "id": "members",
        "type": "repeater",
        "label": "Team members",
        "min": 1,
        "max": 12,
        "minimized": true,
        "textMinimized": { "id": "name", "fallback": "Team member" },
        "attributes": [
          { "id": "name", "type": "text", "label": "Name" },
          { "id": "bio", "type": "richtext", "label": "Bio" }
        ]
      }
    ]
  }
}
```

## Återanvändbara fältuppsättningar

Definiera en grupp fält en gång i en `field.json` och hänvisa till den från vilket block som helst med `"type": "custom/cta"`. Fälten bäddas in direkt, så mallar läser dem som vilket annat attribut som helst.

Använd samma uppsättning två gånger med en `idStructure`, till exempel `hero_{id}`, och ändra etiketter, standardvärden eller villkor per block med `overrides`. Fälttypen `block` gör samma sak med ett helt block: den expanderar blockets fält direkt och returnerar dess renderade HTML.

[Anpassade fält](https://blockstudio.dev/sv/docs/blocks/attributes/custom-fields/)

fields/cta/field.json

```
{
  "name": "cta",
  "title": "Call to action",
  "attributes": [
    { "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
    { "id": "url", "type": "link", "label": "Button URL" }
  ]
}
```

## ES-moduler utan byggsteg

Lägg till `script.js` så läses den in som en ES-modul. Importera npm-paket med prefixet `npm:`, så laddar Blockstudio ned dem lokalt för produktion.

Redigeraren får en direkt förhandsvisning, medan frontend använder lokala moduler utan externa beroenden, som köas in endast en gång.

Stilmallar importeras på samma sätt. `import "npm:swiper@11.0.0/swiper.min.css"` hämtar filen och lägger till den i kön en gång per version, även när flera block använder den.

[Behandling av tillgångar](https://blockstudio.dev/sv/docs/blocks/assets/)

script.js

```
import Swiper from "npm:swiper@11.0.0";
import "npm:swiper@11.0.0/swiper.min.css";

for (const el of document.querySelectorAll(".swiper")) {
  new Swiper(el, {
    slidesPerView: 3,
    spaceBetween: 20,
    loop: true,
  });
}
```

## Blocktaggar utöver mallar

Koppla ett kort prefix till ett namnrymd i `blockstudio.json`, eller en tagg till ett block med ett aliasfilter, så renderar `<acme-card>` `acme/card`. Aktivera `blockTags.enabled` för att rendera taggar i inläggsinnehåll och widgetar, begränsat av mönstren `allow` och `deny`.

Attribut från `data-*` når blockets rotelement, och attribut från `html-*` kommer dit utan prefixet. Lägg till egna taggbyggare med `blockstudio/block_tags/builders` och skriv om kortformer till den portabla stavningen `<bs:acme-card>` med kommandot `migrate-block-tags`.

[Läs guiden](https://blockstudio.dev/sv/guides/block-tags/)

blockstudio.json

```
{
  "blockTags": {
    "enabled": true,
    "prefixes": {
      "acme": ["acme"],
      "ui": ["acme-ui"]
    },
    "deny": ["acme-ui/admin-*"]
  }
}
```

## Anpassade fälttyper

Registrera en egen fältkontroll och använd den som ett inbyggt fält.

## Blocköar

Cacha hela sidan och rendera ett block i besökarens begäran.

## Villkorad registrering

Registrera ett block endast för en inläggstyp, användarroll eller annat globalt villkor, eller hoppa över det om ett plugin eller den pluginversion det behöver saknas.

## Inläggsmetadata och alternativ

Lagra värden i inläggsmetadata eller alternativ tillsammans med blockattribut.

## Villkorsstyrd logik

Visa fält baserat på värden med likhet, inkludering, tomhet och jämförelser.

## Dynamiska datakällor

Hämta val från inlägg, användare, termer, funktioner eller API:er.

## Åsidosättningar

Ange override: true med namnet på ett delat block för att slå samman attribut efter id, ersätta tillgångar med matchande filnamn och byta mall. Twig-mallar kan åsidosätta enskilda block med extends.

## Varianter

Ange varianter i block.json som förinställer fältvärden, och dölj fältet som styr dem med hidden.

## Komponenter

Ange component: true för ett block som renderas endast från PHP eller blocktaggar. Det behåller fält, mallar, tillgångar och Tailwind men visas aldrig i infogaren.

## Regler för InnerBlocks

Tillåt block med tokensen namespace/*, category: och @theme, byt den inre mallen från ett select-alternativ och ta bort omslutaren på frontend med ett filter.

## Tillgångar för kodfält

Ett kodfält med asset: true omvandlar redigerarens inmatning till CSS, SCSS eller JavaScript för det blocket, avgränsat till instansen med %selector%.

## Resurser efter filnamn

*.view.js laddas endast på frontend, och prefixen global-, admin- och block-editor- laddar en fil på varje sida, i wp-admin respektive i blockredigeraren.

## Ikoner och blockmappar

Ge ett block en anpassad SVG- eller HTML-ikon, flytta sökningen med filtret blockstudio/path och lägg till mappar med Blockstudio\Build::init().

## Värden för ACF och Meta Box

Mallar får $post_id, så get_field() och rwmb_get_value() läser det redigerade inlägget, och refreshOn uppdaterar förhandsvisningen efter att du har sparat.

## Kontext för Query Loop

I en Query Loop följer $block[‘context’][‘postId’] det aktuella objektet, medan $block[‘postId’] förblir inlägget som visas.

## WPML

wp bs wpml config skriver wpml-config.xml, som markerar textfält som översättningsbara, och bilder som lagras i fält läggs till i WPML-översättningsjobb med sina alt-texter och bildtexter.

Plus

## Det officiella tilläggspaketet

Premiumwebbplatsmallar, systeminstruktioner för AI och en privat Discord-community. Engångsköp, uppdateringar på livstid.

- 500+ webbplatsmallar
- AI-systeminstruktioner
- Uppdateringar livet ut
- Privat Discord-community

[Skaffa Plus](https://blockstudio.dev/sv/plus/)
