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.
{
"$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 %}
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
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
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
<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') }}" />
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.
{
"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 %}
attribute değeri, repeaterId[index].fieldId kalıbını izler; burada index döngüdeki sıfır tabanlı satır numarasıdır.