MediaPlaceholder
A MediaPlaceholder komponens helyőrzőt biztosít médiaelemek blokkhoz adásához. Ugyanezt a komponenst használja a core/image blokk is. Az azonos nevű React komponens alapján készült.
Alapvető használat
A MediaPlaceholder legegyszerűbb használatához add hozzá a megfelelő attribútumot a block.json elemhez,
és illeszd be a MediaPlaceholder komponenst a blokkodba.
{
"$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 %}
Médiafájl kiválasztása után a MediaPlaceholder komponens többé nem jelenik meg.
Tulajdonságok
accept
A FormFileUpload számára átadott szöveg, amely megadja a böngészőnek, hogy milyen fájltípusok tölthetők fel a feltöltési ablakba, amely a e.g segítségével nyílik meg: image/* vagy video/*. Erről a szövegről további információ az MDN dokumentációjában található.
allowedTypes
A feltöltendő vagy a médiatárból kiválasztható médiatípusok tömbje. Minden típus egy szöveg, amely tartalmazhat általános MIME-típust (e.g: image, audio, text) vagy teljes MIME-típust (e.g: audio/mpeg, image/gif). Ha az allowedTypes nincs beállítva, minden MIME-típust engedélyezni kell.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Ha igaz, a MediaUpload komponens automatikusan megnyitja az adott platform választófelületét.
disableDropZone
Ha igaz, a Drop Zone nem jelenik meg. A felhasználók nem húzhatnak médiát a komponensbe vagy a blokkba. A média fájlon, URL-en vagy médiatárból történő feltöltésére szolgáló UI vezérlők továbbra is elérhetők.
dropZoneUIOnly
Ha igaz, csak a Drop Zone jelenik meg. A média feltöltésére szolgáló UI vezérlők nem láthatók. A disableDropZone tulajdonság elsőbbséget élvez a dropZoneUIOnly beállítással szemben: ha mindkettő igaz, semmi sem jelenik meg.
ikon
A cím bal oldalán megjelenítendő Dashicon.
isAppender
Ha igaz, a tulajdonság úgy módosítja a helyőrző megjelenését, hogy az megfeleljen annak az esetnek, amikor fájlokat adnak egy már meglévő fájlkészlethez, e.g például képek hozzáadásakor egy galériához. Ha hamis, az alapértelmezett helyőrzőstílus érvényesül.
disableMediaButtons
Ha igaz, csak a Drop Zone jelenik meg. A média feltöltésére szolgáló UI vezérlők nem láthatók.
címkék
Cím és útmutatások tulajdonságot tartalmazó objektum.
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') }}" />
Ismétlőmezők
A MediaPlaceholder ismétlőmezőkben is működik. A megfelelő sor megcélzásához használd a ciklus indexével ellátott szögletes zárójeles jelölést.
{
"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 %}
A attribute érték a repeaterId[index].fieldId mintát követi, ahol a index a ciklus nullától kezdődő sorszáma.