MediaPlaceholder
Komponentas MediaPlaceholder pateikia vietos rezervavimo elementą medijos elementams į bloką pridėti. Tas pats komponentas naudojamas bloke core/image. Jis pagrįstas to paties pavadinimo komponentu React.
Pagrindinis naudojimas
Norėdami naudoti MediaPlaceholder paprasčiausiu būdu, pridėkite atitinkamą atributą prie block.json ir komponentą MediaPlaceholder prie savo bloko.
{
"$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 %}
Pasirinkus medijos failą, komponentas MediaPlaceholder neberodomas.
Savybės
accept
FormFileUpload perduodama eilutė, nurodanti naršyklei, kokius failų tipus galima įkelti į įkėlimo langą naudojant e.g.: image/* arba video/*. Daugiau informacijos apie šią eilutę rasite MDN dokumentacijoje.
allowedTypes
Medijos tipų, kuriuos galima įkelti arba pasirinkti iš medijos bibliotekos, masyvas. Kiekvienas tipas yra eilutė, kurioje gali būti bendras MIME tipas e.g.: image, audio, text arba visas MIME tipas e.g.: audio/mpeg, image/gif. Jei allowedTypes nenustatytas, leidžiami visi MIME tipai.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Jei reikšmė true, komponentas MediaUpload automatiškai atidaro atitinkamos platformos parinkiklį.
disableDropZone
Jei reikšmė true, „Drop Zone“ nerodoma. Naudotojai negalės nuvilkti medijos į komponentą ar bloką. Valdikliai UI medijai įkelti iš failo, URL arba medijos bibliotekos liks pasiekiami.
dropZoneUIOnly
Jei reikšmė true, rodoma tik „Drop Zone“. Medijai įkelti skirti valdikliai UI nerodomi. Pirmenybė vis tiek teikiama ypatybei disableDropZone, o ne dropZoneUIOnly – nustačius abi reikšmes į true, niekas nebus atvaizduota.
icon
Dashicon piktograma, rodoma pavadinimo kairėje.
isAppender
Jei reikšmė true, ši ypatybė pakeičia vietos rezervavimo elemento išvaizdą, kad jis tiktų atvejams, kai prie jau esamo failų rinkinio pridedami nauji failai, e.g., pavyzdžiui, pridedant failų prie galerijos. Jei reikšmė false, naudojamas numatytasis vietos rezervavimo elemento stilius.
disableMediaButtons
Jei reikšmė true, rodoma tik „Drop Zone“. Medijai įkelti skirti valdikliai UI nerodomi.
labels
Objektas, kuriame gali būti pavadinimo ir instrukcijų ypatybės.
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') }}" />
Kartotuvo laukai
MediaPlaceholder veikia kartotuvo laukuose. Naudokite laužtinių skliaustų žymėjimą su ciklo indeksu, kad nurodytumėte reikiamą eilutę.
{
"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 %}
Reikšmė attribute atitinka šabloną repeaterId[index].fieldId, kuriame index yra nuliniais skaičiais indeksuotas eilutės numeris iš ciklo.