구성 요소
Blockstudio는 모든 빌드에 59 UI 구성 요소를 포함합니다. 구성 요소는 자동으로 등록되고 디자인 토큰으로 스타일이 지정되며, 다른 블록과 동일한 태그 구문으로 작성됩니다.
Blockstudio 7.3에는 WordPress 인터랙티비티 API로 구동되는 헤드리스 UI 블록 묶음이 포함되어 있습니다. 이 블록은 bsui/* 네임스페이스에 등록되며 템플릿, 파일 기반 페이지, 패턴, 글 콘텐츠에서 조합할 수 있습니다.
참고
UI 컴포넌트 세트, 이름, 동작, 프로젝트 사용 패턴에 대한 의견을 수렴하는 동안 해당 컴포넌트는 베타 버전으로 제공됩니다. 7.3에서 사용해 볼 수 있지만, 안정화로 표시되기 전에 API 인터페이스가 다듬어질 수 있습니다.
UI 컴포넌트 활성화
번들 UI 컴포넌트는 선택 기능입니다. 테마의 blockstudio.json에서 활성화하세요.
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
필터를 사용해 활성화할 수도 있습니다.
add_filter('blockstudio/settings/ui/enabled', '__return_true');
활성화하면 Blockstudio가 includes/ui/blocks의 번들 컴포넌트 라이브러리를 등록합니다.
공개 인벤토리 및 예제
번들 구현 블록은 일반 bsui/* 등록 항목으로 유지되지만, 컴포넌트 갤러리를 만들 때는 공개 패밀리 인벤토리를 사용해야 합니다.
use Blockstudio\Ui;
$families = Ui::inventory();
$examples = Ui::examples();
Ui::inventory()는 모든 복합 컴포넌트를 공개 루트별로 그룹화하고 각 패밀리에 필요한 구현 등록 항목을 나열합니다. Ui::examples()는 기본 데이터와 예시 데이터가 포함된 결정적이고 정규화된 선언을 추가합니다. 필수 루트 및 자식 관계를 유지하므로 결과를 Blockstudio\Render::document()에 바로 전달할 수 있습니다.
공개 Canvas 인벤토리는 ui 유형으로 이러한 예제를 노출하고, 일반 blocks 유형에서는 번들 구현 등록 항목을 제외합니다. 그 결과 내부 루트, 트리거, 팝업, 레이어 조각의 모음 대신 공개 컴포넌트 패밀리마다 완전한 예제 하나를 제공합니다.
이미 렌더링된 문서를 조립할 때 Ui::global_assets($block_names, $html)는 선택한 출력에서 UI 컴포넌트를 실제로 사용하는 경우에만 정확한 번들 전역 스타일과 스크립트를 반환합니다.
렌더링
일반 블록 태그 구문을 사용하세요.
<block name="bsui/button" label="Save" variant="default"></block>
더 짧은 <bs:> 구문도 사용할 수 있습니다.
<bs:bsui-button label="Save" variant="default" />
Blockstudio 템플릿에서는 블록 태그가 자동으로 렌더링됩니다. 파일 기반 페이지와 패턴에서는 네이티브 WordPress 블록으로 동기화됩니다. 글 콘텐츠나 위젯 영역에서 UI 컴포넌트를 직접 렌더링하려면 페이지 수준 블록 태그를 활성화하세요.
{
"ui": {
"enabled": true
},
"blockTags": {
"enabled": true,
"allow": ["bsui/*", "app/*"]
}
}
기본 컴포넌트
간단한 컴포넌트는 단일 블록으로 렌더링됩니다.
<block name="bsui/button" label="Continue" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
name="bsui/input"
nameAlt="email"
type="email"
placeholder="Email"
></block>
<block name="bsui/textarea" name="message" placeholder="Message"></block>
<block name="bsui/spinner"></block>
속성은 각 컴포넌트의 block.json 속성에 직접 매핑됩니다. 예를 들어 bsui/button은 label, icon, iconPosition, href, variant, size, disabled을 지원합니다.
bs_render_block([
'name' => 'bsui/button',
'data' => [
'label' => 'Continue',
'icon' => [
'set' => 'heroicons',
'subSet' => 'outline',
'icon' => 'arrow-right',
],
'iconPosition' => 'right',
],
]);
복합 컴포넌트
많은 UI 컴포넌트는 복합 블록입니다. 루트 블록이 상태를 관리하고 자식 블록이 부모를 지정합니다.
탭
<block name="bsui/tabs" defaultValue="tab1">
<block name="bsui/tabs-list">
<block name="bsui/tabs-trigger" value="tab1" title="Features"></block>
<block name="bsui/tabs-trigger" value="tab2" title="Pricing"></block>
<block name="bsui/tabs-trigger" value="tab3" title="FAQ"></block>
</block>
<block name="bsui/tabs-panel" value="tab1">
<p>Features content.</p>
</block>
<block name="bsui/tabs-panel" value="tab2">
<p>Pricing content.</p>
</block>
<block name="bsui/tabs-panel" value="tab3">
<p>FAQ content.</p>
</block>
</block>
대화상자
<block name="bsui/dialog">
<block name="bsui/dialog-trigger" label="Open Dialog"></block>
<block name="bsui/dialog-backdrop"></block>
<block name="bsui/dialog-popup">
<p>Dialog content.</p>
<block name="bsui/dialog-close" label="Close"></block>
</block>
</block>
선택 메뉴
<block name="bsui/select" placeholder="Choose a fruit" nameAlt="fruit">
<block name="bsui/select-trigger"></block>
<block name="bsui/select-popup">
<block name="bsui/select-option" value="apple" label="Apple"></block>
<block name="bsui/select-option" value="banana" label="Banana"></block>
<block name="bsui/select-option" value="cherry" label="Cherry"></block>
</block>
</block>
폼 필드
<block name="bsui/form" block="contact/form" successMessage="Thank you!">
<block name="bsui/field">
<block name="bsui/field-label" text="Email"></block>
<block name="bsui/input" nameAlt="email" type="email"></block>
<block name="bsui/field-error"></block>
</block>
</block>
사용 가능한 블록
번들 UI 라이브러리에는 다음이 포함됩니다.
| 영역 | 블록 |
|---|---|
| 레이아웃 | bsui/aspect-ratio, bsui/card, bsui/separator, bsui/stack, bsui/table |
| 동작 | bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar |
| 입력 | bsui/checkbox, bsui/color-picker, bsui/date-input, bsui/file-upload, bsui/input, bsui/number-field, bsui/otp-input, bsui/password-input, bsui/phone-input, bsui/radio-group, bsui/rating, bsui/select, bsui/slider, bsui/switch, bsui/textarea, bsui/time-picker |
| 오버레이 | bsui/alert-dialog, bsui/dialog, bsui/drawer, bsui/menu, bsui/menubar, bsui/popover, bsui/preview-card, bsui/tooltip |
| 탐색 | bsui/accordion, bsui/breadcrumb, bsui/carousel, bsui/collapsible, bsui/context-menu, bsui/navigation-menu, bsui/pagination, bsui/tabs |
| 피드백 | bsui/badge, bsui/kbd, bsui/meter, bsui/progress, bsui/skeleton, bsui/spinner, bsui/text, bsui/toast |
| 폼 | bsui/field, bsui/field-group, bsui/form |
복합 컴포넌트는 bsui/dialog-trigger, bsui/dialog-popup, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel, bsui/select-trigger, bsui/select-popup, bsui/select-option 등의 자식 블록도 노출합니다.
스타일 지정
UI 컴포넌트에는 --bs-ui-* 접두사를 사용하는 자체 CSS 사용자 지정 속성이 포함됩니다. 테마 CSS에서 재정의할 수 있습니다.
:root {
--bs-ui-radius: 0.5rem;
--bs-ui-primary: oklch(0.45 0.18 260);
--bs-ui-primary-foreground: white;
}
컴포넌트는 동작 면에서 헤드리스이지만, 바로 사용할 수 있도록 적절한 기본값을 제공합니다. 먼저 토큰을 재정의한 다음 필요한 경우 컴포넌트별 CSS를 추가하세요.
번들 컴포넌트 CSS는 이름이 지정된 bsui 캐스케이드 레이어에 출력됩니다. 레이어가 없는 테마 CSS는 !important 없이 컴포넌트 규칙을 재정의할 수 있습니다.
.button-brand {
background: var(--brand-primary);
}
사용자 지정 bsui/button 변형을 추가하려면 기존 속성 필터로 선택 옵션을 추가하고 blockstudio/ui/button/variants-style를 사용해 변형 CSS을 제공하세요.
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
if (($block['name'] ?? '') === 'bsui/button' && ($attribute['id'] ?? '') === 'variant') {
$attribute['options'][] = [
'label' => 'Brand',
'value' => 'brand',
];
}
return $attribute;
}, 10, 2);
add_filter('blockstudio/ui/button/variants-style', function($css) {
return $css . '
[data-bsui-button][data-variant="brand"] {
background: var(--brand-primary);
color: white;
}';
});
관련 항목
- UI 구성(제어 필드, 필드 카드, 툴바 구분선 포함)
- 프로그래밍 방식 렌더링
- 컴포넌트
- 상호작용API