본문으로 건너뛰기

에셋

Blockstudio은 블록에 제로 설정 에셋 파이프라인을 제공합니다. 블록 옆에 CSS, SCSS 또는 JavaScript 파일을 두면 자동으로 컴파일하고 최소화한 뒤 등록합니다.

  • 에셋 등록: 파일 이름 규칙 및 등록 동작
  • 처리: SCSS 컴파일, ES 모듈 가져오기 및 최소화
  • 코드 필드: 코드 필드 유형을 통한 인라인 코드 편집

블록의 에셋 확인

bs_block_assets('theme/card')은 등록된 Blockstudio 블록에서 검색된 프런트엔드 및 편집기 캔버스 에셋을 반환합니다. 블록 등록 후 init부터 호출하세요. 알 수 없는 블록, Blockstudio이 아닌 블록, 에셋이 없는 블록은 []를 반환합니다. 이 헬퍼는 블록을 렌더링하거나, 무언가를 대기열에 추가하거나, 컴파일을 실행하지 않습니다.

PHP
$assets = bs_block_assets('theme/card');

// Each entry has this shape:
[
  'type' => 'style',
  'handle' => 'blockstudio-theme-card-style-css',
  'url' => '/wp-content/blockstudio/cache/.../style-123.css?ver=123',
  'inline' => false,
  'scope' => ['frontend', 'editor'],
  'html' => '<link ...>',
];
  • type은 CSS에서 style이고 JavaScript에서 module입니다. Blockstudio의 파일 기반 JavaScript 에셋은 인라인 스크립트를 포함해 ES 모듈을 사용합니다.
  • handle은 Blockstudio의 렌더러와 blockstudio/assets/disable 필터에서 사용하는 안정적인 에셋 식별자입니다. WordPress에 대기열에 추가할 필요는 없습니다.
  • url은 기존 컴파일된 에셋의 버전을 포함한 확인된 URL이며, 컴파일된 파일이 없으면 소스 URL입니다. 인라인 에셋에서는 null입니다.
  • inline는 인라인 <style>/<script> 출력과 외부 파일을 구분합니다.
  • scope은 에셋이 적용되는 컨텍스트를 나열합니다. 공유 파일에는 frontend와 editor이, 보기/편집기 파일에는 둘 중 하나만 표시됩니다.
  • html에는 일반 에셋 렌더러에서 바로 사용할 수 있는 태그가 포함됩니다. 인라인 콘텐츠, 범위가 지정된 CSS, UI 스타일 레이어, 렌더링 시점의 비활성화 필터는 일반 블록 출력과 동일하게 처리됩니다.

누락되었거나 비어 있거나 비활성화되었거나 컴파일되지 않은 SCSS 파일은 제외됩니다. WordPress-enqueued 관리자 및 블록 편집기 상위 문서 에셋은 제외됩니다. 목록에는 해당 블록에서 자체적으로 발견된 파일만 포함됩니다. 종속성 전체를 포함하는 목록은 아닙니다. 중첩 블록, 코드 필드 값, WordPress-enqueued 핸들, 모듈 CSS 가져오기, Tailwind, 공유 UI/Interactivity 런타임은 렌더링된 콘텐츠에 따라 달라질 수 있습니다. 완전한 자체 포함 미리보기를 보려면 Render::document()확인을 사용하세요. 등록된 필드 정의를 살펴보려면 bs_block_fields()를 사용하세요.