Voorwaardelijke logica
Velden kunnen worden getoond of verborgen op basis van voorwaarden.
Operatoren
Er zijn 8 verschillende operatoren die je kunt gebruiken:
| Operator | Beschrijving |
|---|---|
== |
Waarden zijn gelijk |
!= |
Waarden zijn niet gelijk |
includes |
Waarde is opgenomen in de referentiewaarde |
!includes |
Waarde is niet opgenomen in de referentiewaarde |
empty |
Waarde is leeg |
!empty |
Waarde is niet leeg |
< |
Waarde is kleiner dan de referentiewaarde |
> |
Waarde is groter dan de referentiewaarde |
<= |
Waarde is kleiner dan of gelijk aan de referentiewaarde |
>= |
Waarde is groter dan of gelijk aan de referentiewaarde |
Globale voorwaarden
Standaard heeft Blockstudio 4 globale voorwaarden: berichttype, bericht-ID, gebruikersrol en gebruikers-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"
}
]
]
}
]
}
}
In het bovenstaande voorbeeld wordt het tekstkenmerk alleen in de editor weergegeven als het bericht-ID 1386 is EN het berichttype post is.
Let op: de camelCase-conventie wordt gebruikt voor de type keys: postType, postId, userRole, userId.
OF-voorwaarden
Verplaats elke voorwaardengroep naar een eigen array om of-voorwaarden te maken:
{
"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"
}
]
]
}
]
}
}
Het tekstkenmerk wordt weergegeven als (bericht-ID 1386 is EN berichttype post is) OF (berichttype jobs is).
Aangepaste voorwaarden
Aangepaste voorwaarden kunnen worden toegevoegd met het filter blockstudio/blocks/conditions.
Het filter wordt uitgevoerd in PHP wanneer de editor wordt geladen en retourneert één waarde per voorwaardetype. Voorwaarden worden geëvalueerd in de editor, die die waarde vergelijkt met de value van de voorwaarde met behulp van de operator.
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;
});
Retourneer voor elke status een niet-lege tekenreeks. Een voorwaardetype waarvan de waarde leeg is of ontbreekt, wordt overgeslagen, waardoor het veld zichtbaar blijft.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Blokvoorwaarden
Je kunt voorwaarden instellen die afhangen van andere kenmerken. Gebruik in plaats van een type-key de id van het kenmerk waarmee je wilt vergelijken:
{
"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
}
]
]
}
]
}
}
Je kunt globale voorwaarden naar behoefte combineren met blokvoorwaarden.
Repeatercontext
Standaard zijn voorwaarden voor kenmerken binnen repeaters afhankelijk van de kenmerken van het momenteel herhaalde element.
{
"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
}
]
]
}
]
}
]
}
}
Omdat kenmerk-ID’s binnen het huidige repeater-element zijn afgebakend, wordt het tekstkenmerk in de repeater alleen weergegeven als de schakelaar in de repeater op true staat.
Voeg "context": "main" toe aan de voorwaarde om te controleren op de schakelaar buiten de repeater:
{
"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"
}
]
]
}
]
}
]
}
}