Gå til indhold

Opskriftsbog med feltmønstre

Blockstudios feltsystem er enkelt i sig selv: Tilføj et felt til blockstudio.attributes, og tilgå det via $a i din skabelon. Men rigtige blokke har sjældent kun ét felt. De har grupper af relaterede indstillinger, felter, der vises eller skjules afhængigt af andre felter, gentagelsesfelter med komplekse rækkestrukturer og data, der skal kunne forespørges uden for blokeditoren.

Denne guide samler praktiske opskrifter på almindelige feltmønstre. Hver opskrift viser konfigurationen af block.json og den tilsvarende skabelonkode. Kopiér dem direkte ind i dine blokke, og tilpas efter behov.

Betingede felter

Det mest almindelige mønster: Vis eller skjul felter baseret på værdien af et andet felt. Det holder editoren overskuelig ved kun at vise relevante indstillinger.

Vis indstillinger med en kontakt

En CTA-blok, hvor yderligere indstillinger vises, når brugeren aktiverer en knap:

JSON
{
  "name": "my-theme/cta",
  "title": "Call to Action",
  "blockstudio": {
    "attributes": [
      { "id": "heading", "type": "text", "label": "Heading", "default": "Ready to get started?" },
      { "id": "description", "type": "textarea", "label": "Description" },
      { "id": "showButton", "type": "toggle", "label": "Show Button", "default": true },
      {
        "id": "buttonText",
        "type": "text",
        "label": "Button Text",
        "default": "Get Started",
        "conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
      },
      {
        "id": "buttonUrl",
        "type": "link",
        "label": "Button Link",
        "conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
      }
    ]
  }
}

Felterne til knaptekst og link vises kun, når kontakten er slået til. Kontrollér kontakten i skabelonen, før du viser dem:

PHP
<div useBlockProps>
  <h2><?php echo esc_html( $a['heading'] ); ?></h2>
  <?php if ( $a['description'] ) : ?>
    <p><?php echo esc_html( $a['description'] ); ?></p>
  <?php endif; ?>
  <?php if ( $a['showButton'] && $a['buttonUrl'] ) : ?>
    <a href="<?php echo esc_url( $a['buttonUrl']['url'] ); ?>">
      <?php echo esc_html( $a['buttonText'] ); ?>
    </a>
  <?php endif; ?>
</div>

Skift feltsæt med en valgliste

En hero-blok, hvor baggrundstypen afgør, hvilke felter der vises:

JSON
{
  "name": "my-theme/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      { "id": "heading", "type": "text", "label": "Heading" },
      {
        "id": "bgType",
        "type": "select",
        "label": "Background Type",
        "default": "color",
        "options": [
          { "value": "color", "label": "Solid Color" },
          { "value": "gradient", "label": "Gradient" },
          { "value": "image", "label": "Image" },
          { "value": "video", "label": "Video" }
        ]
      },
      {
        "id": "bgColor",
        "type": "color",
        "label": "Background Color",
        "conditions": [[{ "id": "bgType", "operator": "==", "value": "color" }]]
      },
      {
        "id": "bgGradient",
        "type": "gradient",
        "label": "Background Gradient",
        "conditions": [[{ "id": "bgType", "operator": "==", "value": "gradient" }]]
      },
      {
        "id": "bgImage",
        "type": "files",
        "label": "Background Image",
        "multiple": false,
        "conditions": [[{ "id": "bgType", "operator": "==", "value": "image" }]]
      },
      {
        "id": "bgVideo",
        "type": "files",
        "label": "Background Video",
        "multiple": false,
        "allowedTypes": ["video"],
        "conditions": [[{ "id": "bgType", "operator": "==", "value": "video" }]]
      },
      {
        "id": "overlay",
        "type": "range",
        "label": "Overlay Opacity",
        "default": 50,
        "min": 0,
        "max": 100,
        "conditions": [[{ "id": "bgType", "operator": "!=", "value": "color" }]]
      }
    ]
  }
}

