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.
{
"$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 %}
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
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
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
<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') }}" />
Campi ripetitore
MediaPlaceholder funziona nei campi ripetitore. Usate la notazione con parentesi quadre e l’indice del ciclo per individuare la riga corretta.
{
"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 %}
Il valore attribute segue il modello repeaterId[index].fieldId, dove index è il numero di riga a partire da zero del ciclo.