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