Feltet for gennemsigtighed af overlejringen bruger != til at blive vist for alle baggrundstyper undtagen ensfarvet. Kun ét baggrundsfelt vises ad gangen. Et color-felt returnerer et array med farvens value, name og slug, så skabelonen læser ['value']:

PHP
<?php
$bg_style = match ( $a['bgType'] ) {
	'color'    => $a['bgColor'] ? "background-color: {$a['bgColor']['value']}" : '',
	'gradient' => $a['bgGradient'] ? "background: {$a['bgGradient']}" : '',
	'image'    => $a['bgImage'] ? "background-image: url({$a['bgImage']['url']})" : '',
	default    => '',
};
?>
<div useBlockProps style="<?php echo esc_attr( $bg_style ); ?>">
  <?php if ( $a['bgType'] === 'video' && $a['bgVideo'] ) : ?>
    <video autoplay muted loop playsinline>
      <source src="<?php echo esc_url( $a['bgVideo']['url'] ); ?>" />
    </video>
  <?php endif; ?>
  <h1><?php echo esc_html( $a['heading'] ); ?></h1>
</div>

ELLER-betingelser

Vis et felt, når en af flere betingelser er opfyldt. Hvert indre array er en OG-gruppe; det ydre array kombinerer dem med ELLER:

JSON
{
  "id": "caption",
  "type": "text",
  "label": "Caption",
  "conditions": [
    [{ "id": "bgType", "operator": "==", "value": "image" }],
    [{ "id": "bgType", "operator": "==", "value": "video" }]
  ]
}

Dette viser billedtekstfeltet, når bgType er “image” ELLER “video”.

Kædede betingelser

Flere betingelser i samme indre array bruger OG-logik:

JSON
{
  "id": "altText",
  "type": "text",
  "label": "Alt Text",
  "conditions": [[
    { "id": "bgType", "operator": "==", "value": "image" },
    { "id": "bgImage", "operator": "!empty" }
  ]]
}

Alternativ tekst-feltet vises kun, når bgType er “image” OG et billede er valgt.

Globale betingelser

Vis felter baseret på indlægstype, indlægs-id eller brugerrolle i stedet for andre feltværdier:

JSON
{
  "id": "seoTitle",
  "type": "text",
  "label": "SEO Title",
  "conditions": [[{ "type": "postType", "operator": "==", "value": "page" }]]
}

Tilgængelige typer af globale betingelser: postType, postId, userRole, userId.

Organiserede indstillinger

Når blokke bliver komplekse, gør det inspektøren mere overskuelig at organisere felter i logiske grupper.

Grupper til visuel organisering

Grupper opretter sektioner, der kan foldes sammen, i inspektøren. En anonym gruppe (uden id) er rent visuel; dens felter tilgås med deres bare id’er:

JSON
{
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "attributes": [
      {
        "type": "group",
        "title": "Content",
        "attributes": [
          { "id": "title", "type": "text", "label": "Title" },
          { "id": "description", "type": "textarea", "label": "Description" },
          { "id": "image", "type": "files", "label": "Image", "multiple": false }
        ]
      },
      {
        "type": "group",
        "title": "Link",
        "attributes": [
          { "id": "url", "type": "link", "label": "URL" },
          { "id": "openInNewTab", "type": "toggle", "label": "Open in New Tab" }
        ]
      },
      {
        "type": "group",
        "title": "Appearance",
        "attributes": [
          {
            "id": "style",
            "type": "select",
            "label": "Style",
            "default": "elevated",
            "options": [
              { "value": "elevated", "label": "Elevated" },
              { "value": "outlined", "label": "Outlined" },
              { "value": "flat", "label": "Flat" }
            ]
          },
          { "id": "accentColor", "type": "color", "label": "Accent Color" }
        ]
      }
    ]
  }
}
PHP
<div useBlockProps>
  <h3><?php echo esc_html( $a['title'] ); ?></h3>
  <p><?php echo esc_html( $a['description'] ); ?></p>
