MediaPlaceholder
Компонентът MediaPlaceholder предоставя контейнер за добавяне на мултимедийни елементи към блок. Същият компонент се използва в блока core/image. Той е базиран на компонента React със същото име.
Основна употреба
За да използвате MediaPlaceholder в най-основната му форма, трябва да добавите подходящия атрибут към block.json и да добавите компонента MediaPlaceholder към блока си.
{
"$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
<MediaPlaceholder attribute="media" />
<?php foreach ($a['media'] as $file) {
echo wp_get_attachment_image($file['ID']);
} ?>
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
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
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
<MediaPlaceholder labels="<?php echo esc_attr(wp_json_encode(['title' => 'Custom title', 'instructions' => 'Custom instructions'])); ?>" />
Twig
<MediaPlaceholder labels="{{ {title: 'Custom title', instructions: 'Custom instructions'}|json_encode|escape('html_attr') }}" />
Полета за повтарящи се записи
MediaPlaceholder работи в полета за повтарящи се записи. Използвайте нотация със скоби и индекса на цикъла, за да зададете целевия ред.
{
"blockstudio": {
"attributes": [
{
"id": "items",
"type": "repeater",
"attributes": [
{
"id": "image",
"type": "files"
}
]
}
]
}
}
<?php foreach ($a['items'] as $index => $item) : ?>
<MediaPlaceholder attribute="items[<?php echo $index; ?>].image" />
<?php endforeach; ?>
{% for item in a.items %}
<MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
{% endfor %}
Стойността attribute следва шаблона repeaterId[index].fieldId, където index е нулево базираният номер на реда в цикъла.