MediaPlaceholder
Komponenta MediaPlaceholder zagotavlja označbo mesta za dodajanje predstavnostnih elementov v blok. Ista komponenta se uporablja v bloku core/image. Temelji na komponenti z istim imenom React.
Osnovna uporaba
Če želite MediaPlaceholder uporabiti v najosnovnejši obliki, morate v block.json dodati ustrezen atribut in v blok dodati komponento 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 %}
Ko izberete predstavnostno datoteko, se komponenta MediaPlaceholder ne bo več izrisala.
Lastnosti
accept
Niz, posredovan komponenti FormFileUpload, ki brskalniku pove, katere vrste datotek je mogoče naložiti v okno za nalaganje, ki ga brskalnik odpre z e.g.: image/* ali video/*. Več informacij o tem nizu je na voljo v dokumentaciji MDN.
allowedTypes
Matrika vrst predstavnosti za nalaganje/izbiro iz predstavnostne knjižnice. Vsaka vrsta je niz, ki lahko vsebuje splošno vrsto MIME e.g.: image, audio, text ali celotno vrsto MIME e.g.: audio/mpeg, image/gif. Če možnost allowedTypes ni nastavljena, morajo biti dovoljene vse vrste MIME.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Če je vrednost true, komponenta MediaUpload samodejno odpre izbirnik ustrezne platforme.
disableDropZone
Če je vrednost true, območje za spuščanje ne bo izrisano. Uporabniki ne bodo mogli povleči in spustiti predstavnosti v komponento ali blok. Kontrolniki UI za nalaganje predstavnosti iz datoteke, URL-ja ali predstavnostne knjižnice bodo še vedno na voljo.
dropZoneUIOnly
Če je vrednost true, bo izrisano samo območje za spuščanje. Kontrolniki UI za nalaganje predstavnosti ne bodo prikazani. Lastnost disableDropZone ima še vedno prednost pred dropZoneUIOnly – če sta obe nastavljeni na true, se ne izriše nič.
ikona
Ikona Dashicon, prikazana levo od naslova.
isAppender
Če je vrednost true, lastnost spremeni videz označbe mesta, da je primeren za primere, ko se nove datoteke dodajajo že obstoječemu naboru datotek, e.g., na primer pri dodajanju datotek v galerijo. Če je vrednost false, se uporabi privzeti slog označbe mesta.
disableMediaButtons
Če je vrednost true, bo izrisano samo območje za spuščanje. Kontrolniki UI za nalaganje predstavnosti ne bodo prikazani.
oznake
Objekt, ki lahko vsebuje lastnosti title in 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') }}" />
Polja za ponavljanje
MediaPlaceholder deluje znotraj polj za ponavljanje. Uporabite zapis z oglatimi oklepaji in indeks zanke, da izberete pravo vrstico.
{
"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 %}
Vrednost attribute sledi vzorcu repeaterId[index].fieldId, pri čemer je index številka vrstice v zanki, ki se začne z ničlo.