MediaPlaceholder
Komponenten MediaPlaceholder giver en pladsholder, hvor du kan føje medieelementer til en blok. Den samme komponent bruges i blokken core/image. Den er baseret på komponenten React med samme navn.
Grundlæggende brug
For at bruge MediaPlaceholder i sin enkleste form skal du føje den relevante attribut til din block.json og føje komponenten MediaPlaceholder til din blok.
{
"$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 er valgt, gengives komponenten MediaPlaceholder ikke længere.
Egenskaber
accept
En streng, der sendes til FormFileUpload, og fortæller browseren, hvilke filtyper der kan uploades i browserens uploadvindue med e.g.: image/* eller video/*. Du kan finde flere oplysninger om strengen i MDN-dokumentationen.
allowedTypes
Array med de medietyper, der kan uploades eller vælges fra mediebiblioteket. Hver type er en streng, der kan indeholde den generelle MIME-type e.g.: image, audio, text eller den fulde MIME-type e.g.: audio/mpeg, image/gif. Hvis allowedTypes ikke er angivet, tillades alle MIME-typer.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Hvis værdien er true, åbner MediaUpload-komponenten automatisk vælgeren på den pågældende platform.
disableDropZone
Hvis værdien er true, gengives dropzonen ikke. Brugerne kan ikke trække og slippe medier ind i komponenten eller blokken. Kontrollerne UI til upload af medier via fil, URL eller mediebiblioteket er stadig tilgængelige.
dropZoneUIOnly
Hvis værdien er true, gengives kun dropzonen. Ingen kontroller UI til upload af medier vises. Egenskaben disableDropZone har stadig forrang frem for dropZoneUIOnly – hvis begge angives som true, gengives der ingenting.
ikon
Dashicon, der vises til venstre for titlen.
isAppender
Hvis værdien er true, ændrer egenskaben pladsholderens udseende, så den passer til situationer, hvor der føjes nye filer til et eksisterende sæt filer, e.g., for eksempel når filer føjes til et galleri. Hvis værdien er false, bruges standardpladsholderens udseende.
disableMediaButtons
Hvis værdien er true, gengives kun dropzonen. Ingen kontroller UI til upload af medier vises.
etiketter
Et objekt, der kan indeholde egenskaberne title og 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') }}" />
Gentagelsesfelter
MediaPlaceholder fungerer i gentagelsesfelter. Brug klammeparentesnotation med løkkens indeks for at vælge den rigtige række.
{
"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ærdien attribute følger mønsteret repeaterId[index].fieldId, hvor index er det nulbaserede rækkenummer fra løkken.