본문으로 건너뛰기

미디어

테마 이미지는 미디어 라이브러리 외부에 있으므로 WordPress는 이미지 크기를 알지 못하고 스타일이 적용되지 않은 이미지는 로드되는 동안 레이아웃을 이동시킵니다. Blockstudio는 생성된 메타데이터 매니페스트, 실제 크기를 항상 출력하는 템플릿 헬퍼, 선택적 지연 로더로 이 문제를 해결합니다.

이미지 렌더링

bs_media_image()는 테마 에셋을 실제 너비와 높이, 예약된 종횡비와 함께 렌더링합니다.

PHP
<?php
echo bs_media_image([
    'src' => 'assets/images/hero.webp',
    'alt' => 'Hero',
    'class' => 'hero-media',
    'sources' => [
        ['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
    ],
]);
?>

출력은 실제 width, height, loading 및 decoding 값이 지정된 img 주위에 인라인 aspect-ratio이 있는 figure.blockstudio-media입니다.

src는 테마 기준 경로, 절대 경로 또는 전체 URL를 받으며, attachmentId는 미디어 라이브러리 이미지를 처리합니다. eager은 페이지 상단 영역에서 지연 로딩을 비활성화하고, sources는 지정한 대체 항목이 있는 <picture> 요소를 출력합니다.

메타데이터가 있으면 헬퍼는 알려진 너비, 높이 및 종횡비 값을 항상 출력합니다. 지연 모드는 blockstudio-* 클래스, 속성, 핸들 및 전역 변수만 사용합니다.

메타데이터 매니페스트

크기 정보는 assets/media.json에서 가져옵니다. 빌드 단계에서 Blockstudio\Media_Metadata_Builder로 생성하거나 직접 작성할 수 있습니다.

PHP
use Blockstudio\Media_Metadata_Builder;

(new Media_Metadata_Builder())->write(
    get_stylesheet_directory(),
    true
);

이 명령은 테마 에셋의 결정적 메타데이터를 기록하며, 두 번째 인수를 사용하면 선택적으로 WordPress 첨부 파일도 포함합니다. assets/ 아래의 파일이 변경될 때마다 다시 생성하세요.

Media_Metadata_Builder::build( string $root )는 매니페스트를 기록하지 않고 반환하며, write()은 이를 저장하는 변형입니다. Blockstudio\Media_Metadata::reset()는 프로세스 내 캐시를 지웁니다. 최신 메타데이터를 사용해 렌더링하기 전에 이 작업이 필요한 장기 실행 빌드 프로세스가 있습니다.

지연 로딩

performance.media 설정이 프런트엔드 로더를 제어합니다.

JSON
{
  "performance": {
    "media": {
      "lazy": true,
      "skeleton": true,
      "metadata": true,
      "rootMargin": "300px"
    }
  }
}

lazy이 켜져 있으면 실제 URL가 올바른 크기의 자리 표시자 뒤에 있는 data-src로 이동하고, Blockstudio의 교차 기반 로더가 이미지가 뷰포트에 가까워지면 이를 표시하며 rootMargin는 미리 로드합니다. skeleton는 기본 제공 로딩 자리 표시자를 표시하고, metadata은 assets/media.json을 사용 중임을 선언합니다.

speed 및 strict 성능 프로필은 기본적으로 로더를 활성화하고, compat에서는 비활성화합니다. 각 하위 값은 프로필 기본값을 재정의할 수 있습니다.

설정

전체 performance.media 옵션 표입니다.

정적 프리렌더링

미디어 메타데이터는 프로덕션 적용 순서의 두 번째 단계입니다.