Treci la conținut

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.

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

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

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

Twig

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

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

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.

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

Valoarea attribute urmează modelul repeaterId[index].fieldId, unde index este numărul rândului din buclă, indexat de la zero.