Ga naar de inhoud

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.

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

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

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

Twig

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

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

Herhaalvelden

MediaPlaceholder werkt binnen herhaalvelden. Gebruik de notatie met vierkante haken en de lusindex om de juiste rij te selecteren.

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

De waarde attribute volgt het patroon repeaterId[index].fieldId, waarbij index het nulgebaseerde rijnummer uit de lus is.