MediaPlaceholder
O componente MediaPlaceholder oferece um espaço reservado para adicionar itens de mídia a um bloco. O mesmo componente é usado no bloco core/image. Ele se baseia no componente React de mesmo nome.
Uso básico
Para usar MediaPlaceholder em sua forma mais básica, você precisa adicionar o atributo apropriado ao seu block.json e adicionar o componente MediaPlaceholder ao seu bloco.
{
"$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 %}
Depois que um arquivo de mídia for selecionado, o componente MediaPlaceholder não será mais renderizado.
Propriedades
accept
Uma string passada para FormFileUpload que informa ao navegador quais tipos de arquivo podem ser enviados para a janela de envio usada pelo navegador e.g.: image/* ou video/*. Mais informações sobre essa string estão disponíveis na documentação do MDN.
allowedTypes
Array com os tipos de mídia a enviar ou selecionar na biblioteca de mídia. Cada tipo é uma string que pode conter o tipo MIME geral e.g.: imagem, áudio, texto, ou o tipo MIME completo e.g.: audio/mpeg, image/gif. Se allowedTypes não estiver definido, todos os tipos MIME devem ser permitidos.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Se verdadeiro, o componente MediaUpload abre automaticamente o seletor da plataforma correspondente.
disableDropZone
Se verdadeiro, a Drop Zone não será renderizada. Os usuários não poderão arrastar e soltar mídia no componente ou bloco. Os controles UI para enviar mídia por arquivo, URL ou pela biblioteca de mídia continuarão disponíveis.
dropZoneUIOnly
Se verdadeiro, somente a Drop Zone será renderizada. Nenhum controle UI para enviar mídia será exibido. A propriedade disableDropZone ainda tem precedência sobre dropZoneUIOnly; especificar ambas como verdadeiras fará com que nada seja renderizado.
ícone
Dashicon exibido à esquerda do título.
isAppender
Se verdadeiro, a propriedade altera a aparência do placeholder para se adequar a cenários em que novos arquivos são adicionados a um conjunto de arquivos já existente, e.g., por exemplo, adicionar arquivos a uma galeria. Se falso, o estilo padrão do placeholder será usado.
disableMediaButtons
Se verdadeiro, somente a Drop Zone será renderizada. Nenhum controle UI para enviar mídia será exibido.
labels
Um objeto que pode conter as propriedades 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') }}" />
Campos repetidores
MediaPlaceholder funciona dentro de campos repetidores. Use a notação de colchetes com o índice do loop para selecionar a linha correta.
{
"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 %}
O valor attribute segue o padrão repeaterId[index].fieldId, em que index é o número da linha, começando em zero, no loop.