Ehdollinen logiikka
Kenttiä voidaan näyttää tai piilottaa ehtojen perusteella.
Operaattorit
Käytettävissä on 8 eri operaattoria:
| Operaattori | Kuvaus |
|---|---|
== |
Arvot ovat samat |
!= |
Arvot eivät ole samat |
includes |
Arvo sisältyy viitearvoon |
!includes |
Arvo ei sisälly viitearvoon |
empty |
Arvo on tyhjä |
!empty |
Arvo ei ole tyhjä |
< |
Arvo on pienempi kuin viitearvo |
> |
Arvo on suurempi kuin viitearvo |
<= |
Arvo on pienempi tai yhtä suuri kuin viitearvo |
>= |
Arvo on suurempi tai yhtä suuri kuin viitearvo |
Globaalit ehdot
Oletuksena Blockstudio sisältää 4 globaalia ehtoa: sisältötyyppi, sisältötunnus, käyttäjärooli ja käyttäjätunnus.
{
"$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"
}
]
]
}
]
}
}
Yllä olevassa esimerkissä tekstimäärite näkyy editorissa vain, jos sisältötunnus on 1386 JA sisältötyyppi on post.
Huomaa, että tyyppiavaimissa käytetään camelCase-käytäntöä: postType, postId, userRole, userId.
TAI-ehdot
Luo tai-ehtoja siirtämällä kukin ehtoryhmä omaan taulukkoonsa:
{
"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"
}
]
]
}
]
}
}
Tekstimäärite näkyy, jos (sisältötunnus on 1386 JA sisältötyyppi on post) TAI (sisältötyyppi on jobs).
Mukautetut ehdot
Mukautettuja ehtoja voi lisätä suodattimella blockstudio/blocks/conditions.
Suodatin suoritetaan kohteessa PHP editorin latautuessa, ja se palauttaa yhden arvon kutakin ehtotyyppiä kohti. Ehdot arvioidaan editorissa, joka vertaa tätä arvoa ehdon value-arvoon operaattorin avulla.
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;
});
Palauta jokaiselle tilalle muu kuin tyhjä merkkijono. Ehtotyyppi, jonka arvo on tyhjä tai puuttuu, ohitetaan, joten kenttä jää näkyviin.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Lohkoehdot
Voit määrittää ehtoja, jotka riippuvat muista määritteistä. Aseta type-avaimen sijaan sen määritteen id, jonka arvoa haluat tarkistaa:
{
"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
}
]
]
}
]
}
}
Voit yhdistää globaaleja ehtoja lohkoehtoihin tarpeen mukaan.
Toistimen konteksti
Oletuksena toistimien sisällä olevien määritteiden ehdot riippuvat parhaillaan toistettavan elementin määritteistä.
{
"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
}
]
]
}
]
}
]
}
}
Koska määritteiden tunnukset rajoittuvat nykyiseen toistinelementtiin, toistimen sisällä oleva tekstimäärite näkyy vain, jos toistimen sisäinen kytkin on asetettu arvoon true.
Jos haluat tarkistaa toistimen ulkopuolisen kytkimen arvon, lisää ehtoosi "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"
}
]
]
}
]
}
]
}
}