Lauku rakstu krājums
Blockstudio lauku sistēma pati par sevi ir vienkārša: pievienojiet lauku pie blockstudio.attributes un piekļūstiet tam veidnē, izmantojot $a. Taču reālos blokos reti ir tikai viens lauks. Tajos ir saistītu iestatījumu grupas, lauki, kas tiek parādīti vai paslēpti atkarībā no citiem laukiem, atkārtotāji ar sarežģītu rindu struktūru un dati, kuriem jāvar piekļūt vaicājumos ārpus bloku redaktora.
Šajā rokasgrāmatā apkopoti praktiski piemēri biežāk sastopamiem lauku lietojuma modeļiem. Katrā piemērā parādīta block.json konfigurācija un atbilstošais veidnes kods. Kopējiet tos tieši savos blokos un pielāgojiet pēc vajadzības.
Nosacījumu lauki
Visbiežāk sastopamais lietojuma modelis: lauku parādīšana vai paslēpšana atkarībā no cita lauka vērtības. Tādējādi redaktors ir pārskatāmāks, jo tiek rādītas tikai atbilstošās opcijas.
Pārslēgs opciju parādīšanai
CTA bloks, kurā, ieslēdzot pogu, tiek parādīti papildu iestatījumi:
{
"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 }]]
}
]
}
}
Pogas teksta un saites lauki tiek parādīti tikai tad, kad pārslēgs ir ieslēgts. Veidnē pirms renderēšanas pārbaudiet pārslēga stāvokli:
<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>
Atlase lauku kopu pārslēgšanai
Hero bloks, kurā fona veids nosaka, kuri lauki tiek parādīti:
{
"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" }]]
}
]
}
}
Pārklājuma necaurspīdīguma lauks izmanto !=, lai tiktu parādīts visiem foniem, izņemot vienkrāsainu. Vienlaikus tiek rādīts tikai viens fona lauks. color lauks atgriež masīvu ar krāsas value, name un slug, tāpēc veidne nolasa ['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>
OR nosacījumi
Parādiet lauku, ja patiess ir kāds no vairākiem nosacījumiem. Katrs iekšējais masīvs ir AND grupa; ārējais masīvs tos apvieno ar OR:
{
"id": "caption",
"type": "text",
"label": "Caption",
"conditions": [
[{ "id": "bgType", "operator": "==", "value": "image" }],
[{ "id": "bgType", "operator": "==", "value": "video" }]
]
}
Tādējādi paraksta lauks tiek parādīts, ja bgType ir “image” OR “video”.
Ķēdēti nosacījumi
Vairāki nosacījumi vienā iekšējā masīvā izmanto AND loģiku:
{
"id": "altText",
"type": "text",
"label": "Alt Text",
"conditions": [[
{ "id": "bgType", "operator": "==", "value": "image" },
{ "id": "bgImage", "operator": "!empty" }
]]
}
Alternatīvā teksta lauks tiek parādīts tikai tad, ja bgType ir “image” AND ir atlasīts attēls.
Globālie nosacījumi
Parādiet laukus, pamatojoties uz ziņas veidu, ziņas ID vai lietotāja lomu, nevis citu lauku vērtībām:
{
"id": "seoTitle",
"type": "text",
"label": "SEO Title",
"conditions": [[{ "type": "postType", "operator": "==", "value": "page" }]]
}
Pieejamie globālo nosacījumu veidi: postType, postId, userRole, userId.
Sakārtoti iestatījumi
Blokiem kļūstot sarežģītākiem, lauku sakārtošana loģiskās grupās palīdz uzturēt inspektoru pārskatāmu.
Grupas vizuālai organizēšanai
Grupas inspektorā veido sakļaujamas sadaļas. Grupa bez nosaukuma (bez id) kalpo tikai vizuālai organizēšanai; tās laukiem piekļūst, izmantojot to ID bez prefiksa:
{
"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>
Laukiem piekļūst tieši: $a['title'], $a['style'], $a['accentColor']. Grupas ietekmē tikai inspektora izkārtojumu.
Grupas ar nosaukumu, izmantojot bs_get_group
Ja grupai ir id, tās bērnelementu lauku ID tiek pievienots prefikss. Izmantojiet bs_get_group(), lai to noņemtu:
{
"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 }
]
}
Bez palīgfunkcijas laukiem piekļūst šādi: $a['author_name'], $a['author_role'], $a['author_avatar']. Ar palīgfunkciju:
<?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>
Grupas ar nosaukumiem noder, ja vairākās grupās ir lauki ar vienādiem nosaukumiem (e.g., author_name un company_name) vai ja grupa kā vienots veselums jānodod daļējai veidnei.
Režģa izkārtojums grupās
Izmantojiet rekvizītu style, lai grupas bērnelementus izkārtotu līdzās:
{
"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 }
]
}
Abi mērvienību lauki inspektorā tiek parādīti līdzās, nevis viens zem otra. Tas labi noder izmēru pāriem, piemales un iekšējās atkāpes vērtībām, kā arī jebkuriem diviem konceptuāli saistītiem laukiem.
Cilnes galvenajām sadaļām
Ja blokam ir daudz iestatījumu, cilnes nodrošina pārskatāmāku izkārtojumu nekā gara grupu kopa:
{
"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" }
]
}
]
}
Katras cilnes laukiem var piekļūt kā augšējā līmeņa laukiem: $a['title'], $a['image'], $a['layout']. Cilnes ir tikai UI konteiners.
Atkārtotāju lietojuma modeļi
Atkārtotāji ļauj lietotājiem pievienot vairākas lauku rindas. Tie ir būtiski sarakstiem, režģiem, laika skalām un jebkuram komponentam ar mainīgu elementu skaitu.
Vienkāršs atkārtotājs ar ierobežojumiem
Funkciju saraksts ar 1 līdz 6 elementiem:
{
"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>
Pielāgotas rindu etiķetes
Pēc noklusējuma samazinātām atkārtotāja rindām ir vispārīga etiķete. Izmantojiet textMinimized, lai tās vietā parādītu lauka vērtību:
{
"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 }
]
}
Kad rinda ir sakļauta, tajā tiek rādīts personas vārds, nevis “Row 1”. Ja vārda lauks ir tukšs, tiek izmantots fallback. Varat arī pievienot virknes prefix un suffix.
Nosacījumi atkārtotājos
Atkārtotāja lauki var atsaukties uz citiem laukiem tajā pašā rindā, izmantojot to ID bez prefiksa id:
{
"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 }]]
}
]
}
Atsauce uz ārējiem laukiem no atkārtotāja
Ja nosacījumam atkārtotājā jāpārbauda lauks ārpus atkārtotāja, pievienojiet "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"
}]]
}
]
}
Bez "context": "main" nosacījums meklētu showDescriptions lauku atkārtotāja rindā. Ar to nosacījums pārbauda pārslēgu saknes līmenī.
Cilnes atkārtotājos
Cilnes atkārtotājos nav pieejamas: tabs lauks atkārtotāja rindā redaktora laukus vietā parāda paziņojumu, un PHPStan paplašinājums par to ziņo. Tā vietā ievietojiet rindas laukus plakanā struktūrā. Garām rindām pielāgota rindas etiķete (textMinimized) palīdz saglabāt lasāmību, kad rindas ir sakļautas; savukārt nosacījumi rindā var paslēpt laukus, kas nepieciešami tikai dažās rindās, kā parādīts iepriekšējos piemēros.
Iestatiet atkārtotājam "minimized": true, lai esošās rindas sākotnēji būtu sakļautas. Jaunas rindas tiek atvērtas uzreiz. Izvērstie izņēmumi tiek saglabāti šajā pārlūkprogrammā arī pēc redaktora atkārtotas ielādes; tā ir rediģēšanas preference, nevis saglabātais ziņas saturs.
Atkārtotājiem bez minimized tiek saglabāta līdzšinējā uzvedība, kurā rindas pēc noklusējuma ir izvērstas.
Multivides lietojuma modeļi
Viens attēls ar rezerves variantu
{
"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; ?>
Noklusējuma returnFormat ir "object", kas nodrošina ID, title, alt, caption, description, href, url un sizes. sizes satur katra reģistrētā attēla izmēra URL (sizes['large']) un tā izmērus (sizes['large-width'], sizes['large-height']). Pilnu sarakstu skatiet sadaļā Renderēšanas atribūti.
Galerija ar ierobežojumu
{
"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; ?>
Atspējojams attēls ar slēdzi
Rekvizīts switch pievieno acs ikonu, kas ļauj lietotājiem atspējot lauku, neizdzēšot tā vērtību:
{
"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; ?>
Lietotājs var izslēgt logotipu, neizdzēšot augšupielādēto failu. Ieslēdzot to atkal, tiek parādīts tas pats fails.
Atgriežamās vērtības formāta varianti
Norādiet, ko atgriež failu lauks:
// 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"
Izmantojiet "id", ja wp_get_attachment_image() jāizsauc pašam. Vienkāršiem fona attēliem izmantojiet "url". Visos citos gadījumos izmantojiet "object" (noklusējums).
Izmantojot "returnFormat": "id", importēta virknes atsauce, piemēram, "buckshair-home", tiek nodota tālāk bez izmaiņām. Redaktorā tiek rādīta rezerves kartīte bez sīktēla, arī atkārtotāju rindās. Lapas atvēršana vai saglabāšana nepārveido skalāru atsauci par masīvu. Darbojas arī jaukti saraksti ar pielikumu ID un virkņu atsaucēm; multivides bibliotēkā tiek meklēti tikai pozitīvi pielikumu ID.
Blockstudio nepiesaista pielikumiem pielāgotas virkņu atsauces. Izmantojot pārnesamus nosaukumus dažādās vietnēs, atrisiniet tās savā renderēšanas filtrā vai veidnē. Izvēloties aizstājēju multivides bibliotēkā, kā parasti tiek saglabāts tā pielikuma ID.
Dinamiskās opcijas
Aizpildīšana no ziņām
Atlases lauks, kurā uzskaitītas visas publicētās lapas:
{
"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
}
}
}
Lauks tiek automātiski aizpildīts ar lapu nosaukumiem kā etiķetēm un ziņu ID kā vērtībām. Izmantojiet returnFormat aizpildīšanas konfigurācijā, lai pielāgotu atbilstību:
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"returnFormat": { "value": "ID", "label": "post_title" }
}
Aizpildīšana no taksonomijas terminiem
{
"id": "category",
"type": "select",
"label": "Category",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "terms",
"arguments": {
"taxonomy": "category",
"hide_empty": true
}
}
}
Aizpildīšana no funkcijas PHP
{
"id": "postType",
"type": "select",
"label": "Post Type",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": { "public": true }
}
}
Statiskās opcijas ar pievienotām aizpildītām opcijām
Apvienojiet cieti kodētas opcijas ar dinamiskām opcijām. Izmantojiet position, lai noteiktu aizpildīto opciju atrašanās vietu:
{
"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"
}
}
Vispirms tiek parādītas statiskās opcijas, pēc tam dinamiski aizpildītās lapas.
Datu glabāšana vaicājumiem
Pēc noklusējuma lauku vērtības atrodas bloka atribūtos post_content. Tām nevar veikt vaicājumus, izmantojot WP_Query. Ja lauka vērtība jāizmanto ziņu filtrēšanai vai kārtošanai, izmantojiet krātuvi.
Ziņu metadati laukiem, ko var izmantot vaicājumos
{
"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"
}
}
Tagad varat veikt vaicājumu, lai atrastu izceltās ziņas:
$featured = new WP_Query( array(
'meta_query' => array(
array(
'key' => 'is_featured',
'value' => '1',
),
),
'orderby' => 'meta_value_num',
'meta_key' => 'priority_score',
'order' => 'DESC',
) );
Meta atslēgas tiek automātiski reģistrētas ar show_in_rest, tāpēc tās ir pieejamas arī REST API.
Datu glabāšana divās vietās
Glabājiet datus gan bloka atribūtos, gan ziņas metadatos. Bloka atribūts padara vērtību pieejamu veidnēs ar $a, bet ziņas metadati ļauj to izmantot vaicājumos:
{
"id": "eventDate",
"type": "date",
"label": "Event Date",
"storage": {
"type": ["block", "postMeta"],
"postMetaKey": "event_date"
}
}
Opciju krātuve vispārīgām vērtībām
Vietnes iestatījumiem, kuriem visur jābūt vienādiem, izmantojiet opciju krātuvi:
{
"id": "companyName",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
}
Vērtība tiek glabāta wp_options un tai var piekļūt jebkur, izmantojot get_option('site_company_name'). Kad lietotājs rediģē šo lauku jebkurā bloka instancē, vērtība tiek atjaunināta visā vietnē.
Atkārtoti izmantojamas lauku definīcijas
Ja vairākiem blokiem ir vienāda lauku struktūra, definējiet to vienreiz kā pielāgotu lauku un izmantojiet visur.
Pielāgota lauka izveide
Izveidojiet field.json sava dizaina blockstudio/fields/ direktorijā:
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" }
]}
]
}
Pielāgota lauka izmantošana
Atsaucieties uz to jebkurā blokā ar "type": "custom/cta":
{
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "type": "custom/cta" }
]
}
}
CTA lauki tiek ievietoti blokā. Piekļūstiet tiem tieši: $a['label'], $a['url'], $a['style'].
Prefiksēti pielāgotie lauki ar idStructure
Izmantojot vienu un to pašu pielāgoto lauku vairākas reizes, pievienojiet idStructure, lai lauku ID būtu ar prefiksu:
{
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{ "type": "custom/cta", "idStructure": "secondary_{id}" }
]
}
}
Pirmā CTA lauki kļūst par primary_label, primary_url, primary_style. Otrās CTA lauki kļūst par secondary_label utt.
Noklusējuma vērtību maiņa
Pielāgojiet konkrētus laukus, atsaucoties uz pielāgotu lauku:
{
"type": "custom/cta",
"idStructure": "hero_{id}",
"overrides": {
"label": { "default": "Get Started", "label": "CTA Label" },
"style": { "default": "primary" }
}
}
Izmaiņas tiek apvienotas ar sākotnējo definīciju. Varat mainīt noklusējuma vērtības, etiķetes, nosacījumus un citus rekvizītus.
Renderēšanas paraugi
Tukšu vērtību pārbaudes
Lielākā daļa lauku veidu, ja tie ir tukši, atgriež false. Vienmēr pārbaudiet vērtību pirms renderēšanas:
<?php if ( $a['title'] ) : ?>
<h2><?php echo esc_html( $a['title'] ); ?></h2>
<?php endif; ?>
Skaitļiem 0 ir derīga vērtība. Izmantojiet stingru salīdzinājumu, ja jāatšķir “tukša” vērtība no “nulles”:
<?php if ( $a['count'] !== 0 || $a['count'] !== false ) : ?>
<span><?php echo esc_html( $a['count'] ); ?></span>
<?php endif; ?>
Atlase ar returnFormat: both
Ja vajadzīga gan vērtība (loģikai), gan etiķete (attēlošanai):
{
"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; ?>
Datu atribūti no atribūtu lauka
Lauka veids attributes ļauj lietotājiem pievienot pielāgotus datu atribūtus:
{
"id": "dataAttrs",
"type": "attributes",
"label": "Data Attributes",
"link": true,
"media": true
}
<div useBlockProps <?php bs_render_data_attributes( $a['dataAttrs'] ); ?>>
Content here.
</div>
CSS mainīgie no lauku vērtībām
Ģenerējiet pielāgotus CSS rekvizītus no atlasītajiem laukiem:
{
"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>
Tiek izvadīts style="--text-color: #333; --font-size: 1rem;" (lauku ID tiek pārveidoti kebab-case formātā). Izmantojiet mainīgos savā CSS:
p {
color: var(--text-color);
font-size: var(--font-size);
}
Nākamie soļi
- Atribūtu reģistrēšana: rekvizīti
id,type,label,default,help,positionunconditions. - Lauku veidu uzziņu materiāls: automātiski ģenerēta uzziņu informācija par visiem katra lauka veida rekvizītiem.
- Nosacījumu loģika: operatori, globālie nosacījumi, pielāgotie nosacījumu filtri un atkārtotāja konteksts.
- Opciju aizpildīšana: vaicājuma, funkcijas, pielāgotais un ielādes režīms dinamiskajiem opciju laukiem.
- Pielāgotie lauki:
field.json, atklāšanas ceļi, filtrsblockstudio/fieldsun uzlabotiidStructurelietojuma modeļi. - Renderēšana:
$a,$b,$c, tukšas vērtības un palīgfunkcijas.