</div>

Felterne tilgås direkte: $a['title'], $a['style'], $a['accentColor']. Grupperne påvirker kun inspektørens layout.

Navngivne grupper med bs_get_group

Når en gruppe har et id, får dens underfelters id’er et præfiks. Brug bs_get_group() til at fjerne præfikset:

JSON
{
  "id": "author",
  "type": "group",
  "title": "Author",
  "attributes": [
    { "id": "name", "type": "text", "label": "Name" },
    { "id": "role", "type": "text", "label": "Role" },
    { "id": "avatar", "type": "files", "label": "Avatar", "multiple": false }
  ]
}

Uden hjælperen tilgås felterne som $a['author_name'], $a['author_role'], $a['author_avatar']. Med hjælperen:

PHP
<?php $author = bs_get_group( $a, 'author' ); ?>
<div class="author">
  <?php if ( $author['avatar'] ) : ?>
    <img src="<?php echo esc_url( $author['avatar']['url'] ); ?>" alt="" />
  <?php endif; ?>
  <p><?php echo esc_html( $author['name'] ); ?></p>
  <p><?php echo esc_html( $author['role'] ); ?></p>
</div>

Navngivne grupper er nyttige, når de samme feltnavne forekommer i flere grupper (e.g., author_name og company_name), eller når du vil videregive gruppen samlet til en delskabelon.

Gitterlayout i grupper

Brug egenskaben style til at arrangere gruppens underfelter side om side:

JSON
{
  "type": "group",
  "title": "Dimensions",
  "style": {
    "display": "grid",
    "grid-template-columns": "1fr 1fr",
    "grid-gap": "16px"
  },
  "attributes": [
    { "id": "width", "type": "unit", "label": "Width", "default": "100%", "switch": false },
    { "id": "height", "type": "unit", "label": "Height", "default": "auto", "switch": false }
  ]
}

De to enhedsfelter vises side om side i inspektøren i stedet for oven på hinanden. Det fungerer godt til par af dimensioner, værdier for margen og padding eller andre felter, der naturligt hører sammen to og to.

Faner til større sektioner

Når en blok har mange indstillinger, giver faner en mere overskuelig organisering end en lang liste af grupper:

JSON
{
  "type": "tabs",
  "tabs": [
    {
      "title": "Content",
      "attributes": [
        { "id": "title", "type": "text", "label": "Title" },
        { "id": "body", "type": "wysiwyg", "label": "Body" }
      ]
    },
    {
      "title": "Media",
      "attributes": [
        { "id": "image", "type": "files", "label": "Image", "multiple": false },
        { "id": "video", "type": "files", "label": "Video", "multiple": false, "allowedTypes": ["video"] }
      ]
    },
    {
      "title": "Settings",
      "attributes": [
        { "id": "layout", "type": "select", "label": "Layout", "options": [
          { "value": "left", "label": "Media Left" },
          { "value": "right", "label": "Media Right" }
        ]},
        { "id": "fullWidth", "type": "toggle", "label": "Full Width" }
      ]
    }
  ]
}

Felterne på hver fane tilgås som felter på øverste niveau: $a['title'], $a['image'], $a['layout']. Faner er udelukkende en UI-beholder.

Mønstre for gentagelsesfelter

Gentagelsesfelter lader brugere tilføje flere rækker med felter. De er uundværlige til lister, gitre, tidslinjer og alle komponenter med et variabelt antal elementer.

Grundlæggende gentagelsesfelt med begrænsninger

En funktionsliste med 1 til 6 elementer:

