MediaPlaceholder
Komponenta MediaPlaceholder poskytuje zástupný prvek pro přidávání médií do bloku. Stejná komponenta se používá také v bloku core/image. Je založena na komponentě React se stejným názvem.
Základní použití
Chcete-li použít MediaPlaceholder v nejzákladnější podobě, přidejte do svého block.json příslušný atribut a do bloku komponentu 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 %}
Po výběru mediálního souboru se komponenta MediaPlaceholder přestane vykreslovat.
Vlastnosti
accept
Řetězec předávaný komponentě FormFileUpload, který prohlížeči říká, jaké typy souborů lze nahrát do okna pro nahrávání, jež prohlížeč používá e.g.: image/* nebo video/*. Další informace o tomto řetězci najdete v dokumentaci MDN.
allowedTypes
Pole typů médií, které lze nahrát nebo vybrat z knihovny médií. Každý typ je řetězec, který může obsahovat obecný typ MIME e.g.: image, audio, text nebo úplný typ MIME e.g.: audio/mpeg, image/gif. Pokud není nastaveno allowedTypes, jsou povoleny všechny typy MIME.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Pokud je hodnota true, komponenta MediaUpload automaticky otevře výběr souborů příslušné platformy.
disableDropZone
Pokud je hodnota true, zóna pro přetahování se nevykreslí. Uživatelé nebudou moci přetahovat média do komponenty ani bloku. Ovládací prvky UI pro nahrávání médií ze souboru, adresy URL nebo knihovny médií zůstanou zachovány.
dropZoneUIOnly
Pokud je hodnota true, vykreslí se pouze zóna pro přetahování. Nezobrazí se žádné ovládací prvky UI pro nahrávání médií. Přednost má stále vlastnost disableDropZone před dropZoneUIOnly – pokud obě nastavíte na true, nevykreslí se nic.
ikona
Dashicon, který se zobrazí vlevo od nadpisu.
isAppender
Pokud je hodnota true, vlastnost změní vzhled zástupného prvku tak, aby vyhovoval případům, kdy se do již existující sady souborů přidávají nové soubory e.g., například při přidávání souborů do galerie. Pokud je hodnota false, použije se výchozí styl zástupného prvku.
disableMediaButtons
Pokud je hodnota true, vykreslí se pouze zóna pro přetahování. Nezobrazí se žádné ovládací prvky UI pro nahrávání médií.
popisky
Objekt, který může obsahovat vlastnosti title a instructions.
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') }}" />
Pole opakovače
MediaPlaceholder funguje v polích opakovače. Pomocí hranaté notace s indexem smyčky určete správný řádek.
{
"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 %}
Hodnota attribute má tvar repeaterId[index].fieldId, kde index je číslo řádku od nuly v rámci smyčky.