본문으로 건너뛰기

구성 요소

구성

번들 UI 컴포넌트는 하나씩 사용하는 것이 아니라 조합해 사용하도록 설계되었습니다. 선택 메뉴는 대화상자 안에서 열리고, 양식은 드로어 안에서 유효성을 검사하며, 메뉴는 테이블 행에 표시됩니다. 이 페이지에서는 이러한 연결이 작동하는 원리를 설명합니다. 복합 컴포넌트 계열의 구조, 트리거가 버튼 속성을 전달하는 방식, Interactivity API가 내부에서 하는 일, 그리고 겹쳐진 표면을 일관되게 유지하는 레이어링 모델을 살펴봅니다.

복합 컴포넌트 계열

복합 컴포넌트는 루트 블록과 자식 블록으로 구성됩니다. 루트가 상태를 소유하며, 각 자식은 block.json의 parent 및 usesContext을 통해 계열 내 위치를 선언합니다:

JSON
{
  "name": "bsui/select-option",
  "parent": ["bsui/select-popup"],
  "usesContext": ["bsui/select"]
}

루트는 InnerBlocks 영역과 allowedBlocks 목록, 시작 template를 제공하므로 편집기에 대화상자를 삽입하면 트리거, 배경, 팝업의 기본 구조가 만들어집니다. 또한 편집기, 파일 기반 페이지, 태그 어디에서 구성하든 계열의 동작은 동일합니다:

HTML
<bs:bsui-select name="role" placeholder="Pick a role">
  <bs:bsui-select-trigger />
  <bs:bsui-select-popup>
    <bs:bsui-select-option value="viewer" label="Viewer" />
    <bs:bsui-select-option value="editor" label="Editor" />
  </bs:bsui-select-popup>
</bs:bsui-select>

팝업과 패널은 특수 구문을 사용하는 슬롯이 아니라 실제 InnerBlocks 영역입니다. bsui/dialog-popup는 그룹 블록과 같은 방식으로 중첩 블록을 허용하므로, 그 안에 양식이나 선택 메뉴, 다른 대화상자를 넣어도 일반적인 구성 작업입니다.

평면 데이터 또는 조합된 자식 요소

일부 계열은 자식 요소 대신 데이터를 콘텐츠로 받습니다. options JSON 배열을 전달하면 선택 메뉴가 자체 트리거와 목록 상자를 렌더링하므로 PHP에서 가져온 옵션에 적합합니다:

PHP
bs_render_block([
  'name' => 'bsui/select',
  'data' => [
    'name' => 'role',
    'placeholder' => 'Pick a role',
    'options' => wp_json_encode([
      ['value' => 'viewer', 'label' => 'Viewer'],
      ['value' => 'editor', 'label' => 'Editor'],
    ]),
  ],
]);

두 형식은 동일한 마크업 계약과 런타임 동작을 생성합니다. 구조를 직접 작성하는 경우에는 자식 요소를, 계산되는 경우에는 options를 사용합니다.

트리거 전달

오버레이 컴포넌트는 버튼을 통해 열리며, 해당 버튼은 시스템 버튼이어야 합니다. 트리거가 각자 버튼을 다시 구현하는 대신 bsui/dialog, bsui/alert-dialog, bsui/drawer, bsui/menu, bsui/popover, bsui/collapsible, bsui/tooltip의 트리거 블록은 bsui/button를 block 필드를 통해 포함합니다:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "trigger",
        "type": "block",
        "block": "bsui/button",
        "idStructure": "trigger_{id}"
      }
    ]
  }
}

idStructure는 버튼의 필드를 trigger_ 접두사를 붙여 트리거에 확장합니다. trigger_label, trigger_variant, trigger_size, trigger_icon, trigger_iconPosition, trigger_href, trigger_disabled 등 모든 버튼 속성을 사용할 수 있습니다.

