Pāriet uz saturu

MediaPlaceholder

Komponents MediaPlaceholder nodrošina vietturi multivides vienumu pievienošanai blokam. Šis pats komponents tiek izmantots blokā core/image. Tā pamatā ir tāda paša nosaukuma komponents React.

Pamata lietojums

Lai izmantotu MediaPlaceholder tā vienkāršākajā formā, pievienojiet atbilstošo atribūtu savam block.json un pievienojiet blokam 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 %}

Kad multivides fails ir atlasīts, komponents MediaPlaceholder vairs netiek attēlots.

Rekvizīti

accept

Virkne, kas nodota FormFileUpload un norāda pārlūkam, kurus failu tipus var augšupielādēt augšupielādes logā, kuru pārlūks atver, izmantojot e.g.: image/* vai video/*. Plašāka informācija par šo virkni pieejama MDN dokumentācijā.

allowedTypes

Masīvs ar augšupielādējamo vai multivides bibliotēkā atlasāmo multivides tipu sarakstu. Katrs tips ir virkne, kurā var norādīt vispārīgo MIME tipu e.g.: attēls, audio, teksts vai pilnu MIME tipu e.g.: audio/mpeg, image/gif. Ja allowedTypes nav iestatīts, jāatļauj visi MIME tipi.

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

Ja true, komponents MediaUpload automātiski atver attiecīgās platformas atlasītāju.

disableDropZone

Ja true, nomešanas zona netiek attēlota. Lietotāji nevarēs ievilkt un nomest multividi komponentā vai blokā. UI vadīklas multivides augšupielādei no faila, URL vai multivides bibliotēkas joprojām būs pieejamas.

dropZoneUIOnly

Ja true, tiek attēlota tikai nomešanas zona. Netiek rādītas UI vadīklas multivides augšupielādei. Rekvizītam disableDropZone joprojām ir priekšroka pār dropZoneUIOnly — ja abi ir true, nekas netiks attēlots.

icon

Dashicon, kas jāparāda pa kreisi no virsraksta.

isAppender

Ja true, rekvizīts maina viettura izskatu, lai tas būtu piemērots gadījumiem, kad esošai failu kopai tiek pievienoti jauni faili, e.g., piemēram, pievienojot failus galerijai. Ja false, tiek izmantots noklusējuma viettura stils.

disableMediaButtons

Ja true, tiek attēlota tikai nomešanas zona. Netiek rādītas UI vadīklas multivides augšupielādei.

labels

Objekts, kurā var būt ietverti rekvizīti title un 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') }}" />

Atkārtotāja lauki

MediaPlaceholder darbojas atkārtotāja laukos. Izmantojiet kvadrātiekavu pierakstu ar cikla indeksu, lai atlasītu pareizo rindu.

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

Vērtība attribute atbilst šablonam repeaterId[index].fieldId, kur index ir cikla rindas numurs, sākot no nulles.