MediaPlaceholder
Komponenten MediaPlaceholder tillhandahåller en platshållare för att lägga till mediaobjekt i ett block. Samma komponent används i blocket core/image. Den bygger på komponenten Reactmed samma namn.
Grundläggande användning
För att använda MediaPlaceholder i sin enklaste form behöver du lägga till lämpligt attribut i din block.json och lägga till komponenten MediaPlaceholder i ditt block.
{
"$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 %}
När en mediefil har valts återges komponenten MediaPlaceholder inte längre.
Egenskaper
accept
En sträng som skickas till FormFileUpload och anger för webbläsaren vilka filtyper som kan laddas upp i webbläsarens uppladdningsfönster med e.g.: image/* eller video/*. Mer information om strängen finns i MDN-dokumentationen.
allowedTypes
Array med de medietyper som ska laddas upp eller väljas från mediebiblioteket. Varje typ är en sträng som kan innehålla en allmän MIME-typ e.g.: bild, ljud, text eller en fullständig MIME-typ e.g.: audio/mpeg, image/gif. Om allowedTypes inte har angetts bör alla MIME-typer tillåtas.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Om värdet är true öppnar komponenten MediaUpload automatiskt väljaren för den aktuella plattformen.
disableDropZone
Om värdet är true återges inte släppzonen. Användare kan inte dra och släppa media i komponenten eller blocket. Kontrollerna UI för att ladda upp media via fil, URL eller mediebiblioteket finns kvar.
dropZoneUIOnly
Om värdet är true återges endast släppzonen. Inga UI kontroller för att ladda upp media visas. Egenskapen disableDropZone har fortfarande företräde framför dropZoneUIOnly – om båda anges som true återges ingenting.
ikon
Dashicon som visas till vänster om rubriken.
isAppender
Om värdet är true ändrar egenskapen platshållarens utseende så att det passar när nya filer läggs till i en befintlig filsamling, e.g., till exempel när filer läggs till i ett galleri. Om värdet är false används standardstilen för platshållaren.
disableMediaButtons
Om värdet är true återges endast släppzonen. Inga UI kontroller för att ladda upp media visas.
etiketter
Ett objekt som kan innehålla egenskaperna title och 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') }}" />
Repeaterfält
MediaPlaceholder fungerar i repeaterfält. Använd hakparentesnotation med loopens index för att välja rätt rad.
{
"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ärdet attribute följer mönstret repeaterId[index].fieldId, där index är det nollbaserade radnumret från loopen.