Siirry sisältöön

MediaPlaceholder

Komponentti MediaPlaceholder tarjoaa paikkamerkin mediakohteiden lisäämiseen lohkoon. Samaa komponenttia käytetään lohkossa core/image. Se perustuu samannimiseen komponenttiin React .

Peruskäyttö

Jotta voit käyttää MediaPlaceholder-komponenttia yksinkertaisimmillaan, lisää sopiva attribuutti komponenttiisi block.json ja lisää lohkoosi komponentti 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 %}

Kun mediatiedosto on valittu, komponenttia MediaPlaceholder ei enää renderöidä.

Ominaisuudet

accept

FormFileUpload-komponentille välitettävä merkkijono, joka kertoo selaimelle, minkä tyyppiset tiedostot voidaan ladata selainikkunaan e.g.image/* tai video/*. Lisätietoja tästä merkkijonosta on MDN:n dokumentaatiossa.

allowedTypes

Taulukko mediatyypeistä, joita voi ladata tai valita mediakirjastosta. Kukin tyyppi on merkkijono, joka voi sisältää yleisen MIME-tyypin e.g: image, audio, text tai täydellisen MIME-tyypin e.g: audio/mpeg, image/gif. Jos allowedTypes-arvoa ei ole asetettu, kaikki MIME-tyypit sallitaan.

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

Jos arvo on true, MediaUpload-komponentti avaa automaattisesti kyseisen alustan valitsimen.

disableDropZone

Jos arvo on true, pudotusaluetta ei renderöidä. Käyttäjät eivät voi vetää ja pudottaa mediaa komponenttiin tai lohkoon. UI-ohjaimet median lataamiseen tiedostosta, URL-osoitteesta tai mediakirjastosta säilyvät käytettävissä.

dropZoneUIOnly

Jos arvo on true, renderöidään vain pudotusalue. Median lataamiseen tarkoitettuja UI-ohjaimia ei näytetä. Ominaisuus disableDropZone menee silti ominaisuuden dropZoneUIOnly edelle: jos molemmat ovat true, mitään ei renderöidä.

icon

Otsikon vasemmalla puolella näytettävä Dashicon-kuvake.

isAppender

Jos arvo on true, tämä ominaisuus muuttaa paikkamerkin ulkoasun tilanteisiin sopivaksi, joissa uusia tiedostoja lisätään jo olemassa olevaan tiedostokokoelmaan, e.g. kuten galleriaan. Jos arvo on false, käytetään paikkamerkin oletustyyliä.

disableMediaButtons

Jos arvo on true, renderöidään vain pudotusalue. Median lataamiseen tarkoitettuja UI-ohjaimia ei näytetä.

labels

Objekti, joka voi sisältää title- ja instructions-ominaisuudet.

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

Toistinkentät

MediaPlaceholder toimii toistinkenttien sisällä. Käytä hakasuljenotaatiota ja silmukan indeksiä oikean rivin kohdistamiseen.

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

Arvo attribute noudattaa kaavaa repeaterId[index].fieldId, jossa index on silmukan nollasta alkava rivinumero.