Умовна логіка
Поля можна показувати або приховувати залежно від умов.
Оператори
Можна використовувати 8 різних операторів:
| Оператор | Опис |
|---|---|
== |
Значення рівні |
!= |
Значення не рівні |
includes |
Значення входить до еталонного значення |
!includes |
Значення не входить до еталонного значення |
empty |
Значення порожнє |
!empty |
Значення не порожнє |
< |
Значення менше за еталонне значення |
> |
Значення більше за еталонне значення |
<= |
Значення менше або дорівнює еталонному значенню |
>= |
Значення більше або дорівнює еталонному значенню |
Глобальні умови
За замовчуванням Blockstudio має 4 глобальні умови: тип запису, ID запису, роль користувача та ID користувача.
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/native",
"title": "Native Block",
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "postId",
"operator": "==",
"value": "1386"
},
{
"type": "postType",
"operator": "==",
"value": "post"
}
]
]
}
]
}
}
У наведеному вище прикладі атрибут text відображатиметься в редакторі, лише якщо ID запису — 1386 І тип запису — post.
Зверніть увагу, що для ключів типів використовується домовленість camelCase: postType, postId, userRole, userId.
Умови АБО
Щоб створити умови або, перемістіть кожну групу умов у власний масив:
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "postId",
"operator": "==",
"value": "1386"
},
{
"type": "postType",
"operator": "==",
"value": "post"
}
],
[
{
"type": "postType",
"operator": "==",
"value": "jobs"
}
]
]
}
]
}
}
Текстовий атрибут відображатиметься, якщо (ID запису — 1386 І тип запису — post) АБО (тип запису — jobs).
Користувацькі умови
Власні умови можна додати за допомогою фільтра blockstudio/blocks/conditions.
Фільтр виконується в PHP під час завантаження редактора й повертає одне значення для кожного типу умови. Умови перевіряються в редакторі, який порівнює це значення зі значенням value умови за допомогою оператора.
add_filter('blockstudio/blocks/conditions', function($conditions) {
// Check if the current user purchased the product.
$conditions['purchasedProduct'] = user_has_purchased(123) ? 'yes' : 'no';
return $conditions;
});
Поверніть непорожній рядок для кожного стану. Тип умови з порожнім або відсутнім значенням пропускається, тож поле залишатиметься видимим.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Умови блоку
Можна задати умови, що залежать від інших атрибутів. Замість ключа type використовуйте id атрибута, який потрібно перевірити:
{
"blockstudio": {
"attributes": [
{
"type": "toggle",
"id": "copyButton",
"label": "Copy Button"
},
{
"type": "text",
"id": "copyButtonText",
"label": "Copy Button Text",
"default": "Copy",
"conditions": [
[
{
"id": "copyButton",
"operator": "==",
"value": true
}
]
]
}
]
}
}
За потреби можна поєднувати глобальні умови з умовами блоку.
Контекст повторювача
За замовчуванням умови для атрибутів усередині повторювачів залежать від атрибутів поточного повторюваного елемента.
{
"blockstudio": {
"attributes": [
{
"type": "toggle",
"id": "toggle",
"label": "Toggle"
},
{
"type": "repeater",
"id": "repeater",
"label": "Repeater",
"attributes": [
{
"type": "toggle",
"id": "toggle",
"label": "Toggle"
},
{
"type": "text",
"id": "text",
"label": "Text",
"conditions": [
[
{
"id": "toggle",
"operator": "==",
"value": true
}
]
]
}
]
}
]
}
}
Оскільки ID атрибутів обмежені поточним елементом повторювача, текстовий атрибут усередині повторювача відображатиметься, лише якщо перемикач усередині повторювача встановлено в true.
Щоб перевірити перемикач поза повторювачем, додайте "context": "main" до умови:
{
"blockstudio": {
"attributes": [
{
"type": "toggle",
"id": "toggle",
"label": "Toggle"
},
{
"type": "repeater",
"id": "repeater",
"label": "Repeater",
"attributes": [
{
"type": "text",
"id": "text",
"label": "Text",
"conditions": [
[
{
"id": "toggle",
"operator": "==",
"value": true,
"context": "main"
}
]
]
}
]
}
]
}
}