HTML
<bs:bsui-dialog-trigger trigger_label="Invite teammate" trigger_variant="outline" />

트리거 템플릿에서 $a['trigger']는 완전히 렌더링된 버튼이므로 버튼의 스타일시트와 향후 개선 사항도 함께 적용됩니다. 런타임에는 공유 도우미가 래퍼의 ARIA 연결(aria-haspopup, aria-expanded, aria-controls, aria-describedby, aria-labelledby, id)을 내부 버튼에 전달하고 MutationObserver를 통해 동기화 상태를 유지하므로 보조 기술이 하나의 일관된 컨트롤로 인식합니다.

내부 Interactivity API

모든 인터랙티브 계열은 루트 블록 이름을 딴 WordPress Interactivity API 저장소입니다. bsui/dialog, bsui/select, bsui/form, bsui/tabs 등이 있습니다. 여기서 세 가지 결과가 나옵니다.

상태는 서버 측에서 초기화됩니다. 루트 템플릿은 블록 속성에서 초기 상태를 그대로 data-wp-context로 출력합니다:

HTML
<div
  data-wp-interactive="bsui/select"
  data-wp-context='{"open":false,"value":"","placeholder":"Pick a role", ...}'
  data-bsui-select-root
>

첫 렌더링은 정확하며 HTML 클라이언트 측 하이드레이션으로 인한 깜박임이 없고, 팝업은 hidden 시작됩니다. 컨텍스트가 프런트엔드 전용 상태 처리에 의존하지 않으므로 편집기 캔버스에서도 동일한 마크업이 작동합니다.

동작은 사용자의 JavaScript가 아니라 디렉티브로 연결됩니다. 템플릿은 마크업을 선언적으로 저장소에 연결합니다. PHP가 제거된 선택 메뉴의 트리거는 디렉티브만으로 구성됩니다:

HTML
<button
  data-wp-interactive="bsui/select"
  data-wp-on--click="actions.toggle"
  data-wp-on--keydown="actions.handleTriggerKeyDown"
  data-wp-bind--aria-expanded="state.ariaExpanded"
  data-wp-text="state.displayValue"
  data-bsui-select-trigger
  aria-haspopup="listbox"
>

data-wp-on는 이벤트를 액션으로 전달하고, data-wp-bind는 파생 상태와 속성을 동기화하며, data-wp-text는 상태를 텍스트로 렌더링하고, data-wp-on-document--click는 루트에 외부 클릭 시 닫기 기능을 제공합니다. 컴포넌트를 조합할 때 이벤트 핸들러를 작성할 필요가 없습니다. 저장소는 인라인 모듈로 블록과 함께 제공됩니다.

사용자의 저장소를 연결 지점에 연결할 수 있습니다. 양식 컨트롤은 속성으로 디렉티브 표현식을 받고, Interactivity API의 네임스페이스 구문으로 이를 원하는 저장소에 연결합니다. onChange는 변경 처리를 사용자의 액션 하나로 전달하고, checked는 컨트롤 상태를 사용자의 상태에 바인딩하며, bindText는 레이블을 임의의 상태 경로에 바인딩된 data-wp-text 범위로 렌더링합니다:

HTML
<bs:bsui-switch label="Notifications" checked="myPlugin::state.notifications" onChange="myPlugin::actions.toggleNotifications" />
<bs:bsui-checkbox label="0 selected" bindText="myPlugin::state.selectionSummary" />

bindText는 bsui/label, bsui/checkbox, bsui/switch, bsui/toggle, bsui/radio-group 항목에서 사용할 수 있습니다. 체크박스, 스위치, 라디오 항목에서는 공유 레이블 기본 요소로 전달되므로 상태에 따라 바뀌는 텍스트에도 시스템 레이블의 서체가 정확히 적용됩니다. 선택 메뉴와 다른 입력은 루트에서 버블링되는 change 이벤트도 디스패치하며, 새 값은 detail에 담겨 상위 수준의 통합에 사용할 수 있습니다.

