Hoppa till innehåll

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.

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 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

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

Twig

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

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') }}" />

Repeaterfält

MediaPlaceholder fungerar i repeaterfält. Använd hakparentesnotation med loopens index för att välja rätt rad.

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ärdet attribute följer mönstret repeaterId[index].fieldId, där index är det nollbaserade radnumret från loopen.