Kokbok med fältmönster
Blockstudios fältsystem är enkelt i isolering: lägg till ett fält i blockstudio.attributes och kom åt det via $a i din mall. Men verkliga block har sällan bara ett fält. De har grupper med relaterade inställningar, fält som visas eller döljs beroende på andra fält, upprepningsfält med komplexa radstrukturer och data som måste kunna sökas utanför blockredigeraren.
Den här guiden samlar praktiska recept för vanliga fältmönster. Varje recept visar konfigurationen för block.json och motsvarande mallkod. Kopiera dem direkt till dina block och anpassa efter behov.
Villkorsstyrda fält
Det vanligaste mönstret: att visa eller dölja fält baserat på värdet i ett annat fält. Det håller redigeraren ren genom att bara visa relevanta alternativ.
Växla för att visa alternativ
Ett CTA-block där ytterligare inställningar visas när användaren aktiverar en knapp:
{
"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 }]]
}
]
}
}
Fälten för knapptext och länk visas bara när växeln är på. Kontrollera växeln i mallen innan du renderar:
<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>
Växla fältuppsättningar med ett urval
Ett hero-block där bakgrundstypen avgör vilka fält som visas:
{
"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" }]]
}
]
}
}
Fältet för opacitet i överlägget använder != för att visas för alla bakgrundstyper utom enfärgad. Bara ett bakgrundsfält visas åt gången. Ett fält av typen color returnerar en array med färgens value, name och slug, så mallen läser ['value']:
<?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-villkor
Visa ett fält när något av flera villkor är sant. Varje inre array är en OCH-grupp; den yttre arrayen kombinerar dem med ELLER:
{
"id": "caption",
"type": "text",
"label": "Caption",
"conditions": [
[{ "id": "bgType", "operator": "==", "value": "image" }],
[{ "id": "bgType", "operator": "==", "value": "video" }]
]
}
Detta visar bildtextfältet när bgType är “image” ELLER “video”.
Kedjade villkor
Flera villkor i samma inre array använder OCH-logik:
{
"id": "altText",
"type": "text",
"label": "Alt Text",
"conditions": [[
{ "id": "bgType", "operator": "==", "value": "image" },
{ "id": "bgImage", "operator": "!empty" }
]]
}
Alt-textfältet visas bara när bgType är “image” OCH en bild har valts.
Globala villkor
Visa fält baserat på inläggstyp, inläggs-ID eller användarroll i stället för andra fältvärden:
{
"id": "seoTitle",
"type": "text",
"label": "SEO Title",
"conditions": [[{ "type": "postType", "operator": "==", "value": "page" }]]
}
Tillgängliga globala villkorstyper: postType, postId, userRole, userId.
Organiserade inställningar
När block blir mer komplexa gör det redigeringspanelen mer hanterbar att organisera fält i logiska grupper.
Grupper för visuell organisering
Grupper skapar fällbara avsnitt i redigeringspanelen. En namnlös grupp (utan id) är endast visuell; dess fält nås med sina vanliga ID:n:
{
"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>
Fälten nås direkt: $a['title'], $a['style'], $a['accentColor']. Grupperna påverkar bara redigeringspanelens layout.
Namngivna grupper med bs_get_group
När en grupp har ett id får dess underordnade fält-ID:n ett prefix. Använd bs_get_group() för att ta bort prefixet:
{
"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 }
]
}
Utan hjälpfunktionen nås fälten som $a['author_name'], $a['author_role'], $a['author_avatar']. Med hjälpfunktionen:
<?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>
Namngivna grupper är användbara när samma fältnamn förekommer i flera grupper (e.g, author_name och company_name) eller när du vill skicka gruppen som en enhet till en partialmall.
Rutnätslayout i grupper
Använd egenskapen style för att placera gruppens underordnade fält bredvid varandra:
{
"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 två enhetsfälten visas bredvid varandra i redigeringspanelen i stället för staplade. Det fungerar bra för dimensionspar, marginal-/utfyllnadsvärden eller andra två fält som hör ihop begreppsmässigt.
Flikar för huvudavsnitt
När ett block har många inställningar ger flikar en tydligare organisering än en lång lista med grupper:
{
"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" }
]
}
]
}
Fälten på varje flik nås som fält på toppnivå: $a['title'], $a['image'], $a['layout']. Flikar är enbart en UI behållare.
Mönster för upprepningsfält
Med upprepningsfält kan användare lägga till flera rader med fält. De är oumbärliga för listor, rutnät, tidslinjer och komponenter med ett varierande antal objekt.
Grundläggande upprepningsfält med begränsningar
En funktionslista med 1 till 6 objekt:
{
"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>
Anpassade radetiketter
Som standard visas en generell etikett för minimerade rader i upprepningsfält. Använd textMinimized för att visa ett fältvärde i stället:
{
"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 rad fälls ihop visas personens namn i stället för “Row 1”. fallback används när namnfältet är tomt. Du kan också lägga till strängarna prefix och suffix.
Villkor i upprepningsfält
Fält i ett upprepningsfält kan referera till andra fält på samma rad med sina vanliga id (inget prefix behövs):
{
"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 }]]
}
]
}
Referera till överordnade fält inifrån ett upprepningsfält
När ett villkor inuti ett upprepningsfält behöver kontrollera ett fält utanför upprepningsfältet lägger du till "context": "main":
{
"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"
}]]
}
]
}
Utan "context": "main" skulle villkoret leta efter ett fält av typen showDescriptions inuti raden i upprepningsfältet. Med det kontrollerar villkoret växeln på rotnivån.
Flikar i upprepningsfält
Flikar är inte tillgängliga i upprepningsfält: ett tabs-fält i en rad i ett upprepningsfält visar ett meddelande i redigeraren i stället för sina fält, och tillägget PHPStan rapporterar det. Håll i stället radens fält platta. För långa rader gör en anpassad radetikett (textMinimized) det lättare att läsa hopfällda rader, och villkor i raden kan dölja fält som bara behövs i vissa rader, vilket visas i mönstren ovan.
Ange "minimized": true för ett upprepningsfält så att befintliga rader är hopfällda från början. Nya rader öppnas direkt. Undantag som fällts ut sparas i den här webbläsaren mellan omladdningar av redigeraren; det är en redigeringsinställning, inte sparat inläggsinnehåll.
Upprepningsfält utan minimized behåller sitt befintliga beteende där de är utfällda som standard.
Mediamönster
Enstaka bild med reservvärde
{
"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; ?>
Standardvärdet för returnFormat är "object", som tillhandahåller ID, title, alt, caption, description, href, url och sizes. sizes innehåller URL för alla registrerade bildstorlekar (sizes['large']) tillsammans med deras mått (sizes['large-width'], sizes['large-height']). Se Renderingsattribut för hela listan.
Galleri med begränsning
{
"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; ?>
Bild som kan inaktiveras med en växel
Egenskapen switch lägger till en ögonikon som låter användare inaktivera fältet utan att ta bort värdet:
{
"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; ?>
Användaren kan stänga av logotypen utan att ta bort den uppladdade filen. När den aktiveras igen visas samma fil.
Variationer av returformat
Styr vad filfältet returnerar:
// 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"
Använd "id" när du själv behöver anropa wp_get_attachment_image(). Använd "url" för enkla bakgrundsbilder. Använd "object" (standardvärdet) för allt annat.
Med "returnFormat": "id" skickas en importerad strängreferens, till exempel "buckshair-home",
vidare oförändrad. Redigeraren visar ett reservkort utan miniatyrbild,
även i rader i upprepningsfält. Att öppna eller spara sidan omvandlar inte en skalär
referens till en array. Blandade listor med bilage-ID:n och strängreferenser
fungerar också; endast positiva bilage-ID:n slås upp i mediebiblioteket.
Blockstudio löser inte anpassade strängreferenser till bilagor. Lös dem själv i ditt renderingsfilter eller din mall när du använder portabla namn mellan webbplatser. Om du väljer en ersättning i mediebiblioteket lagras dess bilage-ID som vanligt.
Dynamiska alternativ
Hämta från inlägg
Ett urvalsfält som listar alla publicerade sidor:
{
"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
}
}
}
Fältet fylls automatiskt med sidtitlar som etiketter och inläggs-ID:n som värden. Använd returnFormat i konfigurationen för automatisk ifyllning för att anpassa mappningen:
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"returnFormat": { "value": "ID", "label": "post_title" }
}
Hämta från taxonomitermer
{
"id": "category",
"type": "select",
"label": "Category",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "terms",
"arguments": {
"taxonomy": "category",
"hide_empty": true
}
}
}
Hämta från en PHP-funktion
{
"id": "postType",
"type": "select",
"label": "Post Type",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": { "public": true }
}
}
Statiska alternativ med tillagda automatiskt ifyllda alternativ
Kombinera hårdkodade och dynamiska alternativ. Använd position för att styra var de automatiskt ifyllda alternativen visas:
{
"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 statiska alternativen visas först, följda av sidorna som hämtas dynamiskt.
Lagra data för sökningar
Som standard lagras fältvärden i blockattribut inuti post_content. De går inte att söka med WP_Query. Använd lagring när du behöver filtrera eller sortera inlägg efter ett fältvärde.
Inläggsmetadata för sökbara fält
{
"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 söka efter utvalda inlägg:
$featured = new WP_Query( array(
'meta_query' => array(
array(
'key' => 'is_featured',
'value' => '1',
),
),
'orderby' => 'meta_value_num',
'meta_key' => 'priority_score',
'order' => 'DESC',
) );
Metanycklarna registreras automatiskt med show_in_rest, så de är också tillgängliga i REST API.
Dubbellagring
Lagra både i blockattribut och inläggsmetadata. Blockattributet gör värdet tillgängligt i mallar via $a, medan inläggsmetadata gör det sökbart:
{
"id": "eventDate",
"type": "date",
"label": "Event Date",
"storage": {
"type": ["block", "postMeta"],
"postMetaKey": "event_date"
}
}
Alternativlagring för globala värden
Använd alternativlagring för webbplatsomfattande inställningar som ska vara desamma överallt:
{
"id": "companyName",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
}
Värdet lagras i wp_options och är tillgängligt överallt med get_option('site_company_name'). När användaren redigerar det här fältet i en blockinstans uppdateras värdet globalt.
Återanvändbara fältdefinitioner
När flera block delar samma fältstruktur definierar du den en gång som ett anpassat fält och refererar till den överallt.
Skapa ett anpassat fält
Skapa ett field.json i temats katalog blockstudio/fields/:
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" }
]}
]
}
Använda det anpassade fältet
Referera till det i valfritt block med "type": "custom/cta":
{
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "type": "custom/cta" }
]
}
}
CTA-fälten bäddas in i blocket. Kom åt dem direkt: $a['label'], $a['url'], $a['style'].
Anpassade fält med prefix via idStructure
När samma anpassade fält används flera gånger lägger du till idStructure för att ge ID:na prefix:
{
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{ "type": "custom/cta", "idStructure": "secondary_{id}" }
]
}
}
Det första CTA-fältets ID:n blir primary_label, primary_url, primary_style. Det andra blir secondary_label och så vidare.
Åsidosätta standardvärden
Anpassa specifika fält när du refererar till ett anpassat fält:
{
"type": "custom/cta",
"idStructure": "hero_{id}",
"overrides": {
"label": { "default": "Get Started", "label": "CTA Label" },
"style": { "default": "primary" }
}
}
Åsidosättningarna slås samman med den ursprungliga definitionen. Du kan ändra standardvärden, etiketter, villkor eller andra egenskaper.
Mönster för rendering
Kontrollera tomma värden
De flesta fälttyper returnerar false när de är tomma. Kontrollera alltid värdet före rendering:
<?php if ( $a['title'] ) : ?>
<h2><?php echo esc_html( $a['title'] ); ?></h2>
<?php endif; ?>
För tal är 0 ett giltigt värde. Använd strikt jämförelse om du behöver skilja mellan “tomt” och “noll”:
<?php if ( $a['count'] !== 0 || $a['count'] !== false ) : ?>
<span><?php echo esc_html( $a['count'] ); ?></span>
<?php endif; ?>
Urval med returnFormat: both
När du behöver både värdet (för logik) och etiketten (för visning):
{
"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; ?>
Dataattribut från attributfältet
Fälttypen attributes låter användare lägga till anpassade dataattribut:
{
"id": "dataAttrs",
"type": "attributes",
"label": "Data Attributes",
"link": true,
"media": true
}
<div useBlockProps <?php bs_render_data_attributes( $a['dataAttrs'] ); ?>>
Content here.
</div>
Variabler för CSS från fältvärden
Generera anpassade egenskaper för CSS från valda fält:
{
"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>
Detta skriver ut style="--text-color: #333; --font-size: 1rem;" (fält-ID:n konverteras till kebab-case). Använd variablerna i din CSS:
p {
color: var(--text-color);
font-size: var(--font-size);
}
Nästa steg
- Registrera attribut: egenskaperna
id,type,label,default,help,positionochconditions. - Referens för fälttyper: automatiskt genererad referens med alla egenskaper för varje fälttyp.
- Villkorslogik: operatorer, globala villkor, anpassade villkorsfilter och upprepningsfältets kontext.
- Fylla i alternativ: lägena query, funktion, anpassat och fetch för dynamiska urvalsfält.
- Anpassade fält:
field.json, upptäcktssökvägar, filtretblockstudio/fieldsoch avancerade mönster föridStructure. - Rendering:
$a,$b,$c, tomma värden och hjälpfunktioner.