MediaPlaceholder
Componenta MediaPlaceholder oferă un substituent pentru adăugarea elementelor media într-un bloc. Aceeași componentă este folosită în blocul core/image. Se bazează pe componenta React cu același nume.
Utilizare de bază
Pentru a folosi MediaPlaceholder în forma sa cea mai simplă, trebuie să adăugați atributul corespunzător în block.json și să adăugați componenta MediaPlaceholder în bloc.
{
"$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 %}
După selectarea unui fișier media, componenta MediaPlaceholder nu va mai fi redată.
Proprietăți
accept
Un șir transmis către FormFileUpload, care îi indică browserului ce tipuri de fișiere pot fi încărcate în fereastra de încărcare folosită de browser cu e.g.: image/* sau video/*. Mai multe informații despre acest șir sunt disponibile în documentația MDN.
allowedTypes
Matrice cu tipurile de fișiere media care pot fi încărcate/selectate din biblioteca media. Fiecare tip este un șir care poate conține tipul MIME general e.g.: image, audio, text, sau tipul MIME complet e.g.: audio/mpeg, image/gif. Dacă allowedTypes nu este setat, ar trebui permise toate tipurile MIME.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Dacă este true, componenta MediaUpload deschide automat selectorul platformei respective.
disableDropZone
Dacă este true, Zona de plasare nu va fi redată. Utilizatorii nu vor putea să tragă și să plaseze elemente media în componentă sau în bloc. Comenzile UI pentru încărcarea fișierelor media dintr-un fișier, prin URL sau din biblioteca media vor rămâne disponibile.
dropZoneUIOnly
Dacă este true, va fi redată doar Zona de plasare. Nu vor fi afișate comenzi UI pentru încărcarea fișierelor media. Proprietatea disableDropZone are în continuare prioritate față de dropZoneUIOnly; dacă le specificați pe ambele ca true, nu va fi redat nimic.
icon
Dashicon afișat în stânga titlului.
isAppender
Dacă este true, această proprietate schimbă aspectul substituentului pentru a se potrivi scenariilor în care se adaugă fișiere noi la un set existent de fișiere, e.g., de exemplu la adăugarea de fișiere într-o galerie. Dacă este false, se folosește stilul implicit al substituentului.
disableMediaButtons
Dacă este true, va fi redată doar Zona de plasare. Nu vor fi afișate comenzi UI pentru încărcarea fișierelor media.
labels
Un obiect care poate conține proprietățile title și 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') }}" />
Câmpuri repetabile
MediaPlaceholder funcționează în câmpurile repetabile. Folosiți notația cu paranteze drepte și indexul buclei pentru a indica rândul corect.
{
"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 %}
Valoarea attribute urmează modelul repeaterId[index].fieldId, unde index este numărul rândului din buclă, indexat de la zero.