제어되는 값

자체적으로 값을 관리하는 컨트롤이라면 value 또는 checked를 설정하지 마세요. 초기 선택값에는 defaultValue, defaultChecked 또는 Toggle의 defaultPressed를 사용하세요. 독립형 Toggle은 소비자 스토어 없이 포인터와 키보드 입력을 처리합니다.

자체 스토어에서 필드를 제어하려면 바인딩과 바인딩된 값을 업데이트하는 onChange 액션을 모두 제공하세요. value는 리터럴 기본값이 아니라 디렉티브 경로입니다. Input, Textarea, Password Input, Number Field, Slider, Radio Group, Color Picker, Rating, Time Picker는 value를 지원합니다. Checkbox, Switch, Toggle에는 대신 checked를 사용하세요.

경로에 소유 네임스페이스를 지정하세요. 예: my/settings::context.quantity 또는 my/settings::state.quantity. 복합 컨트롤에는 자체 네임스페이스가 있습니다. 네임스페이스를 지정하지 않은 경로는 부모 스토어가 아니라 해당 컨트롤을 가리킵니다. 복합 값 바인딩은 컨텍스트 또는 상태 내부의 점 표기 경로와 숫자 배열 키를 지원하지만, JavaScript 표현식이나 함수 호출은 지원하지 않습니다.

다음은 Interactivity API 지원을 활성화한 사용자 지정 블록에서 Number Field를 바인딩하는 전체 예시입니다.

PHP
<div
  data-wp-interactive="my/settings"
  data-wp-context='<?php echo esc_attr(wp_json_encode(['quantity' => 2])); ?>'
>
  <bs:bsui-number-field
    nameAlt="quantity"
    defaultValue="2"
    value="my/settings::context.quantity"
    onChange="my/settings::actions.setQuantity"
  />
  <output data-wp-text="context.quantity"></output>
</div>
JavaScript
import { getContext, store } from '@wordpress/interactivity';

store('my/settings', {
  actions: {
    setQuantity(event) {
      // Compound controls publish their normalized value in a custom change event.
      if (event.detail?.value !== undefined) {
        getContext().quantity = event.detail.value;
      }
    },
  },
});

서버 렌더링 초기값에도 일치하는 기본값을 설정하세요. 하이드레이션이 끝나면 0, false, 빈 값을 포함해 부모 값이 변경될 때마다 바인딩된 모든 인스턴스가 업데이트됩니다. Checkbox와 Switch의 숨겨진 폼 입력도 checked 바인딩을 따릅니다. Time Picker 값은 24시간 형식의 HH:MM 또는 빈 문자열을 사용합니다. 기본 Input, Textarea, Password Input 핸들러에서는 event.target.value를 읽으세요. 복합 값 컨트롤은 event.detail.value를 게시합니다. Number Field의 경계값은 선택 사항입니다. min와 max를 생략하면 제한이 없으며, 0을 명시해도 유효한 경계값입니다.

Select, Date Input, Phone Input, OTP Input은 onChange를 통해 변경 사항을 게시하지만, 이 제어형 value 바인딩은 노출하지 않습니다. 초기값에는 문서화된 기본값 속성을 사용하세요.

자체 블록에서 구성하기

구성은 페이지에만 국한되지 않습니다. 블록 태그는 블록 템플릿 안에서 자동으로 렌더링되므로 프로젝트 블록에서 bsui 컴포넌트를 바로 출력하고 자체 구조로 감쌀 수 있습니다:

PHP
<div useBlockProps class="settings-panel">
  <bs:bsui-switch label="Public profile" name="public" />
  <bs:bsui-space size="4" />
  <bs:bsui-button label="Save" variant="default" />
</div>

