MediaPlaceholder
Komponent MediaPlaceholder pakub kohatäidet meediaüksuste plokki lisamiseks. Sama komponenti kasutatakse ka plokis core/image. See põhineb samanimelisel komponendil React.
Põhikasutus
MediaPlaceholder kasutamiseks kõige lihtsamal kujul tuleb lisada vastav atribuut objektile block.json ja lisada plokki komponent 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 %}
Kui meediafail on valitud, siis komponenti MediaPlaceholder enam ei renderdata.
Omadused
accept
String, mis edastatakse elemendile FormFileUpload ja ütleb brauserile, milliseid failitüüpe üleslaadimisaknas lubada; brauser kasutab selleks e.g.: image/* või video/*. Lisateavet selle stringi kohta leiate MDN-i dokumentatsioonist.
allowedTypes
Üleslaaditava või meediateegist valitava meedia tüüpide massiiv. Iga tüüp on string, mis võib sisaldada üldist MIME-tüüpi e.g.: image, audio, text või täielikku MIME-tüüpi e.g.: audio/mpeg, image/gif. Kui allowedTypes pole määratud, tuleks lubada kõik MIME-tüübid.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Kui väärtus on tõene, avab komponent MediaUpload automaatselt vastava platvormi valija.
disableDropZone
Kui väärtus on tõene, siis kukutustsooni ei renderdata. Kasutajad ei saa komponenti ega plokki meediat lohistada. Meedia üleslaadimise juhtnupud UI failist, URL-i kaudu või meediateegist jäävad alles.
dropZoneUIOnly
Kui väärtus on tõene, renderdatakse ainult kukutustsoon. Meedia üleslaadimise juhtnuppe UI ei kuvata. Atribuut disableDropZone on endiselt atribuudist dropZoneUIOnly ülimuslik – kui mõlemad on tõesed, ei renderdata midagi.
icon
Pealkirjast vasakul kuvatav Dashicon.
isAppender
Kui väärtus on tõene, muudab see atribuut kohatäite sobivaks olukordades, kus olemasolevasse failikomplekti lisatakse uusi faile, e.g., näiteks galeriisse failide lisamisel. Kui väärtus on väär, kasutatakse kohatäite vaikestiili.
disableMediaButtons
Kui väärtus on tõene, renderdatakse ainult kukutustsoon. Meedia üleslaadimise juhtnuppe UI ei kuvata.
labels
Objekt, mis võib sisaldada pealkirja ja juhiste atribuute.
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') }}" />
Kordusväljad
MediaPlaceholder töötab kordusväljades. Õige rea sihtimiseks kasutage nurksulgudega süntaksit ja tsükli indeksit.
{
"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 %}
Väärtus attribute järgib mustrit repeaterId[index].fieldId, kus index on tsükli nullist algav reanumber.