JSON
{
  "id": "features",
  "type": "repeater",
  "label": "Features",
  "min": 1,
  "max": 6,
  "textButton": "Add Feature",
  "attributes": [
    { "id": "icon", "type": "icon", "label": "Icon" },
    { "id": "title", "type": "text", "label": "Title", "default": "Feature" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}
PHP
<div useBlockProps class="grid grid-cols-3 gap-8">
  <?php foreach ( $a['features'] as $feature ) : ?>
    <div>
      <?php if ( $feature['icon'] ) : ?>
        <?php bs_render_icon( $feature['icon'] ); ?>
      <?php endif; ?>
      <h3><?php echo esc_html( $feature['title'] ); ?></h3>
      <p><?php echo esc_html( $feature['description'] ); ?></p>
    </div>
  <?php endforeach; ?>
</div>

Brugerdefinerede rækkelabels

Som standard vises et generisk label på minimerede rækker i gentagelsesfelter. Brug textMinimized til at vise en feltværdi i stedet:

JSON
{
  "id": "team",
  "type": "repeater",
  "label": "Team Members",
  "textMinimized": { "id": "name", "fallback": "Team Member" },
  "attributes": [
    { "id": "name", "type": "text", "label": "Name" },
    { "id": "role", "type": "text", "label": "Role" },
    { "id": "photo", "type": "files", "label": "Photo", "multiple": false }
  ]
}

Når en række er foldet sammen, vises personens navn i stedet for “Row 1”. fallback bruges, hvis navnefeltet er tomt. Du kan også tilføje tekststrengene prefix og suffix.

Betingelser i gentagelsesfelter

Felter i et gentagelsesfelt kan henvise til andre felter i samme række med deres bare id (intet præfiks kræves):

JSON
{
  "id": "links",
  "type": "repeater",
  "label": "Links",
  "attributes": [
    { "id": "label", "type": "text", "label": "Label" },
    { "id": "url", "type": "link", "label": "URL" },
    {
      "id": "isExternal",
      "type": "toggle",
      "label": "External Link"
    },
    {
      "id": "externalNote",
      "type": "message",
      "label": "Note",
      "description": "External links open in a new tab with rel=\"noopener\".",
      "conditions": [[{ "id": "isExternal", "operator": "==", "value": true }]]
    }
  ]
}

Henvisning til felter uden for et gentagelsesfelt

Hvis en betingelse i et gentagelsesfelt skal kontrollere et felt uden for gentagelsesfeltet, skal du tilføje "context": "main":

JSON
{
  "id": "showDescriptions",
  "type": "toggle",
  "label": "Show Descriptions",
  "default": true
},
{
  "id": "items",
  "type": "repeater",
  "label": "Items",
  "attributes": [
    { "id": "title", "type": "text", "label": "Title" },
    {
      "id": "description",
      "type": "textarea",
      "label": "Description",
      "conditions": [[{
        "id": "showDescriptions",
        "operator": "==",
        "value": true,
        "context": "main"
      }]]
    }
  ]
}

Uden "context": "main" ville betingelsen lede efter et showDescriptions-felt i gentagelsesfeltets række. Med det kontrollerer betingelsen kontakten på rodniveau.

Faner i gentagelsesfelter

Faner er ikke tilgængelige i gentagelsesfelter: Et tabs-felt i en række i et gentagelsesfelt viser en meddelelse i editoren i stedet for sine felter, og udvidelsen PHPStan rapporterer det. Hold i stedet felterne i en række flade. Ved lange rækker gør en brugerdefineret rækkelabel (textMinimized) sammenklappede rækker læsbare, og betingelser i rækken kan skjule felter, som kun er nødvendige i nogle rækker, som vist i mønstrene ovenfor.

Angiv "minimized": true på et gentagelsesfelt for at starte med eksisterende rækker sammenklappet. Nye rækker åbnes med det samme. Udvidede undtagelser huskes i denne browser på tværs af genindlæsninger af editoren; det er en redigeringsindstilling, ikke gemt indlægsindhold. Gentagelsesfelter uden minimized bevarer den eksisterende adfærd, hvor de som standard er udvidet.

Mediemønstre

Enkeltbillede med reservebillede

JSON
{
  "id": "image",
  "type": "files",
  "label": "Image",
  "multiple": false
}
PHP
<?php if ( $a['image'] ) : ?>
  <img
    src="<?php echo esc_url( $a['image']['url'] ); ?>"
    alt="<?php echo esc_attr( $a['image']['alt'] ); ?>"
    <?php if ( isset( $a['image']['sizes']['full-width'], $a['image']['sizes']['full-height'] ) ) : ?>
      width="<?php echo esc_attr( $a['image']['sizes']['full-width'] ); ?>"
      height="<?php echo esc_attr( $a['image']['sizes']['full-height'] ); ?>"
    <?php endif; ?>
  />
<?php endif; ?>

Standardværdien for returnFormat er "object", som giver ID, title, alt, caption, description, href, url og sizes. sizes indeholder URL for alle registrerede billedstørrelser (sizes['large']) med deres dimensioner (sizes['large-width'], sizes['large-height']). Se Rendering Attributes for den fulde liste.

JSON
{
  "id": "gallery",
  "type": "files",
  "label": "Gallery",
  "multiple": true,
  "max": 6,
  "allowedTypes": ["image"]
}
PHP
<?php if ( $a['gallery'] ) : ?>
  <div class="grid grid-cols-3 gap-4">
    <?php foreach ( $a['gallery'] as $image ) : ?>
      <img
        src="<?php echo esc_url( $image['url'] ); ?>"
        alt="<?php echo esc_attr( $image['alt'] ); ?>" />
    <?php endforeach; ?>
  </div>
<?php endif; ?>

Billede, der kan deaktiveres med en kontakt

Egenskaben switch tilføjer et øjeikon, der lader brugerne deaktivere feltet uden at slette værdien:

JSON
{
  "id": "logo",
  "type": "files",
  "label": "Logo",
  "multiple": false,
  "switch": true
}
PHP
<?php
$is_disabled = ! empty( $a['_disabled'] ) && in_array( 'logo', $a['_disabled'], true );
if ( $a['logo'] && ! $is_disabled ) : ?>
  <img src="<?php echo esc_url( $a['logo']['url'] ); ?>" alt="" />
<?php endif; ?>

Brugeren kan slå logoet fra uden at fjerne den uploadede fil. Når det aktiveres igen, vises den samme fil.

Varianter af returformat

Styr, hvad filfeltet returnerer:

JSON
// Full object (default)
{ "id": "photo", "type": "files", "returnFormat": "object", "multiple": false }
// $a['photo']['url'], $a['photo']['alt'], $a['photo']['sizes']['full-width'], etc.

// Just the ID
{ "id": "photo", "type": "files", "returnFormat": "id", "multiple": false }
// $a['photo'] = 42

// Just the URL
{ "id": "photo", "type": "files", "returnFormat": "url", "multiple": false }
// $a['photo'] = "https://example.com/photo.jpg"

Brug "id", når du selv skal kalde wp_get_attachment_image(). Brug "url" til enkle baggrundsbilleder. Brug "object" (standardindstillingen) til alt andet.

Med "returnFormat": "id" sendes en importeret strengreference som "buckshair-home" videre uden ændringer. Editor viser et reservekort uden miniaturebillede, også i rækker i gentagelsesfelter. Når du åbner eller gemmer siden, konverteres en skalær reference ikke til et array. Blandede lister med vedhæftnings-id’er og strengreferencer fungerer også; kun positive vedhæftnings-id’er slås op i mediebiblioteket.

Blockstudio løser ikke brugerdefinerede strengreferencer til vedhæftninger. Løs dem i dit eget renderfilter eller din skabelon, når du bruger flytbare navne på tværs af websteder. Hvis du vælger en erstatning i mediebiblioteket, gemmes dens vedhæftnings-id som normalt.

Dynamiske indstillinger

Hent fra indlæg

Et valgfelt, der viser alle offentliggjorte sider:

JSON
{
  "id": "linkedPage",
  "type": "select",
  "label": "Linked Page",
  "stylisedUi": true,
  "populate": {
    "type": "query",
    "query": "posts",
    "arguments": {
      "post_type": "page",
      "post_status": "publish",
      "posts_per_page": -1
    }
  }
}

Feltet udfyldes automatisk med sidetitler som labels og indlægs-id’er som værdier. Brug returnFormat i udfyldningskonfigurationen til at tilpasse tilknytningen:

JSON
"populate": {
  "type": "query",
  "query": "posts",
  "arguments": { "post_type": "page" },
  "returnFormat": { "value": "ID", "label": "post_title" }
}

Hent fra taksonomitermer

JSON
{
  "id": "category",
  "type": "select",
  "label": "Category",
  "stylisedUi": true,
  "populate": {
    "type": "query",
    "query": "terms",
    "arguments": {
      "taxonomy": "category",
      "hide_empty": true
    }
  }
}

Hent fra en PHP-funktion

JSON
{
  "id": "postType",
  "type": "select",
  "label": "Post Type",
  "populate": {
    "type": "function",
    "function": "get_post_types",
    "arguments": { "public": true }
  }
}

Statiske indstillinger med dynamiske tilføjelser

Kombinér hardkodede indstillinger med dynamiske. Brug position til at styre, hvor de hentede indstillinger vises:

JSON
{
  "id": "source",
  "type": "select",
  "label": "Source",
  "options": [
    { "value": "manual", "label": "Manual Entry" },
    { "value": "latest", "label": "Latest Posts" }
  ],
  "populate": {
    "type": "query",
    "query": "posts",
    "arguments": { "post_type": "page" },
    "position": "after"
  }
}

De statiske indstillinger vises først, efterfulgt af de dynamisk hentede sider.

Lagring af data til forespørgsler

Som standard ligger feltværdier i blokattributter i post_content. De kan ikke forespørges med WP_Query. Brug lagring, når du har brug for at filtrere eller sortere indlæg efter en feltværdi.

Indlægsmetadata til søgbare felter

JSON
{
  "id": "featured",
  "type": "toggle",
  "label": "Featured",
  "storage": {
    "type": "postMeta",
    "postMetaKey": "is_featured"
  }
},
{
  "id": "priority",
  "type": "number",
  "label": "Priority",
  "default": 0,
  "min": 0,
  "max": 100,
  "storage": {
    "type": "postMeta",
    "postMetaKey": "priority_score"
  }
}

Nu kan du forespørge efter fremhævede indlæg:

PHP
$featured = new WP_Query( array(
    'meta_query' => array(
        array(
            'key'   => 'is_featured',
            'value' => '1',
        ),
    ),
    'orderby'  => 'meta_value_num',
    'meta_key' => 'priority_score',
    'order'    => 'DESC',
) );

Metanøglerne registreres automatisk med show_in_rest, så de også er tilgængelige i REST API.

Dobbelt lagring

Gem både i blokattributter og indlægsmetadata. Blokattributten holder værdien tilgængelig i skabeloner via $a, mens indlægsmetadataene gør den søgbar:

JSON
{
  "id": "eventDate",
  "type": "date",
  "label": "Event Date",
  "storage": {
    "type": ["block", "postMeta"],
    "postMetaKey": "event_date"
  }
}

Indstillingslagring til globale værdier

Brug indstillingslagring til indstillinger for hele webstedet, som skal være ens alle steder:

JSON
{
  "id": "companyName",
  "type": "text",
  "label": "Company Name",
  "storage": {
    "type": "option",
    "optionKey": "site_company_name"
  }
}

Værdien gemmes i wp_options og kan tilgås overalt med get_option('site_company_name'). Når brugeren redigerer dette felt i en hvilken som helst blokinstans, opdateres værdien globalt.

Genanvendelige feltdefinitioner

Når flere blokke deler den samme feltstruktur, kan du definere den én gang som et brugerdefineret felt og henvise til det overalt.

Oprettelse af et brugerdefineret felt

Opret et field.json i dit temas mappe blockstudio/fields/:

Kode
theme/
└── blockstudio/
    └── fields/
        └── cta/
            └── field.json
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" },
    { "id": "style", "type": "select", "label": "Button Style", "default": "primary", "options": [
      { "value": "primary", "label": "Primary" },
      { "value": "secondary", "label": "Secondary" },
      { "value": "outline", "label": "Outline" }
    ]}
  ]
}

