본문으로 건너뛰기

Dennis · 2026년 5월 19일

Blockstudio 7.3

Blockstudio 7.3에서는 프레임워크에 새로운 기능을 더합니다. 다른 블록처럼 렌더링할 수 있는 재사용 가능한 UI 구성 요소입니다.

7.1에서는 블록을 풀스택 애플리케이션으로 발전시켰고 7.2에서는 규모가 큰 프로젝트를 더 쉽게 검사하고 검증하고 배포할 수 있게 했습니다. 7.3은 이러한 애플리케이션을 만들고 편집하는 일상의 경험에 초점을 맞춥니다.

간단히 요약하면:

  • UI 구성 요소: WordPress Interactivity API 기반의 번들형 선택 구성 요소 라이브러리 bsui/*.
  • 앱: UI 구성 요소가 더 큰 인터페이스로 조합되는 방식을 보여 주는 번들형 app/* 예제입니다.
  • 확장 편집기: 사이드바가 너무 비좁을 때 Blockstudio 필드를 편집할 수 있는 더 넓은 드로어입니다.
  • 범위가 지정된 에셋 선택자: CSS 및 SCSS 에셋에서 %selector%를 사용해 블록 래퍼 클래스를 직접 선택할 수 있습니다.
  • 플러그인 종속성: 블록에서 활성 WordPress 플러그인을 요구할 수 있으며, 버전 제약 조건도 선택적으로 지정할 수 있습니다.
  • 편집기 정책: blockstudio.json는 WordPress의 PHP 기반 편집기 훅을 사용해 전역 블록, 패턴, 미디어 동작을 구성할 수 있습니다.
  • 블록 태그 별칭: 블록 태그 작성에 사용할 사용자 지정 별칭입니다.
  • 정적 분석 및 문서: 외부 블록 라이브러리의 PHPStan 적용 범위를 개선하고 설정 및 훅 문서를 생성합니다.
  • 페이지 및 편집기 수정: 파일 기반 페이지 파싱, Tailwind 후보 감지, 초기화 모드, 렌더링 캐시 분리, 편집기 사전 로드의 안정성을 높였습니다.

UI 라이브러리

7.3에는 번들형 구성 요소 라이브러리와 이를 기반으로 만든 예제 앱이 포함되어 있습니다.

UI 구성 요소

Blockstudio 7.3에는 bsui/* 네임스페이스에 번들형 UI 라이브러리가 포함되어 있습니다. 구성 요소는 일반 Blockstudio 블록이므로, 이미 사용 중인 블록 태그 문법으로 템플릿, 파일 기반 페이지, 패턴, 글 콘텐츠에서 렌더링할 수 있습니다.

UI 구성 요소 라이브러리는 더 많은 의견을 수렴하는 동안 베타로 제공됩니다. 7.3의 목표는 첫 구성 요소 세트를 공개하고 실제 프로젝트에서 피드백을 얻어, API 인터페이스가 안정적이라고 선언하기 전에 이름, 동작, 기본값을 다듬는 것입니다.

라이브러리는 선택적으로 사용할 수 있습니다:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}

활성화한 뒤에는 간단한 구성 요소를 바로 렌더링할 수 있습니다:

HTML
<block name="bsui/button" label="Save" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
  name="bsui/input"
  nameAlt="email"
  type="email"
  placeholder="Email"
></block>

더 짧은 bs: 문법도 사용할 수 있습니다:

HTML
<bs:bsui-button label="Save" variant="default" />

Blockstudio를 페이지 빌더 UI 키트로 만들려는 것이 아닙니다. 일반적인 인터페이스 기본 요소를 블록으로 제공해, Blockstudio로 만든 애플리케이션이 프로젝트마다 버튼, 대화상자, 탭, 선택 상자, 양식 필드, 메뉴, 도구 모음, 피드백 구성 요소를 다시 만들 필요가 없도록 하는 것이 목표입니다.

첫 구성 요소 세트에는 레이아웃, 동작, 입력, 오버레이, 탐색, 피드백, 양식, 데이터 표시를 위한 기본 요소가 포함됩니다:

  • bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar
  • bsui/input, bsui/textarea, bsui/select, bsui/checkbox, bsui/radio-group, bsui/slider, bsui/switch, bsui/number-field, bsui/password-input, bsui/phone-input, bsui/otp-input, bsui/date-input, bsui/time-picker
  • bsui/dialog, bsui/drawer, bsui/popover, bsui/menu, bsui/context-menu, bsui/menubar, bsui/tooltip, bsui/alert-dialog
  • bsui/tabs, bsui/accordion, bsui/breadcrumb, bsui/pagination, bsui/navigation-menu
  • bsui/card, bsui/table, bsui/stack, bsui/separator, bsui/aspect-ratio, bsui/badge, bsui/avatar, bsui/progress, bsui/meter, bsui/skeleton, bsui/spinner, bsui/kbd
  • bsui/form, bsui/field, bsui/field-group, bsui/file-upload, bsui/color-picker, bsui/rating

이 가운데 상당수는 복합 블록입니다. bsui/tabs 블록이 대화형 상태를 관리하고, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel 같은 자식 블록이 구조를 나타냅니다.

HTML
<block name="bsui/tabs" defaultValue="features">
  <block name="bsui/tabs-list">
    <block name="bsui/tabs-trigger" value="features" title="Features"></block>
    <block name="bsui/tabs-trigger" value="pricing" title="Pricing"></block>
  </block>
  <block name="bsui/tabs-panel" value="features">
    <p>Features content.</p>
  </block>
  <block name="bsui/tabs-panel" value="pricing">
    <p>Pricing content.</p>
  </block>
</block>

덕분에 마크업을 읽기 쉽게 유지하면서 상태와 동작은 Interactivity API에서 처리할 수 있습니다.

앱 예제

app/* 네임스페이스에는 동일한 UI 구성 요소로 만든 예제가 포함되어 있습니다.

별도의 프레임워크가 아닙니다. 더 큰 Blockstudio 인터페이스를 위한 참조 구현입니다. 복합 블록, 중첩된 UI, Interactivity API 상태, UI 구성 요소가 RPC 또는 데이터베이스 기반 기능과 함께 사용되는 상황을 보여 줍니다.

HTML
<block name="app/kitchen-sink"></block>

<block name="app/chat">
  <block name="app/chat-sidebar"></block>
  <block name="app/chat-header"></block>
  <block name="app/chat-messages"></block>
  <block name="app/chat-input"></block>
</block>

UI 라이브러리에는 자체 문서와 실시간 구성 요소 참조도 포함됩니다. 구성 요소 동작은 단순히 템플릿 모음에 그치지 않습니다. 프레임워크의 계약 일부이며, 라이브러리가 확장되어도 일관성을 유지합니다.

작성 및 편집

몇 가지 변경으로 블록을 더 쉽게 작성하고 편집할 수 있습니다.

확장 편집기

검사기 사이드바에서 복잡한 블록을 편집하다 보면 금세 공간이 부족해집니다. 반복 필드, 코드 필드, 서식 있는 텍스트, 중첩 그룹에서 특히 그렇습니다.

Blockstudio 7.3에서는 블록 검사기에 확장 편집기 동작을 추가했습니다. 편집기 오른쪽에서 더 넓은 드로어를 열고 동일한 Blockstudio 필드를 표시합니다.

중요한 점은 여전히 동일한 필드 시스템을 사용한다는 것입니다. 필드 렌더링을 복제하지 않고, 별도의 저장 경로를 도입하지도 않습니다. 확장 편집기에서 변경하면 일반 사이드바에서 변경한 것처럼 선택된 블록이 업데이트됩니다.

사이드바에서 내용을 훑어보기는 편하지만 실제 입력을 하기에는 비좁을 때 사용하세요.

범위가 지정된 에셋 선택자

Blockstudio은 이미 코드 필드에 %selector% 지원을 제공했습니다. 7.3에서는 블록 CSS 및 SCSS 에셋에도 같은 작성 방식을 적용할 수 있습니다.

CSS 파일에서 %selector%는 블록의 범위가 지정된 클래스로 확장됩니다:

CSS
%selector% {
  --hero-gap: var(--wp--preset--spacing--space-10);
}

%selector%.hero {
  border-bottom: 1px solid currentColor;
}

.hero__title {
  color: red;
}

이 기능을 사용하면 실제 래퍼 요소에 스타일을 지정할 수 있습니다:

PHP
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Hero</h1>
</section>

*.scoped.css의 일반 선택자는 계속 하위 요소를 대상으로 합니다. %selector%는 블록 루트를 대상으로 하는 명시적 훅입니다.

플러그인 종속성

이제 블록의 block.json blockstudio 키 안에 WordPress 플러그인 종속성을 선언할 수 있습니다.

간단한 형식은 나열된 모든 플러그인 슬러그가 활성 상태인지 확인합니다:

JSON
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}

객체 형식에서는 버전 제약 조건을 추가할 수 있습니다:

JSON
{
  "blockstudio": {
    "pluginDependencies": {
      "woocommerce": {
        "version": ">6"
      }
    }
  }
}

식별자는 WordPress 플러그인 슬러그이며, WordPress 코어의 플러그인 종속성 시스템과 일치합니다. Blockstudio는 활성 플러그인을 해당 슬러그로 확인하고, 필요한 플러그인이 없거나 비활성 상태이거나 요구 버전보다 낮으면 등록을 건너뜁니다.

버전 제약 조건은 PHP의 version_compare()과 동일한 비교 모델을 사용합니다. "6" 같은 일반 버전은 >=6로 취급됩니다.

플러그인이 제공될 때만 의미가 있는 블록에 유용합니다. WooCommerce 상품 카드, 양식 통합, SEO 통합, 멤버십 구성 요소, 예약 위젯, 타사 플러그인에 연결된 관리자 UI 등이 있습니다.

편집기 정책

blockstudio.json 파일은 프로젝트 수준의 편집기 정책 파일로도 점점 더 유용해지고 있습니다.

7.3에서는 PHP 기반 blockEditor 정책 레이어를 추가했습니다. WordPress가 서버 측 훅으로 이미 제공하는 설정을 다룹니다. 따라서 일회성 테마 연결 코드를 추가하지 않고도 전역 삽입기, 패턴, 미디어 동작을 정의할 수 있습니다.

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      }
    },
    "patterns": {
      "core": false,
      "remote": false,
      "categories": {
        "deny": ["gallery"],
        "order": ["featured", "buttons"]
      }
    },
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"]
      }
    }
  }
}

첫 단계에서는 의도적으로 PHP에서 지원하는 기능에만 집중합니다. 허용 및 차단 블록, 블록 디렉터리 로드, 삽입기 카테고리 레이블 및 순서, 패턴 소스와 카테고리, Openverse, 이미지 크기 선택, 레거시 위젯 표시 여부, PHP에 등록된 블록 스타일 제거가 포함됩니다.

임의의 코어 블록 기본값을 다시 쓰려는 기능은 아닙니다. core/columns.isStackedOnMobile 같은 설정은 블록 편집기의 JavaScript 등록 흐름에 있으므로, 이를 JSON 파일에 억지로 넣는 대신 더 명시적인 별도의 API가 필요합니다.

블록 태그 별칭

블록 태그에 별칭 필터가 추가되었습니다:

PHP
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
    $aliases['theme-button'] = 'bsui/button';
    return $aliases;
});

이 기능을 사용하면 프로젝트에서 작성하기 편한 태그를 정의하면서도 내부적으로는 표준 블록 이름으로 처리할 수 있습니다.

HTML
<bs:theme-button label="Continue" />

표준 블록 이름은 맞지만 작성하기에 늘 편리한 것은 아닌, UI가 많이 쓰이는 템플릿을 구성할 때 특히 유용합니다.

도구 및 안정성

정적 분석, 안정성, 성능 도구가 모두 개선되었습니다.

정적 분석 및 문서 생성

PHPStan 확장 기능에서 외부 블록 라이브러리의 명시적인 검색 루트를 지원합니다. 이를 통해 프로젝트는 현재 플러그인이나 테마 밖에 있는 블록에 대해서도 <bs:*> 및 <block> 태그를 검증할 수 있으며, 분석 시에는 해당 루트를 레지스트리 전용으로 유지합니다.

페이지 메타데이터와 pluginDependencies에 대한 스키마 검사도 확장되어, 잘못된 릴리스 시점 설정을 WordPress에 도달하기 전에 더 쉽게 감지할 수 있습니다.

이제 문서 생성에 설정 및 PHP 훅의 필터 참조가 포함됩니다. blockstudio.json가 흩어진 몇 가지 토글이 아니라 실제 프로젝트 정책 파일로 쓰이게 되면서 이 기능의 중요성이 커졌습니다.

페이지 및 편집기 안정성

7.3에는 파일 기반 페이지, 편집기 렌더링, 초기화 모드와 관련한 여러 수정 사항도 포함되어 있습니다.

파일 기반 페이지 파싱이 HTML 파싱 중 속성을 인식하는 사용자 지정 컨테이너 매핑을 이제 처리합니다. bs: 페이지 태그도 하이픈이 포함된 블록 네임스페이스를 올바르게 확인하므로, custom-theme/card 같은 이름도 더는 파서를 혼란스럽게 하지 않습니다.

일반 비코어 컨테이너 태그는 래퍼 마크업을 제공하지 않을 때 이제 유효한 innerContent을 직렬화합니다. 덕분에 동기화된 페이지 콘텐츠를 더 예측하기 쉬워지고 WordPress 블록 직렬화도 유효하게 유지됩니다.

편집기의 미리보기 및 사전 로드 동작을 다음과 같이 수정했습니다:

  • Tailwind 편집기 CSS에 이제 파일 기반 페이지 템플릿의 클래스 후보가 포함됩니다.
  • 편집기 사전 로드는 같은 유형의 블록이 반복될 때 RichText 래퍼 클래스를 유지합니다.
  • 편집기 사전 로드는 Gutenberg가 확장하지만 저장된 블록 마크업에서는 생략된 기본 필드 값이 있는 블록과 일치합니다.
  • Gutenberg가 확장한 등록 기본 속성은 렌더 캐시 키를 비교하기 전에 무시됩니다.
  • 편집기 미리보기 렌더와 삽입기 미리보기 렌더는 클라이언트 ID를 공유하더라도 이제 별도의 캐시 항목을 유지합니다.
  • bs_get_group()는 필드 그룹 ID가 사용자 지정 필드 이름과 일치하는 경우를 포함해 재사용된 사용자 지정 필드 그룹에서도 올바르게 작동하며, 정확한 그룹 접두사만 추출합니다.
  • withCreateSuggestion가 있는 링크 필드는 이제 WordPress LinkControl 생성 흐름을 올바르게 연결하고 REST API을 통해 임시 페이지를 생성합니다.
  • PHP 블록 템플릿은 폐기되는 사전 실행 include를 실행하는 대신 렌더마다 한 번만 실행됩니다.

재설정 모드도 개선했습니다. 이제 구성된 게시물 유형에서 Gutenberg 편집기 블록 너비 및 세로 여백 규칙을 무력화하고, 필요한 경우 WordPress iframe 콘텐츠 및 재설정 스타일을 제거하며, Blockstudio의 호버 및 선택 오버레이를 더 깔끔하게 표시합니다.

복잡한 InnerBlocks 패턴에 대한 회귀 테스트 범위도 중첩된 Blockstudio 블록을 포함하도록 확대해, 수동으로 확인하기 가장 어려운 패턴 삽입 사례를 대상으로 편집기 렌더 경로를 점검합니다.

성능 도구

로컬 익명 blockstudio-perf=1 프로브에서 디버그 패널을 삽입하지 않고도 Server-Timing 헤더를 출력할 수 있습니다.

측정 시간에는 탐색, 에셋 처리, 등록, 오버라이드를 비롯해 빌드 수명 주기의 더 많은 단계가 포함됩니다. 따라서 화면에 표시되는 프로파일링 UI을 켜지 않아도 실제로 어느 단계에 시간이 걸리는지 파악하기 쉬워집니다.

이번 릴리스가 중요한 이유

7.3의 핵심 주제는 구성입니다.

UI 구성 요소를 사용하면 애플리케이션 인터페이스를 더 쉽게 구성할 수 있습니다. 확장된 편집기로 더 큰 블록도 쉽게 편집할 수 있습니다. 플러그인 종속성을 통해 블록은 필요한 플러그인 컨텍스트를 명시할 수 있습니다. 편집기 정책을 사용하면 프로젝트 수준의 블록 편집기 규칙을 blockstudio.json로 옮길 수 있습니다. 블록 태그 별칭으로 템플릿 작성도 편리해집니다. 파서, PHPStan 및 편집기 수정으로 이러한 구성이 WordPress을 거치는 동안 더 안정적으로 작동합니다.

Blockstudio는 여전히 파일 기반입니다. 블록은 여전히 폴더에 있습니다. 템플릿은 여전히 작업을 수행합니다. 다만 이제 이 기반 위에 더 강력한 UI 계층이 추가됐습니다.