Files
clean-architecture-frontend…/src/presentation/styles/theme/primitives.css
T
DongHyeonka 353bed7ac2 fix(design-system): 공통 primitive의 키보드·보조기술 동작을 약속대로 맞춘다
공통 primitive가 디자인 시스템 설계 8.1·8.2절과 WCAG 2.2 AA 약속을
어긴다.

- Popover가 이름 없는 role="dialog"를 그린다(1112/05-10).
- Dialog 안의 Menu·Popover·Tooltip에서 Escape를 누르면 Dialog까지
  닫힌다. Dialog가 안쪽이 처리한 Escape를 보지 않는다(05-11).
- SearchField는 required 기호만, Checkbox는 상태만 있다(05-13).
- Toast를 닫기 버튼으로 닫으면 포커스가 body로 떨어진다(05-14).
- TextArea 글자 수가 <output>(암묵 status)이라 글자마다 발표되고 입력과
  이어지지 않는다(05-17).
- 라우트 h1의 :focus outline 제거가 layer 순서로 키보드 :focus-visible
  표시까지 지운다(05-02). Tooltip이 pointer-events: none과 틈 때문에
  포인터를 설명 위로 옮기면 사라진다(1.4.13, 05-06).
- 홈 readiness 목록이 role 없는 div에 aria-label을 단다(05-15).
- fe-a11y·fe-ux 스킬이 제출 실패 때 오류 요약으로 포커스가 간다고 적는다.
  코드는 첫 오류 필드로 보낸다(05-09).

고른 방법: Popover는 trigger id로 이름을 받는다. Popover·Tooltip은
Escape를 capture 단계에서 받아 preventDefault하고, Dialog는 기본 동작이
막힌 Escape(과 그 뒤 cancel)를 넘긴다. Tooltip은 보일 때(hover·focus)만
Escape를 가진다. 숨은 tooltip이 다른 Dialog의 Escape를 막지 않게 하려는
것이다. Toast 닫기는 다음 toast의 닫기 버튼, 없으면 toast로 들어오기 전
요소로 포커스를 돌린다. TextArea 글자 수는 aria-describedby로 잇고 0에
닿을 때만 따로 발표한다. h1은 :focus:not(:focus-visible)만 outline을
지운다. Tooltip은 보일 때만 포인터를 받고 ::before 다리로 틈을 메운다.
버린 대안: Dialog가 안쪽 layer 목록을 들고 Escape를 나누기(primitive끼리
묶인다).

위험·한계: native <dialog>가 막힌 keydown 뒤에도 cancel을 쏘는지는
브라우저마다 다를 수 있어, Dialog는 같은 task의 cancel 하나를 넘긴다.
Toast가 돌려줄 요소가 지워졌으면 포커스를 옮기지 않는다. 시각 골든이
바뀌는지는 desktop test:visual로 본다.

검증: 새 component 시험(tests/component/design-system-a11y.test.tsx,
starter-pages), e2e(app-shell focus ring, 세 엔진), storybook(tooltip
hover)의 RED·GREEN은 desktop에서 돌려 PR 본문에 적는다.

Refs: 1112/05-02, 1112/05-06, 1112/05-09, 1112/05-10, 1112/05-11,
 1112/05-13, 1112/05-14, 1112/05-15, 1112/05-17
2026-11-12 22:53:40 +09:00

749 lines
16 KiB
CSS

