Přejít k obsahu

MediaPlaceholder

Komponenta MediaPlaceholder poskytuje zástupný prvek pro přidávání médií do bloku. Stejná komponenta se používá také v bloku core/image. Je založena na komponentě React se stejným názvem.

Základní použití

Chcete-li použít MediaPlaceholder v nejzákladnější podobě, přidejte do svého block.json příslušný atribut a do bloku komponentu 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ýběru mediálního souboru se komponenta MediaPlaceholder přestane vykreslovat.

Vlastnosti

accept

Řetězec předávaný komponentě FormFileUpload, který prohlížeči říká, jaké typy souborů lze nahrát do okna pro nahrávání, jež prohlížeč používá e.g.: image/* nebo video/*. Další informace o tomto řetězci najdete v dokumentaci MDN.

allowedTypes

Pole typů médií, které lze nahrát nebo vybrat z knihovny médií. Každý typ je řetězec, který může obsahovat obecný typ MIME e.g.: image, audio, text nebo úplný typ MIME e.g.: audio/mpeg, image/gif. Pokud není nastaveno allowedTypes, jsou povoleny všechny 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

Pokud je hodnota true, komponenta MediaUpload automaticky otevře výběr souborů příslušné platformy.

disableDropZone

Pokud je hodnota true, zóna pro přetahování se nevykreslí. Uživatelé nebudou moci přetahovat média do komponenty ani bloku. Ovládací prvky UI pro nahrávání médií ze souboru, adresy URL nebo knihovny médií zůstanou zachovány.

dropZoneUIOnly

Pokud je hodnota true, vykreslí se pouze zóna pro přetahování. Nezobrazí se žádné ovládací prvky UI pro nahrávání médií. Přednost má stále vlastnost disableDropZone před dropZoneUIOnly – pokud obě nastavíte na true, nevykreslí se nic.

ikona

Dashicon, který se zobrazí vlevo od nadpisu.

isAppender

Pokud je hodnota true, vlastnost změní vzhled zástupného prvku tak, aby vyhovoval případům, kdy se do již existující sady souborů přidávají nové soubory e.g., například při přidávání souborů do galerie. Pokud je hodnota false, použije se výchozí styl zástupného prvku.

disableMediaButtons

Pokud je hodnota true, vykreslí se pouze zóna pro přetahování. Nezobrazí se žádné ovládací prvky UI pro nahrávání médií.

popisky

Objekt, který může obsahovat 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') }}" />

Pole opakovače

MediaPlaceholder funguje v polích opakovače. Pomocí hranaté notace s indexem smyčky určete správný řádek.

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 řádku od nuly v rámci smyčky.