Tabs
한 자리에서 내용을 갈아 끼우는 탭입니다. 고른 탭 아래 밑줄이 서고 다른 탭을 고르면 그 자리로 미끄러집니다. 탭 줄 아래 선은 탭을 놓는 자리가 긋습니다.
🚩 Playground
모양과 탭 수를 조합해 확인합니다. 켠 탭은 Control로 고르지 않고 미리보기의 탭을 직접 눌러 옮깁니다. 탭 줄 아래 선은 Tabs가 긋지 않으므로, 아래 선 Toggle은 탭을 놓는 자리가 긋는 선을 켜고 끕니다.
Appearance
Content
Anatomy
Tabs를 구성하는 실제 요소와 문서에서 사용하는 명칭입니다. Root가 탭 줄과 칸을 함께 감싸므로 둘이 서로를 가리킵니다. Indicator는 탭마다 켜졌다 꺼지지 않고 하나가 자리를 옮깁니다.
Tabs structure
- 1.Root
- 2.List
- 3.Tab
- 4.Indicator
- 5.Panel
Properties · Style
모양은 둘이며 기본값은 Underline입니다. 담는 것은 같고 켠 탭을 알리는 방식이 다릅니다. 한 화면에서는 두 모양을 섞지 않습니다.
Underline · Default
본문을 가르는 자리입니다. 글자 14px, 탭 높이 32px이고 밑줄은 2px입니다. 아래 선은 놓는 자리가 긋습니다.
Filled
컨트롤 줄에 끼는 자리입니다. 줄 높이 32px이 공통 Control Height의 Small과 같아 옆에 선 컨트롤과 높이가 맞습니다.
Properties · State
탭이 갖는 상태는 켜짐 여부 하나입니다. 켠 탭은 중립으로 알립니다 — brand를 쓰면 Focus ring과 같은 색조가 되어 켠 탭과 초점이 놓인 탭이 색으로 갈리지 않습니다. 켠 탭을 다시 눌러도 꺼지지 않습니다.
Selected · Unselected
켠 탭은 oe-foreground-primary에 font-medium, 그 밖은 oe-foreground-tertiary입니다. 포인터를 얹으면 oe-foreground-secondary가 됩니다.
Disabled
Property로 열려 있으나 화면에서는 쓰지 않기를 권합니다. 누를 수 없는 탭은 그 칸이 왜 막혔는지 탭 줄만으로 말하지 못합니다.
아래 선
탭 줄 아래 선은 Tabs가 긋지 않습니다. 그 선이 어디에서 시작해 어디까지 가는지는 탭을 놓는 자리가 정하기 때문입니다. 밑줄은 그 선과 겹치도록 1px 내려앉으므로, 선이 없으면 밑줄만 공중에 뜹니다.
본문 안 · 상자의 폭까지
카드나 목록처럼 폭이 정해진 상자 안에서는 그 상자의 폭까지만 갑니다.
화면의 머리 · 좌우 끝까지
화면의 머리에서는 좌우 여백을 넘어 끝까지 갑니다. 선은 바깥 요소가 긋고 탭 줄은 여백 안에 섭니다.
Guidelines
Tabs를 언제 쓰고 어느 모양을 고르는지에 대한 규칙입니다.
모양 고르기
Underline · 본문을 가르는 자리
Filled · 컨트롤 줄에 끼는 자리
- 본문을 가르는 자리에는 Underline을 씁니다. 화면의 머리 아래나 카드 안의 첫 줄처럼 탭이 그 아래 내용 전체의 머리인 자리입니다.
- 컨트롤 줄에 끼는 자리에는 Filled를 씁니다. 같은 것을 다른 단위로 바꿔 보는 자리이며, 줄 높이가 공통 Control Height의 Small과 같아 옆에 선 Button과 높이가 맞습니다.
- 한 화면에서 두 모양을 섞지 않습니다. 섞으면 어느 쪽이 화면을 가르는 탭이고 어느 쪽이 보기 방식을 고르는 탭인지 읽히지 않습니다.
Chip과 나눠 쓰기
Do
항상 하나가 켜져 있는 자리에 Tabs를 쓰세요.
Don’t
켜고 끄거나 여럿을 고르는 자리에 쓰지 마세요.
- Tabs는 항상 하나가 켜져 있고 끌 수 없는 위치 표시입니다. 켠 탭을 다시 눌러도 꺼지지 않습니다.
- Chip은 여러 개를 켜고 끌 수 있고 아무것도 켜지지 않은 상태가 기본입니다. 거르는 자리는 Chip이 맡습니다.
- 켠 것의 색이 갈리는 것도 여기서 나옵니다. Chip의 Active가 brand alpha를 유지하는 것은 그쪽이 조작이기 때문이고, 탭이 중립인 것은 위치 표시이기 때문입니다.
탭 정하기
- 탭의 이름은 그 칸에 무엇이 있는지를 말하는 명사로 둡니다. 누르면 실행되는 것이 아니라 보는 자리가 바뀌므로 동작을 적지 않습니다.
- 이름은 한 줄에서 끝냅니다. 두 줄로 넘어가면 그 탭만 높아져 줄의 기준선이 어긋납니다.
- 탭이 둘보다 적으면 두지 않습니다. 하나뿐인 탭은 가를 것이 없다는 뜻이므로 제목으로 둡니다.
- 첫 탭은 가장 자주 보는 칸으로 둡니다. 처음 열었을 때 켜지는 자리입니다.
- 켠 탭을 주소에 남길지는 쓰는 자리가 정합니다. 링크로 건네는 쓰임이 있으면 남기고, 처음부터 훑어 내려가며 읽는 화면이면 남기지 않습니다.
Property map
실제 Props와 기본값입니다. 조각마다 받는 값도 함께 적습니다.
| Property | Values | Default | Status |
|---|---|---|---|
| variant | underline | filled | underline | Confirmed |
| value | string | undefined | 제어할 때 |
| defaultValue | string | 첫 탭 | Confirmed |
| onValueChange | (value, details) => void | undefined | Confirmed |
| TabsTab.value | string | 필수 | Confirmed |
| TabsTab.disabled | false | true | false | 쓰지 않기를 권한다 |
| TabsPanel.value | string | 필수 | Confirmed |
| TabsPanel.keepMounted | false | true | false | Confirmed |
| TabsList.activateOnFocus | false | true | false | 켜지 않는다 |
| TabsList.loopFocus | false | true | true | Confirmed |
| className | string | undefined | Confirmed |
명세 문서
docs/system/components/tabs.md
Tabs
packages/ui/src/tabs.tsx
한 자리에서 내용을 갈아 끼우는 탭이다. 항상 하나가 켜져 있고 끌 수 없으며, 켜진 것이 지금 어느 칸을 보고 있는지를 알린다.
역할과 경계
Tabs는 Root와 List, Indicator, Tab, Panel을 소유한다. 탭 줄과 그 탭이 여는 칸을 함께 감싸므로 둘이 서로를 가리킨다. 탭 줄을 다른 컴포넌트(화면의 머리 등) 안에 넣는 경우에도Tabs로 그 컴포넌트와 본문을 함께 감싼다. 칸이 탭 줄의 바깥에 있기 때문이다.- 한 화면 안을 나누는 자리에 쓴다. 같은 대상을 여러 각도에서 보는 자리, 같은 목록을 구간으로 나누는 자리가 여기 든다.
- 제품 전체를 가르는 최상위 화면으로 옮기는 데 쓰지 않는다. 모바일에서 그 자리는 bottom-navigation.md가 맡고, 관리자 웹에서는 좌측 메뉴가 맡는다.
- 탭 줄 아래 선은 이 컴포넌트가 긋지 않는다. 그 선이 어디에서 시작해 어디까지 가는지는 탭을 놓는 자리가 정하기 때문이다. 화면의 머리에서는 좌우 끝까지 가고, 본문 안에서는 그 상자의 폭까지만 간다. 이 컴포넌트는 그 선 위에 밑줄을 얹는 일만 한다.
- 키보드 이동과
role="tab"·aria-selected·aria-controls연결은 Base UI의Tabs가 소유한다. 이 컴포넌트는 그 위에 모양 둘을 얹는다. - 선택 상태에 중립을 쓰는 규칙은 interaction.md의 「선택 상태와 Hover·Pressed」가 소유한다. Focus 표시의 유형도 같은 문서가 소유한다.
- 구성 요소를 부르는 이름은 vocabulary.md를 따른다. 업계에서 굳은
Tab·Panel·Indicator를 그대로 쓴다.
Chip과의 경계
둘을 한 컴포넌트에 담지 않는다. 겉모습이 닮아 보여도 켜고 끄는 규칙과 키보드 동작이 다르다.
| Tabs | Chip | |
|---|---|---|
| 켜진 개수 | 항상 하나. 끌 수 없다 | 없거나 하나거나 여럿 |
| 기본 상태 | 하나가 켜져 있다 | 아무것도 켜지지 않았다 |
| 역할 | 지금 어느 칸을 보고 있는지 알리는 위치 표시 | 값을 고르거나 거르는 조작 |
| 역할 속성 | role="tab"과 tabpanel 연결이 필수다 |
버튼이다 |
| 키보드 | 방향키로 줄 안을 옮기고 줄 전체가 Tab 키 한 번에 든다 | 하나씩 Tab 키로 닿는다 |
| 켜진 것의 색 | 중립 | Active는 brand alpha |
한 컴포넌트에 담으면 Property 하나가 키보드 동작과 필수 속성까지 바꾼다. 켜진 것의 색이 갈리는 것도 여기서 나온다 — Chip의 Active가 brand alpha를 유지하는 것은 그쪽이 조작이기 때문이고, 탭이 중립인 것은 위치 표시이기 때문이다.
Anatomy
- Root: 탭 줄과 칸을 함께 감싸며 모양(
variant)과 지금 켜진 값을 소유한다. 자기 면이나 여백을 갖지 않는다. - List: 탭을 나란히 세우는 줄이다. Indicator가 자리를 옮기는 기준점이며,
filled에서는 이 요소가 바탕 알약이 된다. - Tab: 탭 하나다. 누르면 그 값이 켜진다.
- Indicator: 켜진 탭을 가리키는 비상호작용 표시다. 탭마다 켜졌다 꺼지지 않고 하나가 자리를 옮긴다.
underline에서는 2px 밑줄이고filled에서는 올라온 면이다. - Panel: 켜진 탭이 여는 칸이다. 탭 줄의 바깥에 선다.
Properties
variant(Style):underline | filled, 기본값underline.underline은 켜진 탭 아래에 밑줄이 서고 탭 줄 아래 선은 놓는 자리가 긋는다.filled는 줄이 바탕 알약을 갖고 켜진 탭이 그 안에서 올라온 면으로 선다. 고르는 기준은 아래 Guidelines의 「모양 고르기」가 갖는다.value: 지금 켜진 탭의 값이다. 넘기면 제어 컴포넌트가 된다.defaultValue: 넘기지 않을 때 처음 켜지는 값이다.onValueChange: 탭을 눌렀을 때 그 값으로 부른다.TabsTab.value: 필수다. 이 값을 가진TabsPanel을 연다.TabsTab.disabled: 누를 수 없는 탭이다. 첫 탭을 끄려면value또는defaultValue를 켜진 탭의 값으로 함께 넘긴다.TabsPanel.value: 필수다. 이 값을 가진 탭이 켜졌을 때 보인다.TabsPanel.keepMounted: 꺼진 칸을 DOM에 남긴다. 기본값은 남기지 않는 것이다.TabsList.activateOnFocus: 방향키로 초점을 옮기는 것만으로 칸을 바꾼다. 기본값은 끈 것이며 켜지 않는다 — 줄을 훑는 동안 지나가는 칸이 모두 그려진다.TabsList.loopFocus: 줄의 끝에서 방향키를 더 누르면 처음으로 돈다. 기본값은 도는 것이다.- State: Selected, Unselected
모양은 Root에서 한 번만 받는다. 조각마다 받게 두면 한 줄 안에서 줄과 탭과 표시의 모양이 어긋난 상태를 쓰는 쪽이 만들 수 있고, 그것은 화면에서 컴포넌트가 깨진 것으로 보인다.
Guidelines
탭 줄 아래 선은 놓는 자리가 긋기
underline을 쓰는 자리는 탭 줄을 감싸는 요소에 아래 선을 직접 긋는다. 밑줄은 그 선과 겹치도록 1px 내려앉으므로, 선이 없으면 밑줄만 공중에 뜬다.- 그 선이 어디까지 가는지는 자리가 정한다. 화면의 머리에서는 좌우 끝까지 가고, 본문 안의 상자에서는 그 상자의 폭까지만 간다.
filled에는 아래 선을 두지 않는다. 바탕 알약이 이미 줄의 경계를 말한다.
모양 고르기
- 본문을 가르는 자리에는
underline을 쓴다. 화면의 머리 아래나 카드 안의 첫 줄처럼, 탭이 그 아래 내용 전체의 머리인 자리다. 탭 줄이 가로폭을 길게 쓸 수 있고 글자가 14px이라 제목 다음 위계로 읽힌다. - 컨트롤 줄에 끼는 자리에는
filled를 쓴다. 제목 옆이나 설정 줄처럼 Button과 나란히 서서 같은 것을 다른 단위로 바꿔 보는 자리다. 줄 높이가 공통 Control Height의 Small과 같아 옆에 선 컨트롤과 높이가 맞는다. - 한 화면에서 두 모양을 섞지 않는다. 섞으면 어느 쪽이 화면을 가르는 탭이고 어느 쪽이 보기 방식을 고르는 탭인지 읽히지 않는다.
- 본문을 가르는 탭을 한 화면에 둘 이상 겹치지 않는다. 바깥 탭이 켠 칸 안에 또 탭이 서면 지금 어디에 있는지 두 줄을 함께 읽어야 한다.
켜진 탭을 중립으로 알리기
- 켜진 탭에 brand를 쓰지 않는다. interaction.md의 「선택 상태와 Hover·Pressed」가 면을 칠해 선택을 알리는 요소의 목록에 탭을 넣고, 이어서 「brand는 그 밖에 실행과 Focus에만 쓴다」로 더 좁힌다. 탭이 알리는 것은 브랜드가 아니라 지금 어느 칸을 보고 있는지다.
- 같은 까닭으로 bottom-navigation.md도 켜진 항목에 중립을 쓴다. 두 컴포넌트가 알리는 것이 한 종류이므로 색도 한 결이다.
- 고른 값에 brand를 쓰면 Focus ring과 같은 색조가 되어, 켜진 탭과 초점이 놓인 탭이 색으로 갈리지 않는다.
탭 정하기
- 탭의 이름은 그 칸에 무엇이 있는지를 말하는 명사로 둔다. 동작을 적지 않는다 — 누르면 실행되는 것이 아니라 보는 자리가 바뀐다.
- 이름은 한 줄에서 끝낸다. 두 줄로 넘어가면 그 탭만 높아져 줄의 기준선이 어긋난다.
- 탭이 둘보다 적으면 두지 않는다. 하나뿐인 탭은 가를 것이 없다는 뜻이므로 제목으로 둔다.
- 첫 탭은 가장 자주 보는 칸으로 둔다. 처음 열었을 때 켜지는 자리다.
- 켜진 탭을 주소에 남길지는 쓰는 자리가 정한다. 링크로 건네는 쓰임이 있으면 남기고, 처음부터 훑어 내려가며 읽는 화면이면 남기지 않는다.
Specification
두 모양이 같은 조각 다섯을 쓰고 값만 갈린다. 값은 tabs.tsx가 소유한다.
공통
- 켜지지 않은 탭의 글자:
oe-foreground-tertiary. Hover에서oe-foreground-secondary가 되며 150ms에 걸쳐 바뀐다. - 켜진 탭의 글자:
oe-foreground-primary에font-medium. - Focus: 탭의 네모에 2px
oe-focus-ring을 그린다(interaction.md의 유형 3). - 표시는 하나가 자리를 옮기며 200ms에 걸쳐 미끄러진다. 움직임을 줄이도록 설정한 기기에서는 전환 없이 곧바로 자리를 잡는다.
- Disabled를 Property로 열어 두되 화면에서는 쓰지 않기를 권한다. 누를 수 없는 탭은 그 칸이 왜 막혔는지 탭 줄만으로 말하지 못한다.
underline
- 탭 글자: 14px에 20px 행간.
- 탭 여백: 좌우 4px, 글자 아래 12px. 탭 높이는 32px이다. 공통 Control Height를 쓰지 않는다 — 밑줄이 설 자리를 비운 높이이고 컨트롤 줄에 끼는 요소가 아니다.
- 탭 사이: 20px. 탭이 좌우로 4px씩 내어 주므로 글자와 글자 사이는 28px로 남는다.
- 줄은 왼쪽으로 4px 당긴다. 그러지 않으면 첫 탭의 글자가 그 4px만큼 안으로 들어가 위아래 요소와 시작점이 어긋난다.
- 밑줄: 두께 2px, 모서리는 알약, 색은
oe-border-bold-primary. 줄 아래 선과 겹치도록 1px 내려앉는다.- 선을 긋는 토큰을 쓴다. 이 요소는 글자가 아니라 선이며, 「선으로 알리는」 중립을 interaction.md의 「선택 상태와 Hover·Pressed」가 이 토큰으로 못 박았다.
oe-foreground-primary와 두 테마 모두 값이 같으므로 화면에 그려지는 색은 다르지 않다. 갈리는 것은 역할이다.
- Focus의 모서리는 위쪽만 6px이다. 밑줄이 서는 아래쪽까지 둥글리면 선이 끊긴 것으로 보인다.
filled
- 줄:
oe-background-secondary면에 모서리 10px, 안쪽 여백 2px. 줄 높이는 탭 28px에 이 여백을 더한 32px이며 공통 Control Height의 Small과 같다.- 안쪽 여백 2px은 표시가 바탕 알약의 둥근 모서리를 넘지 않게 하는 값이다. 사방이 같아야 표시가 알약 안에서 한가운데 놓인 것으로 보인다. 탭의 모서리 8px에 이 2px을 더한 값이 줄의 10px이다.
- 줄은 내용 폭만 쓴다. 좌우로 늘어나면 탭 둘짜리 묶음이 화면 폭을 다 차지한다.
- 탭: 높이 28px(공통 Control Height의 XSmall), 좌우 12px, 글자 12px, 모서리 8px.
- 이 단계가 필요한 자리는 Button과 나란히 서는 컨트롤 줄이다. 저장소에 손으로 짜여 있던 네 자리(
color-lab의 보기 전환 셋,studio-navigation의 화면 크기·모드·언어 묶음)가 모두 28px이었다. - 두세 글자 약어만 드는 묶음은 좌우 6px에 최소 폭 28px로 정사각에 가깝게 두기도 한다. 그것은 그 묶음의 값이며 컴포넌트의 기본값이 아니다.
- 이 단계가 필요한 자리는 Button과 나란히 서는 컨트롤 줄이다. 저장소에 손으로 짜여 있던 네 자리(
- 탭 사이에 간격을 두지 않는다. 묶음 하나가 한 덩어리로 읽혀야 하고, 간격을 주면 표시가 옮겨 갈 때 빈틈을 건너뛰는 것으로 보인다.
- 켜진 탭의 면:
oe-background-primary에 가장 옅은 그림자, 모서리 8px. 바탕보다 한 단계 밝은 면이 올라온 것으로 읽힌다. 여기에도 brand를 쓰지 않는다. - 표시는 켜진 탭과 같은 자리에 같은 크기로 선다. 좌표와 크기를 탭에서 받으므로 글자 길이가 달라도 둘이 어긋나지 않는다.
현재 정의하지 않은 항목
- 세로 탭. 줄이 세로로 서는 배치를 만들지 않았다. Base UI의
orientation을 열어 두지도 않았다 — 세로 줄은 좌측 메뉴와 쓰임이 겹치므로 둘의 경계를 먼저 정해야 한다. - 탭 닫기. 탭마다 닫는 버튼을 두지 않았다. 닫을 수 있는 탭은 개수가 사람의 조작으로 바뀌므로, 마지막 탭을 닫았을 때 무엇이 켜지는지와 닫은 것을 되살릴 길을 함께 정해야 한다.
- 넘칠 때 스크롤. 탭이 줄의 폭을 넘을 때의 동작을 정하지 않았다. 지금은 넘친 탭이 그대로 잘린다. 가로로 스크롤할지 접어 넣을지, 스크롤한다면 양 끝의 그림자와 화살표를 둘지, 키보드로 닿은 탭을 보이는 자리로 끌어올지를 함께 정해야 한다.
filled로 갈아탈 화면. 모양은 갖추었으나 저장소의 손으로 짜인 네 자리를 아직 갈아타지 않았다. 남은 일은docs/process/open-questions.md의 「Tab 컴포넌트」가 갖는다.