MediaPlaceholder
Komponent MediaPlaceholder poskytuje zástupný prvok na pridávanie médií do bloku. Rovnaký komponent sa používa aj v bloku core/image. Je založený na komponente React s rovnakým názvom.
Základné použitie
Ak chcete používať MediaPlaceholder v najzákladnejšej podobe, pridajte príslušný atribút do block.json a do bloku pridajte komponent MediaPlaceholder.
{
"$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 %}
Po výbere súboru s médiom sa komponent MediaPlaceholder už nebude vykresľovať.
Vlastnosti
accept
Reťazec odovzdaný komponentu FormFileUpload, ktorý informuje prehliadač o typoch súborov, ktoré možno nahrať do okna nahrávania. Prehliadač používa e.g.: image/* alebo video/*. Ďalšie informácie o tomto reťazci nájdete v dokumentácii MDN.
allowedTypes
Pole obsahujúce typy médií, ktoré možno nahrať alebo vybrať z knižnice médií. Každý typ je reťazec, ktorý môže obsahovať všeobecný typ MIME e.g.: obrázok, zvuk, text alebo úplný typ MIME e.g.: audio/mpeg, image/gif. Ak nie je nastavené allowedTypes, mali by byť povolené všetky typy MIME.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Ak je hodnota true, komponent MediaUpload automaticky otvorí výber súborov príslušnej platformy.
disableDropZone
Ak je hodnota true, zóna presúvania sa nevykreslí. Používatelia nebudú môcť presúvať médiá do komponentu ani bloku. Ovládacie prvky UI na nahrávanie médií zo súboru, adresy URL alebo knižnice médií však zostanú k dispozícii.
dropZoneUIOnly
Ak je hodnota true, vykreslí sa iba zóna presúvania. Nezobrazia sa žiadne ovládacie prvky UI na nahrávanie médií. Vlastnosť disableDropZone má stále prednosť pred vlastnosťou dropZoneUIOnly – ak obe nastavíte na true, nevykreslí sa nič.
ikona
Dashicon, ktorá sa zobrazí naľavo od názvu.
isAppender
Ak je hodnota true, vlastnosť zmení vzhľad zástupného prvku tak, aby vyhovoval situáciám, keď sa nové súbory pridávajú k už existujúcej skupine súborov, e.g., napríklad pri pridávaní súborov do galérie. Ak je hodnota false, použije sa predvolený štýl zástupného prvku.
disableMediaButtons
Ak je hodnota true, vykreslí sa iba zóna presúvania. Nezobrazia sa žiadne ovládacie prvky UI na nahrávanie médií.
štítky
Objekt, ktorý môže obsahovať vlastnosti title a 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') }}" />
Polia opakovača
MediaPlaceholder funguje aj v poliach opakovača. Pomocou zápisu s hranatými zátvorkami a indexu cyklu zacielite na správny riadok.
{
"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 %}
Hodnota attribute má tvar repeaterId[index].fieldId, kde index je číslo riadka v cykle, ktoré začína od nuly.