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 컴포넌트」가 갖는다.