Pereiti prie turinio

MediaPlaceholder

Komponentas MediaPlaceholder pateikia vietos rezervavimo elementą medijos elementams į bloką pridėti. Tas pats komponentas naudojamas bloke core/image. Jis pagrįstas to paties pavadinimo komponentu React.

Pagrindinis naudojimas

Norėdami naudoti MediaPlaceholder paprasčiausiu būdu, pridėkite atitinkamą atributą prie block.json ir komponentą MediaPlaceholder prie savo bloko.

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

Pasirinkus medijos failą, komponentas MediaPlaceholder neberodomas.

Savybės

accept

FormFileUpload perduodama eilutė, nurodanti naršyklei, kokius failų tipus galima įkelti į įkėlimo langą naudojant e.g.: image/* arba video/*. Daugiau informacijos apie šią eilutę rasite MDN dokumentacijoje.

allowedTypes

Medijos tipų, kuriuos galima įkelti arba pasirinkti iš medijos bibliotekos, masyvas. Kiekvienas tipas yra eilutė, kurioje gali būti bendras MIME tipas e.g.: image, audio, text arba visas MIME tipas e.g.: audio/mpeg, image/gif. Jei allowedTypes nenustatytas, leidžiami visi MIME tipai.

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

Jei reikšmė true, komponentas MediaUpload automatiškai atidaro atitinkamos platformos parinkiklį.

disableDropZone

Jei reikšmė true, „Drop Zone“ nerodoma. Naudotojai negalės nuvilkti medijos į komponentą ar bloką. Valdikliai UI medijai įkelti iš failo, URL arba medijos bibliotekos liks pasiekiami.

dropZoneUIOnly

Jei reikšmė true, rodoma tik „Drop Zone“. Medijai įkelti skirti valdikliai UI nerodomi. Pirmenybė vis tiek teikiama ypatybei disableDropZone, o ne dropZoneUIOnly – nustačius abi reikšmes į true, niekas nebus atvaizduota.

icon

Dashicon piktograma, rodoma pavadinimo kairėje.

isAppender

Jei reikšmė true, ši ypatybė pakeičia vietos rezervavimo elemento išvaizdą, kad jis tiktų atvejams, kai prie jau esamo failų rinkinio pridedami nauji failai, e.g., pavyzdžiui, pridedant failų prie galerijos. Jei reikšmė false, naudojamas numatytasis vietos rezervavimo elemento stilius.

disableMediaButtons

Jei reikšmė true, rodoma tik „Drop Zone“. Medijai įkelti skirti valdikliai UI nerodomi.

labels

Objektas, kuriame gali būti pavadinimo ir instrukcijų ypatybės.

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

Kartotuvo laukai

MediaPlaceholder veikia kartotuvo laukuose. Naudokite laužtinių skliaustų žymėjimą su ciklo indeksu, kad nurodytumėte reikiamą eilutę.

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

Reikšmė attribute atitinka šabloną repeaterId[index].fieldId, kuriame index yra nuliniais skaičiais indeksuotas eilutės numeris iš ciklo.