Gå til indhold

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.

JSON
{
  "$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

PHP
<MediaPlaceholder attribute="media" />
<?php foreach ($a['media'] as $file) {
  echo wp_get_attachment_image($file['ID']);
} ?>

Twig

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

PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />

Twig

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

PHP
<MediaPlaceholder labels="<?php echo esc_attr(wp_json_encode(['title' => 'Custom title', 'instructions' => 'Custom instructions'])); ?>" />

Twig

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.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "items",
        "type": "repeater",
        "attributes": [
          {
            "id": "image",
            "type": "files"
          }
        ]
      }
    ]
  }
}
PHP
<?php foreach ($a['items'] as $index => $item) : ?>
  <MediaPlaceholder attribute="items[<?php echo $index; ?>].image" />
<?php endforeach; ?>
Twig
{% 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.