bs_block()와 PHP를 사용하는 경우에도 마찬가지이며, content 키를 통한 중첩도 가능합니다. 자세한 내용은 프로그래밍 방식 렌더링을 참조하세요. 어느 방식이든 컴포넌트의 스타일시트와 저장소가 함께 로드되므로 사용자 블록은 시스템 구성 요소를 배치하는 얇은 계층으로 유지됩니다.

컴포넌트를 나란히 배치할 때 bsui/stack는 일반적인 플렉스 행 또는 열입니다. direction, 간격 배율의 gap, align, justify, wrap 토글을 사용할 수 있습니다. 기본적으로 자식 요소는 자연 크기를 유지하며, grow 토글을 사용하면 동일한 스택 길이를 공유하도록 늘어납니다. 이 기능을 사용하면 바닥글에서 버튼 두 개가 한쪽 끝에 모이지 않고 너비를 똑같이 나눠 갖습니다.

필드 그룹 및 카드

bsui/field-group는 fieldset을 렌더링합니다. 기본 variant는 표면을 추가하지 않고 관련 필드를 그룹화합니다. variant="card"를 사용해 바깥쪽에 은은한 프레임을 만든 다음, 필드를 bsui/field-group-content 안에 배치해 안쪽 콘텐츠 표면을 만드세요. 제목과 설명은 해당 콘텐츠 블록 바깥에 두세요:

HTML
<bs:bsui-field-group variant="card">
  <bs:bsui-field-group-title text="Account settings" />
  <bs:bsui-field-group-description text="Manage your account preferences." />
  <bs:bsui-field-group-content>
    <bs:bsui-field>
      <bs:bsui-field-label text="Display name" />
      <bs:bsui-input nameAlt="display_name" placeholder="Enter display name" />
    </bs:bsui-field>
    <bs:bsui-field>
      <bs:bsui-field-label text="Email" />
      <bs:bsui-input nameAlt="email" type="email" placeholder="Enter email" />
    </bs:bsui-field>
  </bs:bsui-field-group-content>
</bs:bsui-field-group>

disabled="true"을 그룹에 사용하면 기본 fieldset 동작에 따라 해당 폼 컨트롤이 비활성화됩니다. 카드 스타일은 기본 변형에 영향을 주지 않습니다.

툴바 구분선

bsui/toolbar-separator을 툴바 항목 사이에 배치하세요. 상위 툴바의 orientation을 따릅니다. 가로 툴바에는 전체 높이의 세로 구분선이, 세로 툴바에는 전체 너비의 가로 구분선이 표시됩니다. 구분선은 컨트롤 높이를 변경하지 않고 툴바 테두리 안쪽 가장자리까지 늘어납니다. 콘텐츠가 사용 가능한 너비를 초과하면 가로 툴바가 스크롤됩니다.

레이어링 모델

컴포넌트 라이브러리는 겹쳐진 표면에서 흔히 무너집니다. 번들 컴포넌트는 실제 UI를 만드는 사람을 위해 몇 가지 규칙을 따릅니다.

모달은 body로 포털 처리됩니다

대화상자, 알림 대화상자 또는 드로어가 열리면 팝업과 배경이 document.body로 이동하고, 닫힐 때 돌아갈 위치를 표시하는 주석이 남습니다. 포털 처리하면 모달이 조상 요소의 overflow, 변환 또는 쌓임 맥락에 영향을 받지 않습니다. 열릴 때 페이지 스크롤도 잠깁니다. 잠금 횟수는 모든 오버레이 컴포넌트에서 참조 횟수로 관리되며, 스크롤바 너비만큼 보정해 페이지가 밀리지 않도록 합니다. 배경은 z-index: 50에, 팝업은 51에 배치되고, 포커스는 팝업으로 이동합니다. Tab 키는 팝업 안에 갇히며, 닫으면 포커스가 트리거로 돌아갑니다.

