Preskočiť na obsah

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.

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

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

PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />

Twig

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

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') }}" />

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.

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

Hodnota attribute má tvar repeaterId[index].fieldId, kde index je číslo riadka v cykle, ktoré začína od nuly.