Betinget logik
Felter kan vises eller skjules afhængigt af betingelser.
Operatorer
Der er 8 forskellige operatorer, du kan bruge:
| Operator | Beskrivelse |
|---|---|
== |
Værdierne er ens |
!= |
Værdierne er ikke ens |
includes |
Værdien er inkluderet i referenceværdien |
!includes |
Værdien er ikke inkluderet i referenceværdien |
empty |
Værdien er tom |
!empty |
Værdien er ikke tom |
< |
Værdien er mindre end referenceværdien |
> |
Værdien er større end referenceværdien |
<= |
Værdien er mindre end eller lig med referenceværdien |
>= |
Værdien er større end eller lig med referenceværdien |
Globale betingelser
Som standard leveres Blockstudio med 4 globale betingelser: indholdstype, indlægs-ID, brugerrolle og bruger-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"
}
]
]
}
]
}
}
I eksemplet ovenfor vises tekstattributten kun i editoren, hvis indlægs-ID’et er 1386 OG indholdstypen er post.
Bemærk, at konventionen camelCase bruges til typenøglerne: postType, postId, userRole, userId.
ELLER-betingelser
Hvis du vil oprette eller-betingelser, skal du flytte hver betingelsesgruppe til sit eget array:
{
"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"
}
]
]
}
]
}
}
Tekstattributten vises, hvis (indlægs-ID’et er 1386 OG indholdstypen er post) ELLER (indholdstypen er jobs).
Brugerdefinerede betingelser
Brugerdefinerede betingelser kan tilføjes med filteret blockstudio/blocks/conditions.
Filteret køres i PHP, når editoren indlæses, og returnerer én værdi pr.
betingelsestype. Betingelser evalueres i editoren, som sammenligner værdien med
value for betingelsen ved hjælp af operatoren.
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;
});
Returnér en ikke-tom streng for hver tilstand. En betingelsestype, hvis værdi er tom eller mangler, springes over, så feltet forbliver synligt.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Blokbetingelser
Du kan angive betingelser, der afhænger af andre attributter. I stedet for at angive en type-nøgle skal du bruge id‘et på den attribut, du vil kontrollere:
{
"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
}
]
]
}
]
}
}
Du kan kombinere globale betingelser med blokbetingelser efter behov.
Repeater-kontekst
Som standard afhænger betingelser for attributter i repeatere af attributterne for det aktuelt gentagne 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
}
]
]
}
]
}
]
}
}
Da attribut-ID’er er afgrænset til det aktuelle repeater-element, vises tekstattributten i repeateren kun, hvis til/fra-knappen i repeateren er slået til.
Hvis du vil kontrollere til/fra-knappen uden for repeateren, skal du føje "context": "main" til betingelsen:
{
"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"
}
]
]
}
]
}
]
}
}