Vai al contenuto

MediaPlaceholder

Il componente MediaPlaceholder fornisce un segnaposto per aggiungere contenuti multimediali a un blocco. Lo stesso componente è usato nel blocco core/image. Si basa sul componente MediaPlaceholderReact, che ha lo stesso nome.

Utilizzo di base

Per usare MediaPlaceholder nella sua forma più semplice, dovete aggiungere l’attributo appropriato al vostro block.json e aggiungere il componente MediaPlaceholder al blocco.

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

Dopo aver selezionato un file multimediale, il componente MediaPlaceholder non verrà più renderizzato.

Proprietà

accept

Una stringa passata a FormFileUpload che indica al browser quali tipi di file possono essere caricati nella finestra di caricamento del browser, che usa e.g.: image/* oppure video/*. Ulteriori informazioni su questa stringa sono disponibili nella documentazione MDN.

allowedTypes

Array con i tipi di contenuti multimediali da caricare o selezionare dalla libreria multimediale. Ogni tipo è una stringa che può contenere il tipo MIME generale e.g: immagine, audio, testo oppure il tipo MIME completo e.g: audio/mpeg, image/gif. Se allowedTypes non è impostato, dovrebbero essere consentiti tutti i tipi MIME.

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

Se è true, il componente MediaUpload apre automaticamente il selettore della piattaforma corrispondente.

disableDropZone

Se è true, la Drop Zone non verrà renderizzata. Gli utenti non potranno trascinare contenuti multimediali nel componente o nel blocco. I controlli UI per caricare contenuti multimediali da file, URL o libreria multimediale resteranno disponibili.

dropZoneUIOnly

Se è true, verrà renderizzata solo la Drop Zone. I controlli UI per caricare contenuti multimediali non saranno visualizzati. La prop disableDropZone ha comunque la precedenza su dropZoneUIOnly: se entrambe sono impostate su true, non verrà renderizzato nulla.

icon

Dashicon da visualizzare a sinistra del titolo.

isAppender

Se è true, la proprietà modifica l’aspetto del segnaposto per adattarlo ai casi in cui si aggiungono nuovi file a un insieme di file già esistente, e.g, ad esempio quando si aggiungono file a una galleria. Se è false, viene usato lo stile predefinito del segnaposto.

disableMediaButtons

Se è true, verrà renderizzata solo la Drop Zone. Non verranno mostrati controlli UI per caricare contenuti multimediali.

labels

Un oggetto che può contenere le proprietà title e 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') }}" />

Campi ripetitore

MediaPlaceholder funziona nei campi ripetitore. Usate la notazione con parentesi quadre e l’indice del ciclo per individuare la riga corretta.

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

Il valore attribute segue il modello repeaterId[index].fieldId, dove index è il numero di riga a partire da zero del ciclo.