@layer components {
.ui-page {
@apply mx-auto flex max-w-6xl flex-col gap-6 p-page;
width: 100%;
box-sizing: border-box;
}
.ui-panel {
@apply rounded-surface p-6 shadow-sm;
border: 1px solid var(--color-border);
background: var(--color-panel);
}
.ui-button {
@apply rounded-control px-4 py-2 font-semibold;
display: inline-flex;
min-height: 2.75rem;
align-items: center;
justify-content: center;
border: 0;
background: var(--button-primary-background);
color: var(--button-primary-content);
text-decoration: none;
cursor: pointer;
}
.ui-button:hover {
background: var(--button-primary-hover);
}
.ui-button:disabled {
cursor: not-allowed;
opacity: var(--opacity-disabled);
}
.ui-button--pending {
gap: var(--space-2);
cursor: progress;
}
.ui-button--secondary {
border: 1px solid var(--color-surface-muted);
color: var(--color-content);
background: var(--color-panel);
}
.ui-button--secondary:hover {
color: var(--color-action);
background: var(--color-surface);
}
.ui-button--danger {
color: var(--color-on-action);
background: var(--color-danger);
}
.ui-button--danger:hover {
background: var(--color-danger-hover);
}
.ui-button--ghost {
color: var(--color-content);
background: transparent;
}
.ui-button--ghost:hover {
color: var(--color-action);
background: var(--color-surface-muted);
}
.ui-button--compact {
min-height: var(--size-control-sm);
padding: 0.4rem 0.75rem;
font-size: 0.85rem;
}
.ui-icon-button {
width: var(--size-touch-target);
min-width: var(--size-touch-target);
padding: 0;
}
.app-shell__menu-button.ui-icon-button {
display: none;
}
.ui-icon {
display: inline-block;
flex: 0 0 auto;
stroke-width: var(--icon-stroke-default);
}
.ui-icon--small {
width: var(--size-icon-sm);
height: var(--size-icon-sm);
}
.ui-icon--medium {
width: var(--size-icon-md);
height: var(--size-icon-md);
}
.ui-icon--large {
width: var(--size-icon-lg);
height: var(--size-icon-lg);
}
.ui-spinner {
display: inline-block;
width: var(--size-icon-sm);
height: var(--size-icon-sm);
box-sizing: border-box;
border: 2px solid currentColor;
border-inline-end-color: transparent;
border-radius: var(--radius-full);
animation: ui-spin var(--duration-slow) linear infinite;
}
@keyframes ui-spin {
to {
transform: rotate(360deg);
}
}
.ui-skeleton {
@apply h-24 animate-pulse rounded-surface bg-surface-muted;
}
.ui-empty,
.ui-terminal-error {
@apply rounded-surface border border-surface-muted p-6;
}
.ui-field {
display: grid;
gap: 0.45rem;
}
.ui-field__label {
font-weight: 750;
}
.ui-field__description,
.ui-field__error {
margin: 0;
font-size: 0.875rem;
line-height: 1.5;
}
.ui-field__description {
color: var(--color-content-muted);
}
.ui-field__error {
color: var(--color-danger);
font-weight: 650;
}
.ui-field__input {
width: 100%;
min-height: 2.75rem;
box-sizing: border-box;
border: 1px solid var(--field-border);
border-radius: var(--radius-control);
padding: 0.65rem 0.8rem;
color: var(--color-content);
background: var(--color-panel);
}
.ui-field__input[aria-invalid="true"] {
border-color: var(--field-border-invalid);
}
.ui-field__textarea {
min-height: 7rem;
resize: vertical;
}
.ui-field__counter {
justify-self: end;
color: var(--color-content-muted);
font-size: var(--font-size-sm);
}
.ui-choice-field,
.ui-radio-group,
.ui-switch-field {
display: grid;
gap: var(--space-2);
}
.ui-choice-field__control {
display: flex;
min-height: var(--size-touch-target);
align-items: center;
gap: var(--space-2);
cursor: pointer;
}
.ui-choice-field__control input {
width: 1.15rem;
height: 1.15rem;
accent-color: var(--color-action);
}
.ui-choice-field__control small {
display: block;
color: var(--color-content-muted);
}
.ui-radio-group {
min-width: 0;
border: 1px solid var(--color-border);
border-radius: var(--radius-control);
padding: var(--space-3);
}
.ui-radio-group legend {
padding-inline: var(--space-1);
font-weight: var(--font-weight-bold);
}
.ui-switch {
display: inline-flex;
width: fit-content;
min-height: var(--size-touch-target);
align-items: center;
gap: var(--space-2);
border: 0;
color: var(--color-content);
background: transparent;
cursor: pointer;
}
.ui-switch__thumb {
display: inline-block;
width: 2.5rem;
height: 1.5rem;
border: 1px solid var(--color-border-strong);
border-radius: var(--radius-full);
background: var(--color-disabled-surface);
}
.ui-switch__thumb::after {
display: block;
width: 1rem;
height: 1rem;
margin: 0.2rem;
border-radius: var(--radius-full);
background: var(--color-content-muted);
content: "";
transition: transform var(--duration-normal) var(--easing-standard);
}
.ui-switch[aria-checked="true"] .ui-switch__thumb {
border-color: var(--color-action);
background: var(--color-action);
}
.ui-switch[aria-checked="true"] .ui-switch__thumb::after {
background: var(--color-on-action);
transform: translateX(1rem);
}
[dir="rtl"] .ui-switch[aria-checked="true"] .ui-switch__thumb::after {
transform: translateX(-1rem);
}
.ui-search-field {
position: relative;
display: grid;
grid-template-columns: auto minmax(0, 1fr) auto;
align-items: end;
gap: var(--space-2);
}
.ui-card {
display: flex;
min-width: 0;
flex-direction: column;
gap: 1.25rem;
border: 1px solid var(--color-border);
border-radius: var(--radius-surface);
padding: 1.25rem;
background: var(--color-panel);
box-shadow: 0 8px 28px color-mix(in oklab, var(--color-content) 6%, transparent);
}
.ui-card__header :is(h2, h3, h4),
.ui-card__header p {
margin-block-end: 0;
}
.ui-card__header p {
margin-block-start: 0.4rem;
color: var(--color-content-muted);
line-height: 1.55;
}
.ui-card__content {
flex: 1;
}
.ui-card__footer {
padding-block-start: 1rem;
border-top: 1px solid var(--color-surface-muted);
}
.ui-alert {
display: flex;
align-items: flex-start;
justify-content: space-between;
gap: 1rem;
border: 1px solid var(--color-surface-muted);
border-radius: var(--radius-control);
padding: 1rem;
background: var(--color-surface);
}
.ui-alert--info {
border-color: var(--color-info-border);
background: var(--color-info-surface);
}
.ui-alert--success {
border-color: var(--color-success-border);
background: var(--color-success-surface);
}
.ui-alert--warning {
border-color: var(--color-warning-border);
background: var(--color-warning-surface);
}
.ui-alert--danger {
border-color: var(--color-danger-border);
background: var(--color-danger-surface);
}
.ui-alert__content,
.ui-alert__content p {
margin-block: 0.35rem 0;
color: var(--color-content-muted);
}
.ui-alert__dismiss,
.ui-dialog__close {
display: inline-grid;
width: 2rem;
height: 2rem;
flex: 0 0 auto;
place-items: center;
border: 0;
border-radius: var(--radius-control);
color: var(--color-content);
background: transparent;
font-size: 1.35rem;
cursor: pointer;
}
.ui-alert__dismiss.ui-icon-button,
.ui-dialog__close.ui-icon-button {
min-width: 2rem;
min-height: 2rem;
padding: 0;
}
.ui-alert__dismiss:hover,
.ui-dialog__close:hover {
background: color-mix(in oklab, var(--color-content) 8%, transparent);
}
.ui-badge {
display: inline-flex;
border-radius: 999px;
padding: 0.3rem 0.65rem;
color: var(--color-content);
background: var(--color-surface-muted);
font-size: 0.8rem;
font-weight: 750;
}
.ui-badge--info {
color: var(--color-info-content);
background: var(--color-info-surface);
}
.ui-badge--success {
color: var(--color-success-content);
background: var(--color-success-surface);
}
.ui-badge--warning {
color: var(--color-warning-content);
background: var(--color-warning-surface);
}
.ui-badge--danger {
color: var(--color-danger-content);
background: var(--color-danger-surface);
}
.ui-dialog {
width: min(34rem, calc(100vw - 2rem));
max-height: calc(100vh - 2rem);
box-sizing: border-box;
overflow: auto;
border: 0;
border-radius: var(--radius-surface);
padding: 0;
color: var(--color-content);
background: var(--color-panel);
box-shadow: var(--dialog-elevation);
}
.ui-dialog::backdrop {
background: var(--dialog-backdrop);
backdrop-filter: blur(2px);
}
/* 1106/08-03. `scrollbar-gutter: stable` (base.css) keeps a classic
scrollbar's strip on the right even when the page does not scroll.
The strip shows the root's background colour: `::backdrop`, like every
fixed box, ends at its left edge. While a modal is open the root
background colour is the scrim over the page surface, so the scrim
reaches the window edge. The page paints its own surface (`body`,
base.css), so this shows only in the strip. A page that scrolls has
its scrollbar there instead, as before.
The first attempt (a gradient layer over the surface, matched with
`:modal`) left the strip the surface colour in Chromium; this changes
the colour itself and matches on `[open]`, the attribute showModal()
sets. The Dialog primitive always opens with showModal(), so an open
`.ui-dialog` in a browser is modal. */
:root:has(.ui-dialog[open]) {
background-color: var(--dialog-backdrop-on-surface);
}
.ui-drawer {
width: var(--drawer-width);
max-width: none;
height: 100dvh;
max-height: none;
margin-block: 0;
border-radius: 0;
}
.ui-drawer--start {
margin-inline: 0 auto;
}
.ui-drawer--end {
margin-inline: auto 0;
}
.ui-drawer .ui-dialog__surface {
min-height: 100%;
box-sizing: border-box;
}
.ui-popover,
.ui-menu,
.ui-tooltip {
position: relative;
display: inline-block;
}
.ui-popover__content,
.ui-menu__content {
position: absolute;
z-index: var(--layer-popover);
top: calc(100% + var(--space-2));
inset-inline-start: 0;
min-width: 12rem;
border: 1px solid var(--color-border);
border-radius: var(--radius-control);
padding: var(--space-2);
background: var(--color-surface-elevated);
box-shadow: var(--elevation-popover);
}
.ui-menu__content {
display: grid;
gap: var(--space-1);
}
.ui-menu__item {
min-height: var(--size-control-sm);
border: 0;
border-radius: var(--radius-control);
padding: var(--space-2) var(--space-3);
color: var(--color-content);
background: transparent;
text-align: start;
cursor: pointer;
}
.ui-menu__item:hover,
.ui-menu__item:focus-visible {
background: var(--color-surface-muted);
}
.ui-tooltip__content {
position: absolute;
z-index: var(--layer-popover);
inset-block-end: calc(100% + var(--space-2));
inset-inline-start: 50%;
width: max-content;
max-width: 16rem;
padding: var(--space-2);
border-radius: var(--radius-control);
color: var(--color-content-inverse);
background: var(--color-content);
opacity: 0;
pointer-events: none;
transform: translateX(-50%);
transition: opacity var(--duration-fast) var(--easing-standard);
}
/* 1112/05-06. WCAG 1.4.13 hoverable: a shown tooltip takes the pointer,
and the bridge below it covers the gap to the trigger, so moving onto it
keeps .ui-tooltip hovered. A hidden one stays out of the pointer's way. */
.ui-tooltip__content::before {
position: absolute;
inset-inline: 0;
inset-block-start: 100%;
block-size: var(--space-2);
content: "";
}
.ui-tooltip:focus-within .ui-tooltip__content,
.ui-tooltip:hover .ui-tooltip__content {
opacity: 1;
pointer-events: auto;
}
.ui-progress,
.ui-progress__label {
display: grid;
gap: var(--space-2);
}
.ui-progress__label {
grid-template-columns: 1fr auto;
}
.ui-progress__bar {
width: 100%;
accent-color: var(--color-action);
}
.ui-skeleton--text {
height: 1em;
}
.ui-skeleton--control {
height: var(--size-control-md);
}
.ui-skeleton--surface {
height: 6rem;
}
.ui-separator {
width: 100%;
border: 0;
border-block-start: 1px solid var(--color-border);
}
.ui-breadcrumbs ol,
.ui-pagination,
.ui-tabs__list {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: var(--space-2);
margin: 0;
padding: 0;
list-style: none;
}
.ui-breadcrumbs li:not(:last-child)::after {
margin-inline-start: var(--space-2);
color: var(--color-content-muted);
content: "/";
}
.ui-tabs {
display: grid;
gap: var(--space-3);
}
.ui-tabs__list {
border-block-end: 1px solid var(--color-border);
}
.ui-tabs__tab {
min-height: var(--size-touch-target);
border: 0;
border-block-end: 0.2rem solid transparent;
padding: var(--space-2) var(--space-3);
color: var(--color-content-muted);
background: transparent;
cursor: pointer;
}
.ui-tabs__tab[aria-selected="true"] {
border-block-end-color: var(--color-action);
color: var(--color-content);
font-weight: var(--font-weight-bold);
}
.ui-tabs__panel {
padding: var(--space-3);
}
.ui-toast-region {
position: fixed;
z-index: var(--layer-toast);
inset-block-end: var(--space-4);
inset-inline-end: var(--space-4);
display: grid;
width: var(--toast-width);
gap: var(--space-2);
}
.ui-toast {
display: flex;
align-items: flex-start;
justify-content: space-between;
gap: var(--space-3);
border: 1px solid var(--color-border);
border-inline-start: 0.25rem solid var(--color-info-border);
border-radius: var(--radius-control);
padding: var(--space-3);
background: var(--color-surface-elevated);
box-shadow: var(--elevation-popover);
}
.ui-toast--success {
border-inline-start-color: var(--color-success-border);
}
.ui-toast--warning {
border-inline-start-color: var(--color-warning-border);
}
.ui-toast--danger {
border-inline-start-color: var(--color-danger-border);
}
.ui-toast p {
margin: var(--space-1) 0 0;
color: var(--color-content-muted);
}
.ui-data-table__scroll {
max-width: 100%;
overflow-x: auto;
}
.ui-data-table {
width: 100%;
border-collapse: collapse;
}
.ui-data-table caption {
margin-block-end: var(--space-2);
font-weight: var(--font-weight-bold);
text-align: start;
}
.ui-data-table th,
.ui-data-table td {
border-block-end: 1px solid var(--color-border);
padding: var(--space-3);
text-align: start;
}
.ui-search-filter-toolbar,
.ui-pagination-bar {
display: flex;
flex-wrap: wrap;
align-items: end;
justify-content: space-between;
gap: var(--space-3);
}
.ui-disclosure-group {
display: grid;
gap: var(--space-2);
}
.ui-disclosure-group details {
border: 1px solid var(--color-border);
border-radius: var(--radius-control);
padding: var(--space-3);
}
.ui-disclosure-group summary {
min-height: var(--size-control-sm);
cursor: pointer;
font-weight: var(--font-weight-bold);
}
.ui-focus-ring {
display: inline-flex;
border-radius: var(--radius-control);
}
.ui-focus-ring:focus-within {
outline: 0.1875rem solid var(--color-focus);
outline-offset: 0.1875rem;
}
.ui-dialog__surface {
padding: 1.5rem;
}
.ui-dialog__header {
display: flex;
align-items: flex-start;
justify-content: space-between;
gap: 1rem;
}
.ui-dialog__header h2 {
margin-block-end: 0.35rem;
}
.ui-dialog__header p,
.ui-dialog__content p {
color: var(--color-content-muted);
line-height: 1.6;
}
.ui-dialog__content {
padding-block: 1rem;
}
.ui-dialog__actions {
display: flex;
flex-wrap: wrap;
justify-content: flex-end;
gap: 0.75rem;
padding-block-start: 1rem;
border-top: 1px solid var(--color-surface-muted);
}
}