Brug af det brugerdefinerede felt

Henvis til det i en hvilken som helst blok med "type": "custom/cta":

JSON
{
  "blockstudio": {
    "attributes": [
      { "id": "heading", "type": "text", "label": "Heading" },
      { "type": "custom/cta" }
    ]
  }
}

CTA-felterne indlejres i blokken. Tilgå dem direkte: $a['label'], $a['url'], $a['style'].

Brugerdefinerede felter med idStructure-præfiks

Når du bruger det samme brugerdefinerede felt flere gange, kan du tilføje idStructure for at sætte præfikser foran id’erne:

JSON
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/cta", "idStructure": "primary_{id}" },
      { "type": "custom/cta", "idStructure": "secondary_{id}" }
    ]
  }
}

Den første CTAs felter bliver primary_label, primary_url, primary_style. Den andens bliver secondary_label osv.

Tilsidesættelse af standardværdier

Tilpas bestemte felter, når du henviser til et brugerdefineret felt:

JSON
{
  "type": "custom/cta",
  "idStructure": "hero_{id}",
  "overrides": {
    "label": { "default": "Get Started", "label": "CTA Label" },
    "style": { "default": "primary" }
  }
}

Tilsidesættelser flettes oven i den oprindelige definition. Du kan ændre standardværdier, labels, betingelser eller enhver anden egenskab.

