Liigu sisu juurde

MediaPlaceholder

Komponent MediaPlaceholder pakub kohatäidet meediaüksuste plokki lisamiseks. Sama komponenti kasutatakse ka plokis core/image. See põhineb samanimelisel komponendil React.

Põhikasutus

MediaPlaceholder kasutamiseks kõige lihtsamal kujul tuleb lisada vastav atribuut objektile block.json ja lisada plokki 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 %}

Kui meediafail on valitud, siis komponenti MediaPlaceholder enam ei renderdata.

Omadused

accept

String, mis edastatakse elemendile FormFileUpload ja ütleb brauserile, milliseid failitüüpe üleslaadimisaknas lubada; brauser kasutab selleks e.g.: image/* või video/*. Lisateavet selle stringi kohta leiate MDN-i dokumentatsioonist.

allowedTypes

Üleslaaditava või meediateegist valitava meedia tüüpide massiiv. Iga tüüp on string, mis võib sisaldada üldist MIME-tüüpi e.g.: image, audio, text või täielikku MIME-tüüpi e.g.: audio/mpeg, image/gif. Kui allowedTypes pole määratud, tuleks lubada kõik MIME-tüübid.

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

Kui väärtus on tõene, avab komponent MediaUpload automaatselt vastava platvormi valija.

disableDropZone

Kui väärtus on tõene, siis kukutustsooni ei renderdata. Kasutajad ei saa komponenti ega plokki meediat lohistada. Meedia üleslaadimise juhtnupud UI failist, URL-i kaudu või meediateegist jäävad alles.

dropZoneUIOnly

Kui väärtus on tõene, renderdatakse ainult kukutustsoon. Meedia üleslaadimise juhtnuppe UI ei kuvata. Atribuut disableDropZone on endiselt atribuudist dropZoneUIOnly ülimuslik – kui mõlemad on tõesed, ei renderdata midagi.

icon

Pealkirjast vasakul kuvatav Dashicon.

isAppender

Kui väärtus on tõene, muudab see atribuut kohatäite sobivaks olukordades, kus olemasolevasse failikomplekti lisatakse uusi faile, e.g., näiteks galeriisse failide lisamisel. Kui väärtus on väär, kasutatakse kohatäite vaikestiili.

disableMediaButtons

Kui väärtus on tõene, renderdatakse ainult kukutustsoon. Meedia üleslaadimise juhtnuppe UI ei kuvata.

labels

Objekt, mis võib sisaldada pealkirja ja juhiste atribuute.

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

Kordusväljad

MediaPlaceholder töötab kordusväljades. Õige rea sihtimiseks kasutage nurksulgudega süntaksit ja tsükli indeksit.

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äärtus attribute järgib mustrit repeaterId[index].fieldId, kus index on tsükli nullist algav reanumber.