Условна логика
Полетата могат да се показват или скриват в зависимост от условията.
Оператори
Могат да се използват 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"
}
]
]
}
]
}
}
Атрибутът text ще се показва, ако (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-тата на атрибутите са ограничени до текущия елемент на повторителя, атрибутът text в повторителя ще се показва само ако превключвателят вътре в повторителя е зададен на 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"
}
]
]
}
]
}
]
}
}