모달은 스택으로 쌓입니다. 모달 안에서 대화상자를 열면 하나의 공유 스택에 추가됩니다. 가장 바깥쪽 대화상자만 배경을 표시하고, 맨 위 대화상자 뒤에 있는 대화상자는 크기가 줄어들어 뒤쪽에서 살짝 보입니다. 이 스택은 각 배경 팝업의 --bs-ui-nested-dialogs 사용자 지정 속성 값을 제어하므로, 단계가 깊어질수록 뒤로 보이는 간격과 축소 정도가 커집니다. 부모 대화상자는 자식 대화상자와 높이를 맞춰 레이어가 고르게 보입니다. 닫을 때는 역순으로 한 번에 한 레이어씩 모두 복원됩니다.

모달이 닫히면 포커스가 모달을 연 요소로 돌아가며, 정확한 요소에 돌아갑니다. 공유 getAnchor 헬퍼는 트리거 래퍼를 내부의 시스템 버튼으로 찾아 연결하므로, 보이지 않는 래퍼가 아니라 화면에 보이는 컨트롤이 다시 포커스를 받습니다.

맨 위 모달에는 변환을 적용하지 않습니다

뒤에서 살짝 보이는 효과는 배경 대화상자에만 변환을 적용합니다. 맨 위 모달에는 의도적으로 변환을 적용하지 않습니다. 변환된 요소는 position: fixed 하위 요소의 기준 블록이 되어 모달 안에서 여는 모든 플로팅 팝업이 제대로 작동하지 않기 때문입니다.

이 규칙 덕분에 전체 레이어링 모델이 서로 잘 맞물립니다. 플로팅 레이어는 모두 고정 좌표로 배치되며, 변환된 조상이 없을 때만 이 좌표가 뷰포트를 기준으로 합니다.

  • 메뉴와 콤보박스는 Floating UI의 fixed 전략으로 트리거를 기준 삼아 위치를 계산합니다. 트리거 아래에 표시하고, 뷰포트 공간이 부족하면 반대 방향으로 뒤집거나 위치를 조정합니다.
  • 선택 항목이 없을 때는 선택 메뉴도 같은 방식으로 동작합니다. 이미 선택된 항목이 있으면 팝업 위치를 조정해 선택된 옵션이 트리거 바로 위에 오도록 하고, 뷰포트 경계 안에 맞춥니다. 이는 macOS의 기본 선택 메뉴와 같은 동작입니다.
  • 컨텍스트 메뉴는 포인터의 clientX/clientY에 표시됩니다.

맨 위 모달에는 변환이 적용되지 않으므로, 중첩 깊이와 관계없이 대화상자, 경고 대화상자 또는 드로어 안의 모든 팝업이 트리거를 기준으로 올바르게 배치됩니다. 팝업은 자신이 모달 안에 있는지 알 필요가 없고, 알게 할 필요도 없습니다.

Escape 키를 누르면 가장 안쪽 레이어부터 닫힙니다

Escape 키를 한 번 누르면 안쪽부터 레이어 하나만 닫힙니다.

  1. 열린 플로팅 레이어(선택 목록 상자, 메뉴, 팝오버, 날짜 또는 전화 팝업)가 먼저 닫히고 트리거로 포커스를 돌려보냅니다. 선택 메뉴는 이벤트 전파를 중단하며, 플로팅 레이어가 하나라도 열려 있으면 모달 핸들러도 동작하지 않으므로 아래의 대화상자는 해당 키 입력을 받지 않습니다.
  2. 다음으로 맨 위 모달이 닫힙니다.
  3. 모달이 쌓여 있으면 Escape 키를 누를 때마다 스택에서 하나씩 더 닫힙니다.

닫기 동작은 우연한 결과가 아니라 정책입니다. dismissable="false"로 렌더링된 대화상자는 Escape 키와 배경 클릭을 모두 무시합니다. bsui/alert-dialog은 모든 모달처럼 Escape 키에는 반응하지만, 패턴의 목적이 실수로 닫히지 않도록 선택을 요구하는 것이므로 배경 클릭은 의도적으로 무시합니다. 일반 대화상자는 배경을 클릭하면 닫히며, dismissable의 기본값이 true이기 때문입니다.

