MediaPlaceholder
MediaPlaceholder 컴포넌트는 블록에 미디어 항목을 추가할 수 있는 플레이스홀더를 제공합니다. core/image 블록에서도 같은 컴포넌트를 사용합니다. 이 컴포넌트는 이름이 같은 React 컴포넌트를 기반으로 합니다.
기본 사용법
MediaPlaceholder을 가장 기본적인 형태로 사용하려면 block.json에 적절한 속성을 추가하고 블록에 MediaPlaceholder 컴포넌트를 추가해야 합니다.
{
"$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 %}
미디어 파일을 선택하면 MediaPlaceholder 컴포넌트는 더 이상 렌더링되지 않습니다.
속성
수락
FormFileUpload에 전달되는 문자열로, 브라우저가 업로드 창에 허용할 파일 유형을 지정합니다. 브라우저는 e.g을 사용합니다. 예: image/* 또는 video/*. 이 문자열에 관한 자세한 내용은 MDN 문서에서 확인할 수 있습니다.
allowedTypes
미디어 라이브러리에서 업로드하거나 선택할 미디어 유형의 배열입니다. 각 유형은 일반 MIME 유형 e.g(image, audio, text) 또는 완전한 MIME 유형 e.g(예: audio/mpeg, image/gif)을 포함하는 문자열입니다. allowedTypes가 설정되지 않으면 모든 MIME 유형이 허용됩니다.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
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
<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') }}" />
반복 필드
MediaPlaceholder는 반복 필드 안에서도 작동합니다. 올바른 행을 지정하려면 루프 인덱스를 사용한 대괄호 표기법을 사용하세요.
{
"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 %}
attribute 값은 repeaterId[index].fieldId 패턴을 따릅니다. 여기서 index는 루프의 0부터 시작하는 행 번호입니다.