Mezőminták receptgyűjteménye
Blockstudio mezőrendszere önmagában egyszerű: adjon hozzá egy mezőt a blockstudio.attributes elemhez, majd érje el a sablonban a $a segítségével. A valódi blokkokban azonban ritkán van csak egy mező. Kapcsolódó beállítások csoportjai, más mezők értékei alapján megjelenő vagy elrejtett mezők, összetett sorstruktúrájú ismétlők, valamint olyan adatok is előfordulnak, amelyeket a blokkszerkesztőn kívülről kell lekérdezni.
Ez az útmutató gyakorlati recepteket gyűjt össze a gyakori mezőmintákhoz. Minden recept bemutatja a block.json konfigurációját és a hozzá tartozó sablonkódot. Másolja be őket közvetlenül a blokkjaiba, majd igény szerint alakítsa át.
Feltételes mezők
A leggyakoribb minta: mezők megjelenítése vagy elrejtése egy másik mező értéke alapján. Így a szerkesztő áttekinthető marad, mert csak a releváns beállítások jelennek meg.
Beállítások megjelenítése kapcsolóval
CTA-blokk, amelyben további beállítások jelennek meg, ha a felhasználó engedélyez egy gombot:
{
"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 }]]
}
]
}
}
A gomb szövegét és hivatkozását megadó mezők csak akkor jelennek meg, ha a kapcsoló be van kapcsolva. A sablonban megjelenítés előtt ellenőrizze a kapcsoló állapotát:
<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>
Mezőkészletek váltása választóval
Hero blokk, amelyben a háttér típusa határozza meg a megjelenő mezőket:
{
"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" }]]
}
]
}
}
Az átfedés átlátszatlanságát megadó mező a != segítségével minden háttértípusnál megjelenik, kivéve az egyszínűt. Egyszerre csak egy háttérmező látható. Egy color mező egy tömböt ad vissza, amely a szín value, name és slug értékeit tartalmazza, ezért a sablonban a ['value'] olvasható ki:
<?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>
VAGY feltételek
Mező megjelenítése, ha több feltétel közül bármelyik igaz. Minden belső tömb egy ÉS-csoport; a külső tömb VAGY-kapcsolattal fűzi össze őket:
{
"id": "caption",
"type": "text",
"label": "Caption",
"conditions": [
[{ "id": "bgType", "operator": "==", "value": "image" }],
[{ "id": "bgType", "operator": "==", "value": "video" }]
]
}
Ezzel a feliratmező akkor jelenik meg, ha a bgType értéke “image” VAGY “video”.
Összefűzött feltételek
Ugyanabban a belső tömbben több feltétel ÉS-logikát használ:
{
"id": "altText",
"type": "text",
"label": "Alt Text",
"conditions": [[
{ "id": "bgType", "operator": "==", "value": "image" },
{ "id": "bgImage", "operator": "!empty" }
]]
}
Az alternatív szöveg mező csak akkor jelenik meg, ha a bgType értéke “image” ÉS ki van választva egy kép.
Globális feltételek
Mezők megjelenítése bejegyzéstípus, bejegyzésazonosító vagy felhasználói szerepkör alapján, más mezők értékei helyett:
{
"id": "seoTitle",
"type": "text",
"label": "SEO Title",
"conditions": [[{ "type": "postType", "operator": "==", "value": "page" }]]
}
Elérhető globális feltételtípusok: postType, postId, userRole, userId.
Rendszerezett beállítások
Ahogy a blokkok összetettebbé válnak, a mezők logikus csoportokba rendezése áttekinthetőbbé teszi a vizsgálót.
Csoportok a vizuális elrendezéshez
A csoportok összecsukható szakaszokat hoznak létre a vizsgálóban. A névtelen csoport (id nélkül) csak vizuális célokat szolgál; mezői a saját azonosítójukon érhetők el:
{
"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>
A mezők közvetlenül érhetők el: $a['title'], $a['style'], $a['accentColor']. A csoportok csak a vizsgáló elrendezését módosítják.
Elnevezett csoportok a bs_get_group segítségével
Ha egy csoportnak van id értéke, a gyermekmezők azonosítója elé előtag kerül. Az előtag eltávolításához használja a bs_get_group() elemet:
{
"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 }
]
}
A segédfüggvény nélkül a mezők így érhetők el: $a['author_name'], $a['author_role'], $a['author_avatar']. A segédfüggvénnyel:
<?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>
Az elnevezett csoportok akkor hasznosak, ha több csoportban is azonos mezőnevek szerepelnek (e.g., author_name és company_name), vagy ha a csoportot egységként szeretné átadni egy részleges sablonnak.
Rácselrendezés csoportokban
A csoport gyermekelemeinek egymás mellé rendezéséhez használja a style tulajdonságot:
{
"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 }
]
}
A két mértékegységmező egymás mellett jelenik meg a vizsgálóban, nem egymás alatt. Ez jól használható méretpároknál, margó és belső térköz értékeknél, illetve bármely két fogalmilag összetartozó mezőnél.
Lapok a főbb szakaszokhoz
Ha egy blokk sok beállítással rendelkezik, a lapok áttekinthetőbbé teszik az elrendezést, mint a csoportok hosszú listája:
{
"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" }
]
}
]
}
Az egyes fülek mezői úgy érhetők el, mint a legfelső szintű mezők: $a['title'], $a['image'], $a['layout']. A fülek csupán UI konténerek.
Ismétlőminták
Az ismétlők lehetővé teszik, hogy a felhasználók több mezős sort adjanak hozzá. Nélkülözhetetlenek listákhoz, rácsokhoz, idővonalakhoz és minden olyan összetevőhöz, amely változó számú elemet tartalmaz.
Egyszerű ismétlő korlátozásokkal
Funkciólista 1–6 elemmel:
{
"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>
Egyéni sorcímkék
Alapértelmezés szerint az összecsukott ismétlősorok általános címkét jelenítenek meg. A textMinimized használatával helyette egy mező értékét jelenítheti meg:
{
"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 }
]
}
Összecsukott sor esetén a “Row 1” helyett a személy neve jelenik meg. Ha a névmező üres, a rendszer a fallback értéket használja. A prefix és suffix karakterláncokat is hozzáadhatja.
Feltételek az ismétlőkön belül
Az ismétlőn belüli mezők az azonos sor más mezőire azok előtag nélküli id értékével hivatkozhatnak (nincs szükség előtagra):
{
"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 }]]
}
]
}
Külső mezőkre hivatkozás ismétlőn belül
Ha egy ismétlőn belüli feltételnek az ismétlőn kívüli mezőt kell ellenőriznie, adja hozzá a "context": "main" elemet:
{
"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"
}]]
}
]
}
A "context": "main" nélkül a feltétel az ismétlősoron belül keresne egy showDescriptions mezőt. Ezzel az elem hozzáadásával a feltétel a gyökérszintű kapcsolót ellenőrzi.
Fülek az ismétlőkben
Az ismétlőkben nem használhatók fülek: az ismétlősorban lévő tabs mező a mezők helyett egy értesítést jelenít meg a szerkesztőben, és a PHPStan bővítmény is jelzi ezt. A sor mezőit tartsa inkább egymás mellett. Hosszú soroknál egy egyéni sorcímke (textMinimized) olvashatóvá teszi az összecsukott sorokat, a soron belüli feltételekkel pedig elrejtheti azokat a mezőket, amelyekre csak egyes sorokban van szükség, a fenti minták szerint.
Állítsa be az "minimized": true értéket az ismétlőn, hogy a meglévő sorok összecsukva jelenjenek meg. Az újonnan hozzáadott sorok azonnal megnyílnak. A kibontott kivételeket a rendszer szerkesztő-újratöltések között is megjegyzi ebben a böngészőben; ez szerkesztési beállítás, nem mentett bejegyzéstartalom.
Az minimized nélküli ismétlők továbbra is alapértelmezés szerint kibontva jelennek meg.
Médiaminták
Egyetlen kép tartalékértékkel
{
"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; ?>
Az alapértelmezett returnFormat értéke "object", amely a következőket biztosítja: ID, title, alt, caption, description, href, url és sizes. Az sizes tartalmazza az összes regisztrált képméret URL értékét (sizes['large']), a méreteikkel együtt (sizes['large-width'], sizes['large-height']). A teljes listát lásd a Megjelenítési attribútumok című részben.
Galéria korláttal
{
"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; ?>
Letiltható kép kapcsolóval
A switch tulajdonság egy szem ikont ad hozzá, amellyel a felhasználók az érték törlése nélkül letilthatják a mezőt:
{
"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; ?>
A felhasználó a feltöltött fájl eltávolítása nélkül kikapcsolhatja a logót. Visszakapcsoláskor ugyanaz a fájl jelenik meg.
Visszatérési formátumok változatai
Adja meg, mit adjon vissza a fájlmező:
// 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"
A "id" értéket használja, ha saját magának kell meghívnia a wp_get_attachment_image() elemet. Egyszerű háttérképekhez használja a "url" értéket. Minden más esetben a "object" értéket használja (ez az alapértelmezett).
Az "returnFormat": "id" használatakor az importált karakterlánc-hivatkozások, például az "buckshair-home", változatlanul kerülnek átadásra. A szerkesztő bélyegkép nélküli tartalék kártyát jelenít meg, az ismétlősorokban is. Az oldal megnyitása vagy mentése nem alakítja tömbbé a skaláris hivatkozást. A mellékletazonosítók és karakterlánc-hivatkozások vegyes listái is működnek; a rendszer csak a pozitív mellékletazonosítókat keresi meg a médiatárban.
Az Blockstudio nem oldja fel a saját karakterlánc-hivatkozásokat mellékletekre. Ha webhelyek között hordozható neveket használ, oldja fel ezeket a saját renderelési szűrőjében vagy sablonjában. Ha a médiatárban választ helyettesítőt, a rendszer a szokásos módon annak mellékletazonosítóját tárolja.
Dinamikus beállítások
Feltöltés bejegyzésekből
Választómező az összes közzétett oldal listájával:
{
"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
}
}
}
A mező automatikusan feltölti a címkéket az oldalcímekkel, az értékeket pedig a bejegyzésazonosítókkal. A leképezés testreszabásához használja a returnFormat elemet a populate konfigurációban:
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"returnFormat": { "value": "ID", "label": "post_title" }
}
Feltöltés taxonómiai kifejezésekből
{
"id": "category",
"type": "select",
"label": "Category",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "terms",
"arguments": {
"taxonomy": "category",
"hide_empty": true
}
}
}
Feltöltés PHP függvényből
{
"id": "postType",
"type": "select",
"label": "Post Type",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": { "public": true }
}
}
Statikus beállítások további feltöltött elemekkel
Statikus, rögzített beállítások dinamikusakkal való kombinálásához használja a position elemet a feltöltött beállítások helyének meghatározására:
{
"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"
}
}
Először a statikus beállítások, majd a dinamikusan feltöltött oldalak jelennek meg.
Adatok tárolása lekérdezésekhez
Alapértelmezés szerint a mezőértékek blokkattribútumokként vannak tárolva a post_content elemen belül. A WP_Query segítségével nem kérdezhetők le. Ha mezőérték alapján szeretné szűrni vagy rendezni a bejegyzéseket, használjon tárolást.
Bejegyzésmeta lekérdezhető mezőkhöz
{
"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"
}
}
Mostantól lekérdezheti a kiemelt bejegyzéseket:
$featured = new WP_Query( array(
'meta_query' => array(
array(
'key' => 'is_featured',
'value' => '1',
),
),
'orderby' => 'meta_value_num',
'meta_key' => 'priority_score',
'order' => 'DESC',
) );
A metakulcsokat a rendszer automatikusan regisztrálja a show_in_rest segítségével, ezért a API REST alatt is elérhetők.
Kettős tárolás
Tároljon adatokat egyszerre a blokkattribútumokban és a bejegyzésmetaadatok között. A blokkattribútum révén az érték a sablonokban a $a segítségével érhető el, a bejegyzésmeta pedig lekérdezhetővé teszi:
{
"id": "eventDate",
"type": "date",
"label": "Event Date",
"storage": {
"type": ["block", "postMeta"],
"postMetaKey": "event_date"
}
}
Beállítástárolás globális értékekhez
A webhely egészére érvényes beállításokhoz, amelyeknek mindenhol azonosnak kell lenniük, használja a beállítástárolást:
{
"id": "companyName",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
}
Az érték a wp_options helyre kerül, és bárhonnan elérhető a get_option('site_company_name') segítségével. Ha a felhasználó bármelyik blokkpéldányban szerkeszti ezt a mezőt, az érték globálisan frissül.
Újrafelhasználható meződefiníciók
Ha több blokk mezőstruktúrája azonos, definiálja egyszer egyéni mezőként, majd hivatkozzon rá mindenhol.
Egyéni mező létrehozása
Hozzon létre egy field.json elemet a témája blockstudio/fields/ könyvtárában:
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" }
]}
]
}
Egyéni mező használata
Hivatkozzon rá bármelyik blokkban a "type": "custom/cta" segítségével:
{
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "type": "custom/cta" }
]
}
}
A CTA mezői beágyazódnak a blokkba. Közvetlenül érhetők el: $a['label'], $a['url'], $a['style'].
Előtaggal ellátott egyéni mezők idStructure használatával
Ha többször használja ugyanazt az egyéni mezőt, adja hozzá a idStructure elemet az azonosítók előtaggal való ellátásához:
{
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{ "type": "custom/cta", "idStructure": "secondary_{id}" }
]
}
}
Az első CTA mezői a következőkké válnak: primary_label, primary_url, primary_style. A második mezői: secondary_label stb.
Alapértelmezések felülírása
Egyéni mezőre hivatkozáskor testre szabhatja az egyes mezőket:
{
"type": "custom/cta",
"idStructure": "hero_{id}",
"overrides": {
"label": { "default": "Get Started", "label": "CTA Label" },
"style": { "default": "primary" }
}
}
A felülírások az eredeti definícióra épülnek. Módosíthatja az alapértelmezett értékeket, címkéket, feltételeket vagy bármely más tulajdonságot.
Megjelenítési minták
Üres értékek ellenőrzése
A legtöbb mezőtípus üres állapotban false értéket ad vissza. Megjelenítés előtt mindig ellenőrizze az értéket:
<?php if ( $a['title'] ) : ?>
<h2><?php echo esc_html( $a['title'] ); ?></h2>
<?php endif; ?>
Számoknál a 0 érvényes érték. Használjon szigorú összehasonlítást, ha különbséget kell tennie az „üres” és a „nulla” között:
<?php if ( $a['count'] !== 0 || $a['count'] !== false ) : ?>
<span><?php echo esc_html( $a['count'] ); ?></span>
<?php endif; ?>
Választó returnFormat: both értékkel
Ha az értékre (logikához) és a címkére (megjelenítéshez) is szükség van:
{
"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; ?>
Adatattribútumok az attributes mezőből
Az attributes mezőtípus lehetővé teszi, hogy a felhasználók egyéni adatattribútumokat adjanak hozzá:
{
"id": "dataAttrs",
"type": "attributes",
"label": "Data Attributes",
"link": true,
"media": true
}
<div useBlockProps <?php bs_render_data_attributes( $a['dataAttrs'] ); ?>>
Content here.
</div>
CSS változók mezőértékekből
Hozzon létre egyéni CSS tulajdonságokat kiválasztott mezőkből:
{
"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>
Ez a következőt állítja elő: style="--text-color: #333; --font-size: 1rem;" (a mezőazonosítók kebab-case formátumra alakulnak). Használja a változókat a CSS elemben:
p {
color: var(--text-color);
font-size: var(--font-size);
}
Következő lépések
- Attribútumok regisztrálása: a
id,type,label,default,help,positionésconditionstulajdonságok. - Mezőtípusok referenciája: automatikusan generált referencia az egyes mezőtípusok valamennyi tulajdonságával.
- Feltételes logika: operátorok, globális feltételek, egyéni feltételszűrők és ismétlőkontextus.
- Beállítások feltöltése: lekérdezési, függvény-, egyéni és lekérési módok a dinamikus választómezőkhöz.
- Egyéni mezők:
field.json, felfedezési útvonalak, ablockstudio/fieldsszűrő és speciálisidStructureminták. - Megjelenítés:
$a,$b,$c, üres értékek és segédfüggvények.