Mønstre for gengivelse

Kontrol af tomme værdier

De fleste felttyper returnerer false, når de er tomme. Kontrollér altid, før du gengiver dem:

PHP
<?php if ( $a['title'] ) : ?>
  <h2><?php echo esc_html( $a['title'] ); ?></h2>
<?php endif; ?>

For tal er 0 en gyldig værdi. Brug en streng sammenligning, hvis du skal skelne mellem “tom” og “nul”:

PHP
<?php if ( $a['count'] !== 0 || $a['count'] !== false ) : ?>
  <span><?php echo esc_html( $a['count'] ); ?></span>
<?php endif; ?>

Valgfelt med returnFormat: both

Når du har brug for både værdien (til logik) og labelen (til visning):

JSON
{
  "id": "status",
  "type": "select",
  "label": "Status",
  "returnFormat": "both",
  "options": [
    { "value": "active", "label": "Active" },
    { "value": "paused", "label": "On Hold" },
    { "value": "closed", "label": "Closed" }
  ]
}
PHP
<?php if ( $a['status'] ) : ?>
  <span class="badge badge--<?php echo esc_attr( $a['status']['value'] ); ?>">
    <?php echo esc_html( $a['status']['label'] ); ?>
  </span>
<?php endif; ?>

Dataattributter fra attributfeltet

Felttypen attributes lader brugerne tilføje brugerdefinerede dataattributter:

JSON
{
  "id": "dataAttrs",
  "type": "attributes",
  "label": "Data Attributes",
  "link": true,
  "media": true
}
PHP
<div useBlockProps <?php bs_render_data_attributes( $a['dataAttrs'] ); ?>>
  Content here.
</div>

CSS-variabler fra feltværdier

Generér brugerdefinerede egenskaber for CSS ud fra valgte felter:

JSON
{
  "id": "textColor", "type": "color", "label": "Text Color"
},
{
  "id": "fontSize", "type": "unit", "label": "Font Size", "default": "1rem"
}
PHP
<div useBlockProps style="<?php bs_render_variables( $a, array( 'textColor', 'fontSize' ) ); ?>">
  <p>Styled content.</p>
</div>

Dette giver style="--text-color: #333; --font-size: 1rem;" (felt-id’er konverteres til kebab-case). Brug variablerne i din CSS:

CSS
p {
  color: var(--text-color);
  font-size: var(--font-size);
}

Næste trin