Kookboek met veldpatronen
Het veldensysteem van Blockstudio is op zichzelf eenvoudig: voeg een veld toe aan blockstudio.attributes en benader het via $a in je sjabloon. Maar echte blokken hebben zelden maar één veld. Ze bevatten groepen met verwante instellingen, velden die worden getoond of verborgen op basis van andere velden, herhalers met complexe rijstructuren en gegevens die buiten de blokeditor opvraagbaar moeten zijn.
Deze gids bevat praktische recepten voor veelvoorkomende veldpatronen. Elk recept toont de configuratie van block.json en de bijbehorende sjablooncode. Kopieer ze rechtstreeks naar je blokken en pas ze zo nodig aan.
Voorwaardelijke velden
Het meest voorkomende patroon: velden tonen of verbergen op basis van de waarde van een ander veld. Zo blijft de editor overzichtelijk en worden alleen relevante opties getoond.
Opties tonen met een schakelaar
Een CTA-blok waarin extra instellingen verschijnen zodra de gebruiker een knop inschakelt:
{
"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 }]]
}
]
}
}
De velden voor de knoptekst en de link verschijnen alleen als de schakelaar aanstaat. Controleer in het sjabloon of de schakelaar is ingeschakeld voordat je ze weergeeft:
<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>
Veldsets wisselen met een keuzelijst
Een hero-blok waarin het achtergrondtype bepaalt welke velden verschijnen:
{
"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" }]]
}
]
}
}
Het veld voor de dekkingsgraad van de overlay gebruikt != om voor alles behalve een effen kleur te verschijnen. Er wordt telkens maar één achtergrondveld getoond. Een veld van het type color retourneert een array met de value, name en slug van de kleur, zodat het sjabloon ['value'] uitleest:
<?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>
OF-voorwaarden
Toon een veld als een van meerdere voorwaarden waar is. Elke binnenste array is een EN-groep; de buitenste array combineert ze met OF:
{
"id": "caption",
"type": "text",
"label": "Caption",
"conditions": [
[{ "id": "bgType", "operator": "==", "value": "image" }],
[{ "id": "bgType", "operator": "==", "value": "video" }]
]
}
Hierdoor wordt het bijschriftveld getoond wanneer bgType “image” OF “video” is.
Gekoppelde voorwaarden
Meerdere voorwaarden in dezelfde binnenste array gebruiken EN-logica:
{
"id": "altText",
"type": "text",
"label": "Alt Text",
"conditions": [[
{ "id": "bgType", "operator": "==", "value": "image" },
{ "id": "bgImage", "operator": "!empty" }
]]
}
Het veld voor alternatieve tekst verschijnt alleen wanneer bgType “image” is EN er een afbeelding is geselecteerd.
Globale voorwaarden
Toon velden op basis van het berichttype, de bericht-ID of de gebruikersrol in plaats van andere veldwaarden:
{
"id": "seoTitle",
"type": "text",
"label": "SEO Title",
"conditions": [[{ "type": "postType", "operator": "==", "value": "page" }]]
}
Beschikbare typen globale voorwaarden: postType, postId, userRole, userId.
Overzichtelijke instellingen
Naarmate blokken complexer worden, houden velden in logische groepen de inspector overzichtelijk.
Groepen voor visuele ordening
Groepen maken inklapbare secties in de inspector. Een anonieme groep (zonder id) is puur visueel; je benadert de velden met hun ongewijzigde ID’s:
{
"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" }
]
}
]
}
}
<div useBlockProps>
<h3><?php echo esc_html( $a['title'] ); ?></h3>
<p><?php echo esc_html( $a['description'] ); ?></p>
</div>
Je benadert de velden rechtstreeks: $a['title'], $a['style'], $a['accentColor']. De groepen zijn alleen van invloed op de indeling van de inspector.
Benoemde groepen met bs_get_group
Als een groep een id heeft, krijgen de ID’s van de onderliggende velden een voorvoegsel. Gebruik bs_get_group() om dat voorvoegsel te verwijderen:
{
"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 }
]
}
Zonder de helper benader je velden als $a['author_name'], $a['author_role'], $a['author_avatar']. Met de helper:
<?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>
Benoemde groepen zijn handig wanneer dezelfde veldnamen in meerdere groepen voorkomen (e.g., author_name en company_name) of als je de groep als geheel aan een gedeeltelijk sjabloon wilt doorgeven.
Rasterindeling in groepen
Gebruik de eigenschap style om onderliggende velden in een groep naast elkaar te plaatsen:
{
"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 twee velden voor eenheden worden naast elkaar in de inspector weergegeven in plaats van onder elkaar. Dit werkt goed voor paren van afmetingen, marges en opvullingen, of andere velden die logisch bij elkaar horen.
Tabbladen voor hoofdsecties
Als een blok veel instellingen heeft, zorgen tabbladen voor een overzichtelijkere indeling dan een lange lijst met groepen:
{
"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" }
]
}
]
}
De velden van elk tabblad zijn toegankelijk als velden op het hoogste niveau: $a['title'], $a['image'], $a['layout']. Tabbladen zijn uitsluitend een UI-container.
Patronen voor herhalers
Met herhalers kunnen gebruikers meerdere rijen met velden toevoegen. Ze zijn onmisbaar voor lijsten, rasters, tijdlijnen en elk onderdeel met een variabel aantal items.
Basisherhaler met beperkingen
Een lijst met functies met 1 tot 6 items:
{
"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" }
]
}
<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>
Aangepaste rijlabels
Ingeklapte rijen van een herhaler krijgen standaard een algemeen label. Gebruik textMinimized om in plaats daarvan een veldwaarde weer te geven:
{
"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 }
]
}
Wanneer een rij is ingeklapt, wordt de naam van de persoon weergegeven in plaats van “Rij 1”. fallback wordt gebruikt als het naamveld leeg is. Je kunt ook tekenreeksen voor prefix en suffix toevoegen.
Voorwaarden in herhalers
Velden in een herhaler kunnen met hun ongewijzigde id naar andere velden in dezelfde rij verwijzen (een voorvoegsel is niet nodig):
{
"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 }]]
}
]
}
Verwijzen naar buitenste velden vanuit een herhaler
Voeg "context": "main" toe als een voorwaarde in een herhaler een veld buiten de herhaler moet controleren:
{
"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"
}]]
}
]
}
Zonder "context": "main" zoekt de voorwaarde naar een veld showDescriptions in de rij van de herhaler. Met dit voorvoegsel controleert de voorwaarde de schakelaar op hoofdniveau.
Tabbladen in repeaters
Tabbladen zijn niet beschikbaar in repeaters: een tabs-veld in een repeaterrij toont in plaats van de velden een melding in de editor, en de PHPStan-extensie meldt dit. Houd de velden van een rij daarom plat. Voor lange rijen houdt een aangepast rijlabel (textMinimized) ingeklapte rijen leesbaar. Met voorwaarden in de rij kun je velden verbergen die slechts voor sommige rijen nodig zijn, zoals in de bovenstaande patronen.
Stel "minimized": true in op een repeater om bestaande rijen ingeklapt te openen. Nieuw toegevoegde rijen worden meteen geopend. Uitzonderingen die zijn uitgeklapt, worden in deze browser onthouden, ook na het opnieuw laden van de editor; dit is een bewerkingsvoorkeur en geen opgeslagen berichtinhoud.
Repeaters zonder minimized behouden hun bestaande gedrag waarbij ze standaard uitgeklapt zijn.
Patronen voor media
Eén afbeelding met terugvaloptie
{
"id": "image",
"type": "files",
"label": "Image",
"multiple": false
}
<?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; ?>
De standaard-returnFormat is "object" en biedt ID, title, alt, caption, description, href, url en sizes. sizes bevat de URL van elk geregistreerd afbeeldingsformaat (sizes['large']), met de afmetingen (sizes['large-width'], sizes['large-height']). Zie Render-attributen voor de volledige lijst.
Galerij met limiet
{
"id": "gallery",
"type": "files",
"label": "Gallery",
"multiple": true,
"max": 6,
"allowedTypes": ["image"]
}
<?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; ?>
Schakelbare afbeelding
De eigenschap switch voegt een oogpictogram toe waarmee gebruikers het veld kunnen uitschakelen zonder de waarde te verwijderen:
{
"id": "logo",
"type": "files",
"label": "Logo",
"multiple": false,
"switch": true
}
<?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; ?>
De gebruiker kan het logo uitschakelen zonder het geüploade bestand te verwijderen. Als het weer wordt ingeschakeld, verschijnt hetzelfde bestand opnieuw.
Variaties in retourformaat
Bepaal wat het bestandsveld retourneert:
// 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"
Gebruik "id" als je zelf wp_get_attachment_image() moet aanroepen. Gebruik "url" voor eenvoudige achtergrondafbeeldingen. Gebruik "object" (de standaardinstelling) voor al het andere.
Met "returnFormat": "id" wordt een geïmporteerde stringreferentie zoals "buckshair-home" ongewijzigd doorgegeven. De editor toont een terugvalkaart zonder miniatuur, ook in repeaterrijen. Het openen of opslaan van de pagina zet een scalaire referentie niet om in een array. Gemengde lijsten met bijlage-ID’s en stringreferenties werken ook; alleen positieve bijlage-ID’s worden opgezocht in de mediabibliotheek.
Blockstudio zet aangepaste stringreferenties niet om naar bijlagen. Los ze op in je eigen renderfilter of template als je draagbare namen op verschillende sites gebruikt. Als je een vervanging kiest in de mediabibliotheek, wordt zoals gebruikelijk de bijlage-ID opgeslagen.
Dynamische opties
Berichten ophalen
Een keuzelijst met alle gepubliceerde pagina’s:
{
"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
}
}
}
Het veld wordt automatisch gevuld met paginatitels als labels en bericht-ID’s als waarden. Gebruik returnFormat in de configuratie voor het vullen om de koppeling aan te passen:
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"returnFormat": { "value": "ID", "label": "post_title" }
}
Taxonomietermen ophalen
{
"id": "category",
"type": "select",
"label": "Category",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "terms",
"arguments": {
"taxonomy": "category",
"hide_empty": true
}
}
}
Ophalen vanuit een functie van PHP
{
"id": "postType",
"type": "select",
"label": "Post Type",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": { "public": true }
}
}
Statische opties combineren met opgehaalde opties
Combineer hardgecodeerde opties met dynamische opties. Gebruik position om te bepalen waar de opgehaalde opties verschijnen:
{
"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 statische opties verschijnen eerst, gevolgd door de dynamisch opgehaalde pagina’s.
Gegevens opslaan om ze op te vragen
Standaard staan veldwaarden in blokattributen binnen post_content. Je kunt ze niet opvragen met WP_Query. Gebruik opslag wanneer je berichten wilt filteren of sorteren op een veldwaarde.
Berichtmeta voor opvraagbare velden
{
"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 kun je berichten met uitgelichte inhoud opvragen:
$featured = new WP_Query( array(
'meta_query' => array(
array(
'key' => 'is_featured',
'value' => '1',
),
),
'orderby' => 'meta_value_num',
'meta_key' => 'priority_score',
'order' => 'DESC',
) );
De metatoetsen worden automatisch geregistreerd met show_in_rest, zodat ze ook beschikbaar zijn in de REST API.
Dubbele opslag
Sla gegevens zowel in blokattributen als in berichtmeta op. Het blokattribuut houdt de waarde beschikbaar in sjablonen via $a, terwijl de berichtmeta de waarde opvraagbaar maakt:
{
"id": "eventDate",
"type": "date",
"label": "Event Date",
"storage": {
"type": ["block", "postMeta"],
"postMetaKey": "event_date"
}
}
Optieopslag voor globale waarden
Gebruik optieopslag voor sitebrede instellingen die overal hetzelfde moeten zijn:
{
"id": "companyName",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
}
De waarde wordt opgeslagen in wp_options en is overal toegankelijk via get_option('site_company_name'). Wanneer de gebruiker dit veld in een blokinstantie bewerkt, wordt de waarde overal bijgewerkt.
Herbruikbare velddefinities
Als meerdere blokken dezelfde veldstructuur gebruiken, definieer je die één keer als aangepast veld en verwijs je er overal naar.
Een aangepast veld maken
Maak een field.json aan in de map blockstudio/fields/ van je thema:
theme/
└── blockstudio/
└── 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" },
{ "id": "style", "type": "select", "label": "Button Style", "default": "primary", "options": [
{ "value": "primary", "label": "Primary" },
{ "value": "secondary", "label": "Secondary" },
{ "value": "outline", "label": "Outline" }
]}
]
}
Het aangepaste veld gebruiken
Verwijs er in elk blok naar met "type": "custom/cta":
{
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "type": "custom/cta" }
]
}
}
De CTA-velden worden rechtstreeks in het blok opgenomen. Benader ze rechtstreeks: $a['label'], $a['url'], $a['style'].
Voorvoegsels voor aangepaste velden met idStructure
Voeg idStructure toe om ID’s te voorzien van een voorvoegsel wanneer je hetzelfde aangepaste veld meerdere keren gebruikt:
{
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{ "type": "custom/cta", "idStructure": "secondary_{id}" }
]
}
}
De velden van de eerste CTA worden primary_label, primary_url, primary_style. Die van de tweede worden secondary_label, enzovoort.
Standaardwaarden aanpassen
Pas specifieke velden aan wanneer je naar een aangepast veld verwijst:
{
"type": "custom/cta",
"idStructure": "hero_{id}",
"overrides": {
"label": { "default": "Get Started", "label": "CTA Label" },
"style": { "default": "primary" }
}
}
Aanpassingen worden samengevoegd met de oorspronkelijke definitie. Je kunt standaardwaarden, labels, voorwaarden en andere eigenschappen wijzigen.
Patronen voor weergave
Controleren op lege waarden
De meeste veldtypen retourneren false als ze leeg zijn. Controleer dit altijd voordat je ze weergeeft:
<?php if ( $a['title'] ) : ?>
<h2><?php echo esc_html( $a['title'] ); ?></h2>
<?php endif; ?>
Bij getallen is 0 een geldige waarde. Gebruik een strikte vergelijking als je onderscheid wilt maken tussen “leeg” en “nul”:
<?php if ( $a['count'] !== 0 || $a['count'] !== false ) : ?>
<span><?php echo esc_html( $a['count'] ); ?></span>
<?php endif; ?>
Keuzelijst met returnFormat: both
Wanneer je zowel de waarde (voor logica) als het label (voor weergave) nodig hebt:
{
"id": "status",
"type": "select",
"label": "Status",
"returnFormat": "both",
"options": [
{ "value": "active", "label": "Active" },
{ "value": "paused", "label": "On Hold" },
{ "value": "closed", "label": "Closed" }
]
}
<?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; ?>
Data-attributen uit het veld attributes
Met het veldtype attributes kunnen gebruikers aangepaste data-attributen toevoegen:
{
"id": "dataAttrs",
"type": "attributes",
"label": "Data Attributes",
"link": true,
"media": true
}
<div useBlockProps <?php bs_render_data_attributes( $a['dataAttrs'] ); ?>>
Content here.
</div>
CSS-variabelen op basis van veldwaarden
Genereer aangepaste eigenschappen van CSS op basis van geselecteerde velden:
{
"id": "textColor", "type": "color", "label": "Text Color"
},
{
"id": "fontSize", "type": "unit", "label": "Font Size", "default": "1rem"
}
<div useBlockProps style="<?php bs_render_variables( $a, array( 'textColor', 'fontSize' ) ); ?>">
<p>Styled content.</p>
</div>
Dit levert style="--text-color: #333; --font-size: 1rem;" op (veld-ID’s worden omgezet naar kebab-case). Gebruik de variabelen in je CSS:
p {
color: var(--text-color);
font-size: var(--font-size);
}
Volgende stappen
- Attributen registreren: de eigenschappen
id,type,label,default,help,positionenconditions. - Naslag voor veldtypen: automatisch gegenereerd naslagwerk met elke eigenschap voor elk veldtype.
- Voorwaardelijke logica: operatoren, globale voorwaarden, aangepaste voorwaardefilters en context voor herhalers.
- Opties vullen: modi voor query’s, functies, aangepaste opties en ophalen voor dynamische optievelden.
- Aangepaste velden:
field.json, detectiepaden, het filterblockstudio/fieldsen geavanceerde patronen vooridStructure. - Weergeven:
$a,$b,$c, lege waarden en helperfuncties.