MediaPlaceholder
De component MediaPlaceholder biedt een tijdelijke aanduiding om media-items aan een blok toe te voegen. Dezelfde component wordt gebruikt in het blok core/image. Deze is gebaseerd op de component ReactMediaPlaceholder met dezelfde naam.
Basisgebruik
Om MediaPlaceholder in de eenvoudigste vorm te gebruiken, moet je het juiste attribuut toevoegen aan je block.json en de component MediaPlaceholder aan je blok toevoegen.
{
"$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 %}
Zodra een mediabestand is geselecteerd, wordt de component MediaPlaceholder niet meer weergegeven.
Eigenschappen
accept
Een tekenreeks die aan FormFileUpload wordt doorgegeven en de browser vertelt welke bestandstypen kunnen worden geüpload naar het uploadvenster dat de browser gebruikt e.g.: image/* of video/*. Meer informatie over deze tekenreeks vind je in de MDN-documentatie.
allowedTypes
Array met de typen media die je kunt uploaden of selecteren uit de mediabibliotheek. Elk type is een tekenreeks die het algemene MIME-type e.g.: afbeelding, audio, tekst, of het volledige MIME-type e.g.: audio/mpeg, image/gif kan bevatten. Als allowedTypes niet is ingesteld, moeten alle MIME-typen zijn toegestaan.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Als dit waar is, opent de MediaUpload-component automatisch de kiezer van het betreffende platform.
disableDropZone
Als dit waar is, wordt de Drop Zone niet weergegeven. Gebruikers kunnen geen media naar de component of het blok slepen. De bedieningselementen UI om media te uploaden via een bestand, URL of de mediabibliotheek blijven beschikbaar.
dropZoneUIOnly
Als dit waar is, wordt alleen de Drop Zone weergegeven. Er worden geen UI bedieningselementen voor het uploaden van media getoond. De prop disableDropZone heeft nog steeds voorrang op dropZoneUIOnly: als je beide op waar instelt, wordt er niets weergegeven.
Pictogram
Dashicon dat links van de titel wordt weergegeven.
isAppender
Als dit waar is, verandert de eigenschap de weergave van de tijdelijke aanduiding zodat deze geschikt is voor scenario’s waarin nieuwe bestanden worden toegevoegd aan een bestaande verzameling bestanden, e.g., zoals bestanden toevoegen aan een galerij. Als dit onwaar is, wordt de standaardstijl voor tijdelijke aanduidingen gebruikt.
disableMediaButtons
Als dit waar is, wordt alleen de Drop Zone weergegeven. Er worden geen UI bedieningselementen voor het uploaden van media getoond.
Labels
Een object dat de eigenschappen title en instructions kan bevatten.
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') }}" />
Herhaalvelden
MediaPlaceholder werkt binnen herhaalvelden. Gebruik de notatie met vierkante haken en de lusindex om de juiste rij te selecteren.
{
"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 %}
De waarde attribute volgt het patroon repeaterId[index].fieldId, waarbij index het nulgebaseerde rijnummer uit de lus is.