Към съдържанието

MediaPlaceholder

Компонентът MediaPlaceholder предоставя контейнер за добавяне на мултимедийни елементи към блок. Същият компонент се използва в блока core/image. Той е базиран на компонента React със същото име.

Основна употреба

За да използвате MediaPlaceholder в най-основната му форма, трябва да добавите подходящия атрибут към block.json и да добавите компонента 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 %}

След като бъде избран мултимедиен файл, компонентът MediaPlaceholder вече няма да се изобразява.

Свойства

приемане

Низ, предаван на FormFileUpload, който указва на браузъра кои типове файлове могат да се качват в прозореца за качване, където браузърът използва e.g.: image/* или video/*. Повече информация за този низ има в документацията на MDN.

allowedTypes

Масив с типовете мултимедия за качване или избор от медийната библиотека. Всеки тип е низ, който може да съдържа общ MIME тип e.g.: изображение, аудио, текст, или пълен MIME тип e.g.: audio/mpeg, image/gif. Ако allowedTypes не е зададен, трябва да бъдат разрешени всички 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

Ако е true, компонентът MediaUpload автоматично отваря инструмента за избор на съответната платформа.

disableDropZone

Ако е true, Drop Zone няма да се изобразява. Потребителите няма да могат да плъзгат и пускат мултимедия в компонента или блока. Контролите UI за качване на мултимедия чрез файл, URL или медийната библиотека ще останат налични.

dropZoneUIOnly

Ако е true, ще се изобразява само Drop Zone. Контролите UI за качване на мултимедия няма да се показват. Пропът disableDropZone все пак има предимство пред dropZoneUIOnly — ако и двата са зададени на true, няма да се изобрази нищо.

икона

Икона Dashicon, която да се показва вляво от заглавието.

isAppender

Ако е true, свойството променя изгледа на контейнера, така че да е подходящ за случаи, в които към вече съществуващ набор от файлове се добавят нови, e.g., например добавяне на файлове към галерия. Ако е false, се използва подразбираният стил на контейнера.

disableMediaButtons

Ако е true, ще се изобразява само Drop Zone. Контролите UI за качване на мултимедия няма да се показват.

етикети

Обект, който може да съдържа свойства за заглавие и инструкции.

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

Полета за повтарящи се записи

MediaPlaceholder работи в полета за повтарящи се записи. Използвайте нотация със скоби и индекса на цикъла, за да зададете целевия ред.

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

Стойността attribute следва шаблона repeaterId[index].fieldId, където index е нулево базираният номер на реда в цикъла.