Lewati ke konten

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.

JSON
{
  "$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

PHP
<MediaPlaceholder attribute="media" />
<?php foreach ($a['media'] as $file) {
  echo wp_get_attachment_image($file['ID']);
} ?>

Twig

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

PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />

Twig

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

PHP
<MediaPlaceholder labels="<?php echo esc_attr(wp_json_encode(['title' => 'Custom title', 'instructions' => 'Custom instructions'])); ?>" />

Twig

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.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "items",
        "type": "repeater",
        "attributes": [
          {
            "id": "image",
            "type": "files"
          }
        ]
      }
    ]
  }
}
PHP
<?php foreach ($a['items'] as $index => $item) : ?>
  <MediaPlaceholder attribute="items[<?php echo $index; ?>].image" />
<?php endforeach; ?>
Twig
{% 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.