본문으로 건너뛰기

구성 요소

탭

같은 공간을 차지하는 패널 간에 전환합니다.

사용법

기본

HTML
<bs:bsui-tabs defaultValue="overview">
  <bs:bsui-tabs-list>
    <bs:bsui-tabs-trigger value="overview" title="Overview" />
    <bs:bsui-tabs-trigger value="activity" title="Activity" />
  </bs:bsui-tabs-list>
  <bs:bsui-tabs-panel value="overview">
    <bs:bsui-text content="Everything at a glance." variant="muted" />
  </bs:bsui-tabs-panel>
  <bs:bsui-tabs-panel value="activity">
    <bs:bsui-text content="What changed recently." variant="muted" />
  </bs:bsui-tabs-panel>
</bs:bsui-tabs>

세로 화살표 키

Orientation이 키보드 이동 축을 정하므로 위아래 키로 탭 사이를 이동합니다.

HTML
<bs:bsui-tabs defaultValue="general" orientation="vertical">
  <bs:bsui-tabs-list>
    <bs:bsui-tabs-trigger value="general" title="General" />
    <bs:bsui-tabs-trigger value="members" title="Members" />
    <bs:bsui-tabs-trigger value="billing" title="Billing" />
  </bs:bsui-tabs-list>
  <bs:bsui-tabs-panel value="general">
    <bs:bsui-text content="Workspace name, time zone, and default branch." variant="muted" />
  </bs:bsui-tabs-panel>
  <bs:bsui-tabs-panel value="members">
    <bs:bsui-text content="Invite teammates and decide what each of them can change." variant="muted" />
  </bs:bsui-tabs-panel>
  <bs:bsui-tabs-panel value="billing">
    <bs:bsui-text content="The card on file, past invoices, and the limits of your plan." variant="muted" />
  </bs:bsui-tabs-panel>
</bs:bsui-tabs>

수동 활성화

화살표 키로 포커스를 이동해도 패널은 바뀌지 않으며, 양 끝에서는 이동이 멈춥니다.

HTML
<bs:bsui-tabs defaultValue="preview" activateOnFocus="false" loop="false">
  <bs:bsui-tabs-list>
    <bs:bsui-tabs-trigger value="preview" title="Preview" />
    <bs:bsui-tabs-trigger value="html" title="HTML" />
    <bs:bsui-tabs-trigger value="json" title="JSON" />
  </bs:bsui-tabs-list>
  <bs:bsui-tabs-panel value="preview">
    <bs:bsui-text content="The rendered block, exactly as a visitor sees it." variant="muted" />
  </bs:bsui-tabs-panel>
  <bs:bsui-tabs-panel value="html">
    <bs:bsui-text content="The markup the server returned for this block." variant="muted" />
  </bs:bsui-tabs-panel>
  <bs:bsui-tabs-panel value="json">
    <bs:bsui-text content="Every attribute the block was rendered with." variant="muted" />
  </bs:bsui-tabs-panel>
</bs:bsui-tabs>

탭마다 양식 하나

각 패널에 자체 필드가 있으므로 카드 하나로 두 작업 흐름을 모두 지원합니다.

HTML
<bs:bsui-tabs defaultValue="signin">
  <bs:bsui-tabs-list>
    <bs:bsui-tabs-trigger value="signin" title="Sign in" />
    <bs:bsui-tabs-trigger value="register" title="Create account" />
  </bs:bsui-tabs-list>
  <bs:bsui-tabs-panel value="signin">
    <bs:bsui-stack direction="column" gap="3" align="stretch">
      <bs:bsui-field>
        <bs:bsui-field-label text="Email" />
        <bs:bsui-input type="email" placeholder="you@example.com" />
      </bs:bsui-field>
      <bs:bsui-field>
        <bs:bsui-field-label text="Password" />
        <bs:bsui-password-input placeholder="Your password" />
      </bs:bsui-field>
      <bs:bsui-button label="Sign in" />
    </bs:bsui-stack>
  </bs:bsui-tabs-panel>
  <bs:bsui-tabs-panel value="register">
    <bs:bsui-stack direction="column" gap="3" align="stretch">
      <bs:bsui-field>
        <bs:bsui-field-label text="Work email" />
        <bs:bsui-input type="email" placeholder="you@example.com" />
        <bs:bsui-field-description text="We send a confirmation link before anything else." />
      </bs:bsui-field>
      <bs:bsui-button label="Create account" />
    </bs:bsui-stack>
  </bs:bsui-tabs-panel>
</bs:bsui-tabs>

구조

탭의 구성 블록은 아래와 같습니다. 각 블록은 별도의 블록이며 부모 블록 안에서만 렌더링됩니다.

  • bsui/tabs
  • bsui/tabs-list
  • bsui/tabs-trigger
  • bsui/tabs-panel

속성

속성유형기본값
defaultValue text —
orientation horizontal vertical horizontal
activateOnFocus toggle true
loop toggle true

bsui/tabs-list

이 블록은 속성을 받지 않습니다.

bsui/tabs-trigger

속성유형기본값
value text —
title richtext —

bsui/tabs-panel

속성유형기본값
value text —