İçeriğe geç

MediaPlaceholder

MediaPlaceholder bileşeni, bir bloğa medya öğeleri eklemek için yer tutucu sağlar. Aynı bileşen core/image bloğunda da kullanılır. Aynı ada sahip React bileşenini temel alır.

Temel kullanım

MediaPlaceholder bileşenini en temel biçimde kullanmak için block.json öğenize uygun özniteliği eklemeniz ve bloğunuza MediaPlaceholder bileşenini eklemeniz gerekir.

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 %}

Bir medya dosyası seçildiğinde MediaPlaceholder bileşeni artık oluşturulmaz.

Özellikler

accept

Tarayıcıya, tarayıcının yükleme penceresine yüklenebilecek dosya türlerini bildiren ve FormFileUpload’a aktarılan dize. e.g.: image/* veya video/*. Bu dize hakkında daha fazla bilgi için MDN belgelerine bakın.

allowedTypes

Medya kitaplığından yüklenecek/seçilecek medya türlerini içeren dizi. Her tür, genel MIME türünü içerebilen bir dizedir e.g.: image, audio, text veya tam MIME türü e.g.: audio/mpeg, image/gif. allowedTypes ayarlanmamışsa tüm MIME türlerine izin verilmelidir.

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

Doğruysa MediaUpload bileşeni ilgili platformun seçicisini otomatik açar.

disableDropZone

Doğruysa Açılır Alan oluşturulmaz. Kullanıcılar bileşene veya bloğa medya sürükleyip bırakamaz. Dosya, URL veya medya kitaplığı üzerinden medya yüklemeye yarayan UI denetimleri kullanılabilir durumda kalır.

dropZoneUIOnly

Doğruysa yalnızca Açılır Alan oluşturulur. Medya yüklemek için UI denetimleri gösterilmez. disableDropZone özelliği yine de dropZoneUIOnly özelliğine göre önceliklidir; ikisini de true olarak belirtmek hiçbir şeyin oluşturulmamasına yol açar.

simge

Başlığın solunda gösterilecek Dashicon.

isAppender

Doğruysa özellik, yer tutucunun görünümünü mevcut bir dosya kümesine yeni dosyalar eklenecek senaryolara uygun hâle getirir e.g.; örneğin galeriye dosya eklerken. Yanlışsa varsayılan yer tutucu stili kullanılır.

disableMediaButtons

Doğruysa yalnızca Açılır Alan oluşturulur. Medya yüklemek için UI denetimleri gösterilmez.

etiketler

Başlık ve talimat özelliklerini içerebilen bir nesne.

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') }}" />

Tekrarlayıcı alanlar

MediaPlaceholder, tekrarlayıcı alanların içinde çalışır. Doğru satırı hedeflemek için döngü diziniyle birlikte köşeli parantez gösterimini kullanın.

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 %}

attribute değeri, repeaterId[index].fieldId kalıbını izler; burada index döngüdeki sıfır tabanlı satır numarasıdır.