대화상자 안의 폼

위의 모든 규칙을 한 번에 보여 주는 패턴입니다. 트리거가 모달을 열고, 모달에는 유효성 검사를 수행하는 폼이 있으며, 폼 안에는 플로팅 선택 메뉴가 있습니다.

HTML
<bs:bsui-dialog>
  <bs:bsui-dialog-trigger trigger_label="Invite teammate" trigger_variant="outline" />
  <bs:bsui-dialog-backdrop />
  <bs:bsui-dialog-popup>
    <bs:bsui-dialog-header>
      <bs:bsui-dialog-title content="Invite a teammate" />
      <bs:bsui-dialog-description content="They receive an email with a join link." />
    </bs:bsui-dialog-header>
    <bs:bsui-dialog-content>
      <bs:bsui-form block="team/invite" successMessage="Invitation sent.">
        <bs:bsui-field name="email">
          <bs:bsui-field-label text="Email" />
          <bs:bsui-input name="email" type="email" placeholder="colleague@example.com" required="true" />
          <bs:bsui-field-error />
        </bs:bsui-field>
        <bs:bsui-field name="role">
          <bs:bsui-field-label text="Role" />
          <bs:bsui-select name="role" defaultValue="editor" placeholder="Pick a role">
            <bs:bsui-select-trigger />
            <bs:bsui-select-popup>
              <bs:bsui-select-option value="viewer" label="Viewer" />
              <bs:bsui-select-option value="editor" label="Editor" />
              <bs:bsui-select-option value="admin" label="Admin" />
            </bs:bsui-select-popup>
          </bs:bsui-select>
        </bs:bsui-field>
        <bs:bsui-space size="2" />
        <bs:bsui-button label="Send invite" />
      </bs:bsui-form>
    </bs:bsui-dialog-content>
    <bs:bsui-dialog-footer>
      <bs:bsui-dialog-close label="Cancel" />
    </bs:bsui-dialog-footer>
  </bs:bsui-dialog-popup>
</bs:bsui-dialog>

위의 모든 태그와 속성은 동작에 꼭 필요합니다. 트리거는 시스템 버튼을 전달하고, 제목과 설명은 content를 사용하며, 필드에는 폼에서 직렬화할 이름이 지정됩니다. 또한 required="true"은 태그 파서에서 실제 불리언 값으로 변환됩니다.

각 스토어의 런타임 동작

bsui/dialog 은 서버에서 {"open":false,"dismissable":true}을 컨텍스트에 초기화합니다. 트리거를 클릭하면 actions.open가 실행됩니다. 팝업과 배경이 body로 포털 렌더링되고, 스크롤바 보정과 함께 스크롤이 잠깁니다. 팝업은 150ms 동안 애니메이션으로 나타나고, 포커스가 첫 번째 포커스 가능 요소로 이동하며, Tab 키로 내부 요소를 순환할 수 있습니다. 헤더, 콘텐츠, 푸터 영역은 모달 간격 토큰에 따라 배치됩니다.

bsui/select 은 폼 안에서 목록 상자 hidden와 함께 대기합니다. 트리거를 클릭하면 context.open가 뒤집히고 목록 상자가 뷰포트 기준 고정 좌표에 배치됩니다. defaultValue="editor"이 이미 선택되어 있으므로 팝업 위치가 조정되어 Editor가 트리거 바로 위에 표시됩니다. 화살표 키, Home, End, 문자 입력으로 활성 옵션을 이동할 수 있습니다. Enter 키나 클릭으로 항목을 선택하고, Tab 키나 바깥쪽 클릭으로는 선택하지 않고 닫습니다. 트리거에 표시되는 텍스트는 data-wp-text="state.displayValue"를 통해 업데이트되고, 숨겨진 <input name="role">는 data-wp-bind--value="state.selectedValue"을 통해 값을 추적합니다. 이 값은 이후 폼에서 직렬화됩니다. 맨 위 모달에는 변환이 적용되지 않으므로 이 모든 요소가 대화상자 안에서도 올바르게 배치됩니다.

