MediaPlaceholder
Komponen MediaPlaceholder menyediakan placeholder untuk menambahkan item media ke blok. Komponen yang sama digunakan di blok core/image. Komponen ini didasarkan pada komponen React dengan nama yang sama.
Penggunaan Dasar
Untuk menggunakan MediaPlaceholder dalam bentuk paling dasar, tambahkan atribut yang sesuai ke block.json dan tambahkan komponen MediaPlaceholder ke blok Anda.
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/media-placeholder",
"title": "Native Block",
"category": "text",
"icon": "star-filled",
"description": "Native Blockstudio MediaPlaceholder block.",
"blockstudio": {
"attributes": [
{
"id": "media",
"type": "files"
}
]
}
}
PHP
<MediaPlaceholder attribute="media" />
<?php foreach ($a['media'] as $file) {
echo wp_get_attachment_image($file['ID']);
} ?>
Twig
<MediaPlaceholder attribute="media" />
{% for file in a.media %}
{{ fn('wp_get_attachment_image', file.ID) }}
{% endfor %}
Setelah file media dipilih, komponen MediaPlaceholder tidak akan dirender lagi.
Properti
accept
String yang diteruskan ke FormFileUpload untuk memberi tahu browser jenis file yang dapat diunggah ke jendela unggahan yang menggunakan e.g.: image/* atau video/*. Informasi selengkapnya tentang string ini tersedia di dokumentasi MDN.
allowedTypes
Array berisi jenis media yang akan diunggah/dipilih dari pustaka media. Setiap jenis berupa string yang dapat berisi jenis MIME umum e.g.: image, audio, text, atau jenis MIME lengkap e.g.: audio/mpeg, image/gif. Jika allowedTypes tidak ditetapkan, semua jenis MIME akan diizinkan.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Jika true, komponen MediaUpload otomatis membuka pemilih pada platform terkait.
disableDropZone
Jika true, Drop Zone tidak akan dirender. Pengguna tidak dapat menarik dan melepas media ke komponen atau blok. Kontrol UI untuk mengunggah media melalui file, url, atau pustaka media tetap tersedia.
dropZoneUIOnly
Jika true, hanya Drop Zone yang akan dirender. Kontrol UI untuk mengunggah media tidak akan ditampilkan. Prop disableDropZone tetap lebih diutamakan daripada dropZoneUIOnly; jika keduanya ditetapkan true, tidak ada yang akan dirender.
icon
Dashicon yang ditampilkan di sebelah kiri judul.
isAppender
Jika true, properti ini mengubah tampilan placeholder agar sesuai untuk skenario ketika file baru ditambahkan ke kumpulan file yang sudah ada, e.g., misalnya menambahkan file ke galeri. Jika false, gaya placeholder default digunakan.
disableMediaButtons
Jika true, hanya Drop Zone yang akan dirender. Kontrol UI untuk mengunggah media tidak akan ditampilkan.
labels
Objek yang dapat berisi properti title dan instructions.
PHP
<MediaPlaceholder labels="<?php echo esc_attr(wp_json_encode(['title' => 'Custom title', 'instructions' => 'Custom instructions'])); ?>" />
Twig
<MediaPlaceholder labels="{{ {title: 'Custom title', instructions: 'Custom instructions'}|json_encode|escape('html_attr') }}" />
Bidang Repeater
MediaPlaceholder berfungsi di dalam bidang repeater. Gunakan notasi tanda kurung siku dengan indeks loop untuk menargetkan baris yang benar.
{
"blockstudio": {
"attributes": [
{
"id": "items",
"type": "repeater",
"attributes": [
{
"id": "image",
"type": "files"
}
]
}
]
}
}
<?php foreach ($a['items'] as $index => $item) : ?>
<MediaPlaceholder attribute="items[<?php echo $index; ?>].image" />
<?php endforeach; ?>
{% for item in a.items %}
<MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
{% endfor %}
Nilai attribute mengikuti pola repeaterId[index].fieldId, dengan index sebagai nomor baris berbasis nol dari loop.