MediaPlaceholder
Komponents MediaPlaceholder nodrošina vietturi multivides vienumu pievienošanai blokam. Šis pats komponents tiek izmantots blokā core/image. Tā pamatā ir tāda paša nosaukuma komponents React.
Pamata lietojums
Lai izmantotu MediaPlaceholder tā vienkāršākajā formā, pievienojiet atbilstošo atribūtu savam block.json un pievienojiet blokam 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 %}
Kad multivides fails ir atlasīts, komponents MediaPlaceholder vairs netiek attēlots.
Rekvizīti
accept
Virkne, kas nodota FormFileUpload un norāda pārlūkam, kurus failu tipus var augšupielādēt augšupielādes logā, kuru pārlūks atver, izmantojot e.g.: image/* vai video/*. Plašāka informācija par šo virkni pieejama MDN dokumentācijā.
allowedTypes
Masīvs ar augšupielādējamo vai multivides bibliotēkā atlasāmo multivides tipu sarakstu. Katrs tips ir virkne, kurā var norādīt vispārīgo MIME tipu e.g.: attēls, audio, teksts vai pilnu MIME tipu e.g.: audio/mpeg, image/gif. Ja allowedTypes nav iestatīts, jāatļauj visi MIME tipi.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Ja true, komponents MediaUpload automātiski atver attiecīgās platformas atlasītāju.
disableDropZone
Ja true, nomešanas zona netiek attēlota. Lietotāji nevarēs ievilkt un nomest multividi komponentā vai blokā. UI vadīklas multivides augšupielādei no faila, URL vai multivides bibliotēkas joprojām būs pieejamas.
dropZoneUIOnly
Ja true, tiek attēlota tikai nomešanas zona. Netiek rādītas UI vadīklas multivides augšupielādei. Rekvizītam disableDropZone joprojām ir priekšroka pār dropZoneUIOnly — ja abi ir true, nekas netiks attēlots.
icon
Dashicon, kas jāparāda pa kreisi no virsraksta.
isAppender
Ja true, rekvizīts maina viettura izskatu, lai tas būtu piemērots gadījumiem, kad esošai failu kopai tiek pievienoti jauni faili, e.g., piemēram, pievienojot failus galerijai. Ja false, tiek izmantots noklusējuma viettura stils.
disableMediaButtons
Ja true, tiek attēlota tikai nomešanas zona. Netiek rādītas UI vadīklas multivides augšupielādei.
labels
Objekts, kurā var būt ietverti rekvizīti title un 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') }}" />
Atkārtotāja lauki
MediaPlaceholder darbojas atkārtotāja laukos. Izmantojiet kvadrātiekavu pierakstu ar cikla indeksu, lai atlasītu pareizo rindu.
{
"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ērtība attribute atbilst šablonam repeaterId[index].fieldId, kur index ir cikla rindas numurs, sākot no nulles.