bsui/form 은 제출 이벤트를 가로챕니다. 폼 끝의 bsui/button은 type 속성이 없는 일반 button 요소를 렌더링하므로, 기본적으로 HTML 폼 제출 컨트롤이 됩니다. Cancel 버튼은 폼 바깥 푸터에 있으므로 form 요소를 통해 아무것도 제출할 수 없습니다. 제출하면 스토어가 폼의 FormData을 직렬화하고, block에 지정된 블록의 데이터 API를 통해 전송합니다. 여기서는 team/invite 블록의 데이터베이스 스키마에 행을 생성합니다. 유효성 검사 오류는 필드별로 반환됩니다. 각 bsui/field는 name을 포함하고, 유효하지 않은 상태로 표시되며, 포커스 링 색상이 오류 색상으로 바뀌고 bsui/field-error 경고에 메시지가 표시됩니다. 성공하면 data-wp-bind--hidden을 통해 폼 본문이 숨겨지고 successMessage가 표시됩니다.

레이어는 순서대로 닫힙니다. 목록 상자가 열린 상태에서 Escape 키를 누르면 목록 상자가 닫히고 선택 메뉴 트리거에 다시 포커스가 갑니다. 한 번 더 누르면 대화상자가 닫히고 Invite teammate에 다시 포커스가 갑니다. dismissable가 기본값으로 유지되어 있으므로 배경을 클릭하면 대화상자가 닫힙니다. 닫으면 스크롤 잠금이 해제되고 팝업이 문서 내 원래 위치로 돌아갑니다.

같은 마크업을 파일 기반 페이지에 붙여 넣으면 네이티브 블록으로 동기화되고, 에디터에서 조합한 구성은 캔버스에서 인터랙티브하게 미리 볼 수 있습니다. 위의 모든 동작은 두 컨텍스트에서 모두 로드되는 디렉티브와 스토어에 구현되어 있기 때문입니다.

이러한 경계가 제대로 작동하는 이유

위의 경계는 관례가 아니라 라이브러리가 렌더링하는 모든 곳에서 유지하는 불변 조건입니다. 모든 레이블은 동일한 타이포그래피로 표시되고, 모든 모달 팝업은 같은 표면을 사용하며 뒤쪽 페이지를 어둡게 표시합니다. 플로팅 팝업은 페이지가 스크롤되어도 트리거에 고정되고, Escape 키를 누르면 안쪽부터 한 번에 레이어 하나만 닫힙니다. 이러한 보장은 프런트엔드와 에디터 캔버스 모두에서 기본 토큰이나 테마 토큰을 사용해도 유지됩니다. 따라서 한 컨텍스트에서 올바르게 동작하는 구성은 다른 컨텍스트에서도 똑같이 동작합니다.

실시간 예제

이 페이지의 구성은 문법이고, /ui/examples는 용례집입니다. 렌더링된 실시간 구성을 세 단계로 모았습니다. 두세 컴포넌트 사이의 경계를 보여 주는 조합, 몇 가지 컴포넌트로 만든 익숙한 제품 패턴, 실제 제품에 컴포넌트를 제공하는 방식대로 조립한 완전한 미니 앱입니다. 각 컴포넌트 페이지인 /ui에는 레이블이 있는 필드부터 팝오버 뒤의 캘린더까지 개별 예제가 추가되어 있습니다.

인터랙티비티

디렉티브와 스토어가 UI 컴포넌트의 기반이 되는 방식과 이를 자체 블록에서 사용하는 방법을 설명합니다.