본문으로 건너뛰기

MediaPlaceholder

MediaPlaceholder 컴포넌트는 블록에 미디어 항목을 추가할 수 있는 플레이스홀더를 제공합니다. core/image 블록에서도 같은 컴포넌트를 사용합니다. 이 컴포넌트는 이름이 같은 React 컴포넌트를 기반으로 합니다.

기본 사용법

MediaPlaceholder을 가장 기본적인 형태로 사용하려면 block.json에 적절한 속성을 추가하고 블록에 MediaPlaceholder 컴포넌트를 추가해야 합니다.

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

미디어 파일을 선택하면 MediaPlaceholder 컴포넌트는 더 이상 렌더링되지 않습니다.

속성

수락

FormFileUpload에 전달되는 문자열로, 브라우저가 업로드 창에 허용할 파일 유형을 지정합니다. 브라우저는 e.g을 사용합니다. 예: image/* 또는 video/*. 이 문자열에 관한 자세한 내용은 MDN 문서에서 확인할 수 있습니다.

allowedTypes

미디어 라이브러리에서 업로드하거나 선택할 미디어 유형의 배열입니다. 각 유형은 일반 MIME 유형 e.g(image, audio, text) 또는 완전한 MIME 유형 e.g(예: audio/mpeg, image/gif)을 포함하는 문자열입니다. allowedTypes가 설정되지 않으면 모든 MIME 유형이 허용됩니다.

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

true이면 MediaUpload 컴포넌트가 해당 플랫폼의 선택기를 자동으로 엽니다.

disableDropZone

true이면 드롭 영역이 렌더링되지 않습니다. 사용자는 컴포넌트나 블록으로 미디어를 끌어다 놓을 수 없습니다. 파일, URL 또는 미디어 라이브러리를 통해 미디어를 업로드하는 UI 컨트롤은 그대로 표시됩니다.

dropZoneUIOnly

true이면 드롭 영역만 렌더링됩니다. 미디어 업로드용 UI 컨트롤은 표시되지 않습니다. disableDropZone 속성이 dropZoneUIOnly보다 우선하므로 둘 다 true로 지정하면 아무것도 렌더링되지 않습니다.

아이콘

제목 왼쪽에 표시할 Dashicon입니다.

isAppender

true이면 파일이 이미 있는 집합(e.g 등)에 새 파일을 추가하는 갤러리 같은 상황에 맞게 플레이스홀더 모양이 바뀝니다. false이면 기본 플레이스홀더 스타일을 사용합니다.

disableMediaButtons

true이면 드롭 영역만 렌더링됩니다. 미디어 업로드용 UI 컨트롤은 표시되지 않습니다.

레이블

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

반복 필드

MediaPlaceholder는 반복 필드 안에서도 작동합니다. 올바른 행을 지정하려면 루프 인덱스를 사용한 대괄호 표기법을 사용하세요.

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

attribute 값은 repeaterId[index].fieldId 패턴을 따릅니다. 여기서 index는 루프의 0부터 시작하는 행 번호입니다.