Logika Kondisional
Kolom dapat ditampilkan atau disembunyikan bergantung pada kondisi.
Operator
Ada 8 operator berbeda yang dapat digunakan:
| Operator | Deskripsi |
|---|---|
== |
Nilai sama |
!= |
Nilai tidak sama |
includes |
Nilai termasuk dalam nilai referensi |
!includes |
Nilai tidak termasuk dalam nilai referensi |
empty |
Nilai kosong |
!empty |
Nilai tidak kosong |
< |
Nilai lebih kecil daripada nilai referensi |
> |
Nilai lebih besar daripada nilai referensi |
<= |
Nilai lebih kecil dari atau sama dengan nilai referensi |
>= |
Nilai lebih besar dari atau sama dengan nilai referensi |
Kondisi Global
Secara default, Blockstudio dilengkapi 4 kondisi global: jenis pos, ID pos, peran pengguna, dan ID pengguna.
{
"$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"
}
]
]
}
]
}
}
Dalam contoh di atas, atribut teks hanya akan ditampilkan di editor jika ID pos adalah 1386 DAN jenis pos adalah post.
Perhatikan bahwa konvensi camelCase digunakan untuk kunci jenis: postType, postId, userRole, userId.
Kondisi OR
Untuk membuat kondisi or, pindahkan setiap grup kondisi ke array-nya sendiri:
{
"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"
}
]
]
}
]
}
}
Atribut teks akan ditampilkan jika (ID pos adalah 1386 DAN jenis pos adalah post) OR (jenis pos adalah jobs).
Kondisi Kustom
Kondisi kustom dapat ditambahkan menggunakan filter blockstudio/blocks/conditions.
Filter berjalan di PHP saat editor dimuat dan mengembalikan satu nilai untuk setiap jenis kondisi. Kondisi dievaluasi di editor, yang membandingkan nilai tersebut dengan value kondisi menggunakan 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;
});
Kembalikan string yang tidak kosong untuk setiap status. Jenis kondisi yang nilainya kosong atau tidak ada akan dilewati, sehingga field tetap terlihat.
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message",
"conditions": [
[
{
"type": "purchasedProduct",
"operator": "==",
"value": "yes"
}
]
]
}
]
}
}
Kondisi Blok
Anda dapat menetapkan kondisi yang bergantung pada atribut lain. Alih-alih menetapkan kunci type, gunakan id atribut yang ingin diperiksa:
{
"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
}
]
]
}
]
}
}
Anda dapat menggabungkan kondisi global dengan kondisi blok sesuai kebutuhan.
Konteks Repeater
Secara default, kondisi untuk atribut di dalam repeater bergantung pada atribut elemen yang sedang diulang.
{
"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
}
]
]
}
]
}
]
}
}
Karena ID atribut dibatasi cakupannya ke elemen repeater saat ini, atribut teks di dalam repeater hanya akan ditampilkan jika toggle di dalam repeater disetel ke true.
Untuk memeriksa toggle di luar repeater, tambahkan "context": "main" ke kondisi:
{
"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"
}
]
]
}
]
}
]
}
}