qufox
Design system
qufox, Design System, v0.53.0

A design system for
AI and humans alike
AI와 사람이 함께 쓰는
디자인 시스템

Design system — the single source of truth (SSOT) for tokens, components, and patterns. Dark-first, light-ready, white-label from one seed color. AI fetches llms.txt, components.json to consume tokens, classes, and conventions directly; humans browse the catalog.Design system — 토큰, 컴포넌트, 패턴의 단일 진실원(SSOT)입니다. 다크 우선, 라이트 대응, 색 시드 하나로 화이트라벨. AI는 llms.txt, components.json을 fetch 해 토큰, 클래스, 규약을 그대로 소비하고, 사람은 카탈로그로 봅니다.

186Components컴포넌트
119Generic범용 (generic)
357Design tokens디자인 토큰
2Themes (dark, light)테마 (다크, 라이트)

Two audiences, one source of truth두 청중, 하나의 진실원

AI

Consume machine-readable outputs기계가독 산출물 소비

Agents read conventions from llms.txt, classes/variants/required-tokens/a11y from components.json, and tokens from tokens.json, then apply them to the target app. The web and local outputs are identical.에이전트는 llms.txt로 규약을, components.json으로 클래스, 변형, 필요 토큰, 접근성을, tokens.json으로 토큰을 읽어 작업 대상 앱에 반영합니다. 웹, 로컬 2채널 산출물은 동일합니다.

Agent guide: AGENTS.md →에이전트 가이드: AGENTS.md →
Humans사람

Browse the catalog카탈로그로 탐색

From the left menu, explore one component per page. Each page shows a live preview, variant gallery, required tokens, and accessibility notes. Switch theme (dark/light) and brand color instantly from the top bar.좌측 메뉴에서 컴포넌트를 1개=1페이지로 살펴봅니다. 각 페이지는 라이브 프리뷰, 변형 갤러리, 필요 토큰, 접근성 주의를 함께 보여줍니다. 다크/라이트 테마와 브랜드 색을 상단에서 즉시 전환할 수 있습니다.

Button page example →Button 페이지 예시 →

Apply with AIAI로 적용하기

Point your agent (Claude, Cursor, Copilot, …) at design.qufox.com — it reads llms.txt for conventions, components.json for classes, variants, required tokens, and a11y, and tokens.json for values, then writes qf-* markup with var(--token). Paste a prompt like these:에이전트(Claude, Cursor, Copilot 등)에게 design.qufox.com을 가리키세요 — llms.txt로 규약을, components.json으로 클래스, 변형, 필요 토큰, 접근성을, tokens.json으로 값을 읽어 qf-* + var(--token) 마크업을 만듭니다. 아래 같은 프롬프트를 붙여넣으세요:

Prompt: set up a project프롬프트: 프로젝트 설정

Set up my project using the design system at design.qufox.com.design.qufox.com 의 디자인 시스템을 사용해서 프로젝트 설정을 해줘.

Prompt: build a screen프롬프트: 화면 만들기

Build a login screen with the design.qufox.com design system.design.qufox.com 디자인 시스템으로 로그인 화면을 만들어줘.

Prompt: restyle existing UI프롬프트: 기존 UI 리스타일

Restyle this component with the design.qufox.com design system.이 컴포넌트를 design.qufox.com 디자인 시스템으로 리스타일 해줘.

Tip: for production, ask it to pin a fixed snapshot (e.g. /v0.53.0/tokens.css) instead of the always-latest root. The agent checks its own output against the rules in llms.txt — no raw values, AA contrast, visible focus, 44px touch targets.팁: 프로덕션에서는 항상-최신 루트 대신 고정 스냅샷(예: /v0.53.0/tokens.css)을 핀하도록 요청하세요. 에이전트는 llms.txt의 규칙(raw 값 금지, AA 대비, 포커스 가시, 44px 터치)으로 자기 출력을 검증합니다.

Direct load: for developers직접 로드: 사람 작업자용

Prefer to wire it up by hand? Browse the catalog, copy a component's markup from its page, and load the CSS directly — design.qufox.com outputs are CORS-enabled, so you can pull them from anywhere (like a CDN). <link> tokens.css + components.css, use qf-* classes, and set color, spacing, and radius only via var(--token).직접 연결하고 싶으신가요? 카탈로그에서 컴포넌트 페이지의 마크업을 복사하고 CSS를 직접 로드하세요 — design.qufox.com 산출물은 CORS 허용이라 어디서나 불러올 수 있습니다(CDN 처럼). tokens.css + components.css를 <link> 하고 qf-* 클래스를 쓰며, 색, 간격, radius는 var(--token)으로만 지정합니다.

<!-- Required: tokens + components -->
<link rel="stylesheet" href="https://design.qufox.com/tokens.css">
<link rel="stylesheet" href="https://design.qufox.com/components.css">
<!-- Optional: mobile (qf-m-*) components -->
<link rel="stylesheet" href="https://design.qufox.com/mobile.css">

<button class="qf-btn qf-btn--primary">Save</button>

Icons reference the sprite (icons.svg) via <use>, and the machine-readable outputs (components.json, tokens.json) are fetchable from the same domain.아이콘은 스프라이트(icons.svg)를 <use>로 참조하고, 기계가독 산출물(components.json, tokens.json)도 같은 도메인에서 fetch 할 수 있습니다.

Versions: latest vs pinned버전: 최신 vs 고정

The root (/tokens.css) is always the latest build — handy for prototyping and AI fetch. For production, pin a fixed snapshot — https://design.qufox.com/v0.53.0/tokens.css. See /versions.json for the published list, or vendor (copy) the build outputs.루트(/tokens.css)는 항상 최신 빌드라 프로토타이핑, AI fetch 에 편합니다. 프로덕션은 고정 스냅샷을 핀하세요 — https://design.qufox.com/v0.53.0/tokens.css. 발행 목록은 /versions.json, 또는 빌드 산출물을 벤더링(복사)해도 됩니다.

Catalog카탈로그

Generic core + optional chat module. Component counts by category.범용 코어(generic) + 선택적 채팅 모듈. 카테고리별 컴포넌트 수입니다.

Resources리소스

Foundations

Color, Type, Space

qufox is a dark-first system. Every surface, text, and border derives from a neutral scale generated along the night-lavender axis, while the violet accent carries the brand contrast.qufox는 dark-first 시스템이에요. 모든 서피스, 텍스트, 보더는 night-lavender 축을 따라 생성된 neutral scale에서 파생되고, violet accent가 브랜드 대비를 담당합니다.

Neutral scale

From the app shell to the header — every dark surface layer is drawn from here.앱 쉘부터 헤더까지 — 다크의 서피스 계층을 전부 여기서 뽑습니다.
--n-0#0E0C2A: app shell
--n-1#141232: chat
--n-2#1A1840: panel
--n-3#221F4F: elevated
--n-4#2C285E: hover
--n-5#3A3570: selected
--n-6#4D4780: border
--n-7#6B6599: disabled
--n-8#9892BF: muted
--n-9#C4BFDC: secondary
--n-10#E9D5FF: text
--n-11#F7F1FF: strong

Accent — violet

The brand accent. Links, CTAs, focus rings, and selected states.브랜드 액센트. 링크, CTA, focus ring, 선택 상태.
--a-50#F5EEFF
--a-100#E9DCFF
--a-200#D4B8FF
--a-300#B48EFF
--a-400#9D6FFD: hover
--a-500#8B5CF6: primary
--a-600#7848E0: press
--a-700#5F38B8

Status

--status-onlineonline
--status-idleidle
--status-dndDnD / error
--status-offlineoffline

Typography

Display/body: Pretendard Variable, Mono: Geist Mono
--fs-32 / 60032/1.1Display title
--fs-24 / 60024/1.2Page heading
--fs-20 / 60020/1.2Modal title
--fs-18 / 60018/1.35Section title
--fs-15 / 40015/1.5Message body — the default reading size for chat messages and settings copy.
--fs-13 / 40013/1.5Secondary copy, helper text, metadata.
--fs-11 mono / 600: caps11EYEBROW LABEL

Spacing

4px base. Most steps use 1–8, while 9+ are reserved for page-level spacing.4px base. 대부분 1–8을 사용하고, 9+는 페이지 레벨 여백.
--s-24px
--s-38px
--s-412px
--s-516px
--s-620px
--s-724px
--s-832px
--s-940px
--s-1048px

Radii

--r-xs: 4px
--r-sm: 6px
--r-md: 8px, Button
--r-lg: 10px, Input
--r-xl: 14px, Card
--r-pill: Avatar
Foundations

Elevation, Motion

In dark mode, shadows alone struggle to convey depth. Combine border and shadow to separate surface hierarchy.다크에서는 shadow만으로 깊이를 만들기 어렵습니다. border + shadow를 함께 써서 표면 위계를 분리하세요.

Shadows

--elev-1
--elev-2
--elev-3
--elev-4

--elev-1 topbar, --elev-2 tooltip / toast, --elev-3 dropdown / popover, --elev-4 modal

Motion

Keep transitions short and crisp. Snappy feedback, just like Discord.전환은 짧고 명확하게. Discord처럼 snappy한 피드백.
--dur-fast
140ms
hover, focus, active
--dur-base
220ms
menu open, toast slide
--dur-slow
320ms
modal enter, page transition

Easings

--ease-standard:   cubic-bezier(0.2, 0, 0, 1);     /* default - most UI transitions */
--ease-emphasized: cubic-bezier(0.3, 0, 0, 1);     /* emphasized - modal, page */
--ease-spring:     cubic-bezier(0.34, 1.56, 0.64, 1);  /* overshoot - server button round, switch */
Foundations

Markdown / Prose

When the consuming app converts Markdown to HTML and wraps it in <article class="qf-prose">, the document renders in the design system's tone. Below are the Markdown source (left) and the rendered result (right) of the same document.소비 앱이 마크다운을 HTML 로 변환한 뒤 <article class="qf-prose"> 로 감싸면 문서가 디자인 시스템 톤으로 렌더됩니다. 아래는 같은 문서의 마크다운 소스(좌)와 렌더 결과(우)입니다.

Markdown sourceMarkdown 소스
# Getting Started with the API

This SDK is **simple**. For details, see the [docs](#).

## Installation

Install with `npm i @acme/sdk`.

- Issue a token
- Create a client
  1. Enter the key
  2. Connect

> Keep your key safe.

```js
const c = new Client(key);
await c.connect();
```

| Method | Description |
|---------|------|
| connect | Connect |
| close | Close |

---
End.
Rendered result: .qf-prose렌더 결과: .qf-prose

Getting Started with the APIAPI 시작하기

This SDK is simple. For details, see the docs.이 SDK는 간단합니다. 자세한 건 문서를 보세요.

Installation설치

Install with npm i @acme/sdk.npm i @acme/sdk 로 설치합니다.

  • Issue a token토큰 발급
  • Create a client클라이언트 생성
    1. Enter the key키 입력
    2. Connect연결
Keep your key safe.키는 안전하게 보관하세요.
const c = new Client(key);
await c.connect();
Method메서드Description설명
connectConnect연결
closeClose종료

End.끝.

Usage사용법

<!-- App: convert Markdown → HTML (marked, markdown-it, etc.), then wrap in .qf-prose -->
<article class="qf-prose">{{renderedHtml}}</article>

For the component interface (classes, required tokens, accessibility), see the Display → Prose page (/prose) or components.json.컴포넌트 인터페이스(클래스, 필요 토큰, 접근성)는 Display → Prose 페이지(/prose) 또는 components.json 참조.

Code syntax highlighting코드 구문 강조

The code blocks in this catalog are colored by a dependency-free build-time highlighter. The highlighting engine is the responsibility of the consumer (Prism, Shiki, highlight.js, etc.) or your own builder, while the colors come from the DS's theme-aware, brand-following tokens — map the highlighter's output classes to the qf-syntax__* classes below (or the --syntax-* tokens) for brand-consistent code blocks.이 카탈로그의 코드 블록은 빌드타임 무의존 하이라이터로 칠해집니다. 하이라이트 엔진은 소비처(Prism, Shiki, highlight.js 등)나 자체 빌더가 담당하고, 색은 DS의 테마 인지, 브랜드 추종 토큰이 담당합니다 — 하이라이터 출력 클래스를 아래 qf-syntax__*(또는 --syntax-* 토큰)에 매핑하면 브랜드 일관 코드 블록이 됩니다.

<span class="qf-syntax__punct">&lt;</span><span class="qf-syntax__tag">button</span> <span class="qf-syntax__attr">class</span>=<span class="qf-syntax__string">"qf-btn"</span><span class="qf-syntax__punct">&gt;</span>

--syntax-tag --syntax-attr --syntax-string --syntax-comment --syntax-punct

Layout & structure

Stack

A layout primitive that stacks child elements vertically at a consistent spacing.자식 요소를 세로로 일정 간격으로 쌓는 레이아웃 프리미티브입니다.

.qf-stacklayer: generic

Preview

First
Second
<div class="qf-stack">
  <div>First</div>
  <div>Second</div>
</div>

Variants

First
Second
qf-stack--tight
First
Second
qf-stack--loose

Required tokens

--s-4 --s-2 --s-6

Accessibility

Layout-only, so it carries no semantics of its own. For a meaningful grouping, apply it to an appropriate element such as ul or section. Spacing is controlled via --qf-gap.레이아웃 전용이라 자체 시맨틱이 없습니다. 의미 있는 묶음이면 ul/section 등 적절한 요소에 적용하세요. 간격은 --qf-gap 으로 조절합니다.

Layout & structure

Cluster

A layout primitive that groups elements horizontally and wraps when they overflow (toolbars, tag groups, action rows).요소를 가로로 묶고 넘치면 줄바꿈하는 레이아웃 프리미티브입니다(툴바, 태그군, 액션열).

.qf-clusterlayer: generic

Preview

<div class="qf-cluster">
  <button class="qf-btn qf-btn--primary">Save</button>
  <button class="qf-btn qf-btn--ghost">Cancel</button>
</div>

Variants

qf-cluster--between
qf-cluster--end
qf-cluster--tight

Required tokens

--s-3 --s-2

Accessibility

Layout-only. For an action grouping, use a container element that fits its meaning, and keep visual order in sync with DOM order.레이아웃 전용. 액션 묶음이면 의미에 맞는 컨테이너 요소를 쓰고, 시각 순서와 DOM 순서를 일치시킵니다.

Layout & structure

Grid

A responsive grid layout whose cells fill in automatically.셀이 자동으로 채워지는 반응형 그리드 레이아웃입니다.

.qf-gridlayer: generic

Preview

A
B
<div class="qf-grid">
  <section class="qf-card">
    <div class="qf-card__body">A</div>
  </section>
  <section class="qf-card">
    <div class="qf-card__body">B</div>
  </section>
</div>

Variants

A
B
qf-grid--cols-2
A
B
qf-grid--cols-3
A
B
qf-grid--cols-4

Required tokens

--s-4 --grid-cell-min

Accessibility

Layout-only. Use --qf-grid-min to control the minimum cell width, and preserve DOM order when content order is meaningful.레이아웃 전용. --qf-grid-min 으로 최소 셀폭을 조절하며, 콘텐츠 순서가 의미를 가지면 DOM 순서를 유지합니다.

Layout & structure

Container

A centered body container (max width + side padding). Which one when: --narrow (640px) for forms and a single document body; --reading (720px) for list-style reading pages such as news, issues, or a blog index (fits a one-line title, a three-line summary, and one row of source chips); default (960px) for dashboards, tables, and two-column layouts; --wide (1200px) for wide tables and charts.중앙 정렬 본문 컨테이너입니다(최대폭 + 좌우 여백). 언제 무엇을 쓰나: --narrow(640px)는 폼과 단일 문서 본문. --reading(720px)은 뉴스, 이슈, 블로그 같은 목록형 읽기 화면(제목 한 줄, 요약 3줄, 출처 칩 한 줄이 들어가는 폭). 기본(960px)은 대시보드, 표, 2열 레이아웃. --wide(1200px)는 넓은 표와 차트.

.qf-containerlayer: generic

Preview

Title

<main class="qf-container qf-container--narrow">
  <h1>Title</h1>
</main>

Variants

Title

qf-container--narrow

Title

qf-container--wide

Title

qf-container--reading

Required tokens

--container-w --container-w-narrow --container-w-wide --s-5 --container-w-reading

Accessibility

Layout-only. Keeps page content width and horizontal padding consistent. Typically applied to main or section.레이아웃 전용. 페이지 본문 폭과 좌우 여백을 일관되게 유지합니다. 보통 main/section 에 적용합니다.

Layout & structure

Divider

A horizontal or vertical line that separates content.콘텐츠를 구분하는 수평 또는 수직 선입니다.

.qf-dividerlayer: generic

Preview


<hr class="qf-divider">

Variants


qf-divider--vertical

Required tokens

--divider --s-5 --s-4

Accessibility

Express a meaningful separation with hr or role=separator. If it is purely decorative, consider aria-hidden.의미 있는 구분은 hr 또는 role=separator 로 표현합니다. 순수 장식이면 aria-hidden 을 고려합니다.

Layout & structure

AppShell

A general app shell that lays out a header, sidebar, main content, and an optional right aside. Columns and the header derive from which regions you include — one, two, or three columns, with or without a header, no modifier needed. A container query collapses the sidebar and aside to a single column when the shell gets narrow (mobile). Tune widths with --sidenav-w and --aside-w.헤더, 사이드바, 본문, 우측 보조 패널을 배치하는 범용 앱 셸입니다. 어떤 영역을 넣느냐로 1, 2, 3단과 헤더 유무가 자동 결정됩니다(별도 모디파이어 불필요). 컨테이너 쿼리로 셸 폭이 좁아지면(모바일) 사이드바, aside가 접혀 단일 컬럼이 됩니다. 폭은 --sidenav-w, --aside-w로 조절합니다.

.qf-app-shelllayer: generic

Preview

Dashboard

A general app shell that lays out a header, sidebar, and main content. Columns derive from which regions you include.

<div class="qf-app-shell">
  <header class="qf-app-shell__navbar">
    <nav class="qf-navbar">
      <span class="qf-navbar__brand">Acme</span>
      <span class="qf-navbar__spacer">
      </span>
      <a class="qf-navbar__link" aria-current="page">Dashboard</a>
      <a class="qf-navbar__link">Reports</a>
    </nav>
  </header>
  <nav class="qf-app-shell__sidenav qf-sidenav">
    <div class="qf-sidenav__section">Menu</div>
    <a class="qf-sidenav__item" aria-current="page">Dashboard</a>
    <a class="qf-sidenav__item">Members</a>
    <a class="qf-sidenav__item">Settings</a>
  </nav>
  <main class="qf-app-shell__main">
    <h1>Dashboard</h1>
    <p>A general app shell that lays out a header, sidebar, and main content. Columns derive from which regions you include.</p>
  </main>
</div>

Examples예시

Dashboard

Header plus content — include only the navbar and main.

1 column, with header

Dashboard

Just the content area — include only main.

1 column, no header

Dashboard

Sidebar plus content under a header — the default layout.

2 columns, with header

Dashboard

Sidebar plus content, with no top header.

2 columns, no header

Dashboard

Sidebar, content, and a right aside — a three-column workspace.

3 columns, with header

Dashboard

Three columns without a header bar.

3 columns, no header

Dashboard

The same three-column markup: at a narrow width the sidebar and aside collapse to a single column. The app surfaces them via a drawer or tab bar.

Mobile (≤600px — sidebar & aside collapse)

Variants

qf-app-shell__navbar qf-app-shell__sidenav qf-app-shell__main qf-app-shell__aside qf-app-shell--locked qf-scroll-region

Required tokens

--sidenav-w --aside-w --shell-vh

Accessibility

This is a layout container. Place landmarks (header, nav, main) inside it so assistive technology can recognize each region. Control the sidebar width with --sidenav-w.레이아웃 컨테이너입니다. 내부에 landmark(header, nav, main)를 두어 보조기술이 영역을 인식하게 합니다. 사이드바 폭은 --sidenav-w 로 조절합니다.

Layout & structure

PageHeader

A page header that groups the page title, subtitle and actions. Title and subtitle always stack vertically (subtitle under the title) even as direct children without a wrapper; only the actions (__actions) sit beside them on the right. --hero is for a site's first screen: a larger title (32px) and a roomier subtitle at body size and reading width.페이지 제목, 부제, 액션을 묶는 페이지 헤더입니다. 제목과 부제는 감싸지 않고 직접 자식으로 두어도 늘 세로로 쌓이고(부제는 제목 아래), 액션(__actions)만 오른쪽에 나란히 섭니다. --hero 는 사이트 첫 화면용으로 제목을 한 단계 크게(32px), 부제를 본문 크기와 가독 폭으로 넉넉히 둡니다.

.qf-page-headerlayer: generic

Preview

Members

12 members

<div class="qf-page-header">
  <div>
    <h1 class="qf-page-header__title">Members</h1>
    <p class="qf-page-header__subtitle">12 members</p>
  </div>
  <div class="qf-page-header__actions">
    <button class="qf-btn qf-btn--primary">Invite</button>
  </div>
</div>

Examples예시

Members

12 members

Unwrapped: title, subtitle and actions as direct children — same layout as the wrapped form

Communities

The 12 communities Coissue reads. An issue appears when two or more of them talk about the same thing, so which community said what first is the site's raw material.

Unwrapped, long subtitle, no actions — the subtitle stays under the title

Today's issues

Five issues a day that several communities talked about, in a few sentences.

--hero, unwrapped

Variants

Members

12 members

qf-page-header--hero

Parts & more: 구성 요소, 기타: qf-page-header__title qf-page-header__subtitle qf-page-header__actions

Required tokens

--s-7 --fs-24 --text-strong --text-muted --tracking-tight --fs-32 --fs-16 --text-secondary --container-w-narrow --s-8 --s-5 --s-2 --s-4 --fs-14 --s-1 --s-3 --font-sans --lh-tight --lh-normal

Accessibility

Make the title an h1 (or a heading appropriate to the page hierarchy) to convey document structure. Keep the action group's visual order in sync with its DOM order.제목은 h1(또는 페이지 계층에 맞는 heading)으로 두어 문서 구조를 전달합니다. 액션 묶음은 시각/DOM 순서를 일치시킵니다.

Layout & structure

TwoCol

A two-column frame for wide screens (main column + aside). Inside qf-container--wide (1200px), from 1100px up the main column (max --container-w-reading, 720px) and the aside (--sz-aside, 300px) sit 40px apart, centered as a pair, so between 1100 and 1200 the main stays at 720 and the aside does not shrink. Below that it is one column — the main column centers like today's reading container and the aside drops below it (gap --s-10). In two columns the aside sticks under the sticky top bar (adjust with --qf-aside-top) and slides to the top when the bar hides (is-hidden). Keep the aside shorter than the viewport — about 560px, up to three sections, sized for a 768px-tall laptop (real viewport ≈ 650–680); a taller aside gets its bottom cut off.넓은 화면의 2열 틀입니다(본문 열 + 사이드 열). qf-container--wide(1200px) 안에 두면 1100px 이상에서 본문 열(최대 --container-w-reading 720px)과 사이드 열(--sz-aside 300px)이 간격 40px 로 가운데 정렬되어, 1100~1200 에서도 본문이 720 을 유지하고 사이드가 좁아지지 않습니다. 그 아래에서는 1열 — 본문 열이 지금의 reading 컨테이너처럼 가운데 오고 사이드는 본문 뒤로 내려갑니다(간격 --s-10). 2열에서 사이드는 고정 상단 바 아래에 sticky 로 붙고(--qf-aside-top 으로 바 높이 조정), 바가 is-hidden 으로 숨으면 맨 위로 미끄러집니다. 사이드는 뷰포트보다 짧게 두세요 — 768px 높이 노트북(실제 뷰포트 ≈ 650~680)을 기준으로 약 560px, 섹션 3개 이내. 길면 아래가 가려집니다.

.qf-twocollayer: generic

Preview

Politics4 communities · 9 posts

Supreme Court admits chief justice filed false expense reports

The court acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate.

<div class="qf-twocol" style="max-width:100%">
  <main class="qf-twocol__main">
    <article class="qf-story">
      <div class="qf-story__kicker">
        <span class="qf-eyebrow">Politics</span>
        <span>4 communities · 9 posts</span>
      </div>
      <h2 class="qf-story__title">Supreme Court admits chief justice filed false expense reports</h2>
      <p class="qf-story__summary">The court acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate.</p>
    </article>
  </main>
  <aside class="qf-twocol__aside qf-aside">
    <section class="qf-aside__section">
      <h2 class="qf-aside__title">Trending now</h2>
      <ol class="qf-ranklist" role="list">
        <li class="qf-ranklist__item">
          <a class="qf-ranklist__link" href="#r1">
            <span class="qf-ranklist__title">Supreme Court admits false expense reports</span>
            <span class="qf-ranklist__meta">8 communities, 51 posts</span>
          </a>
        </li>
        <li class="qf-ranklist__item">
          <a class="qf-ranklist__link" href="#r2">
            <span class="qf-ranklist__title">Central bank holds rates</span>
            <span class="qf-ranklist__meta">3 communities, 5 posts</span>
          </a>
        </li>
      </ol>
    </section>
  </aside>
</div>

Variants

qf-twocol__main qf-twocol__aside

Required tokens

--container-w-reading --sz-aside --s-9 --s-10 --s-6 --h-navbar --dur-base --ease-standard

Accessibility

Put the main element first and the aside after it so reading order stays main → aside in one column too. Make aside section titles h2 so they enter the outline. Keep the aside short enough that every focusable item inside it is visible while stuck.본문(main 요소)을 먼저, 사이드(aside 요소)를 뒤에 두어 1열에서도 읽기 순서가 본문 → 사이드가 되게 합니다. 사이드의 섹션 제목은 h2 로 두어 문서 개요에 들어가게 합니다. sticky 사이드가 가리는 영역이 없도록 사이드 안에는 포커스 대상이 뷰포트 안에 다 보이는 길이만 둡니다.

Layout & structure

Aside

Content of the aside column: a stack of sections (qf-aside__section), each with a title (qf-aside__title — 12px 600 caps, --text-muted, same tone as qf-keypoints__title) and a body. One step quieter than the main column (14px, --text-secondary), --s-6 between sections, no boxes or rules — the column itself is the separation. Inside go qf-ranklist (ranking), a group of qf-stat--sm (numbers), qf-chips with qf-chip__count (per-category counts), and qf-sources with qf-source--link (community links).사이드 열의 내용입니다: 섹션(qf-aside__section) 묶음, 섹션은 제목(qf-aside__title — 12px 600 대문자, --text-muted, qf-keypoints__title 과 같은 톤)과 본문. 본문보다 한 단계 조용한 톤(14px, --text-secondary)이고 섹션 사이 --s-6. 열 자체가 구분이므로 상자·선을 두르지 않습니다. 안에는 qf-ranklist(순위), qf-stat--sm 묶음(숫자), qf-chips + qf-chip__count(분류별 건수), qf-sources + qf-source--link(커뮤니티 링크) 를 둡니다.

.qf-asidelayer: generic

Preview

<aside class="qf-aside" style="max-width:300px">
  <section class="qf-aside__section" aria-labelledby="as1">
    <h2 class="qf-aside__title" id="as1">Today in numbers</h2>
    <div class="qf-cluster" style="--qf-gap:var(--s-6)">
      <div class="qf-stat qf-stat--sm">
        <span class="qf-stat__value">24</span>
        <span class="qf-stat__label">issues today</span>
      </div>
      <div class="qf-stat qf-stat--sm">
        <span class="qf-stat__value">12</span>
        <span class="qf-stat__label">communities</span>
      </div>
      <div class="qf-stat qf-stat--sm">
        <span class="qf-stat__value">3 min</span>
        <span class="qf-stat__label">since update</span>
      </div>
    </div>
  </section>
  <section class="qf-aside__section" aria-labelledby="as2">
    <h2 class="qf-aside__title" id="as2">By category</h2>
    <div class="qf-chips">
      <a class="qf-chip" href="#c1">
        Politics
        <span class="qf-chip__count">7</span>
      </a>
      <a class="qf-chip" href="#c2">
        Society
        <span class="qf-chip__count">5</span>
      </a>
      <a class="qf-chip" href="#c3">
        Sports
        <span class="qf-chip__count">4</span>
      </a>
    </div>
  </section>
  <section class="qf-aside__section" aria-labelledby="as3">
    <h2 class="qf-aside__title" id="as3">Communities</h2>
    <div class="qf-sources">
      <a class="qf-source qf-source--link" href="#s1">Clien</a>
      <a class="qf-source qf-source--link" href="#s2">Ruliweb</a>
      <a class="qf-source qf-source--link" href="#s3">Ppomppu</a>
      <a class="qf-source qf-source--link" href="#s4">82cook</a>
    </div>
  </section>
</aside>

Variants

qf-aside__section qf-aside__title

Required tokens

--s-6 --s-3 --fs-14 --fs-12 --lh-tight --tracking-caps --text-secondary --text-muted

Accessibility

Use the aside element and make section titles h2 (or the heading level that fits the page). Link each section to its title with aria-labelledby so assistive technology names the region. The uppercase transform is visual only.aside 요소에 두고 섹션 제목은 h2(또는 페이지 계층에 맞는 heading)로 둡니다. 섹션마다 aria-labelledby 로 제목을 연결하면 보조기기가 영역 이름을 읽습니다. 대문자 변환은 시각 표현입니다.

Layout & structure

Footer

A footer within the reading width: a top rule, a note paragraph (qf-footer__note, 13px secondary tone, limited measure), and a link row (qf-footer__links). Keep the note to one paragraph — more small print stops being read. Links are 13px with vertical padding for a 24px+ tap target, and the row keeps its spacing when it wraps on phones. Bottom padding includes the safe area. A leading icon (e.g. RSS) inside a link sits with a --s-1 gap.읽기 폭 안의 바닥글입니다: 위 선, 안내 문단(qf-footer__note, 13px 보조 톤, 줄 길이 제한), 링크 줄(qf-footer__links). 안내는 한 문단으로 쓰기를 권합니다 — 둘 이상이면 작은 글씨가 길어져 읽히지 않습니다. 링크는 13px 에 세로 패딩으로 탭 대상 24px 이상이고 폰에서 두 줄로 감싸도 줄 사이 간격이 유지됩니다. 아래 여백은 안전 영역을 더합니다. 링크 앞에 아이콘(RSS 등)을 두면 간격 --s-1 로 붙습니다.

.qf-footerlayer: generic

Preview

<footer class="qf-footer">
  <p class="qf-footer__note">Summaries are written by AI from community posts and may be inaccurate. Check the original posts for details.</p>
  <nav class="qf-footer__links" aria-label="Site">
    <a href="#about">About</a>
    <a href="#removal">Correction and removal requests</a>
    <a href="#privacy">Privacy policy</a>
  </nav>
</footer>

Variants

qf-footer__note qf-footer__links

Required tokens

--s-10 --s-7 --s-6 --safe-bottom --border --text-muted --text-secondary --text --fs-13 --lh-normal --container-w-narrow --s-2 --s-4 --s-5 --s-1 --ring-focus --r-xs

Accessibility

Use the footer element (contentinfo) and group the links in nav[aria-label] or a ul. Links rely on the link-row context plus hover underline rather than a permanent underline, so use this only in a footer link row. 13px is the floor for secondary text; do not make the note smaller.footer 요소(contentinfo)에 두고 링크 줄은 nav[aria-label] 또는 ul 로 묶습니다. 링크는 밑줄 대신 세로 패딩과 hover 밑줄을 쓰므로 바닥글 맥락(링크 줄)에서만 씁니다. 글자 13px 는 보조 정보의 바닥이며 안내 본문을 더 작게 두지 않습니다.

Layout & structure

MapLayout

A wide-screen map-and-list layout (026, 047). Side by side when the width is 960 (--bp-side) or more, or 600 (--bp-regular) or more and wider than tall: the map leading (remaining width) | the list trailing (width clamp(--sz-pane-min 320, 40%, --sz-pane 360), divider on its leading edge). When JS needs the same condition, use this query as is: matchMedia("(min-width: 960px), (min-width: 600px) and (orientation: landscape)"). Otherwise the web stacks: the map on top (at least --sz-map-min, half the height) with the list below. The app (RN) has two shapes only. At regular width (size class; if it cannot be read, a window at least 600 both wide and tall: the Duo inner display, full-screen iPad, a 1/2 window on a 13-inch iPad), when the box the layout sits in (the tab body without the top bar and the bottom tab bar; even when the tab bar stands at the side, 076 MobileTabBar --side, judge from the tab body as it is with the bottom bar, and split the panes from the width without the side bar) meets the side-by-side condition above, side by side; otherwise its current phone shape (location tab: map + two-detent sheet; timeline: chips + map 42% + list + date bar at the bottom). Phones in landscape and the Duo outer display (even rotated) are compact, so phone shape; the Duo inner display in portrait and iPad mini or 11 in portrait are regular but taller than wide, so they stretch the phone shape (the date bar and chips do not move when opening or closing). App prerequisite: these shapes appear only after lifting the orientation lock (app.json orientation portrait) and supportsTablet false. List column order (as on the web): location tab: status, stale notice, person rows (qf-m-row). Timeline: person chips (qf-chips), date bar (qf-m-datenav), stale, status, day list (qf-m-tl). The person chip row at the top of the list pane (web, app side by side) has s-3 (8) above and below and --m-gutter (16) at the sides, like the day list rows; the s-3 below runs to the date bar's top rule, so even the web's touch chips (40, hit area 44 sticking out 2 each way) do not overlap the date bar buttons. With qf-chips--scroll put this spacing on the outer box (its own padding s-2 and margin -s-2 are for the focus ring). The phone app (map right under the chips) stays as it is (056, operator 10-25: too little space under the people list). The chips and date bar stay at the top of the column and only what is below them scrolls (side by side, controls for a column sit at its top, like Mail's list filter). The top bar (group switcher, status pill, notifications) spans the full width above map and list. Map buttons (qf-map-btns) sit s-4 in from the top trailing corner of the map column, and the open-in-another-app link (qf-map-link, MapButton) s-4 in from the bottom-right corner (069). The callout's (qf-map-callout) "visible map" and the "show all" fit use the map column only (nothing goes under the list column; the web CSS sets overflow hidden, in RN give the map column View overflow: 'hidden'). Fold (iPhone Duo inner display partly folded, app only): the fold (the frame of the fold division ReservedRegion while it is active) becomes the boundary between map and list. Side by side (vertical fold), the map takes the leading part and the list the whole trailing part from the fold's trailing edge (it may exceed the clamp). In the phone shape (inner display portrait, horizontal fold), the timeline map ends at the fold's top edge and the location sheet's high detent puts its top at the fold's bottom edge. Map tiles may run under the fold, but map buttons, qf-map-link, callouts and fitting stay inside the map part without the fold. Fully opened, everything returns. When the size changes (opening, closing, rotating, window size, the fold turning on or off): add no motion. The system shows the resize; do not run qf-enter or the sheet snap (the same under reduced motion). Keep the selected person, date, chips, an open callout (re-decide only its flip and side panning; close it if the pin leaves the column), the list scroll (keep the selected row visible), and the map centre and zoom. But if the person has not moved the map since it was last fitted (no drag, zoom or rotate), refit what was last fitted ("show all", the day, the selected row) to the new map column without motion (076, Den 089): once the size has settled, in the map column minus the fold and the map buttons. When one person was centred, keep that person centred at the same zoom. When the app changes from the phone shape to side by side, the location sheet becomes the list column; going back, the sheet returns to its remembered detent. Web prerequisite: a parent with a definite height (an app shell, 100dvh): then the map fills the screen side by side, and when stacked the list column scrolls instead of the page. Known limit (web): the decision uses viewport orientation, so in browsers where the keyboard shrinks the viewport (Firefox on Android and others) a portrait tablet may switch to side by side while the keyboard is up. Base map (057, Den 068): tile colours are the tokens --map-land, --map-water, --map-green, --map-complex, --map-building, --map-road, --map-road-major, --map-road-highway, --map-road-casing, --map-label, --map-label-strong, --map-label-halo and --map-boundary (dark at the default dark lightness with a Den navy tint, light with white roads on a pale lavender grey). Light base colours stay under 1.5 apart (dark see 059 below) so the route, places and person pin rings (3:1 on every light base; dark see 059 below) and map labels (4.5 on their halo) come first. In the Naver Style Editor (058): keep each default item's hue and lightness order (within the 4.5 floor for text) and move it into the Den tone (schools blue, medical red, sports and parks green, interest areas brown, light major roads pale yellow and orange); tint neutrals navy (dark) or lavender grey (light); push lightness only as far as 3:1 for overlays on base areas and 4.5 for labels on their halo. General POIs (one switch) stay visible with labels lowered to 4.5 to 5 on the halo; banks, shopping and stations under construction are hidden; subway lines, stations, exits and text on icons (road number shields, exit numbers) keep their defaults, as do opacities, the single boundary item and contours. Road and line names that sit straight on the map (라벨[...]) follow the other text: halo --map-label-halo and 4.5:1 (line names keep their official hue and chroma within gamut, move only in lightness, and are kept apart from other lines in the same city). Item values: docs/tasks/058-naver/target-{dark,light}.json, generated by make-style.mjs. Dark (059, operator: keep the default dark lightness and only make the colours Den-like): dark land, base areas, buildings, roads, water and green keep the editor's default dark lightness (OKLCH L) and only take a Den navy tint (land #28293F); general buildings get opacity 1 so they show. Areas are darkened by at most 0.02 L to regain 3:1 (commercial, culture, roads under construction); some still fall below 3:1 (route on road surfaces 1.84, water 2.38, beaches 2.35, low-zoom road lines 1.48 to 2.59). On road surfaces the overlays' 2px casing separates them at 3.02; on water the casing is 2.33.넓은 화면의 지도 + 목록 배치입니다(026, 047). 나란히: 폭 960(--bp-side) 이상이거나, 600(--bp-regular) 이상이면서 가로가 세로보다 길 때 — 앞쪽 지도(남는 폭) | 뒤쪽 목록(폭 clamp(--sz-pane-min 320, 40%, --sz-pane 360), 앞쪽 선 divider). JS 에서 같은 때를 알아야 하면 이 쿼리를 그대로 씁니다: matchMedia("(min-width: 960px), (min-width: 600px) and (orientation: landscape)"). 웹은 그 밖에서 위아래입니다: 지도 위(최소 --sz-map-min, 높이의 절반), 목록 아래. 앱(RN)은 두 모양뿐입니다. regular 폭(size class. 읽지 못하면 창의 가로와 세로가 모두 600 이상: Duo 안쪽, iPad 전체 화면, 13인치 iPad 1/2 창)이면서 이 배치가 놓일 칸(위 막대와 아래 탭 막대를 뺀 탭 본문. 탭 막대가 옆(076 MobileTabBar --side)이어도 아래 막대일 때의 탭 본문으로 판단하고, 칸 폭만 옆 막대를 뺀 폭으로 나눔)이 위 나란히 조건에 들면 나란히, 그 밖은 지금의 폰 모양 그대로입니다(위치 탭 지도 + 두 단계 시트, 타임라인 칩 + 지도 42% + 목록 + 아래 날짜 막대). 폰 가로와 Duo 바깥(가로로 돌려도)은 compact 라 폰 모양, Duo 안쪽 세로와 iPad mini, 11 세로는 regular 지만 세로로 길어 폰 모양을 늘려 씁니다(접고 펼 때 날짜 막대와 칩이 자리를 옮기지 않음). 앱 전제: 화면 방향 고정(app.json orientation portrait)과 supportsTablet false 를 풀어야 이 모양이 나타납니다. 목록 칸 차례(웹과 같음): 위치 탭은 상태, 오래됨 안내, 사람 줄(qf-m-row). 타임라인은 사람 칩(qf-chips), 날짜 막대(qf-m-datenav), 오래됨, 상태, 하루 목록(qf-m-tl). 목록 칸 맨 위의 사람 칩 줄(웹, 앱 나란히)은 위아래 s-3(8), 좌우 --m-gutter(16, 아래 하루 목록 줄과 같음)입니다. 아래 s-3 은 날짜 막대의 위 선까지입니다. 웹 터치 환경의 칩(40, 누르는 곳 44 가 위아래로 2 씩 나옴)도 날짜 막대 단추와 겹치지 않습니다. 칩이 가로 스크롤(qf-chips--scroll)이면 이 여백은 그 바깥 상자에 줍니다(그 클래스의 padding s-2 와 margin -s-2 는 포커스 링용). 폰 앱(칩 아래 바로 지도)은 지금 그대로입니다(056, 운영자 10-25 '사람 목록의 하단 여백 너무 없음'). 칩과 날짜 막대는 목록 칸 맨 위에 붙고 그 아래만 스크롤됩니다(나란히일 때는 그 칸을 다루는 단추를 그 칸 위에, Apple Mail 의 목록 거르기와 같음). 위 막대(그룹 바꾸기, 알약, 알림)는 지도와 목록 위로 화면 폭 전체입니다. 지도 단추(qf-map-btns)는 지도 칸의 위 뒤쪽 모서리에서 s-4 안쪽, 다른 앱에서 여는 링크(qf-map-link, MapButton)는 아래 오른쪽 모서리에서 s-4 안쪽입니다(069). 말풍선(qf-map-callout)의 '보이는 지도 칸'과 '모두 보기'의 맞춤은 지도 칸만입니다(목록 칸 밑으로 들어가지 않음. 웹은 CSS 가 overflow hidden, RN 은 지도 칸 View 에 overflow: 'hidden' 을 줍니다). 접힘(iPhone Duo 안쪽 화면을 반쯤 접었을 때, 앱만): 접힌 곳(ReservedRegion 의 접힘 division 이 활성일 때 그 frame)이 지도와 목록의 경계가 됩니다. 나란히(접힌 곳이 세로)면 지도는 앞쪽 조각, 목록은 접힌 곳 뒤 끝부터 뒤쪽 조각 전부(clamp 를 넘어도 됨). 폰 모양(안쪽 세로, 접힌 곳이 가로)이면 타임라인 지도는 접힌 곳 위 끝까지, 위치 탭 시트의 높은 단계는 위 끝을 접힌 곳 아래 끝에 맞춥니다. 지도 바탕은 접힌 곳 밑까지 그려도 되지만 지도 단추, qf-map-link, 말풍선, 맞춤은 접힌 곳을 뺀 지도 조각 안에서만. 다 펴면 원래 자리로 돌아갑니다. 크기가 바뀔 때(펴고 접기, 돌리기, 창 크기, 접힘이 켜지고 꺼짐): 움직임을 넣지 않습니다. 크기 바뀜은 시스템이 보여 주고, qf-enter 나 시트가 붙는 움직임을 걸지 않습니다(동작 줄이기에서도 같음). 고른 사람, 날짜, 칩, 열린 말풍선(뒤집기와 옆 옮기기만 다시 정하고, 핀이 칸 밖이면 닫음), 목록 스크롤(고른 줄이 보이게), 지도 가운데와 확대는 그대로 둡니다. 다만 맞춘 뒤 사람이 지도를 움직이지 않았으면(끌기, 확대, 돌리기 없음) 마지막에 맞춘 것('모두 보기', 하루, 고른 줄)을 새 지도 칸에 움직임 없이 다시 맞춥니다(076, Den 089). 크기가 정해진 뒤 한 번, 접힌 곳과 지도 단추를 뺀 지도 칸으로 합니다. 한 사람을 가운데 둔 채면 그 사람을 가운데에 두고 확대는 그대로입니다. 앱이 폰 모양에서 나란히로 바뀌면 위치 탭의 시트가 목록 칸이 되고, 돌아오면 시트는 기억한 단계로 돌아갑니다. 웹 전제: 부모의 높이가 정해져 있어야 합니다(앱 셸, 100dvh). 그래야 나란히일 때 지도가 화면을 채우고, 위아래일 때 목록 칸이 페이지 대신 스크롤됩니다. 알려진 한계(웹): 뷰포트의 방향으로 정하므로 키보드가 뷰포트를 줄이는 브라우저(Android Firefox 등)에서 세로 태블릿에 키보드가 뜨면 나란히로 바뀔 수 있습니다. 지도 바탕(057, Den 068): 지도 타일의 색은 토큰 --map-land(육지), --map-water, --map-green(녹지), --map-complex(단지, 부지), --map-building, --map-road, --map-road-major, --map-road-highway, --map-road-casing(도로 테두리), --map-label(지명, 도로 이름, 공공 장소), --map-label-strong(구, 동, 역 이름), --map-label-halo, --map-boundary 입니다. 다크는 bg-app 남색 계열이고 라이트는 흰 도로에 옅은 보라 회색 바탕입니다. 라이트는 바탕끼리 1.5 아래로 낮게 두고(다크는 아래 059), 그 위 그림이 먼저 보입니다: 경로(--map-route), 장소(--map-place), 사람 핀 고리(--viz-1~8)는 라이트의 모든 바탕 위 3:1 이상(다크는 아래 059), 지도 글자는 halo 위 4.5 이상입니다(contrast-check). 지도 스타일 편집기(Naver Style Editor)에 넣을 때(058, 운영자 '같은 색으로 도배하지 말고 기존의 다양한 색을 조화롭게'): 편집기 기본 템플릿의 색상(hue)과 밝기 순서를 살려(글자는 4.5 바닥 안에서) 항목마다 Den 톤으로 옮깁니다. 학교 단지는 푸르게, 의료는 붉게, 스포츠와 공원은 초록, 관심영역은 갈색, 라이트의 큰 도로는 옅은 노랑과 주황 그대로입니다. 무채색은 다크 남색, 라이트 보라 회색으로 틴트하고, 바탕 면은 그 위 그림 3:1, 글자는 halo 위 4.5 까지만 밝기를 밀어냅니다. 일반 POI(음식, 카페, 교육, 의료가 한 스위치)는 숨기지 않고 글자를 halo 위 4.5~5 로 낮춥니다. 은행, 쇼핑편의, 공사중 역은 숨깁니다. 지하철 노선, 역, 출구와 아이콘 위 글자(도로번호 방패, 출구번호)는 기본값 그대로입니다. 지도 위에 바로 놓이는 도로 이름과 노선 이름(라벨[...])은 다른 글자처럼 halo 를 --map-label-halo 로 하고 4.5 를 지킵니다(노선 이름은 공식 색의 색상과 채도를 색역 안에서 두고 밝기만 밀며, 같은 도시의 노선끼리 색이 붙지 않게 합니다). 투명도와 경계(한 항목), 등고는 기본값 그대로입니다. 항목별 값은 docs/tasks/058-naver/target-{dark,light}.json(make-style.mjs 가 기본값에서 만듦). 다크(059, 운영자 '육지 밝기를 기본 다크랑 거의 맞춰줘. 주요 요소의 밝기는 거의 맞추는 선에서 색만 den 스럽게'): 다크의 육지, 바탕 면, 건물, 도로, 수계, 녹지는 편집기 기본 다크의 밝기(OKLCH L)를 그대로 두고 색조만 Den 남보라로 옮깁니다(육지 #28293F). 일반건물은 투명도 1 로 보이게 합니다. 기본 L 에서 0.02 안에서만 어둡게 밀어 3:1 을 되찾고(상업, 문화, 공사중 도로), 그래도 안 되는 면이 남습니다(도로 면 경로 1.84, 물 2.38, 해수욕장 2.35, 낮은 배율 도로 선 1.48~2.59). 도로 면 위는 그림의 2px casing 이 면과 3.02 로 가르고, 물 위 casing 은 2.33 입니다.

.qf-map-layoutlayer: generic

Preview

M
Minsu
2 min ago
<div class="qf-map-layout" style="height:260px">
  <div class="qf-map-layout__map" style="background:var(--bg-panel)">
  </div>
  <div class="qf-map-layout__panel">
    <div class="qf-m-row">
      <span class="qf-avatar qf-avatar--md qf-avatar--ring" style="--qf-member-color:var(--viz-3)">M</span>
      <div>
        <div class="qf-m-row__primary">Minsu</div>
        <div class="qf-m-row__secondary">2 min ago</div>
      </div>
      <span>
      </span>
    </div>
  </div>
</div>

Variants

qf-map-layout__map qf-map-layout__panel

Required tokens

--sz-map-panel --sz-map-min --divider --bg-app --sz-pane --sz-pane-min --bp-regular --bp-side --map-land --map-water --map-green --map-complex --map-building --map-road --map-road-major --map-road-highway --map-road-casing --map-label --map-label-strong --map-label-halo --map-boundary

Accessibility

Name the map region (role="application" aria-label="Family map"); the list carries the same information as text and is the main path for keyboard and screen-reader users. Selecting a row moves the map and vice versa.지도는 <div role="application" aria-label="가족 지도"> 처럼 이름을 두고, 목록은 지도와 같은 정보를 글로 담아 키보드·스크린리더 사용자의 주 경로가 됩니다(지도만으로 전하지 않음). 목록 줄을 고르면 지도가 따라가고 그 반대도.

Layout & structure

Split

A list | content layout (047) for screens that go from a list to subpages (the Den app's settings tab), shown side by side on wide screens. Under the same condition as qf-map-layout (960 wide or more, or 600 or more and wider than tall; in JS matchMedia("(min-width: 960px), (min-width: 600px) and (orientation: landscape)"); in the app only at regular width): the list __list leading (width clamp(--sz-pane-min 320, 40%, --sz-pane 360), divider on its trailing edge) | the content __detail trailing. Otherwise one column: the list only, or with --detail the content only (list → subpage as on a phone; the consumer adds and removes it). It uses the map tabs' condition so the number of columns does not change between tabs (split at the Duo inner portrait width of 669, the content would be 349). The list column keeps the current first screen: rows that lead to a subpage open it in the content column, and what is not a row (notices, buttons such as pause, legal text) stays in the list column (320 to 360 is a phone width, so it fits as is). The selected row is aria-current="page": bg-selected with a 4px accent-on-subtle band on the leading edge, and text-muted inside that row is raised to text-secondary. Do not use text-danger or accent-text inside the selected row (below AA on bg-selected: show warnings as an icon + text-secondary, action text in accent-on-subtle). Rows (direct links of __list, qf-m-row) take an inner focus ring (ring-accent; on the selected row a 2px accent-on-subtle line), so the column's scrolling does not clip it. Buttons and inputs that are not rows keep their own focus ring, so keep them off the column edges (--m-gutter). On first entering side by side, open with the first row that leads to a subpage selected (no empty content column). Deeper screens (e.g. group admin → members → invite) stack inside the content column with their back button at its top, and the row first opened stays selected in the list. When one column shows only the list, do not set aria-current (the list itself is the current screen). When one column is wide (iPad portrait), centre both the list and the content in a --container-w-reading column (720, the outer boundary), the same width as the other one-column screens (MobileBody) and the Den web admin and account pages (qf-container--reading), with insets and buttons as in MobileBody. Side by side, when the content column is wider than 720 (iPad landscape), centre the content in a 720 column inside it. Fold (iPhone Duo, app only): the list takes the leading part and the content starts at the fold's trailing edge (the qf-map-layout rule). In one column (inner portrait) with a horizontal fold, follow MobileBody's horizontal fold rule. When the size changes, add no motion and keep the selected row and the subpage in the content column (back in one column, the open subpage stays as --detail). Prerequisite: a parent with a definite height, so both columns scroll on their own side by side. The CSS sets display: none only to hide. A one-column web admin page may stay as it is (no fold). For grouped settings (054, MobileGroup) both panes use qf-m-grouped and the selected row looks the same inside its card, the bar clipped by the card's corners.목록 | 내용 배치입니다(047). 목록에서 하위 화면으로 가는 화면(Den 앱의 설정 탭)을 넓은 화면에서 나란히 봅니다. qf-map-layout 과 같은 때(폭 960 이상, 또는 600 이상이면서 가로가 세로보다 길 때. JS 는 matchMedia("(min-width: 960px), (min-width: 600px) and (orientation: landscape)"), 앱은 regular 폭일 때만) 앞쪽 목록 __list(폭 clamp(--sz-pane-min 320, 40%, --sz-pane 360), 뒤쪽 선 divider) | 뒤쪽 내용 __detail. 그 밖은 한 칸입니다: 목록만, --detail 이면 내용만(폰에서처럼 목록 → 하위 화면. 소비처가 붙이고 뗌). 지도 탭과 같은 때로 둬 탭을 옮겨도 칸 수가 같습니다(Duo 안쪽 세로 669 에서 나누면 내용이 349). 목록 칸은 지금 첫 화면을 그대로 둡니다: 하위 화면으로 가는 줄은 누르면 내용 칸에 열고, 줄이 아닌 것(안내, 잠시 멈춤 같은 단추, 법적 고지)은 목록 칸에 남습니다(320~360 은 폰 폭이라 그대로 맞음). 고른 줄은 aria-current="page": bg-selected 바탕 + 앞쪽 4px accent-on-subtle 띠, 그 줄 안의 text-muted 는 text-secondary 로 올립니다. 고른 줄 안에는 text-danger, accent-text 를 쓰지 않습니다(bg-selected 위 AA 미달: 경고는 아이콘 + text-secondary, 할 일 글은 accent-on-subtle). 줄(__list 의 직계 링크, qf-m-row)의 포커스는 안쪽 링(ring-accent, 고른 줄은 accent-on-subtle 2px 선)이라 칸의 스크롤에 잘리지 않습니다. 줄이 아닌 단추와 입력은 제 포커스 링을 쓰므로 칸 가장자리에서 띄워 둡니다(--m-gutter). 나란히로 처음 들어오면 하위 화면으로 가는 첫 줄을 고른 채로 엽니다(빈 내용 칸을 두지 않음). 내용 칸에서 더 들어가는 화면(예: 그룹 관리 → 구성원 → 초대)은 그 칸 안에 쌓고 뒤로 단추도 그 칸 위에 두며, 목록에서는 처음 연 줄이 고른 줄로 남습니다. 한 칸에서 목록만 보일 때는 aria-current 를 두지 않습니다(목록 자체가 지금 화면). 한 칸이 넓으면(iPad 세로) 목록도 내용도 --container-w-reading(720, 바깥 경계) 열 안에서 가운데입니다. 다른 한 칸 화면(MobileBody)과 Den 웹의 관리, 내 계정 화면(qf-container--reading)과 같은 폭이고, 여백과 단추도 MobileBody 를 따릅니다. 나란히일 때 내용 칸이 720 보다 넓으면(iPad 가로) 내용은 칸 안의 720 열에서 가운데입니다. 접힘(iPhone Duo, 앱만): 목록은 앞쪽 조각, 내용은 접힌 곳 뒤 끝부터(qf-map-layout 과 같은 규칙). 한 칸일 때(안쪽 세로) 접힌 곳이 가로면 MobileBody 의 가로 접힘 규칙을 따릅니다. 크기가 바뀔 때 움직임 없이, 고른 줄과 내용 칸의 하위 화면을 그대로 둡니다(한 칸으로 돌아가면 보던 하위 화면이 --detail 로 남음). 전제: 부모 높이가 정해져 있어야 나란히일 때 두 칸이 따로 스크롤됩니다. CSS 는 숨길 때만 display: none 을 줍니다. 웹의 한 열 관리 화면은 그대로 둬도 됩니다(접힘이 없음). 설정처럼 묶음 카드 화면이면(054, MobileGroup) 두 칸 모두 qf-m-grouped 바탕이고 고른 줄은 카드 안에서 같은 모양입니다(띠는 카드 모서리에서 잘림).

.qf-splitlayer: generic

Preview

<div class="qf-split" style="height:220px">
  <nav class="qf-split__list" aria-label="Settings">
    <a class="qf-m-row" href="#" aria-current="page">
      <span class="qf-m-row__icon">
        <svg class="qf-icon" aria-hidden="true">
          <use href="#qf-i-user"/>
        </svg>
      </span>
      <div>
        <div class="qf-m-row__primary">Account</div>
        <div class="qf-m-row__secondary">Apple sign-in</div>
      </div>
      <span>
      </span>
    </a>
    <a class="qf-m-row" href="#">
      <span class="qf-m-row__icon">
        <svg class="qf-icon" aria-hidden="true">
          <use href="#qf-i-bell"/>
        </svg>
      </span>
      <div>
        <div class="qf-m-row__primary">Notifications</div>
        <div class="qf-m-row__secondary">On</div>
      </div>
      <span>
      </span>
    </a>
    <a class="qf-m-row" href="#">
      <span class="qf-m-row__icon">
        <svg class="qf-icon" aria-hidden="true">
          <use href="#qf-i-place"/>
        </svg>
      </span>
      <div>
        <div class="qf-m-row__primary">Places</div>
        <div class="qf-m-row__secondary">3</div>
      </div>
      <span>
      </span>
    </a>
  </nav>
  <div class="qf-split__detail" style="padding:var(--s-5)">
    <h1 tabindex="-1" style="margin:0;font:600 var(--fs-20) var(--font-sans);color:var(--text-strong)">Account</h1>
  </div>
</div>

Variants

qf-split__list qf-split__detail qf-split--detail

Required tokens

--sz-pane --sz-pane-min --divider --bg-app --bg-selected --accent-on-subtle --text-secondary --s-2 --bp-regular --bp-side --container-w-reading --ring-accent --s-1 --m-gutter

Accessibility

The list is links or buttons inside <nav aria-label="Settings">, with aria-current="page" on the selected row side by side or in --detail (the background and band are the visible cue). Side by side, selecting a row moves focus to the content heading (h1, tabindex="-1"). In one column, going to --detail moves focus to the heading as on a subpage, and going back returns it to the selected row. In RN give the row accessibilityState {selected: true}.목록은 <nav aria-label="설정"> 안의 링크나 버튼이고, 나란히이거나 --detail 일 때 고른 줄에 aria-current="page" 를 둡니다(바탕과 띠는 보이는 표시). 나란히일 때 줄을 고르면 내용 칸 제목(h1, tabindex="-1")으로 포커스를 옮깁니다. 한 칸에서 --detail 로 가면 하위 화면과 같이 제목으로 포커스, 뒤로는 고른 줄로 돌려보냅니다. RN 은 줄에 accessibilityState {selected: true}.

Layout & structure

VisuallyHidden

Text hidden from the screen but read by screen readers (042). Use it to say once in words a state the eye already sees by shape, like "Loading" in a Skeleton region. Unlike display: none or visibility: hidden it stays in the accessibility tree. Do not use it on focusable elements (invisible focus). RN uses accessibilityLabel or AccessibilityInfo.announceForAccessibility instead.화면에는 보이지 않고 화면 낭독기만 읽는 글입니다(042). 뼈대(Skeleton) 영역의 "불러오는 중"처럼, 눈에는 모양으로 이미 보이는 상태를 말로 한 번 전할 때 씁니다. display: none 이나 visibility: hidden 과 달리 접근성 트리에 남습니다. 포커스를 받는 요소에는 쓰지 않습니다(보이지 않는 포커스). RN 은 이 클래스 대신 accessibilityLabel 이나 AccessibilityInfo.announceForAccessibility 를 씁니다.

.qf-sr-onlylayer: generic

Preview

<div>
  <span class="qf-sr-only" role="status">
  </span>
  <div aria-busy="true">
    <div class="qf-skel" inert aria-hidden="true" style="width: 60%; height: var(--s-4)">
    </div>
  </div>
</div>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

—

Accessibility

For a status message pair it with role="status" and fill text into an always-mounted empty region (one mounted already filled may not be announced). Keep it outside any aria-busy region. If the same words are also visible, keep only one, or it is read twice.상태 알림이면 role="status" 와 함께, 늘 마운트해 둔 빈 영역에 글을 채워 넣습니다(처음부터 글이 든 채 마운트하면 읽히지 않을 수 있음). aria-busy 영역 안에 두지 않습니다. 같은 말을 보이는 글로도 두면 두 번 읽히니 한쪽만 둡니다.

Layout & structure

PageEnter

A fade for a block that newly appears (044, qufox Den 058 B-34). Web sub-screen changes do not slide; the new screen's body only fades in over --dur-enter (220) with --ease-enter. Apply it going forward (links, pushState) only, not going back (popstate, the top-bar back, Safari's edge swipe). Safari's edge swipe and back/forward already slide the page themselves, so a page slide would move twice, and a page cannot imitate a finger-following swipe. If the app (RN) moves sub-screens to the iOS native stack, it leaves the transition to iOS and uses no DS values. When it draws transitions in JS (063, Den 057 B-34): on entry the new screen moves from the right edge to 0, the screen below recedes 30% of the width to the left under --scrim at 0.2x opacity (0 → 0.2), and the top screen gets --elev-3 on its left edge. Button-driven transitions (tapping a row, the back button) use --dur-slow (320) with --ease-emphasized; leaving is the same in reverse. The left-edge swipe responds only to drags that start within 24pt of the left edge, have moved more than 10pt, and are more horizontal than vertical and rightward; the top screen follows the finger exactly (clamped between 0 and the width) and the screen below and the scrim move proportionally. Grabbing again within 24pt of the moving top screen's current left edge while the spring runs continues the drag from where it is. On release: rightward at 0.5 widths/s or more goes back, leftward at 0.5 widths/s or more stays, and in between it goes back past halfway. Velocity is per second (PanResponder's vx is px/ms, so compare vx × 1000 / width ≥ 0.5). A terminated gesture (onPanResponderTerminate) counts as a release at velocity 0. After release, do not use --ease-emphasized (its initial slope is 0, so the screen stalls the moment the finger lifts and then speeds up again). Finish with a critically damped spring that carries the release velocity: RN Animated.spring stiffness 330, damping 36.3, mass 1, overshootClamping true, velocity = the animated value's velocity per second (vx × 1000 when moving px, vx × 1000 / width for progress 0..1). Released at rest halfway the visible motion ends in about 280ms; a fast fling is shorter. So the end callback (re-enabling taps, removing the screen, focus) is not late, set restDisplacementThreshold and restSpeedThreshold to the value's scale (displacement 2 and speed 40 for px, 0.005 and 0.1 for progress, which brings the callback to about 0.3 to 0.4s; the default 0.001 delays it close to a second in px). Snapping back uses the same spring. Keep the top screen's background opaque, and if the shadow drops frames, remove it and keep only the scrim. Block taps on both screens during the transition. Under Reduce Motion, button-driven transitions cross-fade over --dur-enter with --ease-enter instead of sliding (the scrim fades 0 → 0.2 with it); a drag moves only the top screen and the scrim (the 30% of the screen below stays put), and release uses the same spring. Where it applies is decided by content: a screen that goes deeper along the hierarchy (returning via the top bar's back chevron) uses this transition (when stacked over the tabs, the tabs and tab bar become the screen below as one and recede 30% together). A self-contained task to finish or abandon (flows such as create, compose or join, ending with Close or Cancel) is a covering screen and uses the sheet motion from below (--m-sheet-dur, --m-sheet-ease). A covering screen rises from the screen height to 0 and goes down with the same duration and curve; the screen below does not move and only gets the scrim (a --dur-enter fade under Reduce Motion). Its first screen has Close (qf-i-x, label "닫기") at top left instead of the back chevron, and the steps inside it use this transition with the chevron. A screen that replaced the first one also has Close and comes in with the slide transition. A covering screen chosen from a sheet also rises after the sheet closes. There is no left-edge drag that closes a covering screen (the steps inside use the slide transition, so they drag back; no drag-down to dismiss either, and if one is added, block it while there is input). When a choice in a sheet leads to a deeper screen, the sheet closes and then the screen slides in. A step that cannot be returned to (e.g. inviting to a group just made) replaces the top screen with the same transition, and back goes to the screen below it. When a screen holds a stack of its own, the inner stack takes the left-edge drag while it can go back. Autofocus on a field (the keyboard) is given after the transition ends (a keyboard resizing mid-transition leaves the screen off-screen; apply size changes once motion stops). A screen whose back can be blocked (unsaved input and the like) decides on release and springs back into place instead of coming off, asking for confirmation once it is back if needed. If a screen still comes off and the app does not remove it, as a safety net it springs back into place after a moment with the same spring. When stacking inside the right pane on wide screens, motion stays inside the pane (clipped): width, 30% and 0.5 widths/s refer to the pane width, the 24pt starts at the pane's left edge, and the shadow and scrim never spill into the left pane. With reduced motion (web) the fade stays (a dissolve, not movement).새로 나타나는 화면 덩이의 페이드입니다(044, qufox Den 058 B-34). 웹의 하위 화면 넘김은 옆으로 미는 움직임 없이 새 화면 본문에 --dur-enter(220) --ease-enter 페이드만 겁니다. 앞으로 갈 때(링크, pushState)만 걸고 뒤로(popstate, 위 막대 뒤로, Safari 가장자리 밀기)에는 걸지 않습니다. Safari 의 가장자리 밀기와 앞뒤 단추는 브라우저가 이미 옆으로 밀어 보여 주므로 페이지가 또 밀면 두 번 움직이고, 손가락을 따르는 밀기는 페이지가 흉내 낼 수 없습니다. 앱(RN)이 하위 화면을 iOS 네이티브 스택으로 옮기면 넘김은 iOS 에 맡기고 DS 값은 쓰지 않습니다. JS 로 넘길 때(063, Den 057 B-34): 들어올 때 새 화면은 오른쪽 끝에서 0 으로, 아래 화면은 왼쪽으로 폭의 30% 물러나고 그 위에 --scrim 을 불투명도 0.2 배로(0 → 0.2) 깔며, 위 화면 왼쪽 가장자리에 --elev-3. 단추로 넘길 때(줄 누름, 뒤로 단추)는 --dur-slow(320) --ease-emphasized, 나갈 때는 거꾸로 같습니다. 왼쪽 끝 밀기는 왼쪽 24pt 안에서 시작해 10pt 넘게 움직였고 가로가 세로보다 크고 오른쪽인 끌기에만 반응하고, 위 화면이 손가락을 그대로 따라오며(0 과 폭 사이에 묶음) 아래 화면과 scrim 도 비율대로 움직입니다. 스프링이 도는 중에 움직이는 위 화면의 지금 왼쪽 끝에서 24pt 안을 다시 잡으면 그 자리에서 이어 끕니다. 놓을 때 오른쪽으로 초당 0.5폭 이상이면 뒤로, 왼쪽으로 초당 0.5폭 이상이면 제자리, 그 사이면 절반을 넘었을 때 뒤로 갑니다. 속도는 초당 값입니다(PanResponder 의 vx 는 px/ms 라 vx × 1000 / 폭 ≥ 0.5 로 비교). 제스처가 끊기면(onPanResponderTerminate) 속도 0 으로 놓은 것과 같습니다. 놓은 뒤에는 --ease-emphasized 를 쓰지 않습니다(첫 기울기가 0 이라 손을 뗀 순간 멈췄다가 다시 빨라짐). 놓을 때 속도를 이어받는 임계 감쇠 스프링으로 끝냅니다: RN Animated.spring stiffness 330, damping 36.3, mass 1, overshootClamping true, velocity 는 움직이는 값의 초당 속도(px 로 움직이면 vx × 1000, 진행도 0..1 이면 vx × 1000 / 폭). 절반에서 가만히 놓으면 약 280ms 에 눈에 보이는 움직임이 끝나고, 빠르게 튕기면 더 짧습니다. 끝 콜백(누름 풀기, 화면 내리기, 초점)이 늦지 않게 restDisplacementThreshold 와 restSpeedThreshold 를 값에 맞춥니다(px 면 거리 2, 속도 40, 진행도면 0.005, 0.1. 그러면 콜백은 약 0.3~0.4초, 기본 0.001 이면 px 에서 1초 가까이 늦음). 제자리로 돌아올 때도 같은 스프링입니다. 위 화면 바탕은 불투명으로 두고, 그림자 때문에 프레임이 떨어지면 그림자를 빼고 scrim 만 둡니다. 넘기는 동안은 두 화면의 누름을 막습니다. 동작 줄이기면 단추로 넘길 때 미는 대신 --dur-enter --ease-enter 로 겹쳐 흐리게 하고(scrim 도 함께 0 → 0.2), 끌기는 위 화면과 scrim 만 따라오며(아래 화면의 30% 는 움직이지 않음) 놓은 뒤는 같은 스프링입니다. 어디에 거는지는 내용으로 정합니다: 계층을 따라 더 깊이 들어가는 화면(위 막대의 뒤로 꺾쇠로 돌아감)은 이 넘김입니다(탭 위로 쌓이면 탭과 탭 막대가 한 장으로 아래 화면이 되어 함께 30% 밀림). 따로 끝내거나 그만두는 일(만들기, 쓰기, 참가 같은 흐름, 닫기나 취소로 끝남)은 덮는 화면이고 아래에서 올라오는 시트 움직임(--m-sheet-dur, --m-sheet-ease)입니다. 덮는 화면은 화면 높이에서 0 으로 올라오고 같은 길이와 곡선으로 내려가며, 아래 화면은 밀리지 않고 scrim 만 받습니다(동작 줄이기면 --dur-enter 페이드). 첫 화면의 왼쪽 위는 꺾쇠 대신 닫기(qf-i-x, 라벨 "닫기")이고, 그 안의 단계는 이 넘김과 꺾쇠입니다. 첫 화면 자리를 갈아 끼운 화면도 닫기이고 밀기 넘김으로 들어옵니다. 시트에서 고른 덮는 화면도 시트가 닫힌 뒤 올라옵니다. 덮는 화면을 닫는 왼쪽 끝 끌기는 없습니다(안의 단계는 밀기 넘김이라 끌어 뒤로 갑니다. 아래로 끌어 닫기도 두지 않고, 두게 되면 입력이 있을 때는 막음). 시트에서 고른 다음 화면이 더 깊은 화면이면 시트가 닫힌 뒤 밀려 들어옵니다. 다시 갈 수 없는 단계(예: 만든 그룹의 초대)는 위 화면의 자리를 갈아 끼우며 같은 넘김으로 들어오고, 뒤로는 그 아래로 갑니다. 화면 안에 또 쌓인 화면이 있으면 안쪽이 뒤로 갈 수 있는 동안 왼쪽 끝 끌기는 안쪽이 갖습니다. 입력 칸의 자동 초점(키보드)은 넘김이 끝난 뒤에 줍니다(넘기는 도중 키보드가 크기를 바꾸면 화면이 밖에 남음, 크기 변화는 멈춘 뒤 적용). 뒤로가 막힐 수 있는 화면(저장하지 않은 입력 등)은 놓을 때 미리 판단해 화면을 빼지 않고 제자리 스프링으로 돌리고, 확인이 필요하면 제자리에 온 뒤 묻습니다. 그래도 빠진 화면을 앱이 내리지 않으면 안전망으로 잠시 뒤 같은 스프링으로 제자리에 돌아옵니다. 넓은 화면의 오른쪽 칸에 쌓일 때는 칸 안에서만 움직입니다(칸 밖은 잘라 냄). 폭, 30%, 초당 0.5폭은 칸 폭 기준이고, 24pt 는 칸 왼쪽 끝부터이며, 그림자와 scrim 은 왼쪽 칸에 넘어가지 않습니다. 동작 줄이기(웹)에서도 페이드는 둡니다(움직임이 아니라 흐려짐).

.qf-enterlayer: generic

Preview

장소 관리

새 화면 본문이 220ms 동안 나타납니다.

<section class="qf-enter" aria-labelledby="pe1">
  <h3 id="pe1" tabindex="-1" style="margin:0">장소 관리</h3>
  <p style="margin:0">새 화면 본문이 220ms 동안 나타납니다.</p>
</section>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--dur-enter --ease-enter --dur-slow --ease-emphasized --scrim --elev-3 --m-sheet-dur --m-sheet-ease

Accessibility

On a screen change, move focus to the new screen's heading (h1, tabindex="-1") and update document.title (independent of the fade). In RN the native stack handles VoiceOver focus and the two-finger scrub (back). When transitions are drawn in JS, keep both screens direct siblings under one parent (collapsable={false}), put accessibilityViewIsModal on the top screen and accessibilityElementsHidden on the screen below, and focus the new screen's heading on entry. On return, clear the lower screen's accessibilityElementsHidden first and move focus to the row that opened the screen only after that applies (the reverse fails silently). If that row is gone, focus the screen's heading. When a covering screen chosen from a sheet closes, the sheet is already gone, so focus returns to the control that opened the sheet. The two-finger scrub goes back via onAccessibilityEscape on the top screen's container.화면이 바뀌면 포커스를 새 화면의 제목(h1, tabindex="-1")으로 옮기고 document.title 을 바꿉니다(페이드와 별개). RN 은 네이티브 스택이 VoiceOver 초점과 두 손가락 문지르기(뒤로)를 맡습니다. JS 로 넘길 때는 두 화면을 같은 부모의 직접 형제로 두고(collapsable={false}) 위 화면에 accessibilityViewIsModal, 아래 화면은 accessibilityElementsHidden, 들어가면 새 화면 제목에 초점을 둡니다. 돌아올 때는 아래 화면의 accessibilityElementsHidden 을 먼저 풀고 반영된 뒤에 그 화면을 연 줄로 초점을 옮깁니다(거꾸로면 조용히 실패). 연 줄이 없어졌으면 그 화면의 제목입니다. 시트에서 고른 덮는 화면을 닫으면 시트는 이미 없으므로 그 시트를 연 컨트롤로 돌아갑니다. 두 손가락 문지르기는 위 화면 컨테이너의 onAccessibilityEscape 로 뒤로 갑니다.

Actions

Button

A primary action button. --ghost combined with --danger is a lighter destructive action (revoke a code, start account deletion): transparent with text-danger. --busy is the wait after a press (044): not dimmed (unlike unavailable), with a 16 spinner (qf-spinner in the label colour, a 3/4 arc) before the label, which stays (it says what is in progress). It takes a leading icon's place; on an icon-only button it replaces the icon. Timing: block repeat presses at once (ignore them in the handler) and add --busy if the work has not finished within 300ms, and once shown keep it at least 500ms (the 042 skeleton rule, so fast replies do not flash). Remove it when done; on failure, report the error. With reduced motion it pulses slowly instead of spinning. RN: ActivityIndicator size="small" in the button's text colour, s-3 before the label. iOS keeps ActivityIndicator spinning under Reduce Motion; leave it.기본 액션 버튼입니다. --ghost 와 --danger 를 함께 쓰면 덜 무거운 위험 행동(번호 끊기, 탈퇴 진입) — 투명 바탕에 text-danger. --busy 는 누른 뒤 응답을 기다리는 동안입니다(044): 흐리지 않고(누를 수 없음과 구별) 글자 앞에 16 회전 표시(qf-spinner, 글자색, 3/4 호)를 두며 글자는 그대로 둡니다(무엇이 진행 중인지). 앞 아이콘이 있으면 회전 표시가 그 자리를 대신합니다. 아이콘만 있는 버튼은 아이콘 대신 회전 표시. 때: 누른 즉시 다시 누르기를 막고(처리기에서 무시), 300ms 안에 끝나지 않으면 --busy 를 걸고, 걸었으면 적어도 500ms 둡니다(042 뼈대와 같은 기준, 빠른 응답에 번쩍이지 않게). 끝나면 떼고, 실패면 오류를 알립니다. 동작 줄이기에서는 돌지 않고 천천히 깜박입니다. RN: ActivityIndicator size="small", color 는 그 버튼의 글자색, 글자 앞 s-3 간격. iOS 의 ActivityIndicator 는 동작 줄이기에서도 돌아 그대로 둡니다.

.qf-btnlayer: generic

Preview

<button class="qf-btn qf-btn--primary">Save</button>

Examples예시

044 Busy: primary, secondary, ghost danger (not dimmed, unlike disabled)

Variants

qf-btn--primary
qf-btn--secondary
qf-btn--ghost
qf-btn--danger
qf-btn--link
qf-btn--sm
qf-btn--lg
qf-btn--icon
qf-btn--touch
qf-btn--provider
qf-btn--busy

Parts & more: 구성 요소, 기타: qf-btn__logo

Required tokens

--accent --text --text-onAccent --border --r-md --s-3 --s-5 --dur-fast --bg-selected --text-strong --m-touch --text-danger --danger-bg --s-1 --dur-deliberate --ease-standard

Accessibility

Make keyboard focus visible and convey the disabled state via disabled or aria-disabled. For icon-only buttons, add meaning with aria-label, and keep text contrast at AA 4.5:1. Ghost/icon buttons used as toggles (aria-pressed) show the pressed state as the selected surface; pair it with an icon or label change so state does not rely on color alone. Button labels do not wrap (white-space: nowrap); shorten long labels or give the button width. Add --touch to a standalone icon button (e.g. share next to a title) to extend a 44px hit area with a transparent ::after on touch devices while keeping its visual size (automatic inside qf-navbar). Do not use it in dense toolbars (gaps under 8px) — it would steal taps from neighbours. --busy: on the web use aria-disabled="true" instead of disabled (focus stays; it is not dimmed either way), aria-hidden on the spinner, and announce once by writing into an empty off-screen status that is already in the DOM (qf-sr-only, role="status"; a region created at that moment is not read), e.g. "Signing in" (aria-busy is not read on buttons). In RN set accessibilityState={{ busy: true, disabled: true }} and call AccessibilityInfo.announceForAccessibility once (iOS has no live regions).키보드 포커스가 보이도록 하고, 비활성은 disabled 또는 aria-disabled 로 전달합니다. 아이콘 전용 버튼은 aria-label 로 의미를 보충하고, 텍스트 대비는 AA 4.5:1 을 지킵니다. 토글(aria-pressed)로 쓰는 ghost/icon 버튼은 눌린 상태가 selected 표면으로 표시됩니다 — 아이콘·라벨 전환과 함께 두어 색에만 기대지 않습니다. 버튼 라벨은 줄바꿈하지 않습니다(white-space: nowrap) — 긴 라벨은 줄이거나 너비를 주세요. 단독으로 선 아이콘 버튼(제목 옆 공유 등)에는 --touch 를 붙이면 터치 환경에서 보이는 크기는 그대로 두고 44px 히트 영역을 투명 ::after 로 넓힙니다(qf-navbar 안은 자동). 밀집 툴바(간격 8px 미만)에는 쓰지 않습니다 — 이웃 버튼의 탭을 가로챕니다. --busy: 웹은 disabled 대신 aria-disabled="true"(포커스를 잃지 않음, 걸어도 흐리지 않음)와 회전 표시 aria-hidden, 그리고 미리 DOM 에 둔 빈 화면 밖 status(qf-sr-only, role="status")에 "로그인 중" 처럼 글을 넣어 한 번 알립니다(그때 만든 영역은 읽히지 않음)(aria-busy 는 버튼에서 읽히지 않음). RN 은 accessibilityState={{ busy: true, disabled: true }} 와 AccessibilityInfo.announceForAccessibility("로그인 중") 한 번(iOS 에는 live region 이 없음).

Actions

IconButton

A clean, icon-only button designed to sit in list rows.리스트 행에 들어가는 군더더기 없는 아이콘 전용 버튼입니다.

.qf-row-iconbtnlayer: generic

Preview

<button class="qf-row-iconbtn" aria-label="Settings">
  <svg class="qf-icon qf-icon--sm" aria-hidden="true">
    <use href="#qf-i-settings"/>
  </svg>
</button>

Examples예시

Settings
Search
More
Edit
Notifications

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--text-muted --text-strong --accent --r-xs

Accessibility

Since only an icon is shown, the action must always be conveyed via aria-label; keep keyboard focus visible and signal the disabled state with disabled. Do not rely on color alone to convey state.아이콘만 표시하므로 aria-label 로 동작을 반드시 전달하고, 키보드 포커스를 보이게 하며 비활성은 disabled 로 알립니다. 색만으로 상태를 전하지 않도록 합니다.

Actions

Link

An inline text link within body content.본문 안의 인라인 텍스트 링크입니다.

.qf-linklayer: generic

Preview

<a class="qf-link" href="/docs">View docs</a>

Examples예시

Default
Unresolved wikilink

Variants

qf-link--muted
qf-link--unresolved

Required tokens

--link --link-hover --r-xs --text-secondary --text-muted

Accessibility

Built as a real a[href] to preserve keyboard and screen reader navigation, with a hover underline and sufficient contrast so meaning is not carried by color alone. The focus ring is visible. An unresolved wikilink (qf-link--unresolved) has no href and is marked aria-disabled="true", conveying the unresolved state with a dotted underline and color rather than color alone.실제 a[href] 로 만들어 키보드/스크린리더 탐색을 보존하고, hover 밑줄과 충분한 대비로 색 단독 의존을 피합니다. 포커스 ring 이 보입니다. 미해결 위키링크(qf-link--unresolved)는 href 를 비우고 aria-disabled="true" 로 표시하며, 점선 밑줄과 색으로 미해결을 색 단독이 아니게 전달합니다.

Actions

ButtonGroup

A group that joins adjacent buttons into a single unit (split actions, segments).인접한 버튼들을 한 덩어리로 결합한 그룹입니다(분할 액션, 세그먼트).

.qf-btn-grouplayer: generic

Preview

<div class="qf-btn-group" role="group" aria-label="Sort">
  <button class="qf-btn qf-btn--secondary" aria-pressed="true">List</button>
  <button class="qf-btn qf-btn--secondary">Grid</button>
</div>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--r-md

Accessibility

Convey the unit's meaning with role=group and aria-label. For toggle segments, set aria-pressed on each button.role=group 과 aria-label 로 묶음의 의미를 전달합니다. 토글 세그먼트면 각 버튼에 aria-pressed 를 둡니다.

Actions

CopyButton

A standalone button that copies an id, path, URL, or similar to the clipboard. Copy completion is reflected via data-copied=true (the consumer handles the toggle).id, 경로, URL 등을 클립보드에 복사하는 독립 버튼입니다. 복사 완료는 data-copied=true 로 상태를 표시합니다(토글은 소비처).

.qf-copy-btnlayer: generic

Preview

<button class="qf-copy-btn" type="button">
  <svg class="qf-icon qf-icon--sm" aria-hidden="true">
    <use href="#qf-i-copy"/>
  </svg>
  Copy
</button>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--bg-elevated --border --text-secondary --bg-hover --ok-400 --r-sm --font-mono

Accessibility

Convey the action and result with text next to the icon (Copy/Copied), and announce completion not just with color but with text and aria-live.아이콘 옆 텍스트(복사/복사됨)로 동작과 결과를 전달하고, 완료는 색뿐 아니라 텍스트, aria-live 로 알립니다.

Actions

ToTop

A round "back to top" icon button floating at the bottom right (qf-i-chevron-up). Hidden by default; consumer JS adds is-shown once the page is scrolled more than a screen. 44px tap target, with the phone safe area added. Set --qf-totop-bottom (default --safe-bottom) to lift it above a bottom ad or a mobile tab bar (qf-m-tabbar, which has a higher z-index).오른쪽 아래에 떠 있는 둥근 "맨 위로" 아이콘 버튼입니다(qf-i-chevron-up). 기본은 숨겨져 있고, 한 화면 넘게 내려갔을 때 소비처 JS 가 is-shown 을 붙이면 나타납니다. 44px 탭 대상이며 폰의 안전 영역을 더합니다. 바닥 광고나 모바일 탭바(qf-m-tabbar, z-index 가 더 높음) 위로 올릴 때는 --qf-totop-bottom 을 지정합니다(기본 --safe-bottom).

.qf-totoplayer: generic

Preview

<div style="position:relative;height:120px">
  <button class="qf-totop is-shown" type="button" aria-label="Back to top" style="position:absolute">
    <svg class="qf-icon qf-icon--md" aria-hidden="true">
      <use href="#qf-i-chevron-up"/>
    </svg>
  </button>
</div>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--s-5 --safe-bottom --z-sticky --m-touch --border --border-strong --r-pill --bg-elevated --bg-hover --text --elev-3 --s-3 --dur-fast --ease-standard --ring-focus

Accessibility

Give the button aria-label="Back to top". While hidden it is visibility: hidden, so it leaves the focus order and is only tappable/focusable when shown. The focus ring is visible. On press the consumer scrolls to top and ideally moves focus to the first element of the content.button 에 aria-label="맨 위로" 를 둡니다. 숨김 상태는 visibility: hidden 이라 포커스 순서에서 빠지고, 보일 때만 탭·포커스됩니다. 포커스 링이 보입니다. 누르면 소비처가 window.scrollTo 로 올리고 포커스를 본문 첫 요소로 옮기면 좋습니다.

Actions

MapButton

A 44px icon button floating over a map (locate me, fit all, zoom). bg-elevated with a border and elev-2 lifts it off the tiles; aria-pressed shows "follow me" on. Stack them top-right with qf-map-btns. Zoom goes in a qf-map-zoom group (+ on top, − below, one --border-strong line between) placed below the other buttons (033). At the zoom limit set that button to aria-disabled="true" (text-disabled, presses ignored). On a web map, turn off the library's own controls (zoom, compass, map type, user location, scale) and use only these. With the compass off, turn rotation off too so north stays up (there would be no way to turn a rotated map back). Native app maps follow the platform's default gestures and controls. Keep free the bottom corner where the map provider puts its logo or legal notice (Naver: the logo at bottom-left). The remaining bottom corner holds only one qf-map-link (069, Den 080). Den turns the scale and map data controls off, so its bottom-right is free; whether a notice may be turned off is for the consumer to check against the provider's terms. On a map whose provider uses both bottom corners (Apple, Google and others), put qf-map-link at the bottom of the qf-map-btns stack (inside the stack it drops its corner position, aligns to the trailing edge and keeps 12 from the button above so the hit areas do not overlap). qf-map-link is a quiet link that opens this map in another app or a new tab ("Apple 지도" + qf-i-external). It is lighter than the buttons above: 32 visible height (s-8; the hit area grows 6 up and down to 44), a pill, fs-12 600 text-secondary, a 14 icon (fs-14, after the text), a --border outline and elev-1. The text is always "Apple 지도" (Apple Maps) and does not change with the selection. Do not make it icon-only (reviewers and first-time users need to see what opens, and the Apple logo is not used as a button glyph). Placement: s-4 in from the map pane's bottom-right (the same inset as qf-map-btns). When a sheet covers the bottom of the map (location tab), s-4 above the sheet's top edge, following the sheet while it is dragged (no motion of its own). Side by side (047, 060) and iPad: the map pane's bottom-right (before the list pane's rule), above the bottom safe area. The timeline's phone shape: the map band's bottom-right. Fold (Duo): only inside the map piece. With a horizontal fold, s-4 above the higher of the fold's top edge and the sheet's top edge; with a vertical fold (side by side), the leading map piece's bottom-right (s-4 before the fold). Draw it above callouts (qf-map-callout) and pins, on the same layer as qf-map-btns: in the app it is a View over the map, so it already is; on the web the default is z-sticky, but if the consumer raised qf-map-btns' z-index above the map library's overlay layer, give it the same value (Den web: 700). A callout may slide under it, and the link stays pressable. App (RN): a Pressable with the same tokens (height s-8, paddingLeft s-4, paddingRight s-3, gap s-2, borderRadius r-pill, borderWidth 1 --border, bg-elevated, elev-1), hitSlop 6 top and bottom, and text on one line with maxFontSizeMultiplier MAP_TEXT_SCALE (1.2) like other map text. bg-hover and text while pressed. Web: <a href target="_blank" rel="noopener noreferrer">. Update href when the selection changes and whenever the map goes idle (so middle-click and copy link go to the same place). In the DOM put it after qf-map-btns and before the list.지도 위에 떠 있는 44px 아이콘 버튼입니다(내 위치로, 모두 보기, 확대와 축소). bg-elevated + 테두리 + elev-2 로 타일 위에서 분리되고, aria-pressed 로 "따라가기 켜짐"을 표시합니다. qf-map-btns 로 오른쪽 위에 세로로 묶습니다. 확대와 축소는 qf-map-zoom 묶음(위 +, 아래 −, 가운데 --border-strong 한 줄)으로 다른 버튼들 아래에 둡니다(033). 끝까지 확대하거나 축소하면 그 버튼은 aria-disabled="true"(text-disabled, 누름 무시)로 바꿉니다. 웹 지도에서는 라이브러리의 자체 컨트롤(확대, 나침반, 지도 종류, 내 위치, 축척)을 끄고 이 버튼만 씁니다. 나침반을 끄면 회전도 꺼서 지도가 늘 북쪽 위로 남게 합니다(돌린 지도를 되돌릴 수단이 없어지므로). 네이티브 앱 지도는 플랫폼 기본 손짓과 컨트롤을 따릅니다. 지도 아래 모서리 중 지도 제공자가 로고나 법적 고지를 두는 곳은 비워 둡니다(Naver 는 왼쪽 아래 로고). 남은 아래 모서리에는 qf-map-link 하나만 둡니다(069, Den 080). Den 은 축척과 지도 데이터 컨트롤을 꺼서 오른쪽 아래가 비어 있습니다. 고지를 끌 수 있는지는 소비처가 제공자 약관으로 확인합니다. 아래 두 모서리를 모두 제공자가 쓰는 지도(Apple, Google 등)라면 qf-map-link 는 qf-map-btns 묶음의 맨 아래에 둡니다(묶음 안에서는 자리를 풀고 뒤쪽에 붙으며, 앞 단추와 12 띄워 누르는 곳이 겹치지 않음). qf-map-link 는 이 지도를 다른 앱이나 새 탭에서 여는 조용한 링크입니다("Apple 지도" + qf-i-external). 위 단추보다 가볍게 둡니다: 보이는 높이 32(s-8, 누르는 곳은 위아래로 6 씩 늘려 44), 알약, 글 fs-12 600 text-secondary, 아이콘 14(fs-14, 글 뒤), 테두리 --border, 그림자 elev-1. 글은 "Apple 지도"로 늘 같고, 고른 것이 있든 없든 바꾸지 않습니다. 아이콘만 두지 않습니다(심사관과 처음 쓰는 사람이 무엇이 열리는지 알아야 하고, Apple 로고는 단추 그림으로 쓰지 않습니다). 자리: 지도 칸의 오른쪽 아래에서 s-4 안쪽입니다(위 단추 qf-map-btns 와 같은 여백). 시트가 지도 아래를 덮으면(위치 탭) 시트 위 끝에서 s-4 위이고, 시트를 끄는 동안 함께 따라갑니다(따로 움직임을 넣지 않음). 나란히(047, 060)와 iPad 는 지도 칸의 오른쪽 아래(목록 칸 선 앞), 아래 안전 영역 위입니다. 타임라인의 폰 모양은 지도 띠의 오른쪽 아래입니다. 접힘(Duo)에서는 지도 조각 안에만 둡니다: 접힌 곳이 가로면 접힌 곳 위 끝과 시트 위 끝 가운데 위쪽에서 s-4 위, 접힌 곳이 세로(나란히)면 앞쪽 지도 조각의 오른쪽 아래(접힌 곳 앞 s-4)입니다. 말풍선(qf-map-callout)과 핀보다 위에 그립니다. qf-map-btns 와 같은 층입니다: 앱은 지도 위에 얹은 View 라 원래 그렇고, 웹은 기본 z-sticky 이지만 소비처가 지도 라이브러리의 오버레이 층 때문에 qf-map-btns 의 z-index 를 올렸으면 같은 값을 줍니다(Den 웹 700). 말풍선이 그 밑으로 들어가도 링크는 늘 누를 수 있습니다. 앱(RN): Pressable 에 같은 토큰(높이 s-8, paddingLeft s-4, paddingRight s-3, gap s-2, borderRadius r-pill, borderWidth 1 --border, bg-elevated, elev-1), hitSlop 위아래 6, 글은 다른 지도 글처럼 maxFontSizeMultiplier MAP_TEXT_SCALE(1.2)에 한 줄입니다. 누르는 동안 bg-hover 와 text. 웹: <a href target="_blank" rel="noopener noreferrer">. href 는 고른 것이 바뀔 때와 지도가 멈출 때(idle)마다 고쳐 둡니다(가운데 클릭이나 링크 복사도 같은 곳으로). DOM 에서는 qf-map-btns 다음, 목록 앞에 둡니다.

.qf-map-btnlayer: generic

Preview

<div class="qf-map-btns" style="position:static;display:inline-flex">
  <button class="qf-map-btn" aria-label="Locate me" aria-pressed="true">
    <svg class="qf-icon" aria-hidden="true">
      <use href="#qf-i-locate"/>
    </svg>
  </button>
  <button class="qf-map-btn" aria-label="Fit all">
    <svg class="qf-icon" aria-hidden="true">
      <use href="#qf-i-fullscreen"/>
    </svg>
  </button>
</div>

Examples예시

모두 보기와 확대, 축소
끝까지 확대(+ aria-disabled)
지도 오른쪽 아래의 Apple 지도(qf-map-link, 069)

Variants

qf-map-btns qf-map-zoom qf-map-link

Required tokens

--m-touch --bg-elevated --bg-hover --border --text --text-secondary --accent-text --elev-2 --r-lg --s-2 --s-4 --s-6 --z-sticky --ring-focus --text-disabled --r-pill --s-3 --s-8 --fs-12 --fs-14 --elev-1 --font-sans

Accessibility

qf-map-btn is icon-only, so give each an aria-label ("Locate me", "Fit all", "Zoom in", "Zoom out"). The follow toggle uses aria-pressed. Wrap zoom in role="group" with aria-label="Zoom". At the zoom limit use aria-disabled="true" rather than disabled and ignore presses, so a keyboard user pressing repeatedly does not lose focus. Recompute the limit state after every zoom change (wheel, pinch, "Fit all"), not only after a press. Place below the top safe area. qf-map-link's name is "Apple 지도에서 열기" (Open in Apple Maps; the visible text "Apple 지도" leads the name, 2.5.3). In the app use accessibilityRole="button" with accessibilityHint "고른 곳을 Apple 지도 앱으로 엽니다" (opens the selected place in the Apple Maps app) when something is selected, otherwise "보고 있는 곳을 Apple 지도 앱으로 엽니다" (opens the area you are looking at). On the web use aria-label="Apple 지도에서 열기 (새 탭)" (new tab) with the icon aria-hidden. VoiceOver and Tab order: after the map buttons, before the sheet or list. text-secondary passes AA on bg-elevated and bg-hover; focus shows ring-focus. It is the only way from the map to Apple Maps, so keep it whenever the map is shown (even with nothing selected).qf-map-btn 은 아이콘만 있으므로 aria-label("내 위치로", "모두 보기", "확대", "축소"). 따라가기 토글은 aria-pressed. 확대와 축소 묶음은 role="group" + aria-label="확대와 축소". 끝에 닿은 확대나 축소 버튼은 disabled 대신 aria-disabled="true" 로 두고 누름을 무시합니다(키보드로 거듭 누르다 포커스를 잃지 않게). 끝 상태는 버튼뿐 아니라 휠, 핀치, "모두 보기" 등 모든 확대 변화 뒤에 다시 계산합니다. 상단 안전 영역 아래에 두어 상태 막대와 겹치지 않게 합니다. qf-map-link 의 이름은 "Apple 지도에서 열기"입니다(보이는 글 "Apple 지도"가 이름 앞에 그대로 들어감, 2.5.3). 앱은 accessibilityRole="button" 에 accessibilityHint 를 고른 것이 있으면 "고른 곳을 Apple 지도 앱으로 엽니다", 없으면 "보고 있는 곳을 Apple 지도 앱으로 엽니다"로 둡니다. 웹은 aria-label="Apple 지도에서 열기 (새 탭)", 아이콘은 aria-hidden 입니다. VoiceOver 와 Tab 차례는 지도 단추 다음, 시트나 목록 앞입니다. 글 text-secondary 는 bg-elevated 와 bg-hover 위 AA, 포커스는 ring-focus 입니다. 지도 위에서 Apple 지도로 가는 길은 이것 하나이므로 지도가 보이는 동안 늘 둡니다(고른 것이 없어도).

Actions

AuthProviders

A stack of sign-in buttons, all the same size (at least 44 tall, full width), so Sign in with Apple is not smaller than the others and is visible without scrolling. The first-party method uses qf-btn--primary. **Apple does not use qf-btn--provider**: put the platform's official button (iOS ASAuthorizationAppleIDButton / expo-apple-authentication, web Apple JS — black, white or white-outline only) in its slot at the same width, height and radius. Google uses its official button (web GIS renderButton) or qf-btn--provider following Google's light/dark/neutral themes (neutral surface, border-strong, the official "G" in qf-btn__logo, centered label). Third-party logos are not in the DS sprite.로그인 방법 버튼 묶음입니다. 모든 버튼이 같은 크기(높이 44 이상, 전체 폭)로 세로로 섭니다 — Apple 지침(Apple 로그인이 다른 방법보다 작지 않고, 스크롤하지 않아도 보이게). 자사 로그인은 qf-btn--primary. **Apple 은 qf-btn--provider 를 쓰지 않고** 플랫폼 공식 버튼(iOS ASAuthorizationAppleIDButton / expo-apple-authentication, 웹 Apple JS — 검정, 흰색, 흰색 + 외곽선만)을 같은 폭·높이·반경으로 그 자리에 둡니다. Google 은 공식 버튼(웹 GIS renderButton) 또는 Google 지침의 light/dark/neutral 테마를 따른 qf-btn--provider(중립 표면 + border-strong + 왼쪽 공식 "G" 로고 qf-btn__logo, 글자는 가운데). 제3자 로고는 DS 스프라이트에 넣지 않습니다(각 회사 자산).

.qf-auth-providerslayer: generic

Preview

Apple's official button here (same width and height)
<div class="qf-auth-providers" style="max-width:340px">
  <button class="qf-btn qf-btn--primary">Continue with qufox.com</button>
  <div role="presentation" style="display:grid;place-items:center;min-height:44px;border:1px dashed var(--border-strong);border-radius:var(--r-md);color:var(--text-muted);font-size:var(--fs-13)">Apple's official button here (same width and height)</div>
  <button class="qf-btn qf-btn--provider">Continue with Google</button>
</div>

Variants

qf-btn--provider qf-btn__logo

Required tokens

--s-3 --s-5 --s-6 --m-touch --fs-15 --bg-elevated --bg-hover --border-strong --text-strong --r-md --text-muted

Accessibility

Labels read "Continue with qufox.com / Apple / Google"; logos are alt="". Default order: first party, Apple, Google. qf-btn--provider reserves the logo space on both sides so the label never overlaps it, and grows with large text (min-height). Each is at least 44 tall.버튼 글자는 "qufox.com으로 계속", "Apple로 계속", "Google로 계속" 처럼 행동 + 제공자. 로고는 alt=""(글자가 이름). 순서는 자사, Apple, Google 이 기본. qf-btn--provider 는 로고 자리를 양쪽에 비워 글자와 겹치지 않고, 높이는 min-height 라 큰 글자에서 늘어납니다. 각 버튼 44 이상.

Forms & inputs

Input

A single-line text input field. --code is a one-box code entry (56 tall, 24px/600 monospace, --tracking-code, centered, uppercase display) so invite or pairing codes paste easily.한 줄 텍스트 입력 필드입니다. --code 는 번호 한 칸 입력(높이 56, 600 24px 고정폭, 자간 --tracking-code, 가운데, 대문자 표시) — 초대, 기기 연결 번호를 붙여 넣기 쉽게.

.qf-inputlayer: generic

Preview

<input class="qf-input" type="text" aria-label="Search" placeholder="Search">

Variants

qf-input--code

Required tokens

--bg-input --text --border --border-strong --text-muted --r-lg --s-4 --ring-danger --h-code-input --fs-24 --font-mono --tracking-code --text-danger

Accessibility

Convey the error state with aria-invalid="true", reinforced by the border and focus ring. Associate the label via a label element or aria-label, and tie helper text together with aria-describedby.오류 상태는 aria-invalid="true" 로 전달하며 보더와 링으로 함께 표시합니다. 라벨은 label 요소나 aria-label 로 연결하고, 안내문은 aria-describedby 로 묶습니다.

Forms & inputs

InputGroup

Groups an input with icon buttons on either side as one unit (no wrapping; the input may shrink). Example: previous/next-day arrows (qf-btn--ghost qf-btn--icon qf-btn--sm qf-btn--touch + qf-i-chevron-left/right) around a date input.입력과 양옆 아이콘 버튼을 한 덩어리로 묶습니다(줄바꿈 없음, 입력은 줄어들 수 있음). 예: 날짜 입력 양옆의 이전 날/다음 날 화살표(qf-btn--ghost qf-btn--icon qf-btn--sm qf-btn--touch + qf-i-chevron-left/right).

.qf-input-grouplayer: generic

Preview

<div class="qf-input-group">
  <button class="qf-btn qf-btn--ghost qf-btn--icon qf-btn--sm qf-btn--touch" type="button" aria-label="Previous day">
    <svg class="qf-icon qf-icon--sm" aria-hidden="true">
      <use href="#qf-i-chevron-left"/>
    </svg>
  </button>
  <input class="qf-input" type="date" value="2026-10-03" aria-label="Go to date">
  <button class="qf-btn qf-btn--ghost qf-btn--icon qf-btn--sm qf-btn--touch" type="button" aria-label="Next day">
    <svg class="qf-icon qf-icon--sm" aria-hidden="true">
      <use href="#qf-i-chevron-right"/>
    </svg>
  </button>
</div>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--s-1

Accessibility

Give the arrow buttons an aria-label (previous day, next day) and the input a label or aria-label. Disable a button at the end of the range. The 28px arrows carry qf-btn--touch so they get a 44px hit area on touch devices (overlapping the input by 8px is acceptable).화살표 버튼에는 aria-label(이전 날, 다음 날)을 두고 입력에는 label 이나 aria-label 을 둡니다. 범위 끝에서는 버튼을 disabled 로. 화살표는 28px 라 qf-btn--touch 를 붙여 터치 환경에서 44px 히트 영역을 받습니다(입력 위로 8px 겹치는 정도는 허용).

Forms & inputs

Textarea

A multi-line text input field that adds height and vertical resizing on top of qf-input. --mono is for prompts and code (--font-mono, 12px).여러 줄 텍스트를 입력하는 입력 필드입니다. qf-input 위에 높이, 세로 리사이즈를 더합니다. --mono 는 지시문·코드 편집용(--font-mono 12px).

.qf-textarealayer: generic

Preview

<textarea class="qf-input qf-textarea" rows="3" aria-label="Notes" placeholder="Enter a note">
</textarea>

Variants

qf-textarea--mono

Required tokens

--bg-input --border --text --r-lg --s-3 --s-4 --ring-accent --font-mono --fs-12 --lh-normal

Accessibility

Associate the label via for/id or a wrapping label, and indicate errors with aria-invalid=true. Allow vertical-only resizing to prevent layout breakage.label 을 for/id 또는 감싼 라벨로 연결하고, 오류는 aria-invalid=true 로 표시합니다. 리사이즈는 세로만 허용해 레이아웃 깨짐을 막습니다.

Forms & inputs

Field

A form field wrapper that groups the label, control, helper text, and error message. The label's uppercase caps tracking applies to Latin only; under :lang(ko) letter-spacing is 0 (024).라벨, 컨트롤, 도움말, 오류 메시지를 묶는 폼 필드 래퍼입니다. 라벨의 대문자·caps 자간은 라틴에만 — :lang(ko) 에서는 자간 0(024).

.qf-fieldlayer: generic

Preview

<label class="qf-field">
  <span class="qf-field__label">Email</span>
  <input class="qf-input" type="email" placeholder="you@example.com">
  <span class="qf-field__hint">Enter your work email.</span>
</label>

Variants

qf-field__label qf-field__hint qf-field__error

Required tokens

--s-2 --fs-12 --text-secondary --text-muted --tracking-caps --tracking-normal --text-danger

Accessibility

Associate the label with the control (by wrapping it or via for/id), and link error text with aria-describedby. Convey errors with text, not color alone.라벨을 컨트롤과 연결하고(감싸거나 for/id), 오류 텍스트는 aria-describedby 로 연결합니다. 색뿐 아니라 텍스트로 오류를 전달합니다.

Forms & inputs

DateRange

A range input that groups a start and end date, using the browser's native date picker for calendar selection.시작, 종료 날짜를 묶는 범위 입력입니다. 달력 선택은 브라우저 native date picker 를 사용합니다.

.qf-daterangelayer: generic

Preview

~
<div class="qf-daterange">
  <input class="qf-input" type="date" aria-label="Start date" value="2026-06-01">
  <span class="qf-daterange__sep">~</span>
  <input class="qf-input" type="date" aria-label="End date" value="2026-06-16">
</div>

Variants

qf-daterange__sep

Required tokens

--s-3 --text-muted --bg-input --border --r-lg

Accessibility

Associate each input with a from/to label via aria-label, and also convey the range meaning (start to end).각 input 에 from/to 라벨을 aria-label 로 연결하고, 범위 의미(시작~종료)를 함께 전달합니다.

Forms & inputs

ToggleRow

A settings toggle row that groups a title, description, and a control on the right into a single line.제목과 설명, 우측 컨트롤을 한 줄로 묶는 설정 토글 행입니다.

.qf-toggle-rowlayer: generic

Preview

Notifications
Receive desktop notifications
<div class="qf-toggle-row">
  <div class="qf-toggle-row__text">
    <div class="qf-toggle-row__title" id="r1">Notifications</div>
    <div class="qf-toggle-row__desc">Receive desktop notifications</div>
  </div>
  <button class="qf-switch" role="switch" aria-checked="true" aria-labelledby="r1">
  </button>
</div>

Variants

qf-toggle-row__text qf-toggle-row__title qf-toggle-row__desc

Required tokens

--s-5 --divider --fs-15 --fs-13 --text-strong --text-muted --font-sans

Accessibility

Associate the row's title text as the label for the switch on the right so screen readers know what is being turned on and off.행의 제목 텍스트를 우측 스위치의 라벨로 연결해 무엇을 켜고 끄는지 화면 낭독기에 전달합니다.

Forms & inputs

Switch

A switch that toggles between on and off states.켜짐, 꺼짐 상태를 토글하는 스위치입니다.

.qf-switchlayer: generic

Preview

<button class="qf-switch" role="switch" aria-checked="true" aria-label="Turn on notifications">
</button>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--bg-track --accent --r-pill --dur-fast --dur-base --ease-spring

Accessibility

Convey state with role=switch and aria-checked, and associate a label. Make it togglable via keyboard and keep focus visible.role=switch와 aria-checked로 상태를 전달하고 라벨을 연결합니다. 키보드로 토글 가능하며 포커스가 보이게 합니다.

Forms & inputs

OtpInput

A one-time code input field where a verification code is entered one digit per box. Also for alphanumeric codes (invites, device pairing); letters display uppercase, but text-transform only changes the display, so normalise the value to uppercase. Use inputmode="text" autocapitalize="characters" for alphanumeric codes, inputmode="numeric" for digits only.인증 코드를 자리별로 입력하는 일회용 코드 입력란입니다. 영숫자 번호(초대, 기기 연결)도 같은 칸 — 글자는 대문자로 보이지만 text-transform 은 표시만 바꾸므로 값은 소비처가 대문자로 정규화합니다. 영숫자면 inputmode="text" autocapitalize="characters" autocomplete="one-time-code", 숫자만이면 inputmode="numeric".

.qf-otp-inputlayer: generic

Preview

<div class="qf-otp-input" role="group" aria-label="6-digit verification code">
  <input class="qf-otp-input__digit" inputmode="numeric" maxlength="1" aria-label="Digit 1">
  <input class="qf-otp-input__digit" inputmode="numeric" maxlength="1" aria-label="Digit 2">
  <input class="qf-otp-input__digit" inputmode="numeric" maxlength="1" aria-label="Digit 3">
  <input class="qf-otp-input__digit" inputmode="numeric" maxlength="1" aria-label="Digit 4">
  <input class="qf-otp-input__digit" inputmode="numeric" maxlength="1" aria-label="Digit 5">
  <input class="qf-otp-input__digit" inputmode="numeric" maxlength="1" aria-label="Digit 6">
</div>

Variants

qf-otp-input__digit

Required tokens

--s-2 --s-10 --fs-24 --font-mono --accent --ring-accent --ring-danger --text-danger

Accessibility

Each digit box shows an accent ring on focus for visible focus, and errors are conveyed beyond color with aria-invalid and a danger ring. inputMode=numeric brings up the numeric keypad, and a label communicates the field's purpose.각 자리 입력은 포커스 시 accent ring으로 가시하고, 오류는 aria-invalid와 danger ring으로 색 외 상태를 함께 전합니다. inputMode=numeric로 숫자 키패드를 제공하고 라벨로 용도를 안내합니다.

Forms & inputs

PasswordStrengthMeter

Displays password strength in real time using a bar and a label.비밀번호 강도를 막대와 라벨로 실시간 표시합니다.

.qf-strength-meterlayer: generic

Preview

Strong

<div class="qf-strength-meter" data-strength="strong">
  <div class="qf-strength-meter__track">
    <span class="qf-strength-meter__bar is-on">
    </span>
    <span class="qf-strength-meter__bar is-on">
    </span>
    <span class="qf-strength-meter__bar is-on">
    </span>
  </div>
  <p class="qf-strength-meter__label" aria-live="polite">Strong</p>
</div>

Examples예시

Weak

Weak

Medium

Medium

Strong

Strong

Variants

qf-strength-meter__track qf-strength-meter__bar qf-strength-meter__label

Required tokens

--s-1 --s-2 --bg-hover --danger-400 --warn-400 --ok-400 --ok-600 --r-sm --text-danger

Accessibility

Strength is conveyed through label text (weak, fair, strong) alongside the data-strength bar color, avoiding reliance on color alone. aria-live announces changes in strength.강도는 data-strength 막대 색과 함께 라벨 텍스트(약함, 보통, 강함)로 전달해 색 단독 의존을 피합니다. aria-live로 강도 변화를 알립니다.

Forms & inputs

BackupCodes

A list that displays one-time recovery codes for two-factor authentication.2단계 인증의 일회용 복구 코드를 보여주는 목록입니다.

.qf-backup-codeslayer: generic

Preview

  • A1B2-C3D4
  • E5F6-G7H8
  • J9K0-L1M2
  • N3P4-Q5R6
  • S7T8-U9V0
  • W1X2-Y3Z4
  • B5C6-D7E8
  • F9G0-H1J2
<ul class="qf-backup-codes" aria-label="Backup codes">
  <li class="qf-backup-codes__code">A1B2-C3D4</li>
  <li class="qf-backup-codes__code is-used">E5F6-G7H8</li>
  <li class="qf-backup-codes__code">J9K0-L1M2</li>
  <li class="qf-backup-codes__code">N3P4-Q5R6</li>
  <li class="qf-backup-codes__code">S7T8-U9V0</li>
  <li class="qf-backup-codes__code">W1X2-Y3Z4</li>
  <li class="qf-backup-codes__code">B5C6-D7E8</li>
  <li class="qf-backup-codes__code">F9G0-H1J2</li>
</ul>

Variants

qf-backup-codes__code

Required tokens

--s-2 --s-4 --bg-input --border --r-md --font-mono --text-strong --text-muted

Accessibility

Used codes are distinguished with a strikethrough and dimmed color; it is best to also convey their state through text and not visuals alone. A monospace alignment keeps the codes legible.사용한 코드는 취소선과 함께 흐린 색으로 구분하며, 상태를 시각만이 아니라 텍스트로 함께 안내하면 좋습니다. mono 정렬로 코드 가독성을 확보합니다.

Forms & inputs

Checkbox

A checkbox for confirmations such as agreeing to terms. --lg is a checkbox that is a question of its own in a form (e.g. "Under 14") — 44 row height, 15px body text. __more is dependent content that opens right below when checked (e.g. guardian consent), indented to the label start. A qf-field__hint or qf-field__error after the checkbox is also indented to the label start (062). Sign-up age (062, Den 071 B-35): the email sign-up form puts --lg "I am 14 or older" after the password field, before submit, with the hint "Under 14s use Den without an account, with a pairing code from a guardian." Submitting unchecked adds "You must be 14 or older to sign up." under the hint, with the other field errors (the hint stays so under 14s still see where to go; Den 071 review). After a first Apple or Google sign-in (and for any account not yet confirmed, however it signed up) one screen: title "Confirm your age", body "Den accounts are for people 14 or older.", the same checkbox and hint, primary lg "Continue", ghost lg "Sign out" below; no back (sign out is the way out). Guardian turns it back on (062, Den 071 B-29): on a device member's management screen, turning on sharing for an under-14 phone leaves the switch off and shows, where the turn-off confirm appears (in Den today right under the sharing row; under the card once the screen uses grouped cards), a default checkbox with the same sentence as at creation plus primary "Turn on sharing" and ghost "Cancel". Pressing it unchecked shows the error "You need guardian consent to turn it on." Asked every time; while off, the row's description reads "Turning this on needs guardian consent." On touch (any-pointer: coarse) the default checkbox, label included, is at least 44 tall too (062, top-aligned like Den RN). A hint or error after any checkbox is indented to the label start. Wrap a checkbox with its hint and error in one qf-field (or __more), so the following-sibling rule never catches another field's error.약관 동의 등 확인을 받는 체크박스입니다. --lg 는 폼의 질문 하나인 체크박스(예: "14세 미만입니다") — 줄 높이 44, 글자 15px 본문색. __more 는 체크하면 바로 아래 펼쳐지는 딸린 내용(예: 법정대리인 동의)으로 라벨 시작선에 맞춰 들여 씁니다. 체크박스 뒤의 qf-field__hint, qf-field__error 도 라벨 시작선에 맞춰 들여 씁니다(062). 가입 나이(062, Den 071 B-35): 이메일 가입 양식은 비밀번호 칸 다음, 제출 단추 앞에 --lg "만 14세 이상입니다"와 그 밑 도움말 "14세 미만은 계정 없이, 보호자가 만든 기기 연결 번호로 씁니다." 체크하지 않고 제출하면 다른 칸 오류와 함께 도움말 밑에 "만 14세 이상만 가입할 수 있습니다."(도움말은 남겨 14세 미만이 갈 길을 계속 보이게, Den 071 반영 대조). Apple, Google 첫 로그인 뒤(그리고 확인 전 계정이면 가입 방식과 상관없이)에는 한 화면: 제목 "나이 확인", 본문 "Den 계정은 만 14세 이상이 만듭니다.", 같은 체크와 도움말, primary lg "계속", 그 아래 ghost lg "로그아웃". 뒤로 가기는 두지 않습니다(로그아웃이 나가는 길). 보호자가 다시 켜기(062, Den 071 B-29): 기기 구성원 관리 화면에서 14세 미만 폰의 꺼진 위치 공유를 켜면 스위치는 꺼진 채로 두고, 끄기 확인이 뜨는 자리(Den 지금: 공유 줄 바로 아래. 묶음 카드로 옮긴 화면이면 카드 바로 아래)에 기본형 체크박스(만들 때와 같은 문장 "법정대리인(부모 등)으로서 이 구성원의 위치 수집과 가족 공유에 동의합니다.") + primary "공유 켜기" + ghost "그만두기". 체크하지 않고 누르면 "법정대리인 동의가 있어야 켤 수 있습니다." 켤 때마다 다시 받습니다. 그 줄의 설명은 "켜려면 법정대리인 동의가 필요합니다." 터치 환경(any-pointer: coarse)에서는 기본형도 라벨째 누르는 곳이 44 이상입니다(062, Den RN 과 같은 위 정렬). 체크박스 뒤의 도움말과 오류는 기본형도 라벨 시작선에 들여 씁니다. 체크박스와 그 도움말, 오류는 qf-field(또는 __more) 하나에 묶습니다(뒤 형제 규칙이 다른 입력칸의 오류를 잡지 않게).

.qf-checkboxlayer: generic

Preview

법정대리인 동의가 있어야 만들 수 있습니다.
<label class="qf-checkbox">
  <input class="qf-checkbox__input" type="checkbox">
  <span class="qf-checkbox__label">I agree to the terms</span>
</label>
<!-- --lg + __more: the dependent content is a sibling right after the checkbox and is not rendered (or hidden) while unchecked -->
  <div>
    <label class="qf-checkbox qf-checkbox--lg">
      <input class="qf-checkbox__input" type="checkbox" checked>
      <span class="qf-checkbox__label">14세 미만입니다</span>
    </label>
    <div class="qf-checkbox__more">
      <label class="qf-checkbox">
        <input class="qf-checkbox__input" type="checkbox" aria-invalid="true" aria-errormessage="cb-e" aria-describedby="cb-e">
        <span class="qf-checkbox__label">법정대리인(부모 등)으로서 이 구성원의 위치 수집과 가족 공유에 동의합니다.</span>
      </label>
      <span class="qf-field__error" id="cb-e">법정대리인 동의가 있어야 만들 수 있습니다.</span>
    </div>
  </div>

Examples예시

14세 미만은 계정 없이, 보호자가 만든 기기 연결 번호로 씁니다.
14세 미만은 계정 없이, 보호자가 만든 기기 연결 번호로 씁니다.만 14세 이상만 가입할 수 있습니다.
062 가입 나이: --lg + 도움말, 체크 안 하고 제출하면 도움말 밑에 오류
062 보호자가 다시 켜기: 카드 아래 동의와 켜기

Variants

법정대리인 동의가 있어야 만들 수 있습니다.
qf-checkbox--lg

Parts & more: 구성 요소, 기타: qf-checkbox__input qf-checkbox__label qf-checkbox__more

Required tokens

--s-3 --s-5 --accent --fs-13 --text-secondary --lh-normal --m-touch --fs-15 --text --s-1 --s-2 --r-xs --text-danger

Accessibility

Only accent-color is layered onto the native input to preserve focus-visible focus visibility. The label and input are associated so that clicking the label works and screen readers read it correctly. If a required confirmation is skipped, set aria-invalid="true" plus aria-errormessage and aria-describedby (both the qf-field__error id, with a hint id after the error when there is a hint — iOS VoiceOver supports errormessage poorly) on the input — a text-danger outline around the box plus the message (not color alone). While focused, the focus ring replaces the error outline in the same place and the message keeps telling the error. Put __more right after the checkbox in the DOM so reading order matches visual order; the checked state is the disclosure, so no aria-expanded. Clear the checks inside when it collapses, and do not render it (or use hidden) while collapsed. The age screen moves focus to its title on open (on the web the h1 gets tabindex="-1"); pressing Continue unchecked announces the error and moves focus to the checkbox. Link the hint with aria-describedby (while the error shows, list both ids, error first). In RN put "error text. hint" in that order in the checkbox's accessibilityHint.네이티브 input 위에 accent-color만 얹어 focus-visible 포커스 가시를 보존합니다. label과 input을 연결해 라벨 클릭과 스크린리더 읽기를 보장합니다. 필수 확인을 하지 않고 넘어가면 input 에 aria-invalid="true" + aria-errormessage 와 aria-describedby(둘 다 qf-field__error 의 id, 도움말이 있으면 그 id 를 오류 뒤에 — iOS VoiceOver 는 errormessage 지원이 약함) — 상자 둘레 text-danger 선과 문구가 함께 보입니다(색 단독 아님). 포커스 중에는 오류선 대신 포커스 링이 같은 자리에 보이고, 오류는 문구가 계속 알립니다. __more 는 DOM 에서 체크박스 바로 뒤에 두어 읽는 순서와 보이는 순서를 같게 하고, 체크 상태가 곧 펼침이라 aria-expanded 는 두지 않습니다. 접힐 때 안의 체크는 풀어 주고, 접힌 동안은 렌더하지 않거나 hidden 으로 둡니다. 나이 확인 화면은 열 때 초점을 제목으로 옮기고(웹은 h1 에 tabindex="-1"), 체크하지 않고 "계속"을 누르면 오류 문구를 알리고 초점을 체크박스로 옮깁니다. 도움말은 aria-describedby 로 체크박스에 잇습니다(오류가 보이면 "오류 id 도움말 id" 둘을 오류 먼저). RN 은 체크박스의 accessibilityHint 에 "오류 문구. 도움말" 순서로 둡니다.

Forms & inputs

Select

A dropdown select field that wraps a native select to match the design.네이티브 select 를 디자인에 맞춰 감싸는 드롭다운 선택 필드입니다.

.qf-selectlayer: generic

Preview

<span class="qf-select">
  <select aria-label="Country">
    <option>Korea</option>
    <option>Japan</option>
  </select>
</span>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--bg-input --border --text --r-lg --s-4 --s-8 --text-muted --ring-accent --text-danger --ring-danger

Accessibility

Because the core is a native select, keyboard and screen reader behavior is preserved as-is. Associate the label via for/id, and indicate errors with aria-invalid=true.내부는 네이티브 select 라 키보드/스크린리더 동작을 그대로 보존합니다. label 을 for/id 로 연결하고, 오류는 aria-invalid=true 로 표시합니다.

Forms & inputs

Radio

Pairs a single-select radio button with its label on one row.단일 선택 라디오 버튼과 라벨을 한 행으로 묶습니다.

.qf-radiolayer: generic

Preview

<div class="qf-stack" style="gap:var(--s-2)">
  <label class="qf-radio">
    <input class="qf-radio__input" type="radio" name="plan" checked>
    <span class="qf-radio__label">Free</span>
  </label>
  <label class="qf-radio">
    <input class="qf-radio__input" type="radio" name="plan">
    <span class="qf-radio__label">Pro</span>
  </label>
  <label class="qf-radio">
    <input class="qf-radio__input" type="radio" name="plan">
    <span class="qf-radio__label">Team</span>
  </label>
</div>

Variants

qf-radio__input qf-radio__label

Required tokens

--s-3 --s-5 --accent --fs-13 --text-secondary

Accessibility

Group options under the same name and wrap them in qf-choice-list. Only accent-color is layered onto the native input to preserve focus visibility.같은 name 으로 그룹을 묶고 qf-choice-list 로 감쌉니다. 네이티브 input 위에 accent-color 만 얹어 포커스 가시를 보존합니다.

Forms & inputs

ChoiceList

A container that groups a set of checkboxes or radios together with a title.체크박스나 라디오 그룹을 제목과 함께 묶는 컨테이너입니다.

.qf-choice-listlayer: generic

Preview

Notifications
<fieldset class="qf-choice-list">
  <legend class="qf-choice-list__legend">Notifications</legend>
  <label class="qf-checkbox">
    <input class="qf-checkbox__input" type="checkbox" checked>
    <span class="qf-checkbox__label">Email</span>
  </label>
  <label class="qf-checkbox">
    <input class="qf-checkbox__input" type="checkbox">
    <span class="qf-checkbox__label">Push</span>
  </label>
  <label class="qf-checkbox">
    <input class="qf-checkbox__input" type="checkbox">
    <span class="qf-checkbox__label">SMS</span>
  </label>
</fieldset>

Variants

qf-choice-list__legend

Required tokens

--s-3 --s-1 --fs-12 --text-secondary --tracking-caps

Accessibility

Build it as a fieldset and convey the group title with legend (qf-choice-list__legend). Use radio for single selection and checkbox for multiple selection.fieldset 으로 만들고 legend(qf-choice-list__legend)로 그룹 제목을 전달합니다. 단일 선택은 radio, 다중 선택은 checkbox 를 씁니다.

Forms & inputs

FormLayout

A layout that arranges form fields vertically and provides horizontal rows and an action row.폼 필드를 세로로 배치하고 가로 행과 액션열을 제공하는 레이아웃입니다.

.qf-formlayer: generic

Preview

<form class="qf-form">
  <div class="qf-form__row">
    <label class="qf-field">
      <span class="qf-field__label">Name</span>
      <input class="qf-input">
    </label>
  </div>
  <div class="qf-form__actions">
    <button class="qf-btn qf-btn--primary">Save</button>
  </div>
</form>

Variants

qf-form__row qf-form__actions

Required tokens

--s-5 --s-4 --s-3 --grid-cell-min

Accessibility

Apply it to a form element, and associate each field's label/hint/error via qf-field. __row wraps automatically at narrow widths.form 요소에 적용하고 각 필드는 qf-field 로 라벨/힌트/에러를 연결합니다. __row 는 좁은 폭에서 자동 줄바꿈됩니다.

Forms & inputs

Search

A search input field with an icon and a clear button.아이콘과 클리어 버튼을 갖춘 검색 입력 필드입니다.

.qf-searchlayer: generic

Preview

<div class="qf-search">
  <span class="qf-search__icon" aria-hidden="true">
    <svg class="qf-icon qf-icon--sm">
      <use href="#qf-i-search"/>
    </svg>
  </span>
  <input class="qf-search__input" type="search" aria-label="Search" placeholder="Search">
  <button class="qf-search__clear" aria-label="Clear search">×</button>
</div>

Variants

qf-search__icon qf-search__input qf-search__clear

Required tokens

--bg-input --border --accent --r-lg --s-4 --text --text-muted

Accessibility

Give the input[type="search"] an aria-label or an associated label. Mark the icon aria-hidden, and give the clear button an aria-label (e.g. "Clear search").input[type=search] 에 aria-label 또는 연결된 label 을 둡니다. 아이콘은 aria-hidden, 클리어 버튼에는 aria-label(예: 검색어 지우기).

Forms & inputs

Slider

A slider for selecting a value from a range.범위 값을 선택하는 슬라이더입니다.

.qf-sliderlayer: generic

Preview

<input class="qf-slider" type="range" min="0" max="100" value="40" aria-label="Volume">

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--s-2 --r-pill --bg-hover --accent --ring-focus

Accessibility

Because it's a native input[type="range"], keyboard operation and value communication come for free. Associate a label, and use aria-valuetext to supplement units when needed.네이티브 input[type=range] 라 키보드 조작과 값 전달이 기본 제공됩니다. label 을 연결하고 필요 시 aria-valuetext 로 단위를 보충합니다.

Forms & inputs

NumberInput

A numeric input field with increment and decrement buttons.증감 버튼이 있는 숫자 입력 필드입니다.

.qf-number-inputlayer: generic

Preview

<div class="qf-number-input">
  <button class="qf-number-input__btn" aria-label="Decrease">−</button>
  <input class="qf-number-input__field" type="number" value="1" aria-label="Quantity">
  <button class="qf-number-input__btn" aria-label="Increase">+</button>
</div>

Variants

qf-number-input__field qf-number-input__btn

Required tokens

--bg-input --border --r-lg --text --font-mono --bg-hover --text-secondary

Accessibility

The field is an input[type="number", inputmode="numeric"] with an associated label. Give the stepper buttons an aria-label (e.g. "Increment" / "Decrement"), and let the input remain the source of truth for the value.field 는 input[type=number, inputmode=numeric] 에 label 연결. 증감 버튼에는 aria-label(예: 1 증가/감소)을 두고, 값은 input 이 권위를 가집니다.

Forms & inputs

FileDrop

A general-purpose upload zone for dropping files via drag-and-drop or clicking to browse.파일을 끌어다 놓거나 클릭해 올리는 범용 업로드 영역입니다.

.qf-file-droplayer: generic

Preview

<label class="qf-file-drop">
  <span class="qf-file-drop__title">Drop files here</span>
  <span>or click to browse</span>
  <input type="file" hidden>
</label>

Variants

qf-file-drop--active

Parts & more: 구성 요소, 기타: qf-file-drop__title

Required tokens

--border-strong --r-lg --bg-input --text-muted --accent --accent-bg --text-strong --s-8

Accessibility

Connect a real input[type="file"] to the zone (via label or click delegation) to preserve keyboard access. Convey the drag state with text in addition to --active.실제 input[type=file] 을 영역에 연결(label 또는 클릭 위임)해 키보드 접근을 보존합니다. 드래그 상태는 --active 와 함께 텍스트로도 안내합니다.

Forms & inputs

Composer

A composer that wraps an auto-expanding textarea and inline actions (send, etc.) in a focus-within pill, with a leading slot (__lead) and size variants (--sm/--lg). The rich-text format bar (__formatbar, --rich) is a chat-layer extension.focus-within 필 안에 자동확장 textarea와 인라인 액션(전송 등)을 묶는 컴포저입니다. 선행 슬롯(__lead)과 크기 변형(--sm/--lg)을 지원합니다. 리치 텍스트 포맷바(__formatbar, --rich)는 챗 확장입니다.

.qf-composerlayer: generic

Preview

<div class="qf-composer">
  <div class="qf-composer__row">
    <button class="qf-composer__attach" aria-label="Attach">
      <svg class="qf-icon" aria-hidden="true">
        <use href="#qf-i-plus"/>
      </svg>
    </button>
    <textarea class="qf-composer__input" rows="1" aria-label="Message" placeholder="Type a message">
    </textarea>
    <button class="qf-composer__send" aria-label="Send">
      <svg class="qf-icon" aria-hidden="true">
        <use href="#qf-i-send"/>
      </svg>
    </button>
  </div>
</div>

Variants

qf-composer--rich
qf-composer--sm
qf-composer--lg

Parts & more: 구성 요소, 기타: qf-composer__formatbar qf-composer__format-btn qf-composer__format-sep qf-composer__row qf-composer__attach qf-composer__input qf-composer__actions qf-composer__send qf-composer__hint qf-composer__hint-count--over qf-composer__lead

Required tokens

--bg-input --border --accent --r-lg --s-3 --s-5 --text --text-onAccent --composer-max-h --composer-font-min --s-10 --text-danger

Accessibility

Because focus-within highlights the field with an accent border, the inner textarea disables its own outline. Formatting buttons convey their toggle state via aria-pressed. Keep the send button disabled when the input is empty, and signal a hint character-count overflow with text as well as color.focus-within 시 accent 보더로 강조하므로 내부 textarea 는 자체 outline 을 끕니다. 포맷 버튼은 aria-pressed 로 토글 상태를 전합니다. 전송 버튼은 입력이 비면 disabled 로 두고, 힌트 글자수 초과는 색만이 아니라 텍스트로도 알립니다.

Forms & inputs

Pick

An image-choice tile that behaves like a radio: pick one from a row of thumbnails. A <label class="qf-pick"> holds input[type=radio].qf-pick__input (laid transparently over the tile so the whole tile is the hit area), a frame qf-pick__frame (4:3, --bg-media, img uses object-fit: contain because the whole picture must be visible — not cover), a bottom-left tag qf-pick__tag (on-media glass, short text), and a one-line label qf-pick__label (12px, ellipsis). States: checked draws an accent outline outside the frame (2px, offset 2), focus-visible shows --ring-focus, disabled dims, hover shows a --border-strong outline. Variants: qf-pick__frame--none (dashed frame with a single word, "None"), qf-pick--muted (not a candidate — desaturated, darker image and a warning-colored tag), qf-pick--current (what is shown now — bolder label). The row is qf-picks: horizontal scroll with scroll-snap, inner padding so outlines and rings are not clipped, and the same right-edge fade as qf-chips--scroll (only when overflowing, clears at the end, is-end fallback). Tile width --sz-pick (160px; 2.1 tiles at 390px).축소 사본을 보고 하나를 고르는 이미지 선택 타일입니다(라디오 동작). <label class="qf-pick"> 안에 input[type=radio].qf-pick__input(투명하게 깔려 타일 전체가 히트), 틀 qf-pick__frame(4:3, --bg-media, img 는 object-fit: contain — 이미지 전체를 봐야 하므로 cover 가 아님), 왼쪽 아래 태그 qf-pick__tag(미디어 위 글래스, 짧은 글자), 한 줄 라벨 qf-pick__label(12px, 말줄임)을 둡니다. 상태: checked 는 틀 바깥 액센트 외곽선(2px, offset 2), focus-visible 은 --ring-focus, disabled 는 흐림, hover 는 --border-strong 외곽선. 변형: qf-pick__frame--none(점선 틀에 글자 하나, "없음"), qf-pick--muted(후보가 아닌 것 — 이미지 채도·밝기 낮춤 + 태그 경고색), qf-pick--current(지금 보이는 것 — 라벨 진하게). 줄은 qf-picks: 가로 스크롤 + scroll-snap, 안쪽 여백으로 외곽선·링이 잘리지 않고, 오른쪽 페이드는 qf-chips--scroll 과 같습니다(넘칠 때만, 끝에서 걷힘, 미지원은 is-end). 타일 폭 --sz-pick(160px, 390px 에서 2.1장).

.qf-picklayer: generic

Preview

<div class="qf-picks" role="radiogroup" aria-label="Image to show">
  <label class="qf-pick qf-pick--current">
    <input class="qf-pick__input" type="radio" name="pick" value="1" checked>
    <span class="qf-pick__frame">
      <img src="brand-assets/png/og-image.png" alt="">
      <span class="qf-pick__tag">Shown</span>
    </span>
    <span class="qf-pick__label">Clien, photo</span>
  </label>
  <label class="qf-pick">
    <input class="qf-pick__input" type="radio" name="pick" value="2">
    <span class="qf-pick__frame">
      <img src="brand-assets/png/icon-512.png" alt="">
      <span class="qf-pick__tag">AI</span>
    </span>
    <span class="qf-pick__label">AI image</span>
  </label>
  <label class="qf-pick qf-pick--muted">
    <input class="qf-pick__input" type="radio" name="pick" value="3">
    <span class="qf-pick__frame">
      <img src="brand-assets/png/og-image.png" alt="">
      <span class="qf-pick__tag">Screenshot</span>
    </span>
    <span class="qf-pick__label">Ruliweb, screenshot of an article</span>
  </label>
  <label class="qf-pick">
    <input class="qf-pick__input" type="radio" name="pick" value="none">
    <span class="qf-pick__frame qf-pick__frame--none">None</span>
    <span class="qf-pick__label">No image</span>
  </label>
</div>

Variants

qf-pick__input qf-pick__frame qf-pick__frame--none qf-pick__tag qf-pick__label qf-pick--muted qf-pick--current qf-picks

Required tokens

--sz-pick --aspect-4x3 --bg-media --r-md --r-xs --s-1 --s-2 --s-3 --s-4 --s-10 --fs-12 --fs-11 --lh-normal --lh-snug --tracking-normal --text-muted --text-strong --border-strong --accent --ring-focus --on-media-glass-bg --on-media-text --warn-400 --dur-fast --ease-standard --font-sans --on-media-glass-bg-strong --text-disabled

Accessibility

Wrap the row in role="radiogroup" with an aria-label; each tile is label > input[type=radio], so click, Space and arrow-key movement work natively (arrow focus scrolls the tile into view via scroll-padding). The radio's accessible name is the label text (tag + label); add a title or aria-describedby for more. Use alt="" for decorative thumbnails, a description when the content matters. The tag sits on an on-media glass (--on-media-glass-bg + --on-media-text), AA on any image; the muted tag uses --warn-400 on the strong glass (--on-media-glass-bg-strong): 6.8:1 even over a white image or the light letterbox (the .68 glass would be 4.1). Tiles are 160×120, an ample touch target, and the gap widens to --s-4 on touch devices. When the checked outline and the focus ring overlap they read as a 4px accent band — both are accent, so it reads as "the selected one is focused". A disabled tile only dims its image; the label stays readable in --text-disabled and the tile does not react to hover. Checked, focus and disabled styling rely on :has(), so browsers without it (Firefox < 121, Safari < 15.4) show no state.줄을 role="radiogroup" + aria-label 로 묶고 타일은 label > input[type=radio] 라 클릭·Space·화살표 이동이 네이티브로 동작합니다(화살표로 옮기면 scroll-padding 으로 타일이 줄 안에 들어옵니다). 라디오의 접근 가능한 이름은 label 의 텍스트(태그 + 라벨)이며, 설명이 더 필요하면 label 의 title 이나 aria-describedby 로. img 는 장식이면 alt="", 내용이 중요하면 설명. 태그는 미디어 위 글래스(--on-media-glass-bg + --on-media-text)라 어떤 이미지 위에서도 AA. muted 태그는 진한 글래스(--on-media-glass-bg-strong) 위 --warn-400 — 흰 이미지·라이트 레터박스 위에서도 6.8:1(.68 글래스는 4.1 로 미달). 타일 160×120 이라 터치 대상이 충분하고 터치 환경에서는 타일 간격이 --s-4 로 넓어집니다. checked 외곽선과 포커스 링이 겹치면 4px 액센트 띠로 보이며 둘 다 액센트라 "선택된 것에 포커스" 로 읽힙니다. disabled 타일은 이미지만 흐려지고 라벨은 --text-disabled 로 읽히며 hover 에 반응하지 않습니다. 선택·포커스·disabled 표시는 :has() 에 기대므로 미지원 브라우저(Firefox < 121, Safari < 15.4)에서는 상태가 보이지 않습니다.

Forms & inputs

ChoiceCard

A large choice card for picking exactly one option (a role, a plan). The whole label is the tap target: an icon on the left, a 15px/600 title and a one-line description, and a real radio on the right. When checked it gets an accent border and a faint accent surface. Groups without a default start with nothing checked; if the user goes on without choosing, set aria-invalid on the group and show qf-field__error. Group them in qf-choice-cards.하나를 반드시 고르는 큰 선택지 카드입니다(역할 고르기, 요금제 등). label 전체가 탭 대상이고 왼쪽 아이콘, 제목(600 15px)과 한 줄 설명, 오른쪽에 진짜 radio 를 둡니다. 고르면 accent 테두리와 옅은 accent 표면. 기본값이 없는 그룹은 checked 없이 시작하고, 고르지 않고 넘어가면 그룹에 aria-invalid 와 qf-field__error. qf-choice-cards 로 묶습니다.

.qf-choice-cardlayer: generic

Preview

<div class="qf-choice-cards" role="radiogroup" aria-label="Your role in this group" aria-required="true">
  <label class="qf-choice-card">
    <span class="qf-choice-card__icon">
      <svg class="qf-icon" aria-hidden="true">
        <use href="#qf-i-map-pin"/>
      </svg>
    </span>
    <span class="qf-choice-card__body">
      <span class="qf-choice-card__title">Share my location</span>
      <span class="qf-choice-card__desc">Watchers in this group see where you are and your trips from today.</span>
    </span>
    <input class="qf-choice-card__input" type="radio" name="role" value="share">
  </label>
  <label class="qf-choice-card">
    <span class="qf-choice-card__icon">
      <svg class="qf-icon" aria-hidden="true">
        <use href="#qf-i-eye"/>
      </svg>
    </span>
    <span class="qf-choice-card__body">
      <span class="qf-choice-card__title">See my family</span>
      <span class="qf-choice-card__desc">You do not share; you see the people who share.</span>
    </span>
    <input class="qf-choice-card__input" type="radio" name="role" value="watch">
  </label>
  <label class="qf-choice-card">
    <span class="qf-choice-card__icon">
      <svg class="qf-icon" aria-hidden="true">
        <use href="#qf-i-map-pin"/>
      </svg>
      <svg class="qf-icon" aria-hidden="true">
        <use href="#qf-i-eye"/>
      </svg>
    </span>
    <span class="qf-choice-card__body">
      <span class="qf-choice-card__title">Both</span>
      <span class="qf-choice-card__desc">Share yours and see theirs.</span>
    </span>
    <input class="qf-choice-card__input" type="radio" name="role" value="both">
  </label>
</div>

Examples예시

Chosen: "See my family" (checked → accent border and faint surface)
Choose your role to join.
Not chosen yet and the user pressed Next: aria-invalid on the group + error text
On the web: sharing is not available — disabled with the reason kept readable

Variants

qf-choice-cards qf-choice-card__icon qf-choice-card__body qf-choice-card__title qf-choice-card__desc qf-choice-card__input

Required tokens

--sz-choice-card --s-1 --s-3 --s-4 --s-6 --border --border-strong --r-lg --bg-elevated --accent --accent-bg-faint --accent-text --text-strong --text-secondary --text-muted --fs-13 --fs-15 --lh-snug --font-sans --ring-focus --dur-fast --ring-accent-inset --sz-choice-icon --text-danger

Accessibility

Use <div role="radiogroup" aria-labelledby="…" aria-required="true">. Each card is a label around a real radio, so click, Space and arrows work natively. The whole label becomes the name, so to avoid reading the description twice give the input aria-labelledby (title id) and aria-describedby (description id) if needed. Choices tied to consent start unchecked. If the user goes on without choosing, set aria-invalid="true" and aria-errormessage on the radiogroup (fieldset/group does not support aria-invalid). Selection shows as both the radio dot and the border, and as the radio without :has(). Choosing with arrows leaves the card checked and focused: the inset ring (--ring-accent-inset) and the focus ring show together. A disabled option dims only its icon, title and radio; the description with the reason stays readable.묶음은 <div role="radiogroup" aria-labelledby="…" aria-required="true">. 각 카드는 <label> 안에 진짜 <input type="radio"> 가 있어 클릭, Space, 화살표가 네이티브로 동작합니다. 이름은 label 전체(제목 + 설명)가 되므로 설명을 두 번 읽히지 않게, 필요하면 input 에 aria-labelledby(제목 id)와 aria-describedby(설명 id)를 따로 줍니다. 기본값을 두지 않는 선택(동의가 걸린 역할 등)은 checked 없이 시작합니다. 고르지 않고 넘어가면 radiogroup 에 aria-invalid="true" + aria-errormessage(오류 문구 id) — fieldset(group 역할)에는 aria-invalid 가 지원되지 않으니 radiogroup 을 씁니다. 선택은 radio 점과 테두리 둘 다로 보이고 :has() 미지원 브라우저에서도 radio 로 보입니다. 화살표로 고르면 고름 + 포커스가 겹치며 안쪽 링(--ring-accent-inset)과 포커스 링이 함께 보입니다. 그 환경에서 못 고르는 선택지는 disabled — 아이콘, 제목, radio 만 흐리고 이유를 담은 설명은 그대로 읽힙니다.

Forms & inputs

Calendar

A month grid for picking one date (041). The app (RN) and the web draw the same thing, because the platform calendar (iOS inline) cannot mark individual days and the web date dialog follows the browser language. Head __head: month title __title ("October 2026", fs-16 600), "Today" __today (only when the chosen day is not today or another month is shown; accent-text; it picks today, closes and goes to today), previous and next month __nav (44, chevron-left/right). Weekday row and day cells __grid (a 7-column table starting on Sunday, weekday text fs-12 text-muted). Day button __day (a 44 circle, fs-15 500; when a cell is narrower than 44, that is a grid under 308 wide, it shrinks to the cell, 41 on a 320 screen). Days of the neighbouring months stay empty (do not fill them in faintly). A month has 4 to 6 weeks, so the height varies (head 44 + gap 8 + weekday row 16 + 44 × weeks; 288 for five). Day states: --today (an inner 2px accent ring, 700), --selected (accent-solid fill, text-onAccent), --record a day with records (a 4px accent dot under the number, text-onAccent on the selected day), and days that cannot be chosen are aria-disabled on the web (both td and button; focus stays) and disabled in RN (text-disabled, no dot: before the first record, from tomorrow, beyond retention). A day without records that can be chosen stays plain (an empty day can still be viewed). Months: do not go before the first month with records or after this month (aria-disabled on that __nav). When the month changes, load its days with records and draw the dots (no dots while loading; numbers stay). Use: in the app, the sheet opened from the date in the date bar (qf-m-datenav), inside qf-m-sheet with gutters; on the web, a popover under the date button (at most 360 wide) or a sheet on narrow screens. Picking a day closes it and goes to that day. RN: cells one seventh wide and 44 tall, a 44 circle button, the dot 4 from the bottom, the ring borderWidth 2 in accent.한 달 격자에서 날짜 하나를 고르는 달력입니다(041). 앱(RN)과 웹이 같은 모양을 그립니다. 플랫폼 기본 달력(iOS inline)은 날마다 표시를 그릴 수 없고, 웹 기본 날짜 창은 브라우저 언어를 따라 한국어가 아닐 수 있어서입니다. 머리 __head: 달 제목 __title("2026년 10월", fs-16 600), "오늘로" __today(고른 날이 오늘이 아니거나 다른 달을 볼 때만, accent-text. 누르면 오늘을 고르고 닫아 오늘로 갑니다), 앞뒤 달 __nav(44, chevron-left/right). 요일 줄과 날짜 칸 __grid(7열 table, 일요일부터, 요일 글 fs-12 text-muted). 날짜 단추 __day(44 원, fs-15 500. 칸이 44 보다 좁으면, 곧 격자 폭이 308 미만이면 칸 폭까지 줄어듭니다. 320 화면에서 41). 앞뒤 달의 날은 빈 칸으로 둡니다(지난달 날을 흐리게 채우지 않음). 한 달은 4~6줄이라 높이가 달마다 다릅니다(머리 44 + 간격 8 + 요일 줄 16 + 44 × 줄 수, 다섯 줄이면 288). 날짜 상태: --today 오늘(안쪽 2px accent 링, 700), --selected 고른 날(accent-solid 채움, text-onAccent), --record 기록 있는 날(숫자 아래 4px accent 점, 고른 날이면 점이 text-onAccent), 고를 수 없는 날은 웹 aria-disabled(td 와 단추 둘 다, 포커스는 남음), RN disabled(text-disabled, 점 없음; 기록 첫날 전, 내일부터, 보관 기간 밖). 기록이 없지만 고를 수 있는 날은 보통 글자(빈 날도 볼 수 있음). 앞뒤 달: 기록 첫 달보다 앞, 이번 달보다 뒤로는 가지 않습니다(그쪽 __nav 를 aria-disabled). 달을 옮기면 그 달의 기록 있는 날을 불러와 점을 그립니다(불러오는 동안은 점 없이, 숫자는 그대로). 쓰임: 앱은 날짜 막대(qf-m-datenav)의 날짜를 누르면 뜨는 시트(qf-m-sheet 안, 좌우 gutter), 웹은 날짜 단추 아래 팝오버(폭 최대 360)나 좁은 화면의 시트. 고르면 바로 닫고 그 날로 갑니다. RN: 칸은 7등분 폭에 44 높이, 단추는 44 원, 점은 bottom 4, 링은 borderWidth 2 accent.

.qf-callayer: generic

Preview

2026년 10월

일월화수목금토
<div style="max-width:360px">
  <div class="qf-cal" role="group" aria-labelledby="cal0-t">
    <div class="qf-cal__head">
      <h2 class="qf-cal__title" id="cal0-t" aria-live="polite">2026년 10월</h2>
      <button class="qf-cal__today">오늘로</button>
      <button class="qf-cal__nav" aria-label="이전 달">
        <svg class="qf-icon" aria-hidden="true">
          <use href="#qf-i-chevron-left"/>
        </svg>
      </button>
      <button class="qf-cal__nav" aria-label="다음 달" aria-disabled="true">
        <svg class="qf-icon" aria-hidden="true">
          <use href="#qf-i-chevron-right"/>
        </svg>
      </button>
    </div>
    <table class="qf-cal__grid" role="grid" aria-labelledby="cal0-t">
      <thead>
        <tr>
          <th scope="col" abbr="일요일">일</th>
          <th scope="col" abbr="월요일">월</th>
          <th scope="col" abbr="화요일">화</th>
          <th scope="col" abbr="수요일">수</th>
          <th scope="col" abbr="목요일">목</th>
          <th scope="col" abbr="금요일">금</th>
          <th scope="col" abbr="토요일">토</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>
          </td>
          <td>
          </td>
          <td>
          </td>
          <td>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 1일 목요일, 고를 수 없음" aria-disabled="true">1</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 2일 금요일, 고를 수 없음" aria-disabled="true">2</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 3일 토요일, 고를 수 없음" aria-disabled="true">3</button>
          </td>
        </tr>
        <tr>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 4일 일요일, 고를 수 없음" aria-disabled="true">4</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--record" tabindex="-1" aria-label="10월 5일 월요일, 기록 있음">5</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--record" tabindex="-1" aria-label="10월 6일 화요일, 기록 있음">6</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--record" tabindex="-1" aria-label="10월 7일 수요일, 기록 있음">7</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--record" tabindex="-1" aria-label="10월 8일 목요일, 기록 있음">8</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--record" tabindex="-1" aria-label="10월 9일 금요일, 기록 있음">9</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 10일 토요일">10</button>
          </td>
        </tr>
        <tr>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 11일 일요일">11</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--record" tabindex="-1" aria-label="10월 12일 월요일, 기록 있음">12</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--record" tabindex="-1" aria-label="10월 13일 화요일, 기록 있음">13</button>
          </td>
          <td role="gridcell" aria-selected="true">
            <button class="qf-cal__day qf-cal__day--selected qf-cal__day--record" tabindex="0" aria-label="10월 14일 수요일, 선택됨, 기록 있음">14</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--record" tabindex="-1" aria-label="10월 15일 목요일, 기록 있음">15</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--record" tabindex="-1" aria-label="10월 16일 금요일, 기록 있음">16</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 17일 토요일">17</button>
          </td>
        </tr>
        <tr>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 18일 일요일">18</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--record" tabindex="-1" aria-label="10월 19일 월요일, 기록 있음">19</button>
          </td>
          <td role="gridcell" aria-selected="false">
            <button class="qf-cal__day qf-cal__day--today qf-cal__day--record" tabindex="-1" aria-label="10월 20일 화요일, 오늘, 기록 있음" aria-current="date">20</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 21일 수요일, 고를 수 없음" aria-disabled="true">21</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 22일 목요일, 고를 수 없음" aria-disabled="true">22</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 23일 금요일, 고를 수 없음" aria-disabled="true">23</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 24일 토요일, 고를 수 없음" aria-disabled="true">24</button>
          </td>
        </tr>
        <tr>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 25일 일요일, 고를 수 없음" aria-disabled="true">25</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 26일 월요일, 고를 수 없음" aria-disabled="true">26</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 27일 화요일, 고를 수 없음" aria-disabled="true">27</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 28일 수요일, 고를 수 없음" aria-disabled="true">28</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 29일 목요일, 고를 수 없음" aria-disabled="true">29</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 30일 금요일, 고를 수 없음" aria-disabled="true">30</button>
          </td>
          <td role="gridcell" aria-selected="false" aria-disabled="true">
            <button class="qf-cal__day" tabindex="-1" aria-label="10월 31일 토요일, 고를 수 없음" aria-disabled="true">31</button>
          </td>
        </tr>
      </tbody>
    </table>
  </div>
</div>

Examples예시

2026년 10월

일월화수목금토
10월: 오늘(20일), 고른 날(14일), 기록 있는 날 점, 기록 첫날(5일) 전과 내일부터는 고를 수 없음

2026년 10월

일월화수목금토
오늘을 고른 경우("오늘로" 없음)

Variants

qf-cal__head qf-cal__title qf-cal__today qf-cal__nav qf-cal__grid qf-cal__day qf-cal__day--today qf-cal__day--selected qf-cal__day--record

Required tokens

--accent --accent-solid --accent-text --text-onAccent --text --text-strong --text-secondary --text-muted --text-disabled --bg-hover --ring-accent --ring-focus --m-touch --r-md --r-pill --s-1 --s-2 --s-3 --s-6 --fs-12 --fs-14 --fs-15 --fs-16 --lh-snug --font-sans

Accessibility

Follows the APG date picker grid. The whole is role="group" with aria-labelledby (the month title); the cells are a <table role="grid">, each day td is role="gridcell" with aria-selected (and aria-disabled when it cannot be chosen), and its button is named with the date, weekday, today, selected, records and unavailable, like "Wednesday 14 October, selected, has records", "Tuesday 20 October, today, has records", "Wednesday 21 October, unavailable" (focus is on the button, not the td, so the cell's aria-selected is often not announced; hence the name; the dot is visual). Today has aria-current="date". Weekday headers are th scope="col" with abbr="Sunday". Keyboard: one focus stop in the grid (the chosen day, else today if in that month, else the month's first available day has tabindex 0; the rest -1). Left and right move a day, up and down a week (crossing into the next month), Home and End go to the start and end of the week, PageUp and PageDown go to the same day of the previous or next month (the last day if it has none, 31 to 30), and do nothing at the end of the range. Enter and Space pick. No Shift+PageUp/PageDown (years): retention keeps months enough. Unavailable days still take focus but cannot be picked (aria-disabled on the web; disabled would drop focus). Escape closes the popover and returns focus to the date button that opened it; "Today" picks today and closes, so focus returns there too. The title (aria-live="polite") is announced when the month changes. Redrawing the grid after the month's record days load replaces the focused button, so put focus back on the same day's button (measured on the Den web). Name the month buttons "Previous month" and "Next month". RN: day buttons accessibilityRole="button" with accessibilityState {selected, disabled} (selected is announced, so "selected" may be left out of the name) and the same names; VoiceOver has no grid keys, so it swipes through the month buttons and day buttons in order. Buttons are 44 (41 on a 320 screen).APG 날짜 고르기 격자를 따릅니다. 전체는 role="group" + aria-labelledby(달 제목), 칸은 <table role="grid">, 날짜 칸 td 는 role="gridcell" aria-selected(고를 수 없으면 aria-disabled), 안의 단추 이름은 "10월 14일 수요일, 선택됨, 기록 있음", "10월 20일 화요일, 오늘, 기록 있음", "10월 21일 수요일, 고를 수 없음" 처럼 날짜, 요일, 오늘, 선택됨, 기록, 고를 수 없음을 담습니다(포커스가 td 가 아닌 단추에 있어 셀의 aria-selected 는 잘 읽히지 않으므로 이름에 넣음, 점은 눈용). 오늘은 aria-current="date". 요일 머리는 th scope="col" abbr="일요일". 키보드: 격자 안 포커스는 하나(고른 날, 그 달에 없으면 오늘, 그것도 없으면 그 달의 첫 고를 수 있는 날이 tabindex 0, 나머지 -1). 화살표 좌우는 하루, 위아래는 한 주(달을 넘으면 그 달로 넘어감), Home/End 는 주의 처음과 끝, PageUp/PageDown 은 앞뒤 달의 같은 날(그 달에 없으면 마지막 날, 31일 → 30일), 범위 끝 달에서는 움직이지 않음. Enter 와 Space 는 고르기. Shift+PageUp/PageDown(해 단위)은 두지 않습니다(보관 기간 안이라 달 단위로 충분). 고를 수 없는 날에도 포커스는 가지만 고르기는 막습니다(웹은 aria-disabled, disabled 는 포커스를 잃음). 팝오버는 Escape 로 닫고 포커스를 연 날짜 단추로 돌립니다. "오늘로"는 오늘을 고르고 닫으므로 포커스도 연 단추로 돌아갑니다. 달이 바뀌면 제목(aria-live="polite")이 읽힙니다. 그 달의 기록 있는 날을 불러와 격자를 다시 그리면 포커스를 가진 단추가 새로 그려져 사라지므로, 같은 날의 단추로 포커스를 돌려놓습니다(Den 웹 실측). 앞뒤 달 단추에 "이전 달", "다음 달". RN: 날짜 단추 accessibilityRole="button", accessibilityState {selected, disabled}(selected 가 읽히므로 이름의 "선택됨"은 빼도 됨), 이름은 같은 글. VoiceOver 는 격자 키가 없으므로 앞뒤 달 단추와 날짜 단추를 차례로 훑습니다. 단추는 44(320 화면에서 41).

Display & data

Avatar

A circular avatar that represents a user (with an optional status dot). --ring adds a 3px member-color ring (--qf-member-color = viz-*, same as the map marker); --stale marks a person with an old fix (dashed, dimmed ring; text unchanged). --paused is someone who paused sharing (solid faded ring, unlike the dashed --stale). Photo (043): an img inside fills the disc. With --ring the photo sits inside the ring (34 in a 40 md) and the ring is its edge. Without a ring a 1px translucent inner line (--avatar-photo-edge) is drawn over the photo so a photo on white still shows its circle. Under --stale and --paused the photo is dimmed as much as the ring (opacity --map-stale-opacity, no grayscale). Never stack the photo over the initial (the initial shows through a dimmed photo). With no photo, or when it fails to load, switch to the initial avatar. Under --stale and --paused the photo is dimmed even without a ring. While loading only the base disc shows. RN: put the base disc (bg-panel) in the bottom View and never dim it; above it the photo (Image), and on top a ring View that is only a border. With a ring, inset the photo by the ring width (34 in a md with the DS 3px ring); without one, inset 0 so it fills the disc, with an inner-line View over it (position absolute, inset 0, borderRadius, borderWidth 1, avatar-photo-edge). Express no ring by not drawing the ring View, not by a transparent ring colour (a transparent ring shrinks the photo by 3px). Dim by setting opacity on the ring View and on the photo separately. The photo is accessible={false}. Initials (044, the same rule in app and web): with s the name without spaces and all Hangul, check in order. (1) If s starts with a two-syllable family name (남궁 황보 제갈 선우 독고 사공 서문), drop those two only when s has four syllables; with three, do not shorten (남궁민, 황보람: no way to tell where the family name ends). (2) Otherwise, if s has three syllables and the first is a common family name (김 이 박 최 정 강 조 윤 장 임 한 오 서 신 권 황 안 송 전 홍 유 류 고 문 양 손 배 백 허 남 심 노 하 곽 성 차 주 우 구 민 나 진 지 엄 채 원 천 방 공 현, the top 50, a little over nine in ten people), drop the first. Show the shortened name as two syllables "지훈" at md and up (avatars 40, 56, 80 and map pins; --duo, or qf-map-pin--duo) and one syllable "지" at sm and xs. Two because siblings often share a generation syllable (지훈, 지민). Not shortened: two-syllable names (김준, 이모: no way to tell a family name), names ending in 님, 이 or 야 (선생님, 지훈이, 민지야), names whose remainder or first two syllables are a family word (엄마 아빠 아들 동생 사람 남편 아내 언니 오빠 누나 형님 이모 고모 삼촌: 양엄마, 남동생, 안사람, 엄마폰, 이모네), and family words as a whole (이모부 고모부 조카딸 손녀딸 손주딸 배우자 오라비). Everything else keeps one first character. Normalise the name to NFC first. A character is the first code point plus the joiners that follow it (U+200D and the next code point, U+FE0F, skin tones U+1F3FB to 1F3FF), and a flag (two regional indicators U+1F1E6 to 1F1FF) counts as one, the same formula in app and web because Hermes lacks Intl.Segmenter. Test values: 김지훈→지훈, 이민지→민지, 노민준→민준, 남궁민수→민수, 남궁민→남, 황보람→황, "김 지훈"→지훈, 김준→김, 엄마→엄, 할머니→할, 이모부→이, 양엄마→양, 엄마폰→엄, 이모네→이, 지훈이→지, 선생님→선, 지훈→지, Jihun→J, 🐶바둑이→🐶, 👨‍👩‍👧바다→👨‍👩‍👧, 🇰🇷우리→🇰🇷, 김지훈 at sm→지. RN font sizes: md 13, lg 17, xl 24, pin 11 (for two syllables). A photo, when there is one, wins (043).사용자를 나타내는 원형 아바타입니다(상태 점은 옵션). --ring 은 구성원 색 3px 링(--qf-member-color = viz-*, 지도 표시와 같은 색), --stale 은 오래된 위치의 사람(파선, 흐린 링, 글자는 그대로). --paused 는 스스로 잠시 멈춘 사람(실선, 흐린 링 — 파선 --stale 과 구별). 사진(043): 안에 img 를 두면 원을 채웁니다. --ring 이 있으면 사진은 링 안쪽에 들고(md 40 이면 34) 링이 가장자리가 됩니다. 링이 없으면 1px 반투명 안쪽 선(--avatar-photo-edge)이 사진 위에 그려져 흰 바탕 사진도 원이 보입니다. --stale, --paused 의 사진은 링과 같은 만큼 흐리게(opacity --map-stale-opacity, grayscale 없음) 합니다. 사진과 글자를 겹쳐 두지 않습니다(흐린 사진 밑으로 글자가 비침). 사진이 없거나 불러오지 못하면 글자 아바타로 바꿉니다. --stale, --paused 의 사진은 링이 없어도 흐립니다. 불러오는 동안은 바탕 원만 보입니다. RN: 바탕 원(bg-panel)은 맨 아래 View 에 두고 흐리지 않습니다. 그 위에 사진(Image), 맨 위에 테두리만 있는 링 View 를 둡니다. 링이 있으면 사진은 링 굵기만큼 안쪽(DS 3px 기준 md 34), 없으면 inset 0 으로 원 전체를 채우고 사진 위에 안쪽 선 View(position absolute, inset 0, borderRadius, borderWidth 1, avatar-photo-edge)를 둡니다. 링이 없다는 것은 투명한 링 색이 아니라 링 View 를 그리지 않는 것으로 나타냅니다(투명 링이면 사진이 3px 작아짐). 흐림은 링 View 와 사진에 각각 opacity 를 겁니다. 사진은 accessible={false}. 글자(044, 앱과 웹이 같은 규칙): 이름의 공백을 뺀 s 가 모두 한글일 때 차례로 봅니다. (1) s 가 두 글자 성(남궁 황보 제갈 선우 독고 사공 서문)으로 시작하면 네 글자일 때만 앞 두 글자를 빼고, 세 글자면 줄이지 않습니다(남궁민, 황보람은 성이 어디까지인지 알 수 없음). (2) 그 밖에 세 글자이고 첫 글자가 흔한 성(김 이 박 최 정 강 조 윤 장 임 한 오 서 신 권 황 안 송 전 홍 유 류 고 문 양 손 배 백 허 남 심 노 하 곽 성 차 주 우 구 민 나 진 지 엄 채 원 천 방 공 현, 상위 50, 인구의 9할 남짓)이면 첫 글자를 뺍니다. 줄인 이름은 md 이상(아바타 40, 56, 80과 지도 핀)에서 두 글자 "지훈"(--duo, 핀은 qf-map-pin--duo), sm, xs 에서 한 글자 "지". 두 글자인 까닭: 형제가 돌림자를 나누면(지훈, 지민) 한 글자로는 또 같아진다. 줄이지 않는 것: 두 글자 이름(김준, 이모는 성인지 알 수 없음), 끝이 님, 이, 야(선생님, 지훈이, 민지야), 뺀 나머지나 앞 두 글자가 가족 말(엄마 아빠 아들 동생 사람 남편 아내 언니 오빠 누나 형님 이모 고모 삼촌: 양엄마, 남동생, 안사람, 엄마폰, 이모네), 그대로 가족 말인 것(이모부 고모부 조카딸 손녀딸 손주딸 배우자 오라비). 그 밖은 지금처럼 첫 글자 하나. 이름은 먼저 NFC 로 정규화합니다. 글자 하나는 첫 코드 포인트에 뒤따르는 결합 문자(U+200D 와 그다음 코드 포인트, U+FE0F, 피부색 U+1F3FB~1F3FF)까지이고, 국기(지역 표시 문자 U+1F1E6~1F1FF)는 둘을 한 글자로 봅니다(Hermes 에 Intl.Segmenter 가 없어 앱과 웹이 같은 식을 씀). 시험 값: 김지훈→지훈, 이민지→민지, 노민준→민준, 남궁민수→민수, 남궁민→남, 황보람→황, "김 지훈"→지훈, 김준→김, 엄마→엄, 할머니→할, 이모부→이, 양엄마→양, 엄마폰→엄, 이모네→이, 지훈이→지, 선생님→선, 지훈→지, Jihun→J, 🐶바둑이→🐶, 👨‍👩‍👧바다→👨‍👩‍👧, 🇰🇷우리→🇰🇷, sm 의 김지훈→지. RN 글자 크기: md 13, lg 17, xl 24, 핀 11(두 글자일 때). 사진이 있으면 사진(043).

.qf-avatarlayer: generic

Preview

M
<span class="qf-avatar qf-avatar--md">
  M
  <span class="qf-avatar__status qf-avatar__status--online">
  </span>
</span>

Examples예시

M
Online
H
Idle
J
Do not disturb
S
Offline
J M S
Member ring: current, stale (dashed), paused (solid, faded)
M
043 Photo: ring, stale, paused, no ring (inner edge), initial fallback
지훈 지민 엄 민수 지훈 지
044 Korean given-name initials: md, lg, xl two syllables (--duo), sm one

Variants

M
qf-avatar--xs
M
qf-avatar--sm
M
qf-avatar--md
M
qf-avatar--lg
M
qf-avatar--xl
M
qf-avatar--ring
M
qf-avatar--stale
M
qf-avatar--paused
M
qf-avatar--duo

Parts & more: 구성 요소, 기타: qf-avatar__status qf-avatar__status--online qf-avatar__status--idle qf-avatar__status--dnd qf-avatar__status--offline

Required tokens

--bg-elevated --r-pill --sz-status-dot --sz-status-dot-ring --status-online --status-offline --avatar-ring --map-stale-opacity --bg-app --accent --avatar-photo-edge --tracking-tight --fs-13 --fs-17 --fs-24

Accessibility

When a name sits next to the photo (list rows, notifications, the account header) the photo is decorative: alt="". When the avatar alone stands for the person (an account button in a top bar) name the button or the img. Do not convey the status dot by color alone, supplementing it with text or aria-label such as online or away. --stale and --paused only change the ring and dim the photo, so state the condition in the adjacent text ("position from 1 h ago", "paused until 15:00").사진 옆에 이름이 있으면(목록 줄, 알림, 계정 머리) 사진은 꾸밈이라 alt="" 로 둡니다. 아바타 혼자 사람을 나타내면(상단바의 계정 버튼 등) 버튼이나 img 에 이름을 붙입니다. 상태 점은 색만으로 전하지 않도록 온라인, 자리 비움 등 텍스트나 aria-label 로 보충합니다. --stale, --paused 는 링 모양과 사진의 흐림만 바꾸므로 상태는 옆의 글("1시간 전 위치", "잠시 멈춤, 15:00까지")로 전합니다.

Display & data

Badge

A small badge for a label, a status, or a notification count. Status tones: --success (healthy), --warn (resting, delayed), --danger (stopped, failed), --muted (paused, inactive). Marking AI-written text: put a default qf-badge with qf-i-sparkle reading "AI summary" in the kicker line above the title (neutral tone, 11px), and shorten the closing qf-notice--info to one line ("Tell us if something is wrong"). An svg inside a badge scales with the text (an explicit size modifier such as qf-icon--sm keeps its size).라벨, 상태, 알림 개수를 나타내는 작은 배지입니다. 상태는 --success(정상) --warn(쉬는 중, 지연) --danger(중단, 실패) --muted(멈춤, 비활성)로 구분합니다. AI 가 쓴 글의 표시: 제목 위 kicker 줄에 기본 qf-badge + qf-i-sparkle 로 "AI 요약" 을 두고(중립 톤, 11px), 글 끝의 qf-notice--info 는 "틀린 곳이 있으면 알려 주세요" 한 줄로 줄입니다. 배지 안 svg 는 글자 크기에 맞춰집니다(qf-icon--sm 같은 크기 변형을 명시하면 그 크기 유지).

.qf-badgelayer: generic

Preview

3
<span class="qf-badge qf-badge--count" aria-label="3 new notifications">3</span>

Examples예시

Healthy Resting Stopped Paused Neutral
Status set
3
Notification count (only)
Clien 2 2 posts
Neutral count (not red)
Politics4 communities · 9 posts · 9 min agoAI summary
AI-written marker (in a kicker line)

Variants

3
qf-badge--accent
3
qf-badge--success
3
qf-badge--warn
3
qf-badge--danger
3
qf-badge--muted
3
qf-badge--dot
3
qf-badge--count

Required tokens

--bg-hover --text-secondary --accent-subtle --ok-bg --text-ok --warn-bg --text-warn --danger-bg --text-danger --border --text-muted --danger-600 --r-xs --r-pill --s-2 --fs-11

Accessibility

Include text so meaning is not conveyed by color alone. qf-badge--count (red) is for notification counts only. Do not use it for neutral counts such as post or community totals; use the default qf-badge or qf-source__count (gray number) instead. Supplement count badges with an aria-label such as N unread.색만으로 의미를 전하지 않도록 텍스트를 함께 둡니다. qf-badge--count(빨강)는 알림 개수 전용입니다. 글 수, 커뮤니티 수 같은 중립 개수에는 쓰지 말고 기본 qf-badge 나 qf-source__count(회색 숫자)를 쓰세요. 개수 배지는 읽지 않음 N건 처럼 aria-label 로 보충합니다.

Display & data

CodeBlock

A code block that displays code in a monospace font.코드를 모노스페이스로 표시하는 코드 블록입니다.

.qf-codeblocklayer: generic

Preview

tsconst a = 1;
<pre class="qf-codeblock">
  <span class="qf-codeblock__lang">ts</span>
  <code>const a = 1;</code>
</pre>

Variants

tsconst a = 1;
qf-codeblock--with-header

Parts & more: 구성 요소, 기타: qf-codeblock__lang qf-codeblock__header qf-codeblock__header-lang qf-codeblock__copy qf-code-inline

Required tokens

--bg-code --text-code --divider --r-md --s-4 --fs-13 --font-mono --ok-400

Accessibility

Use a button element for the copy button and signal copy completion with 'Copied' text, not color alone. Wrap code in pre and code markup to convey its meaning.복사 버튼은 button 요소로 두고 복사 완료는 색만이 아니라 'Copied' 텍스트로 함께 알립니다. 코드는 pre, code 마크업으로 감싸 의미를 전달합니다.

Display & data

Prose

A body (prose) style that renders long-form documents such as Markdown in the design system's tone. The body measure defaults to a readable ~640px and is overridable via --qf-prose-max (e.g., none or var(--container-w-wide)). --article is for article bodies of several 3–6 sentence paragraphs (news write-ups): 16px body, one-line paragraph spacing (--s-6), and keep-all word breaking for Korean. Inside --article, h2/h3 are article subheadings (17px, 600, no underline, --s-6 above and --s-2 below) — when the body runs four paragraphs or more, put a short h2 (about 12 characters) where the thread changes.마크다운 등 장문 문서를 디자인 시스템 톤으로 렌더하는 본문(prose) 스타일입니다. 본문 폭은 기본 가독성 measure(약 640px)이며, --qf-prose-max 로 오버라이드합니다(예: none, var(--container-w-wide)). --article 은 뉴스 전말처럼 3~6문장 문단이 이어지는 기사 본문용으로 본문 16px, 문단 간격 한 줄(--s-6), 한국어 어절 유지(keep-all)를 적용합니다. --article 안의 h2/h3 는 기사 소제목(17px, 600, 밑선 없음, 위 --s-6 아래 --s-2)입니다 — 전말이 네 문단 이상이면 흐름이 바뀌는 곳에 12자 안의 h2 를 둡니다.

.qf-proselayer: generic

Preview

Document title

The body uses emphasis, a link, and inline code.

  • First item
  • Second item
Blockquotes are highlighted with the accent bar.
<article class="qf-prose">
  <h2>Document title</h2>
  <p>
    The body uses
    <strong>emphasis</strong>
    , a
    <a href="#prose">link</a>
    , and
    <code>inline</code>
    code.
  </p>
  <ul>
    <li>First item</li>
    <li>Second item</li>
  </ul>
  <blockquote>Blockquotes are highlighted with the accent bar.</blockquote>
</article>

Examples예시

The Supreme Court acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate, and issued a formal apology. The admission followed a week of reporting that traced dozens of receipts to restaurants closed on the dates listed.

Community reaction spread quickly across several Korean forums. Threads on Clien and Bobaedream questioned why the internal audit had taken years, while posters on 82cook focused on the apology itself.

The court said it would publish a corrected ledger and refer the matter to an outside review. No timeline was given.

--article (news write-up)

Variants

Document title

The body uses emphasis, a link, and inline code.

  • First item
  • Second item
Blockquotes are highlighted with the accent bar.
qf-prose--article

Required tokens

--text --text-strong --link --accent --divider --bg-panel --font-mono --container-w-narrow --fs-16 --s-6 --fs-17 --lh-snug

Accessibility

Maintain the semantic HTML hierarchy (h1→h6 order, ul/ol/blockquote/table structure), and underline links to provide a cue beyond color. Keep body contrast at AA, and use token colors for code and tables.시맨틱 HTML 계층(h1→h6 순서, ul/ol/blockquote/table 구조)을 유지하고, 링크는 밑줄로 색 외 단서를 함께 줍니다. 본문 대비 AA, 코드/표는 토큰 색을 사용합니다.

Display & data

Lede

A lede (standfirst) paragraph under the title. A two-to-three-sentence summary set one step larger than body text (18px, so the line pitch widens too) in a secondary tone (--text-secondary), apart from the article body (qf-prose--article, 16px). --rule draws a short accent line underneath to mark where the body begins. Use --rule when nothing sits between lede and body; use the plain form when a picture separates them. Margins: --s-2 above, --s-6 below (inside a qf-stack the stack gap is added on both sides). Same measure as qf-prose; when overriding --qf-prose-max, set it on a common ancestor of lede and body.제목 아래 리드(standfirst) 문단입니다. 2~3문장 요약을 본문보다 한 단계 큰 글자(18px, 줄 간격도 따라 넓어짐)와 보조 톤(--text-secondary)으로 두어 본문(qf-prose--article, 16px)과 구분합니다. --rule 은 아래에 짧은 액센트 선을 그려 본문의 시작을 알립니다. 리드와 본문 사이에 그림이 없으면 --rule 을 쓰고, 그림이 사이를 가르면 기본형을 씁니다. 위 여백 --s-2, 아래 여백 --s-6(qf-stack 안에서는 stack 의 gap 이 양쪽에 더해집니다). 폭은 qf-prose 와 같은 measure 이며, --qf-prose-max 를 바꿀 때는 리드와 본문의 공통 조상에 둡니다.

.qf-ledelayer: generic

Preview

Supreme Court admits chief justice filed false expense reports

The court acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate and issued a formal apology, after a week of reporting traced dozens of receipts to restaurants closed on the dates listed.

The admission followed an investigation by a nonprofit newsroom. Community reaction spread quickly across several Korean forums, with threads questioning why the internal audit had taken years.

The court said it would publish a corrected ledger and refer the matter to an outside review. No timeline was given.

<article>
  <h1 class="qf-page-header__title">Supreme Court admits chief justice filed false expense reports</h1>
  <p class="qf-lede qf-lede--rule">The court acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate and issued a formal apology, after a week of reporting traced dozens of receipts to restaurants closed on the dates listed.</p>
  <section class="qf-prose qf-prose--article">
    <p>The admission followed an investigation by a nonprofit newsroom. Community reaction spread quickly across several Korean forums, with threads questioning why the internal audit had taken years.</p>
    <p>The court said it would publish a corrected ledger and refer the matter to an outside review. No timeline was given.</p>
  </section>
</article>

Examples예시

Supreme Court admits chief justice filed false expense reports

The court acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate and issued a formal apology.

The admission followed an investigation by a nonprofit newsroom. Community reaction spread quickly across several Korean forums.

--rule (no picture between lede and body)

Supreme Court admits chief justice filed false expense reports

The court acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate and issued a formal apology.

The admission followed an investigation by a nonprofit newsroom. Community reaction spread quickly across several Korean forums.

Plain (a figure separates lede and body)

Variants

Supreme Court admits chief justice filed false expense reports

The court acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate and issued a formal apology, after a week of reporting traced dozens of receipts to restaurants closed on the dates listed.

The admission followed an investigation by a nonprofit newsroom. Community reaction spread quickly across several Korean forums, with threads questioning why the internal audit had taken years.

The court said it would publish a corrected ledger and refer the matter to an outside review. No timeline was given.

qf-lede--rule

Required tokens

--fs-18 --lh-loose --text-secondary --font-sans --s-2 --s-5 --s-6 --s-9 --accent --container-w-narrow

Accessibility

Use a p so it is read as the paragraph right after the heading (h1). Two cues separate it from the body independently of color: size (18 vs 16px) and the --rule line; the secondary tone is an extra cue (its contrast against body text is only 1.3–1.5:1). So when no picture sits between lede and body, always use --rule. The line is ::after decoration (drawn as a border so it survives forced-colors mode) and is not exposed to assistive technology. Weight is fixed at 400 (in Korean fallback fonts 500 may render like 400, so weight is not a reliable cue). Contrast: --text-secondary on --bg-app 10.7:1 (dark) / 10.2:1 (light); the --accent line 4.49 / 4.07.p 로 두어 제목(h1) 바로 다음 문단으로 낭독되게 합니다. 본문과의 구분은 크기(18 vs 16px)와 --rule 의 선, 두 가지가 색과 무관한 단서이고 보조 톤은 덧붙는 단서입니다(본문색과의 대비는 1.3~1.5:1 로 약함). 그래서 리드와 본문 사이에 그림이 없으면 반드시 --rule 을 씁니다. 선은 ::after 장식(border 로 그려 강제 색상 모드에서도 남음)이라 보조기기에 노출되지 않습니다. 굵기는 400 으로 고정합니다(한국어 폴백 글꼴에서 500 은 400 과 같게 렌더될 수 있어 단서가 되지 못함). 대비: --text-secondary on --bg-app 10.7:1(다크) / 10.2:1(라이트), 선 --accent 4.49 / 4.07.

Display & data

KeyPoints

An article's key points. A box placed between the lede and the body (after the picture if there is one), holding a label ("Key points", 12px caps tone) and two to four one-sentence items (under about 40 characters). Bullets are short accent bars, not dots (order carries no meaning, so no numbers). It has a --bg-panel background and a border but no left rule, so it does not read as a qf-notice. When it is the lede's immediate next sibling under the same parent, the qf-lede--rule line hides automatically (:has adjacent sibling); if the lede is wrapped in another element this does not fire, so leave --rule off then. Place the box outside qf-prose (inside, qf-prose's h2 style would override the label). Same measure as qf-prose.기사의 핵심 묶음입니다. 리드와 전말 사이(그림이 있으면 그림 다음)에 두는 상자로, 라벨("핵심", 12px 대문자 톤)과 한 문장짜리 항목 2~4개(40자 안)를 담습니다. 글머리는 점이 아니라 액센트의 짧은 막대(순서가 의미가 아니라 번호를 쓰지 않습니다). 바탕 --bg-panel 과 테두리만 있고 왼쪽 선이 없어 qf-notice 와 같은 종류로 보이지 않습니다. 리드와 같은 부모의 바로 다음 형제로 오면 qf-lede--rule 의 선이 자동으로 숨습니다(:has 인접 형제). 리드가 다른 요소에 감싸여 있으면 발동하지 않으니 그때는 --rule 을 붙이지 마세요. 상자는 qf-prose 밖에 둡니다(안에 두면 qf-prose 의 h2 스타일이 라벨을 덮습니다). 폭은 qf-prose 와 같은 measure 입니다.

.qf-keypointslayer: generic

Preview

Key points

  • The court admitted its expense reports were inaccurate and apologized.
  • Dozens of receipts named restaurants closed on the dates listed.
  • A corrected ledger and an outside review were promised, with no timeline.
<section class="qf-keypoints" aria-labelledby="kp-title">
  <h2 class="qf-keypoints__title" id="kp-title">Key points</h2>
  <ul class="qf-keypoints__list">
    <li class="qf-keypoints__item">The court admitted its expense reports were inaccurate and apologized.</li>
    <li class="qf-keypoints__item">Dozens of receipts named restaurants closed on the dates listed.</li>
    <li class="qf-keypoints__item">A corrected ledger and an outside review were promised, with no timeline.</li>
  </ul>
</section>

Examples예시

The court acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate and issued a formal apology.

Key points

  • The court admitted its expense reports were inaccurate and apologized.
  • A corrected ledger and an outside review were promised.

What the reporting found

The admission followed an investigation by a nonprofit newsroom that traced dozens of receipts to restaurants closed on the dates listed.

Community reaction

Threads on several Korean forums questioned why the internal audit had taken years.

After a lede (lede rule hides)

Variants

qf-keypoints__title qf-keypoints__list qf-keypoints__item

Required tokens

--s-5 --s-6 --s-4 --s-3 --s-2 --container-w-narrow --bg-panel --border --r-lg --r-pill --fs-12 --fs-15 --lh-tight --lh-normal --tracking-caps --text-muted --text --accent --font-sans

Accessibility

Use section[aria-labelledby] to name the region and make the label an h2 so "Key points" enters the document outline, and mark items up as ul/li (the bar is ::before decoration). Bar --accent on --bg-panel 3.97 dark / 3.79 light (graphics 3:1). Text --text on --bg-panel passes AA. More than four items makes the box heavier than the lede — keep it to four.section[aria-labelledby] 로 영역 이름을 주고 라벨을 h2 로 두어 "핵심" 이 문서 구조에 들어가게 하고, 항목은 ul/li 로 둡니다(막대는 ::before 장식). 막대 --accent on --bg-panel 다크 3.97 / 라이트 3.79(그래픽 3:1). 글자 --text on --bg-panel AA. 항목이 다섯 개를 넘으면 상자가 리드보다 무거워집니다 — 네 개까지.

Display & data

Mark

Search-term highlight. Use <mark class="qf-mark"> inside titles (qf-story__title) and summaries (qf-story__summary). Background is the subtle accent (--accent-subtle); the text color is inherited, so it stays calm in both 600-weight titles and 400-weight summaries. The 2px side padding is offset by a negative margin so text does not shift, and when it spans two lines each end is rounded (box-decoration-break: clone).검색어 강조입니다. <mark class="qf-mark"> 로 제목(qf-story__title)과 요약(qf-story__summary) 안에서 씁니다. 바탕은 액센트의 옅은 톤(--accent-subtle), 글자색은 상속이라 제목(600)과 요약(400) 어디서도 과하지 않습니다. 좌우 2px 패딩은 음수 margin 으로 상쇄되어 글자 흐름이 밀리지 않고, 두 줄에 걸치면 양 끝이 각각 둥급니다(box-decoration-break: clone).

.qf-marklayer: generic

Preview

Politics4 communities · 9 posts

Supreme Court admits chief justice filed false expense reports

The court acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate.

<article class="qf-story">
  <div class="qf-story__kicker">
    <span class="qf-eyebrow">Politics</span>
    <span>4 communities · 9 posts</span>
  </div>
  <h2 class="qf-story__title">
    Supreme
    <mark class="qf-mark">Court</mark>
    admits chief justice filed false expense reports
  </h2>
  <p class="qf-story__summary">
    The
    <mark class="qf-mark">court</mark>
    acknowledged on Tuesday that expense reports filed by its chief justice were inaccurate.
  </p>
</article>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--accent-subtle --r-xs --s-1

Accessibility

A mark element, which assistive technology may announce as highlighted (some do not). Inherited text color: --text-strong on --accent-subtle 13.1:1 dark / 14.6:1 light, --text-secondary 8.2 / 8.2 — AA. Use it only for matched search terms so the highlight does not change meaning. When a card hover turns the title accent-colored, text inside the mark stays --text-strong (accent text would be 4.25:1 in light). Because of the negative margin, a mark at the start of a line may lose its left 2px inside qf-clamp (overflow hidden) — only the decorative end flattens.mark 요소라 보조기기가 강조로 알립니다(일부는 낭독하지 않음). 글자색 상속: --text-strong on --accent-subtle 다크 13.1:1 / 라이트 14.6:1, --text-secondary 8.2 / 8.2 — AA. 강조가 의미를 바꾸지 않도록 검색어 외에는 쓰지 않습니다. 카드 hover 로 제목이 accent 색이 되어도 mark 안 글자는 --text-strong 을 유지합니다(라이트에서 accent 글자는 4.25:1). 음수 margin 때문에 줄 첫머리의 mark 는 왼쪽 2px 이 qf-clamp(overflow hidden) 안에서 잘릴 수 있습니다 — 장식 끝만 평평해집니다.

Display & data

Footnotes

A Markdown footnotes list — footnotes and back-reference links below a divider at the end of the body. In-body reference superscripts (sup>a) are accented via --accent-text within qf-prose.마크다운 각주 목록 — 본문 하단 구분선 아래 각주와 역참조 링크입니다. 본문 내 참조 위첨자(sup>a)는 qf-prose 스코프에서 --accent-text 로 강조됩니다.

.qf-footnoteslayer: generic

Preview

  1. 디자인 시스템은 사람과 AI가 함께 씁니다. ↩
<section class="qf-footnotes">
  <ol>
    <li id="fn1">
      디자인 시스템은 사람과 AI가 함께 씁니다.
      <a class="qf-footnotes__backref" href="#fnref1" aria-label="본문으로 돌아가기">↩</a>
    </li>
  </ol>
</section>

Variants

qf-footnotes__backref

Required tokens

--divider --fs-13 --text-secondary --text-muted --accent-text --accent-bg-faint --r-xs --s-5 --s-6 --s-8

Accessibility

Footnotes use an ol to convey order, and back-reference links carry an aria-label (e.g., back to content) so meaning is not carried by an icon or glyph alone. In-body references are real a[href] anchors enabling round-trip navigation.각주는 ol 로 순서를 전달하고, 역참조 링크에는 aria-label(예: 본문으로 돌아가기)을 두어 아이콘, 기호 단독 의존을 피합니다. 본문 참조는 실제 a[href] 앵커로 왕복 이동이 가능합니다.

Display & data

Transclude

A transclusion card that quotes another note inline within the body, with a left --border-strong accent, --bg-panel surface, and a __source link to the original at the top. Named qf-transclude to avoid colliding with the chat embed qf-embed.다른 노트를 본문에 인라인 인용하는 트랜스클루전 카드입니다. 좌측 --border-strong 액센트 + --bg-panel 배경, 상단 __source 원문 링크. 채팅 임베드 qf-embed 와 이름 충돌을 피해 qf-transclude 로 명명했습니다.

.qf-transcludelayer: generic

Preview

Embedded content from another note is quoted inline here.

<blockquote class="qf-transclude">
  <div class="qf-transclude__source">
    <svg class="qf-icon qf-icon--sm" aria-hidden="true">
      <use href="#qf-i-link"/>
    </svg>
    <a href="/notes/api">notes/api</a>
  </div>
  <p>Embedded content from another note is quoted inline here.</p>
</blockquote>

Variants

qf-transclude__source

Required tokens

--border --border-strong --bg-panel --divider --text-secondary --text-muted --link --r-md --s-4 --s-5 --fs-12

Accessibility

Convey the quotation with blockquote semantics, and provide a real a[href] source link for navigation to the origin. The left accent is decorative, with source text supplying context.인용 의미를 blockquote 시맨틱으로 전달하고, 원문 링크는 실제 a[href] 로 출처 이동을 보장합니다. 좌측 액센트는 장식이며 출처 텍스트로 맥락을 함께 제공합니다.

Display & data

EmptyState

An empty-state area that provides guidance when there is no content. Pages such as a 404 are built from the same parts: title, body, a search form (qf-search), and an action button as children (no variant needed).내용이 없을 때 안내하는 빈 상태 영역입니다. 404 같은 안내 화면도 제목, 본문, 찾기 입력(qf-search), 행동 버튼을 자식으로 두면 됩니다(변형 불필요).

.qf-emptylayer: generic

Preview

No items yet
Add your first item to get started.
<div class="qf-empty">
  <svg class="qf-icon qf-icon--xl" aria-hidden="true" style="color:var(--text-muted)">
    <use href="#qf-i-inbox"/>
  </svg>
  <div class="qf-empty__title">No items yet</div>
  <div class="qf-empty__body">Add your first item to get started.</div>
  <button class="qf-btn qf-btn--primary qf-btn--sm">New item</button>
</div>

Examples예시

Page not found
The address may be wrong, or the issue may have been removed.
Back to the front page
404 page (title + body + search + action)

Variants

qf-empty__title qf-empty__body

Required tokens

--s-12 --s-7 --s-4 --text-muted --text-strong --fs-18 --fs-14

Accessibility

Convey the guidance through title and body text rather than the icon. When it appears dynamically, placing it in an aria-live region is recommended.안내 의미를 아이콘이 아닌 제목, 본문 텍스트로 전달합니다. 동적으로 나타날 때는 aria-live 영역에 넣는 것을 권장합니다.

Display & data

Skeleton

A placeholder skeleton shown while content loads. Row skeletons (042, qufox Den): put --skel on the same classes as the real row and leave the text slots empty (:empty, not even whitespace or a line break); CSS draws the bars. Bone rows are divs (a div inside li for the timeline), not buttons. Member and settings rows use qf-m-row--skel (a qf-avatar without text, photo or status dot becomes a shimmering circle; the place icon tile __icon too), timeline rows qf-m-tl__row--skel (time, marker, name, second line). Bars are 0.75 of the font size (fs-15 → 11.25, fs-13 → 9.75) and slots keep the real line heights, so rows keep their height when content arrives (member row 64, timeline stay row 58). Widths vary on a 3-row cycle: member first line 40/56/32%, second 64/48/64%, timeline time 70%, name 48/56/32%, second line 28%. Corners r-xs, avatar a circle, place icon tile r-lg. The shimmer uses qf-skel's keyframes (1.8 s, bg-hover → bg-selected). Use: show only when loading takes over 300ms, and once shown keep it at least 500ms (vanishing at 320ms is itself a flash). As many rows as fit, at most 3 members, 4 timeline rows, 3 settings rows. Replace them wholesale when loaded, or with the error state on failure (never leave bones). If nothing arrives after 10 s, stop the shimmer (still bars) and add "Still loading" and Retry below. Do not use bones when content is already there (pull to refresh). Reduced motion: on the web, still bg-hover bars under prefers-reduced-motion (no animation). RN draws the bars in bg-selected and pulses the group's opacity 1 → 0.55 → 1 with Animated (1.8 s, useNativeDriver) instead of a gradient (bg-selected at 0.55 is close to bg-hover, the same range as the web shimmer), and draws still bg-hover bars when AccessibilityInfo.isReduceMotionEnabled. Inside a grouped card (054, MobileGroup) settings skeleton rows stay qf-m-row--skel within the card. Skeletons of one-line settings rows (44) leave out __secondary to keep the height.콘텐츠 로딩 중에 보여 주는 자리표시자 스켈레톤입니다. 줄 뼈대(042, qufox Den): 실제 줄과 같은 클래스에 --skel 을 걸고 글자 칸을 비우면(:empty, 공백이나 줄바꿈도 두지 않음) 막대가 그려집니다. 뼈대 줄은 button 이 아니라 div(타임라인은 li 안 div)로 둡니다. 구성원 줄과 설정 줄은 qf-m-row--skel(아바타 칸 qf-avatar 는 글자, 사진, 상태 점 없이 두면 원으로 반짝임, 장소 아이콘 칸 __icon 도), 타임라인 줄은 qf-m-tl__row--skel(시각, 마커, 이름, 둘째 줄). 막대 높이는 글자 크기의 0.75(fs-15 → 11.25, fs-13 → 9.75), 칸 높이는 실제 줄 높이라 불러온 뒤에도 줄 높이가 같습니다(구성원 줄 64, 타임라인 머묾 줄 58). 폭은 3줄 주기로 달리합니다: 구성원 첫 줄 40/56/32%, 둘째 줄 64/48/64%, 타임라인 시각 70%, 이름 48/56/32%, 둘째 줄 28%. 모서리 r-xs, 아바타 원, 장소 아이콘 칸 r-lg. 반짝임은 qf-skel 과 같은 keyframes(1.8초, bg-hover → bg-selected). 쓰는 법: 불러오기가 300ms 를 넘을 때만 띄우고, 띄웠으면 최소 500ms 는 둡니다(320ms 에 사라지면 오히려 번쩍임). 줄 수는 화면에 들어갈 만큼, 최대 구성원 3, 타임라인 4, 설정 3. 불러오면 통째로 바꾸고, 실패하면 오류 상태로 바꿉니다(뼈대를 남기지 않음). 10초가 지나도 오지 않으면 반짝임을 멈추고(정지 막대) 아래에 "아직 불러오는 중입니다"와 다시 시도를 둡니다. 당겨서 새로고침처럼 이미 내용이 있으면 뼈대를 쓰지 않습니다. 동작 줄이기: 웹은 prefers-reduced-motion 에서 정지한 bg-hover 막대(애니메이션 없음). RN 은 그라데이션 대신 막대 색을 bg-selected 로 두고 Animated 로 묶음의 opacity 를 1 → 0.55 → 1(1.8초, useNativeDriver) 깜빡이며(0.55 의 bg-selected 는 bg-hover 와 거의 같아 웹의 반짝임 폭과 같음), AccessibilityInfo.isReduceMotionEnabled 이면 움직이지 않는 bg-hover 막대. 묶음 카드(054, MobileGroup) 안에서도 설정 뼈대 줄은 qf-m-row--skel 그대로 카드 안에 둡니다. 한 줄짜리 설정 줄(44)의 뼈대는 __secondary 를 빼서 높이를 맞춥니다.

.qf-skellayer: generic

Preview

<div class="qf-skel" aria-hidden="true" style="width: 60%; height: var(--s-4)">
</div>

Examples예시

불러오는 중
042: 가족 목록 줄(qf-m-row--skel, 아바타 + 두 줄), 상태 알림은 busy 영역 밖 (status 의 글은 뼈대를 띄울 때 채움)
불러오는 중
042: 타임라인 줄(qf-m-tl__row--skel, li 안 div) (status 의 글은 뼈대를 띄울 때 채움)
불러오는 중
042: 설정 줄(qf-m-row--skel, 아바타 없이) (status 의 글은 뼈대를 띄울 때 채움)

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--bg-hover --bg-selected --fs-13 --fs-15 --lh-normal --lh-snug --r-lg --r-pill --r-sm --r-xs

Accessibility

The loading region is aria-busy="true" and the group of bones is inert with aria-hidden="true" (hiding and removing focus together; no buttons inside bone rows). The screen-reader message is an always-mounted empty role="status" (qf-sr-only) placed as a sibling outside the busy region: fill it with "Loading" when the bones appear, change it to "Still loading" after 10 s, and empty it when loaded (a live region inside the busy region, or one mounted already filled, may not be announced). Remove aria-busy when loaded. RN: accessibilityElementsHidden and importantForAccessibility="no-hide-descendants" on the bars, accessibilityState={{ busy: true }} on the region, and AccessibilityInfo.announceForAccessibility("Loading") once when the bones appear and once after 10 s. Bone rows cannot be tapped (pointer-events none; no Pressable in RN). The shimmer follows prefers-reduced-motion (web) and iOS Reduce Motion (RN), and stops after 10 s.로딩 영역은 aria-busy="true", 뼈대 묶음은 inert + aria-hidden="true"(숨김과 포커스 제거를 함께. 뼈대 줄 안에 단추를 두지 않음). 화면 낭독기용 상태 알림은 busy 영역 밖의 형제로 늘 마운트해 둔 빈 role="status"(qf-sr-only)입니다: 뼈대를 띄울 때 "불러오는 중"을 채우고, 10초 뒤에는 "아직 불러오는 중입니다"로 바꾸고, 불러오면 비웁니다(busy 영역 안이나 처음부터 글이 든 채 마운트된 라이브 영역은 읽히지 않을 수 있음). 불러오면 aria-busy 를 지웁니다. RN: 막대 묶음에 accessibilityElementsHidden 과 importantForAccessibility="no-hide-descendants", 영역에 accessibilityState={{ busy: true }}, 알림은 AccessibilityInfo.announceForAccessibility("불러오는 중")(뼈대를 띄울 때 한 번, 10초 뒤 한 번). 뼈대 줄은 누를 수 없습니다(pointer-events none, RN 은 Pressable 없이). 반짝임은 prefers-reduced-motion(웹)과 iOS 동작 줄이기(RN)를 따르고, 10초 뒤에는 멈춥니다.

Display & data

Eyebrow

A small uppercase label placed above a section.섹션 위에 올리는 작은 대문자 레이블입니다.

.qf-eyebrowlayer: generic

Preview

New feature
<span class="qf-eyebrow">New feature</span>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--fs-12 --font-sans --tracking-caps --accent-text

Accessibility

The uppercase transform is visual presentation only, so keep the actual text in normal casing so screen readers read it correctly. Do not carry meaning in the accent color alone.대문자 변환은 시각 표현이며 실제 텍스트는 정상 표기로 두어 화면 낭독기가 올바르게 읽도록 합니다. 강조 색에만 의미를 싣지 않습니다.

Display & data

KeyboardShortcutSheet

A sheet that presents a list of keyboard shortcuts grouped by category.단축키 목록을 그룹별로 보여 주는 시트입니다.

.qf-kbd-sheetlayer: generic

Preview

Navigation
Open searchCtrl+K
<div class="qf-kbd-sheet">
  <div class="qf-kbd-sheet__group">
    <div class="qf-kbd-sheet__group-title">Navigation</div>
    <div class="qf-kbd-sheet__row">
      <span>Open search</span>
      <span class="qf-kbd-sheet__keys">
        <kbd class="qf-kbd">Ctrl</kbd>
        <span class="qf-kbd-sheet__plus">+</span>
        <kbd class="qf-kbd">K</kbd>
      </span>
    </div>
  </div>
</div>

Variants

qf-kbd-sheet__group qf-kbd-sheet__group-title qf-kbd-sheet__row qf-kbd-sheet__keys qf-kbd-sheet__plus qf-kbd

Required tokens

--s-6 --s-8 --s-2 --fs-11 --fs-14 --text-muted --text-secondary --tracking-caps

Accessibility

Mark each keycap with a kbd element to convey its meaning, and manage focus within the dialog context when placed inside a modal.각 키캡은 kbd 요소로 표기해 의미를 전달하고 모달 안에 둘 때는 dialog 컨텍스트에서 포커스를 관리합니다.

Display & data

Card

A surface container that groups content (with header, body, and footer slots).콘텐츠를 묶는 표면 컨테이너입니다(헤더, 본문, 푸터 슬롯).

.qf-cardlayer: generic

Preview

Title

This is the content.
<section class="qf-card">
  <div class="qf-card__header">
    <h3 class="qf-card__title">Title</h3>
  </div>
  <div class="qf-card__body">This is the content.</div>
</section>

Variants

Title

This is the content.
qf-card--interactive

Parts & more: 구성 요소, 기타: qf-card__header qf-card__title qf-card__body qf-card__footer

Required tokens

--bg-panel --border --divider --r-xl --s-6 --text-strong --border-strong

Accessibility

An interactive card (--interactive) should be wrapped in a keyboard-accessible element (a/button) or given an appropriate role and tabindex, with visible focus.상호작용 카드(--interactive)는 키보드 접근 가능한 요소(a/button)로 감싸거나 적절한 role 과 tabindex 를 부여하고 포커스를 보이게 합니다.

Display & data

Tag

A chip that represents a label or category (a text label, distinct from Badge which is used for counts and status). As <a class="qf-tag"> it becomes a clickable tag (hover = selected surface; 40px tall with a 44px hit area on touch). Show counts such as post totals with qf-tag__count (a lighter-weight number) — qf-badge--count (red) is for notifications only. It stays clickable inside a qf-story--stretched card.라벨이나 카테고리를 나타내는 칩입니다(카운트, 상태용 Badge 와 구분되는 텍스트 라벨). <a class="qf-tag"> 로 두면 눌리는 태그가 됩니다(hover 는 selected 표면, 터치 환경 40px + 44px 히트). 글 수 같은 개수는 qf-tag__count(가는 숫자)로 — qf-badge--count(빨강)는 알림 전용입니다. qf-story--stretched 카드 안에서도 눌립니다.

.qf-taglayer: generic

Preview

Design
<span class="qf-tag qf-tag--accent">
  Design
  <button class="qf-tag__remove" aria-label="Remove Design tag">×</button>
</span>

Examples예시

Link tags with counts (tag index)

Variants

Design
qf-tag--accent
Design
qf-tag--outline

Parts & more: 구성 요소, 기타: qf-tag__remove qf-tag__count

Required tokens

--bg-hover --text-secondary --accent-subtle --accent-on-subtle --r-sm --s-3 --fs-12 --bg-selected --text --text-muted --ring-focus --s-9 --m-touch --dur-fast --ease-standard --s-2 --border-strong --r-xs

Accessibility

Give the remove button (qf-tag__remove) an aria-label (e.g., Remove design tag). Pair label text with color so meaning is never conveyed by color alone. A link tag is an a[href] with a visible focus ring; supplement a count with an aria-label such as "powershell, 24 posts". Do not put qf-tag__remove inside a link tag (a button inside an a). Inline tags inside qf-prose keep the line height and do not grow on touch. The count uses --text-secondary at weight 400 (tag text is 500): 9.5 / 9.5 on --bg-hover and still AA on the --bg-selected hover surface (--text-muted would be 4.48 in light, so it is not used).제거 버튼(qf-tag__remove)에는 aria-label(예: 디자인 태그 제거)을 둡니다. 색만으로 의미를 전하지 않고 라벨 텍스트를 함께 둡니다. 링크 태그는 a[href] 라 포커스 링이 보이고, 개수는 숫자 뒤에 단위를 aria-label 로 보충할 수 있습니다(예: "powershell, 글 24건"). 링크 태그에는 qf-tag__remove 를 넣지 않습니다(a 안의 button). 본문(qf-prose) 안 인라인 태그는 줄 높이를 지키며 터치 성장이 없습니다. 개수는 --text-secondary(굵기 400, 태그 글자는 500)라 바탕 --bg-hover 위 9.5 / 9.5, hover 표면 --bg-selected 위에서도 AA 입니다(--text-muted 는 라이트 4.48 로 미달이라 쓰지 않음).

Display & data

Stat

Displays a dashboard metric (KPI) with a large value, a label, and a trend delta. A hint line under the value (qf-stat__hint, e.g. "limit 300") is optional. --sm is for short figures in an aside or summary row (value 18px 600, label 12px).대시보드 지표(KPI)를 큰 값, 라벨, 추세 델타로 표시합니다. 값 아래 보조 텍스트(qf-stat__hint, 예: 상한 300장)를 둘 수 있습니다. --sm 은 사이드·요약 줄의 짧은 숫자(값 18px 600, 라벨 12px)입니다.

.qf-statlayer: generic

Preview

Monthly active users12,840▲ 8.2%
<div class="qf-stat">
  <span class="qf-stat__label">Monthly active users</span>
  <span class="qf-stat__value">12,840</span>
  <span class="qf-stat__delta qf-stat__delta--up">▲ 8.2%</span>
</div>

Examples예시

Monthly active users12,840▲ 8.2%
Increase
Churn rate3.1%▼ 1.4%
Decrease
Pending tasks27
No delta
Images kept212limit 300
With hint

Variants

Monthly active users12,840▲ 8.2%
qf-stat--sm

Parts & more: 구성 요소, 기타: qf-stat__label qf-stat__value qf-stat__delta qf-stat__delta--up qf-stat__delta--down qf-stat__hint

Required tokens

--text-strong --text-muted --fs-32 --fs-13 --tracking-tight --ok-600 --danger-400 --fs-12 --fs-18 --lh-snug --tracking-normal

Accessibility

Trend is conveyed not just by color but with an arrow/sign (▲▼ or +/-) and text, avoiding reliance on color alone. Pair the value with its unit and meaning.추세는 색뿐 아니라 화살표/부호(▲▼ 또는 +/-)와 텍스트로 전달해 색 단독 의존을 피합니다. 값에는 단위/의미를 함께 둡니다.

Display & data

Sparkline

A mini chart that shows a time-series trend within a small area. The consumer generates points/path from the data, and the DS provides token-based styling (line and area colors).시계열 추세를 작은 영역에 보여주는 미니 차트입니다. 데이터→points/path 는 소비처가 생성하고 DS 는 토큰 기반 스타일(선, 영역 색)을 제공합니다.

.qf-sparklinelayer: generic

Preview

<span class="qf-sparkline qf-sparkline--ok">
  <svg viewBox="0 0 100 32" preserveAspectRatio="none" role="img" aria-label="Recent throughput trend, rising">
    <polyline class="qf-sparkline__area" points="0,28 12,24 24,26 36,18 48,20 60,12 72,14 84,6 100,8 100,32 0,32">
  </polyline>
  <polyline class="qf-sparkline__line" points="0,28 12,24 24,26 36,18 48,20 60,12 72,14 84,6 100,8">
</polyline>
</svg>
</span>

Variants

qf-sparkline--ok
qf-sparkline--warn
qf-sparkline--danger

Parts & more: 구성 요소, 기타: qf-sparkline__line qf-sparkline__area

Required tokens

--accent --ok-400 --warn-400 --danger-400

Accessibility

Unless decorative, provide a trend summary via role=img + aria-label (e.g., "Throughput over the last 24 hours, rising"), and pair color with numeric labels.장식이 아니면 role=img + aria-label 로 추세 요약(예: "최근 24시간 처리량, 상승")을 제공하고, 색뿐 아니라 수치 라벨을 함께 둡니다.

Display & data

Table

A table that presents data in rows and columns, offering a sort caret (aria-sort), a sticky header, row selection, and toolbar affordances (the consumer handles sort and selection logic).행과 열로 데이터를 보여주는 표입니다. 정렬 캐럿(aria-sort), sticky 헤더, 행 선택, 툴바 affordance 를 제공합니다(정렬/선택 로직은 소비처).

.qf-tablelayer: generic

Preview

Jobs
NameStatus
sync-skulkRunning
backfillQueued
<div class="qf-table-wrap">
  <div class="qf-table__toolbar">
    <span class="qf-table__toolbar-title">Jobs</span>
    <span class="qf-table__toolbar-spacer">
    </span>
    <button class="qf-btn qf-btn--secondary qf-btn--sm">Retry</button>
  </div>
  <table class="qf-table qf-table--sticky">
    <thead>
      <tr>
        <th>
          <input type="checkbox" class="qf-checkbox__input" aria-label="Select all">
        </th>
        <th class="qf-table__th--sortable" aria-sort="ascending">
          <span class="qf-table__sort">Name</span>
        </th>
        <th class="qf-table__th--sortable">
          <span class="qf-table__sort">Status</span>
        </th>
      </tr>
    </thead>
    <tbody>
      <tr class="is-selected">
        <td>
          <input type="checkbox" class="qf-checkbox__input" checked aria-label="Select row">
        </td>
        <td>sync-skulk</td>
        <td>Running</td>
      </tr>
      <tr>
        <td>
          <input type="checkbox" class="qf-checkbox__input" aria-label="Select row">
        </td>
        <td>backfill</td>
        <td>Queued</td>
      </tr>
    </tbody>
  </table>
</div>

Variants

Jobs
NameStatus
sync-skulkRunning
backfillQueued
qf-table--striped
Jobs
NameStatus
sync-skulkRunning
backfillQueued
qf-table--sticky

Parts & more: 구성 요소, 기타: qf-table-wrap qf-table__th--sortable qf-table__sort qf-table__toolbar qf-table__toolbar-title qf-table__toolbar-spacer

Required tokens

--divider --s-3 --s-4 --text-muted --text --bg-hover --fs-14 --accent --accent-bg --bg-panel --z-sticky

Accessibility

Convey header relationships with a thead/th(scope=col)/tbody structure, and describe the table's purpose with a caption or aria-label. At narrow widths, qf-table-wrap enables horizontal scrolling.thead/th(scope=col)/tbody 구조로 헤더 관계를 전달하고, 표 용도는 caption 또는 aria-label 로 설명합니다. 좁은 폭은 qf-table-wrap 으로 가로 스크롤합니다.

Display & data

DescriptionList

A list that presents term-and-description (key-value) pairs in an aligned layout.용어와 설명(키-값) 쌍을 정렬해 보여주는 목록입니다.

.qf-dllayer: generic

Preview

Plan
Pro
Joined
2026-01-01
<dl class="qf-dl">
  <dt>Plan</dt>
  <dd>Pro</dd>
  <dt>Joined</dt>
  <dd>2026-01-01</dd>
</dl>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--s-2 --s-5 --text-muted --text --fs-13 --fs-14

Accessibility

Convey key-value relationships with dl/dt/dd semantics. The grid handles the visual two-column alignment while the markup preserves the meaning.dl/dt/dd 시맨틱으로 키-값 관계를 전달합니다. 시각적 2열 정렬은 grid 가 담당하고 의미는 마크업이 보존합니다.

Display & data

AvatarGroup

Stacks multiple avatars in an overlapping cluster to compactly represent a set of participants.여러 아바타를 겹쳐 쌓아 참여자를 압축 표시합니다.

.qf-avatar-grouplayer: generic

Preview

MHJ+2
<span class="qf-avatar-group" aria-label="5 participants">
  <span class="qf-avatar qf-avatar--sm">M</span>
  <span class="qf-avatar qf-avatar--sm">H</span>
  <span class="qf-avatar qf-avatar--sm">J</span>
  <span class="qf-avatar qf-avatar--sm">+2</span>
</span>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--avatar-ring --r-pill --s-3

Accessibility

Provide alt text (the user's name) on each avatar image, and supplement the group's overall meaning (e.g. "5 participants") with aria-label. The ring is separated from the surface via --avatar-ring (surface).각 아바타 이미지에 alt(사용자명)를 제공하고, 그룹 전체 의미(예: 참여자 5명)는 aria-label 로 보충합니다. ring 은 --avatar-ring(표면) 으로 표면과 분리됩니다.

Display & data

List

A general-purpose vertical list with dividers (settings rows, item lists).구분선이 있는 범용 세로 목록입니다(설정 행, 항목 리스트).

.qf-listlayer: generic

Preview

  • NotificationsOn
  • LanguageEnglish
<ul class="qf-list">
  <li class="qf-list__item">
    <span class="qf-list__text">Notifications</span>
    <span class="qf-list__trailing">On</span>
  </li>
  <li class="qf-list__item">
    <span class="qf-list__text">Language</span>
    <span class="qf-list__trailing">English</span>
  </li>
</ul>

Variants

qf-list__item qf-list__text qf-list__trailing qf-list__item--interactive

Required tokens

--s-3 --s-4 --divider --text --bg-hover --text-muted --s-9

Accessibility

Build it with ul/li, and make interactive items (--interactive) an a/button to preserve keyboard access and visible focus. Interactive rows are at least 40px tall, and a link or button inside (.qf-list__text) extends its tap target into the row padding (about 37px, WCAG 2.5.8). Inline content inside the link (icon + text, qf-clamp) keeps flowing as usual.ul/li 로 만들고, 상호작용 항목(--interactive)은 a/button 으로 두어 키보드 접근과 포커스 가시를 보존합니다. 상호작용 행은 최소 40px 이고, 행 안의 링크나 버튼(.qf-list__text)은 행 패딩까지 탭 대상으로 가져갑니다(약 37px, WCAG 2.5.8). 링크 안의 내용은 인라인 흐름 그대로 둘 수 있습니다(아이콘 + 텍스트, qf-clamp).

Display & data

RankList

A ranked list (e.g. trending issues 1–5). Numbers come from a CSS counter so there is no digit in the markup (rank carries meaning: accent, tabular-nums). Each item is a link (qf-ranklist__link) holding a title (qf-ranklist__title, 14px 600, two-line clamp) and a meta line (qf-ranklist__meta, 12px muted), with hover tint, visited tone and focus ring. Meant for the aside but works unchanged when the layout drops to one column.순위 목록입니다(지금 뜨는 이슈 1~5). 번호는 CSS counter 로 그려 마크업에 숫자가 없고(순위가 의미라 번호, 액센트, tabular-nums), 항목 전체가 링크(qf-ranklist__link)이며 제목(qf-ranklist__title, 14px 600, 두 줄 clamp)과 메타(qf-ranklist__meta, 12px muted)로 이루어집니다. hover 틴트, 방문 톤, 포커스 링. 사이드 열에서 쓰지만 1열로 내려가도 그대로 동작합니다.

.qf-ranklistlayer: generic

Preview

<ol class="qf-ranklist" role="list" style="max-width:300px">
  <li class="qf-ranklist__item">
    <a class="qf-ranklist__link" href="#r1">
      <span class="qf-ranklist__title">Supreme Court admits chief justice filed false expense reports, apologizes</span>
      <span class="qf-ranklist__meta">8 communities, 51 posts</span>
    </a>
  </li>
  <li class="qf-ranklist__item">
    <a class="qf-ranklist__link" href="#r2">
      <span class="qf-ranklist__title">Central bank holds rates, signals a cut before year end</span>
      <span class="qf-ranklist__meta">3 communities, 5 posts</span>
    </a>
  </li>
  <li class="qf-ranklist__item">
    <a class="qf-ranklist__link" href="#r3">
      <span class="qf-ranklist__title">City council reverses late-night bus cuts</span>
      <span class="qf-ranklist__meta">2 communities, 4 posts</span>
    </a>
  </li>
</ol>

Variants

qf-ranklist__item qf-ranklist__link qf-ranklist__title qf-ranklist__meta

Required tokens

--s-7 --s-3 --s-2 --s-1 --r-md --fs-14 --fs-12 --lh-snug --accent-text --text-strong --text-secondary --text-muted --bg-row-hover --ring-focus --dur-fast --ease-standard

Accessibility

Use ol/li, and add role="list" to the ol because list-style: none can drop list semantics in WebKit. The CSS counter number is ::before generated text, so it becomes part of the link name and is read as "1 title meta" (the rank is conveyed). For titles cut by the two-line clamp, provide the full text via title or aria-label. Number --accent-text on --bg-app 7.5 / 5.3 — AA.ol/li 로 두되 list-style: none 이라 WebKit 에서 목록 의미가 떨어질 수 있으니 ol 에 role="list" 를 둡니다. CSS counter 번호는 ::before 생성 텍스트라 링크 이름에 포함되어 "1 제목 메타" 로 읽힙니다(순위가 전달됨). 두 줄 clamp 로 잘린 제목은 title 속성이나 aria-label 로 전체를 줄 수 있습니다. 번호 --accent-text on --bg-app 7.5 / 5.3 — AA.

Display & data

Story

One item of a content list such as news, issues, or a blog. It fixes the hierarchy of kicker (category + meta), title, summary, source chips, and a 4:3 thumbnail. The whole item may be the link (a.qf-story) or only the title. --pictured places text in column 1 and the thumbnail in column 2 (on narrow screens it only shrinks, it does not move); --lead emphasizes the first item (24px title, wider thumbnail; on narrow screens a 16:9 thumbnail sits above the text); --compact shows only kicker and title (summary and sources are hidden even if present). Visited items get a quieter title. Place the list inside qf-container--reading (720px): narrow overflows titles and source chips, the default width makes summary lines too long. Source chips inside an item are automatically one step smaller (11px). --skeleton is a placeholder card shown while the next page loads (bars in the empty slots, same height as a real card; if real cards are --stretched, add --stretched to the skeleton too so the sources row matches on touch devices). --stretched stretches the title link over the whole card when the card is an article with only the title linked, so source chips (qf-source--link) and tag links (a.qf-tag) inside can be real links — sources use qf-source, categories and topics use qf-tag.뉴스, 이슈, 블로그 같은 콘텐츠 목록의 한 항목입니다. 분류와 메타(kicker), 제목, 요약, 출처 칩, 4:3 썸네일의 위계를 구성요소로 고정합니다. 항목 전체가 링크(a.qf-story)이거나 제목만 링크일 수 있습니다. --pictured 는 텍스트 1열 + 썸네일 2열(좁은 폭에서는 크기만 줄고 자리는 유지), --lead 는 첫 항목 강조(제목 24px, 썸네일 확대. 좁은 폭에서는 16:9 썸네일이 텍스트 위로), --compact 는 제목과 kicker 만(요약, 출처는 마크업이 있어도 숨김). 방문한 항목은 제목이 한 톤 낮아집니다. 목록은 qf-container--reading(720px) 안에 두는 것을 권합니다(narrow 는 제목과 출처 칩이 넘치고 기본 폭은 요약 행이 깁니다). 항목 안의 출처 칩은 자동으로 한 단계 작아집니다(11px). --skeleton 은 다음 화면을 불러오는 동안 자리를 지키는 카드(빈 슬롯에 막대, 실제 카드와 같은 높이. 실제 카드가 --stretched 면 스켈레톤에도 --stretched 를 붙여 터치 환경의 출처 행 높이를 맞춥니다). --stretched 는 카드가 article 이고 제목만 링크일 때 제목 링크를 카드 전체로 늘려, 카드 안의 출처 칩(qf-source--link)과 태그 링크(a.qf-tag)를 눌리는 링크로 둘 수 있게 합니다 — 출처는 qf-source, 분류·주제는 qf-tag.

.qf-storylayer: generic

Preview

<a class="qf-story qf-story--pictured" href="#story">
  <img class="qf-story__media" src="brand-assets/png/og-image.png" alt="" width="180" height="135">
  <div class="qf-story__kicker">
    <span class="qf-eyebrow">Politics</span>
    <span>4 communities · 9 posts · 9 min ago</span>
  </div>
  <h2 class="qf-story__title">Supreme Court admits chief justice filed false expense reports, apologizes</h2>
  <p class="qf-story__summary qf-clamp qf-clamp--3">Reporting by an investigative outlet traced dozens of receipts to restaurants that were closed on the dates listed. The court issued a formal apology and said a corrected ledger would follow.</p>
  <div class="qf-sources qf-story__sources">
    <span class="qf-source">82cook</span>
    <span class="qf-source">Inven</span>
    <span class="qf-source">Clien</span>
    <span class="qf-source">Bobaedream</span>
  </div>
</a>

Examples예시

Text only, title is the link
--pictured without summary/sources (spacer rows keep kicker↔title tight)
--skeleton (loading placeholder)
--stretched (article, title link stretched, source chips are links)

Variants

qf-story__kicker qf-story__title qf-story__summary qf-story__sources qf-story__media qf-story--pictured qf-story--lead qf-story--compact qf-story--skeleton qf-story--stretched

Required tokens

--text-strong --text-secondary --text-muted --accent-text --bg-row-hover --bg-media --aspect-4x3 --aspect-16x9 --sz-story-media --sz-story-media-sm --sz-story-media-lead --fs-18 --fs-24 --fs-14 --r-md --s-5 --ring-focus --fs-12 --fs-15 --s-1 --s-2 --s-3 --s-4 --lh-snug --lh-tight --lh-normal --tracking-tight --dur-fast --ease-standard --border --bg-hover --bg-selected --r-xs --r-pill --m-touch

Accessibility

Use h2/h3 for the title to convey list structure. When the whole item is a link, do not nest other links inside it (no source --link chips). Give decorative thumbnails alt="" and width/height to avoid layout shift. Focus is shown as a ring around the whole item. The visited tone is a secondary cue; meaning never relies on color alone. When the whole item is a link, the kicker, title, summary, and sources all become the link name and it gets long; if summaries are long, consider linking only the title (see the Text only example). To shorten the link name to the title only, aria-labelledby="<title id>" can be set on a.qf-story. With --stretched, text inside the card cannot be selected by dragging and the context menu is the title link's — in return the link name is just the title. Give skeletons aria-hidden="true" and replace them wholesale when real cards arrive.제목은 h2/h3 로 두어 목록의 문서 구조를 전달합니다. 항목 전체를 링크로 만들 때는 안에 다른 링크(출처 칩 --link 등)를 넣지 않습니다(중첩 링크 금지). 장식 썸네일은 alt="" 로 두고 width/height 를 적어 레이아웃 점프를 막습니다. 포커스는 항목 전체에 링으로 보입니다. 방문 톤은 보조 단서일 뿐 의미를 색에만 싣지 않습니다. 항목 전체가 링크면 kicker, 제목, 요약, 출처가 모두 링크 이름이 되어 길어집니다. 요약이 길면 제목만 링크로 두는 형태(Text only 예제)를 고려하세요. 링크 이름을 제목만으로 줄이려면 a.qf-story 에 aria-labelledby="제목 id" 를 둘 수 있습니다. --stretched 에서는 카드 안 텍스트를 드래그로 선택할 수 없고 우클릭 메뉴가 제목 링크의 것입니다 — 그 대신 링크 이름이 제목만으로 짧습니다. 스켈레톤은 aria-hidden="true" 로 두고 실제 카드가 오면 통째로 바꿉니다.

Display & data

Source

A small, neutral chip naming one source (a community or outlet). An outline pill, distinct from Tag (labels) and Badge (status, notifications). qf-source__count shows a count as a gray number (instead of a red count badge); qf-source__mark holds an initial or favicon. --link makes it a link to the original list; qf-sources is the wrapping group container. Inside qf-story__sources and qf-timeline__body they are secondary information and shrink automatically by one step (11px, matching the body line height).출처(커뮤니티, 매체) 이름 하나를 나타내는 중립 톤의 작은 칩입니다. 태그(라벨)나 배지(상태, 알림)와 구분되는 outline pill 입니다. qf-source__count 는 회색 숫자로 개수를(빨간 count 배지 대신), qf-source__mark 는 이니셜이나 파비콘을 넣습니다. --link 는 눌러서 원문 목록으로 가는 링크형, qf-sources 는 줄바꿈되는 묶음 컨테이너입니다. qf-story__sources 와 qf-timeline__body 안에서는 보조 정보라 자동으로 한 단계 작아집니다(11px, 본문 줄 높이와 같음).

.qf-sourcelayer: generic

Preview

82cookInven 3Clien 2
<div class="qf-sources">
  <span class="qf-source">82cook</span>
  <span class="qf-source">
    Inven
    <span class="qf-source__count">3</span>
  </span>
  <a class="qf-source qf-source--link" href="#source">
    <span class="qf-source__mark" aria-hidden="true">C</span>
    Clien
    <span class="qf-source__count">2</span>
  </a>
</div>

Examples예시

Bobaedream
Plain
Bobaedream 2
With count (gray, not red)
Ruliweb
With mark (initial)
--link
82cookInvenClienBobaedreamPpomppuRuliwebDC Inside
Group (qf-sources, wraps)

Variants

82cookInven 3Clien 2
qf-source--link

Parts & more: 구성 요소, 기타: qf-sources qf-source__count qf-source__mark

Required tokens

--border --border-strong --text-secondary --text-muted --text --r-pill --fs-12 --fs-11 --s-2 --s-3 --s-5 --m-touch --ring-focus --bg-selected --bg-hover --s-4 --lh-snug --dur-fast --ease-standard

Accessibility

Counts are gray numbers, so they do not read as warnings; add an aria-label when needed (e.g. "2 posts on Bobaedream"). --link is an anchor with a visible focus ring. On touch devices (any-pointer: coarse, including touch laptops) only --link chips grow to 44px; static chips and chips inside a linked qf-story stay as they are. Do not use --link inside a qf-story that is itself a link.개수는 회색 숫자라 경고로 읽히지 않습니다. 필요하면 aria-label 로 뜻을 보충합니다(예: 보배드림 글 2건). --link 는 a 로 두고 포커스 링이 보입니다. 터치 환경(any-pointer: coarse, 터치 노트북 포함)에서는 --link 칩만 44px 로 커지고, 정적 칩과 카드 안 칩은 그대로입니다. 항목 전체가 링크인 qf-story 안에서는 --link 를 쓰지 않습니다.

Display & data

DayRule

A date or section rule placed between list items: an eyebrow-toned label plus a line, used as an li (with role="separator", also provide the label via aria-label). --sticky pins it to the top while scrolling and paints the app background (--bg-app) so items do not show through. Knobs: --qf-dayrule-top (offset under a fixed header, default 0; the rule sits at --z-sticky, so with a fixed header you must set this to the header height, e.g. var(--h-navbar)) and --qf-dayrule-bg (background when used inside a panel). Give items a scroll-margin-top so a sticky rule does not cover the top of a focused item. When a sticky top bar (qf-navbar--sticky) hides with is-hidden, the rule automatically moves up to top: 0.목록 사이에 끼우는 날짜, 구간 구분줄입니다. eyebrow 톤 라벨과 선으로 이루어지며 li 로 씁니다(role="separator" 를 쓰면 aria-label 로 라벨을 함께 줍니다). --sticky 는 스크롤 시 상단에 붙고 앱 배경(--bg-app)을 깔아 아래 항목이 비치지 않습니다. 노브: --qf-dayrule-top(고정 헤더 아래 오프셋, 기본 0. z-index 가 --z-sticky 라 고정 헤더가 있으면 반드시 헤더 높이, 예: var(--h-navbar), 를 지정), --qf-dayrule-bg(패널 안에서 쓸 때 배경). sticky 구분줄이 포커스된 항목의 윗부분을 가리지 않게 항목에 scroll-margin-top 을 주는 것을 권합니다. 고정 상단 바(qf-navbar--sticky)가 is-hidden 으로 숨으면 날짜줄은 자동으로 맨 위(top: 0)로 올라붙습니다.

.qf-dayrulelayer: generic

Preview

  • First item of the day
  • Second item
  • An older item
<ul class="qf-stack qf-stack--tight" style="list-style:none;margin:0;padding:0;width:100%">
  <li class="qf-dayrule" role="separator" aria-label="Today, Wednesday, Sep 30">
    <span class="qf-dayrule__label">Today · Wednesday, Sep 30</span>
  </li>
  <li class="qf-list__item" style="padding-inline:0">First item of the day</li>
  <li class="qf-list__item" style="padding-inline:0">Second item</li>
  <li class="qf-dayrule" role="separator" aria-label="Yesterday, Tuesday, Sep 29">
    <span class="qf-dayrule__label">Yesterday · Tuesday, Sep 29</span>
  </li>
  <li class="qf-list__item" style="padding-inline:0">An older item</li>
</ul>

Variants

  • First item of the day
  • Second item
  • An older item
qf-dayrule--sticky

Parts & more: 구성 요소, 기타: qf-dayrule__label

Required tokens

--accent-text --text-muted --bg-app --z-sticky --fs-12 --tracking-caps --s-3 --s-4 --lh-tight --border --dur-base --ease-standard

Accessibility

In ARIA, separator has presentational children, so text inside it is not exposed to assistive technology. If you use role="separator", always duplicate the label in aria-label (e.g. aria-label="Today, Wednesday, Sep 30"); if counting it among the items is acceptable, use a plain li without the role so the label is read as-is. Keep the label as real text; the uppercase transform is visual only. The --sticky background must stay opaque so text does not show through; do not set a translucent value.ARIA 의 separator 는 자식 요소가 presentational 이라 안의 텍스트가 보조기기에 노출되지 않습니다. role="separator" 를 쓰려면 같은 텍스트를 aria-label 로 반드시 함께 두고(예: aria-label="오늘, 9월 30일 수요일"), 항목 수에 섞여도 괜찮으면 role 없이 일반 li 로 두어 라벨이 그대로 낭독되게 합니다. 라벨은 실제 텍스트로 두고 대문자 변환은 시각 표현입니다. --sticky 의 배경은 아래 텍스트가 겹쳐 보이지 않게 불투명해야 하므로 반투명 값을 넣지 않습니다.

Display & data

Timeline

A vertical timeline of events in time order (unlike qf-steps, which shows progress through stages). Each item has a time (qf-timeline__time), a marker (qf-timeline__marker), and a body (qf-timeline__body: source chip + title link + meta); qf-timeline__day marks a date change. The marker color is exposed through one custom property, --qf-timeline-marker, which consumers set with a token (e.g. var(--viz-2)) to tell sources apart (default --text-muted). The time column (--sz-timeline-time) survives narrow widths; for very narrow layouts, --stacked moves the time above the body.시간순 기록을 세로로 보여 주는 타임라인입니다(진행 단계를 나타내는 qf-steps 와 다릅니다). 항목은 시각(qf-timeline__time), 마커(qf-timeline__marker), 본문(qf-timeline__body: 출처 칩 + 제목 링크 + 메타)로 이루어지고, 날짜가 바뀌는 곳에 qf-timeline__day 를 둡니다. 마커 색은 커스텀 프로퍼티 --qf-timeline-marker 하나로 열어 두어 소비처가 토큰(예: var(--viz-2))으로 출처를 구분합니다(기본 --text-muted). 좁은 폭에서도 시각 칸(--sz-timeline-time)이 유지되며, 더 좁게 써야 하면 --stacked 로 시각을 본문 위로 올립니다.

.qf-timelinelayer: generic

Preview

<ol class="qf-timeline">
  <li class="qf-timeline__day">Sep 30</li>
  <li class="qf-timeline__item" style="--qf-timeline-marker: var(--viz-1)">
    <time class="qf-timeline__time" datetime="2026-09-30T09:12">09:12</time>
    <span class="qf-timeline__marker" aria-hidden="true">
    </span>
    <div class="qf-timeline__body">
      <span class="qf-source">Clien</span>
      <a class="qf-link" href="#post">The chief justice's expense reports do not add up</a>
      <span class="qf-timeline__meta">4 comments</span>
    </div>
  </li>
  <li class="qf-timeline__item" style="--qf-timeline-marker: var(--viz-2)">
    <time class="qf-timeline__time" datetime="2026-09-30T09:40">09:40</time>
    <span class="qf-timeline__marker" aria-hidden="true">
    </span>
    <div class="qf-timeline__body">
      <span class="qf-source">82cook</span>
      <a class="qf-link" href="#post">So the Supreme Court apologized. Now what?</a>
      <span class="qf-timeline__meta">31 comments</span>
    </div>
  </li>
  <li class="qf-timeline__item" style="--qf-timeline-marker: var(--viz-3)">
    <time class="qf-timeline__time" datetime="2026-09-30T11:05">11:05</time>
    <span class="qf-timeline__marker" aria-hidden="true">
    </span>
    <div class="qf-timeline__body">
      <span class="qf-source">Bobaedream</span>
      <a class="qf-link" href="#post">Court to publish a corrected ledger, refers case to outside review</a>
      <span class="qf-timeline__meta">12 comments</span>
    </div>
  </li>
  <li class="qf-timeline__day">Sep 29</li>
  <li class="qf-timeline__item">
    <time class="qf-timeline__time" datetime="2026-09-29T22:48">22:48</time>
    <span class="qf-timeline__marker" aria-hidden="true">
    </span>
    <div class="qf-timeline__body">
      <span class="qf-source">Inven</span>
      <a class="qf-link" href="#post">First report surfaces on the expense records</a>
      <span class="qf-timeline__meta">2 comments</span>
    </div>
  </li>
</ol>

Examples예시

Variants

Parts & more: 구성 요소, 기타: qf-timeline__item qf-timeline__time qf-timeline__marker qf-timeline__body qf-timeline__meta qf-timeline__day

Required tokens

--text --text-strong --text-secondary --text-muted --accent-text --sz-timeline-time --sz-timeline-marker --fs-14 --fs-12 --lh-normal --r-pill --s-3 --s-4 --border-strong --s-1 --s-2 --tracking-caps --lh-tight --border

Accessibility

Convey order with an ol and mark times with time[datetime]. Markers are decorative (aria-hidden); the source is conveyed by the qf-source text, not by color. Titles are qf-link anchors with a visible focus ring and a light underline so they read as links next to the meta text on the same line, and visited links are toned down. Date dividers (qf-timeline__day) are read as list item text.ol 로 순서를 전달하고 시각은 time[datetime] 으로 둡니다. 마커는 장식(aria-hidden)이며 출처는 색이 아니라 qf-source 텍스트로 전달합니다. 제목은 qf-link 로 두어 포커스 링이 보이고, 같은 줄의 메타 텍스트와 구분되게 옅은 밑줄로 링크 단서를 함께 줍니다. 방문한 링크는 한 톤 낮아집니다. 날짜 구분(qf-timeline__day)은 li 텍스트로 낭독됩니다.

Display & data

Clamp

A utility that truncates text to N lines with an ellipsis — keeps card titles and descriptions uniform.텍스트를 N줄에서 말줄임하는 유틸리티입니다. 카드 제목, 설명을 균일하게 자릅니다.

.qf-clamplayer: generic

Preview

This is a longer description that clamps to two lines with an ellipsis when it overflows its container width, keeping cards uniform.

<p class="qf-clamp" style="max-width:320px;margin:0">This is a longer description that clamps to two lines with an ellipsis when it overflows its container width, keeping cards uniform.</p>

Examples예시

This variant clamps to three lines instead of two. Useful for denser cards where a little more context fits before the ellipsis truncates the remaining overflow text.

3 lines (--3)

A single-line clamp behaves like a truncating ellipsis on overflow.

1 line (--1)

Variants

This is a longer description that clamps to two lines with an ellipsis when it overflows its container width, keeping cards uniform.

qf-clamp--1

This is a longer description that clamps to two lines with an ellipsis when it overflows its container width, keeping cards uniform.

qf-clamp--3

This is a longer description that clamps to two lines with an ellipsis when it overflows its container width, keeping cards uniform.

qf-clamp--reserve

Required tokens

--lh-snug

Accessibility

Visual truncation only — the full text stays in the accessibility tree (never aria-hidden the clamp node). When text may be cut, pair it with a title attribute or qf-tooltip.시각적 절단만이며 전체 텍스트는 접근성 트리에 유지합니다(클램프 노드에 aria-hidden 금지). 잘릴 수 있으면 title 이나 qf-tooltip 을 함께 제공합니다.

Display & data

SortToggle

A three-state sort toggle that cycles ascending↔descending↔off — used as a table header (th[aria-sort]) or a button, with a direction glyph.오름차순↔내림차순↔off를 순환하는 3상태 정렬 토글입니다. 테이블 헤더(th[aria-sort]) 또는 버튼으로 쓰며 방향을 글리프로 표시합니다.

.qf-sort-togglelayer: generic

Preview

<button class="qf-sort-toggle is-active" type="button" data-direction="asc" aria-label="Sort by name, ascending">
  <span>Name</span>
  <span class="qf-sort-toggle__indicator" aria-hidden="true">▲</span>
</button>

Examples예시

Descending (active)
Off (inactive)

Variants

qf-sort-toggle--lg

Parts & more: 구성 요소, 기타: qf-sort-toggle__indicator

Required tokens

--text-secondary --text-strong --accent --bg-hover --sort-indicator-size --ring-accent --r-sm --s-1 --s-2 --fs-13

Accessibility

Table headers use th[aria-sort='ascending|descending|none']; standalone buttons use role=button with an accessible name. Cycle with Enter/Space, convey direction via aria-sort/glyph (not color alone), and keep headers at a 44px tap target.테이블 헤더는 th[aria-sort='ascending|descending|none'], 독립 버튼은 role=button + 접근명입니다. Enter/Space로 순환하고 방향은 색이 아니라 aria-sort/글리프로 전달하며 헤더는 44px 탭 타깃을 유지합니다.

Display & data

MapPin

A member marker on a map: a 32px disc with the photo (when there is one, 26 inside the ring) or the initial; the member color (--qf-member-color = viz-1..8) is only a 3px ring, so the text stays text-strong on bg-elevated (AA) however bright the color. A 2px casing separates it from the tiles. --stale marks an old fix (dimmed, dashed ring, clock badge), --selected adds an accent ring, --cluster shows a count. --paused is the last position of someone who paused sharing themselves (ring faded like --stale but solid, plus a pause badge, qf-i-pause). Keep the pin; when paused and stale coincide, use only --paused. A tap opens the callout above it (qf-map-callout, 036) and the pin becomes --selected. The photo (043) is the same one as the list avatar; when it fails to load switch to the initial. Stale and paused photos are only dimmed (opacity --map-stale-opacity), no grayscale (RN on iOS has no grayscale filter, so app and web match). A cluster always shows a count. Stale (044, revising the 036 table): --stale when the last point is over 60 minutes old, except when the current state is an open stay (a stay with no departure, now.type stay) and the phone's last contact (anything the server received from that device: a point, a visit, a wake reply) is within 4 hours; then draw a normal pin and "Home, since 18:10". iOS sends no points during a stay, so by points alone everyone at home in the evening fades. 4 hours is the server's wake interval for a staying phone (2 to 3 hours) plus an hour for one missed wake. App and web do not hard-code it: they use the threshold (seconds) the server ships alongside, or 14400 (4 hours) when there is none (oracle names the field in api.md). Without a last-contact time (an older server), only the 60-minute rule. Shorten old times to one unit, rounded down: 1 to 23 hours "3시간 전", 1 to 6 days "2일 전", 7 days or more "10월 17일" ("2025년 10월 17일" in another year). People at the same spot are fanned out (qf-map-fan, 044). A two-syllable name ("지훈") uses --duo (fs-11; see the Avatar initials rule). On the dark base map (059, the default dark lightness) the ring's own 3:1 separates it on land (casing 1.34), and on lighter areas such as road surfaces the casing separates it at 3:1; the casing also separates overlapping pins and lines. 062 (Den 071 B-24): when an open stay goes stale past the threshold, measure the age from the last contact, not the last fix (no departure had arrived by then): arrived home at 18:10, last contact 5 h ago gives "5 h ago, at home". Not a stay (moving, no now): measure from the last fix as before. The callout, the list row, the timeline's current row and its map marker (MapStop --live) use the same decision and the same time. In Den (qufox-den 7c1fb29) the threshold is GET /config presence.staleAfterS (14400 if not received) and the last contact is lastSeenAt on /family and Member. Without lastSeenAt (old server, not sharing) only the 60-minute rule applies, and the timeline's current row also drops --live once the last fix is over 60 minutes old. Moving (067, qufox Den 077): while the screen is being viewed, when a new position for the same person changes the pin's drawn spot (including its fanned spot in MapFan), the pin glides from the old spot to the new one over --map-move-dur (520) with --map-move-ease (a symmetric cubic-bezier(0.4, 0, 0.6, 1): leaves slowly, lands slowly). The duration is the same whatever the distance. The end spot is the new coordinate plus the fan offset after regrouping. Start only once regrouping is done, and make the decisions below from that spot (where screen-point conversion is asynchronous, as in the app, do not start first with the new coordinate and the old offset). Interpolate the coordinate (latitude and longitude, linearly) and the offset separately on the same progress (drawn spot = coordinate + offset, so the pin keeps its place if the map is dragged mid-glide). If another position arrives mid-glide, start again from the spot currently drawn. If the user moves the map and it regroups mid-glide, stop and switch to the new spot at once (a pan made by opening the callout does not cut the rest of the glide). That person's accuracy circle moves its centre and radius on the same progress; the circle appearing or disappearing is immediate. Change the state (stale, paused, photo) and the name when the glide starts; a selected pin (--selected) stays on top throughout. The map (camera) does not follow the pin. Switch at once (no motion): on first draw and on coming back to the screen (app to the foreground, tab visible again, group switched); when both the old and the new spot are outside the visible map (measured as for MapCallout's flip); when the on-screen distance between them is longer than the visible map's shorter side (measure it without converting off-screen coordinates to screen points: divide the distance between the two coordinates by the current zoom's scale, Den app metresPerPoint, web metersPerPx); when the pin joins or leaves a count of nine or more (--cluster), and for the count mark itself (always immediate); and with reduced motion (iOS Reduce Motion, prefers-reduced-motion). Distance is measured on screen, not in km: several km zoomed out is short and glides; crossing the screen zoomed in switches at once. If none of these applies and only one end is inside, it glides (you see it enter or leave at the edge). Reduced motion switches at once without a fade (a fade shows the same person twice, half transparent, and still does not show which way they went). Pins that appear or disappear (sharing turned on or off) still have no motion. My own pin follows the same rule (in the app, each time the phone records a new point, Den 076). On the app map keep both the location dot (drawn by the map SDK from GPS) and my pin. Member pins stack above the dot (Den app aboveLocation), so while staying alone the pin (outer 36) usually covers the dot and they read as one; when fanned with family at the same spot my pin sits in the fan and the dot shows separately at the real spot; while moving the dot leads and the pin catches up. Hiding my pin would lose "(me)" first in the list and fan order, my callout and the way to my timeline, and how my family sees me (paused, stale); hiding the dot would leave me unable to see where I am while sharing is off or paused. The web has no location dot. Drawing: in the app (react-native-naver-map) a marker's image is not redrawn while drawKey stays the same, so change only latitude, longitude and anchor each frame (requestAnimationFrame, progress from Easing.bezier(...map-move-ease)). Keep the motion state per pin so a frame does not redraw the whole screen (sheet, list). The callout in the floating layer (a React view) and the native marker may be about a frame apart (known limit). On the web (Naver Maps JS) keep one N.Marker per person and change setPosition and the offset inside its box (translate) each frame. A drawing that puts several pins in one .qf-map-fan box cannot glide, because the element changes when a person joins or leaves the group; to add the motion, give each person their own mark with the MapFan offset set in JS (a way MapFan allows). If a timeline map shows a member pin at the current spot, the same rule applies; the route line extends to the new point at once and the pin catches up to its end.지도 위 구성원 표시입니다. 32px 원에 사진(있으면, 링 안쪽 26) 또는 이름 첫 글자를 두고 사람 색(--qf-member-color = viz-1~8)은 3px 링으로만 씁니다 — 글자는 bg-elevated 위 text-strong 이라 색이 밝아도 AA. 바깥 2px casing(--map-casing)이 타일과 분리합니다. --stale 은 오래된 위치(흐림 + 파선 링 + 시계 배지), --selected 는 액센트 링, --cluster 는 겹친 수("+3"). --paused 는 스스로 잠시 멈춘 사람의 마지막 위치(링은 --stale 과 같이 흐리게 하되 실선 + 멈춤 배지 qf-i-pause). 핀은 숨기지 않고, 멈춤과 오래됨이 겹치면 --paused 만 겁니다. 누르면 핀 위에 말풍선(qf-map-callout, 036)이 뜨고 핀은 --selected 가 됩니다. 사진(043)은 목록의 아바타와 같은 사진이고, 불러오지 못하면 첫 글자로 바꿉니다. 오래됨과 멈춤의 사진은 grayscale 없이 흐림(opacity --map-stale-opacity)만 둡니다(RN iOS 에 grayscale 필터가 없어 앱과 웹을 같게). 겹침(--cluster)은 늘 수입니다. 오래됨(044, 036 표를 바꿈): 마지막 점이 60분을 넘으면 --stale. 단 지금이 열린 머묾(떠남 없는 머묾, now.type stay)이고 그 폰의 마지막 연락(위치 점, 방문, 깨움 응답 등 서버가 그 기기에서 받은 무엇이든)이 4시간 안이면 오래되지 않은 것으로 보고 보통 핀과 "집, 18:10부터"를 둡니다. 머무는 동안 iOS 는 점을 보내지 않아서, 점만 보면 저녁에 집에 있는 사람이 모두 흐려진다. 4시간은 서버가 머무는 폰을 깨우는 간격(2~3시간)에 한 번 놓친 여유 1시간을 더한 값입니다. 앱과 웹은 이 값을 박아 두지 않고 서버가 함께 싣는 기준(초)을 쓰고, 기준이 없으면 14400(4시간)을 씁니다(필드 이름은 oracle 이 api.md 에 정함). 마지막 연락 시각이 오지 않으면(옛 서버) 60분 규칙만. 오래된 시각은 큰 단위 하나로 줄입니다: 1~23시간 "3시간 전", 1~6일 "2일 전", 7일 이상 "10월 17일"(해가 다르면 "2025년 10월 17일"), 내림. 같은 자리 사람들은 부채꼴로 벌립니다(qf-map-fan, 044). 이름 두 글자("지훈")는 --duo(fs-11, Avatar 의 글자 규칙). 다크 지도 바탕(059, 기본 다크의 밝기)에서 육지 위는 고리 자체의 3:1 이 가르고(casing 1.34), 도로 면처럼 밝은 면 위는 casing 이 면과 3:1 로 가릅니다. casing 은 겹친 핀과 선 사이도 뗍니다. 062(Den 071 B-24): 열린 머묾이 기준을 넘어 오래됨이 되면 시각은 마지막 점이 아니라 마지막 연락에서 잽니다(그때까지 떠남이 오지 않았다). 예: 18:10에 집에 와서 마지막 연락이 5시간 전이면 "5시간 전, 집에서". 머묾이 아니면(이동 중, now 없음) 지금처럼 마지막 점에서 잽니다. 말풍선(MapCallout), 목록 줄(MobileListRow), 타임라인의 지금 줄(MobileTimeline)과 그 지도 표시(MapStop --live)가 같은 판단과 같은 시각을 씁니다. Den 의 자리(qufox-den 7c1fb29): 기준 초는 GET /config 의 presence.staleAfterS(못 받으면 14400), 마지막 연락은 /family 와 Member 의 lastSeenAt. lastSeenAt 이 없으면(옛 서버, 공유 중이 아님) 60분 규칙만, 타임라인 지금 줄도 마지막 점 60분을 넘으면 --live 를 뗍니다. 옮겨 감(067, qufox Den 077): 화면을 보고 있는 동안 같은 사람의 새 위치를 받아 그려진 자리(MapFan 의 벌린 자리 포함)가 바뀌면, 핀은 옛 자리에서 새 자리로 --map-move-dur(520) 동안 --map-move-ease(대칭 cubic-bezier(0.4, 0, 0.6, 1), 천천히 떠나 천천히 내려앉음)로 미끄러집니다. 시간은 거리와 상관없이 같습니다. 끝 자리는 새 좌표에 다시 묶은 뒤의 벌린 자리 오프셋을 더한 것입니다. 다시 묶기가 끝난 뒤에 출발하고 아래 판정도 그 자리로 합니다(앱처럼 화면 점 셈이 비동기면 새 좌표와 옛 오프셋으로 먼저 출발하지 않음). 좌표(위도, 경도를 선형으로)와 오프셋을 같은 진행값으로 따로 옮깁니다(그려진 자리 = 좌표 + 오프셋이라 옮기는 중에 지도를 끌어도 핀이 제 자리를 지킴). 옮기는 중에 새 위치가 또 오면 지금 그려진 자리에서 새로 시작합니다. 옮기는 중에 사용자가 지도를 움직여 다시 묶이면 옮김을 멈추고 새 자리로 바로 바꿉니다(말풍선을 열어 생긴 지도 옮김은 남은 옮김을 끊지 않음). 그 사람의 정확도 원도 같은 진행값으로 가운데와 반지름을 옮기고, 원이 나타나거나 사라지는 것은 바로입니다. 상태(오래됨, 멈춤, 사진)와 이름은 옮기기 시작할 때 바꾸고, 고른 핀(--selected)은 옮기는 동안에도 맨 위입니다. 지도(카메라)는 핀을 따라가지 않습니다. 바로 바꾸는 때(움직임 없음): 처음 그릴 때와 화면에 다시 돌아왔을 때(앱이 앞으로 옴, 탭이 다시 보임, 그룹 바꿈), 옛 자리와 새 자리가 모두 보이는 지도 칸(MapCallout 의 뒤집기와 같은 기준) 밖일 때, 두 자리 사이의 화면 거리가 보이는 지도 칸의 짧은 변보다 길 때(화면 거리는 화면 밖 좌표를 화면 점으로 바꾸지 않고 두 좌표의 거리를 지금 줌의 축척으로 나눠 잼. Den 앱 metresPerPoint, 웹 metersPerPx), 9명 이상 수 표시(--cluster)에 들거나 빠질 때와 수 표시 자체(수 표시는 늘 바로), 동작 줄이기(iOS 동작 줄이기, prefers-reduced-motion)일 때. 거리는 km 가 아니라 화면에서 잽니다: 수 km 라도 넓게 보면 짧아서 미끄러지고, 크게 확대해 화면을 가로지르면 바로 바꿉니다. 위의 어느 때에도 들지 않고 한쪽만 칸 안이면 미끄러집니다(가장자리로 들어오거나 나가는 쪽이 보임). 동작 줄이기는 페이드 없이 바로 바꿉니다(옛 자리와 새 자리에 같은 사람이 반투명하게 둘 보이고, 페이드로는 어느 쪽으로 갔는지도 알 수 없음). 핀이 새로 나타나거나 사라질 때(공유를 켜고 끔)는 지금처럼 움직임이 없습니다. 내 핀도 같은 규칙입니다(앱은 폰의 새 점이 찍힐 때마다, Den 076). 앱 지도의 내 위치 점(지도 SDK 가 GPS 로 그리는 점)과 내 핀은 둘 다 둡니다. 사람 핀을 점 위에 쌓으므로(Den 앱 aboveLocation) 혼자 머무는 동안은 핀(바깥 36)이 점을 덮어 대개 하나로 보이고, 가족과 같은 자리라 벌려지면 내 핀은 부채꼴 안에, 점은 실제 자리에 따로 보이며, 움직이는 동안은 점이 앞서고 핀이 따라붙습니다. 내 핀을 숨기면 목록과 부채꼴에서 "(나)"가 먼저인 차례, 내 말풍선과 타임라인 길, 가족에게 보이는 나(멈춤, 오래됨)가 사라지고, 점을 숨기면 공유를 끄거나 멈춘 동안 내 자리를 볼 수 없습니다. 웹에는 내 위치 점이 없습니다. 그리기: 앱(react-native-naver-map)은 drawKey 가 그대로면 마커 그림을 다시 그리지 않으므로 프레임마다 latitude, longitude, anchor 만 바꿉니다(requestAnimationFrame, 진행값은 Easing.bezier(...map-move-ease)). 움직임 상태는 핀마다 따로 두어 프레임마다 화면 전체(시트, 목록)를 다시 그리지 않습니다. 떠 있는 층의 말풍선(React 뷰)과 네이티브 마커는 한 프레임쯤 어긋날 수 있습니다(알려진 한계). 웹(Naver 지도 JS)은 사람마다 N.Marker 하나를 두고 프레임마다 setPosition 과 상자 안 오프셋(translate)을 바꿉니다. 여러 핀을 .qf-map-fan 상자 하나에 넣은 그림은 사람이 묶음에 들고 날 때 요소가 바뀌어 미끄러질 수 없으므로, 옮김을 넣을 때는 사람마다 표시 하나에 MapFan 식의 오프셋을 JS 로 줍니다(MapFan 이 허용하는 길). 타임라인 지도에 지금 자리의 사람 핀이 있으면 같은 규칙이고, 경로 선은 움직임 없이 새 점까지 바로 늘어나 핀이 그 끝으로 따라붙습니다.

.qf-map-pinlayer: generic

Preview

M
<span class="qf-map-pin" role="img" style="--qf-member-color:var(--viz-3)" aria-label="Minsu, 3 min ago">M</span>

Examples예시

M Y J +3 M
All states: default, stale, selected, cluster, paused
043 Photo pins: current, stale, paused, selected
지훈 지민 엄
044 Two-syllable given names (--duo)

Variants

M
qf-map-pin--stale
M
qf-map-pin--paused
M
qf-map-pin--selected
M
qf-map-pin--cluster
M
qf-map-pin--duo

Parts & more: 구성 요소, 기타: qf-map-pin__badge

Required tokens

--sz-map-pin --map-casing --map-casing-w --map-stale-opacity --bg-elevated --text-strong --text-secondary --text-muted --fs-12 --fs-13 --font-sans --accent --border-strong --elev-2 --r-pill --s-3 --s-4 --s-5 --bg-app --fs-11 --tracking-tight --map-fan-gap --map-move-dur --map-move-ease

Accessibility

Name the marker with the person and the age of the fix ("Minsu, 3 min ago"); say "position from 1 h ago" for stale ones (dimming, dashes and the badge are visual). A cluster expands or opens the sheet list on tap. The consumer guarantees a 44px hit area around the 32px marker. In RN on iOS (Fabric) a Marker sizes itself from its view's first child, not the view, so start every marker view with an empty box of the view's size (position absolute, pointerEvents none); without it the pin sits about 10pt right of and below its point (measured in Den 036; stops and places too). In RN the selection ring sits 8 outside the inner box (26; the ::after inset is relative to the padding box), so it is 42 across with an outer radius of 21 (its 2 width drawn inward, 19 to 21). The visual box is that 42 (the casing ends at 36), so give the custom Marker wrapper ≥ 42 (views clip; the 044 fan spacing of 44 leaves 5 between this 21 and a neighbour's outer 18), draw the selection ring as a separate View and the casing with outline* (RN ≥ 0.76) or an extra View. Dim only the ring and photo when stale, never the parent (text and badge contrast). Name a paused person like "Minji, paused, position from 14:00". The photo is alt="" (the name is in the marker's accessible name). The move (067) is not announced (every 15 seconds would be noise). The pin's name changes to the new place and time as now; the pin can be tapped mid-glide, and a tap goes to the person at the spot drawn at that moment.표시의 접근 가능한 이름은 "민수, 3분 전" 처럼 이름과 갱신 시각을 담고, 오래됨은 "1시간 전 위치" 라고 말로도 전합니다(흐림, 파선, 배지는 눈용). 겹침 표시는 누르면 펼치거나 시트의 목록으로 보냅니다. 지도 위 표시는 기본적으로 44px 히트 영역을 소비처가 보장합니다(표시 32 + 투명 여백). RN(iOS, Fabric) 의 Marker 는 뷰가 아니라 첫 자식의 크기로 자리를 잡으므로 마커 뷰 맨 앞에 뷰와 같은 크기의 빈 상자(position absolute, pointerEvents none)를 둡니다. 없으면 핀이 좌표에서 약 10pt 오른쪽 아래로 어긋납니다(Den 036 실측, 머문 곳과 장소 표시도 같음). RN 으로 옮길 때: 선택 고리는 링 안쪽 상자(26)에서 8 씩 바깥(::after 의 inset 은 padding box 기준)이라 지름 42, 바깥 반지름 21(굵기 2 는 안쪽으로, 19~21)입니다. 시각 상자는 그 42 이므로(casing 바깥은 36) react-native-maps 커스텀 Marker 의 래퍼를 42 이상으로 잡고(뷰 밖은 잘림. 044 부채꼴의 이웃 간격 44 는 이 21 과 이웃 바깥 18 사이에 틈 5 를 둔 값) 선택 링은 별도 View 로, casing 은 outline*(RN ≥ 0.76) 또는 한 겹 더 큰 View 로 그립니다. stale 의 흐림은 링과 사진에만(부모 opacity 금지 — 글자와 배지 대비가 깎임). 멈춘 사람은 "민지, 잠시 멈춤, 14:00 위치" 처럼 이름을 붙입니다. 사진은 alt=""(이름은 표시의 접근 가능한 이름에 있음). 옮겨 감(067)은 화면 낭독기에 알리지 않습니다(15초마다 읽으면 시끄러움). 핀의 이름은 지금처럼 새 장소와 시각으로 바뀌고, 옮기는 중에도 눌리며 누른 것은 그때 그려진 자리의 사람입니다.

Display & data

MapFan

Fans out the pins of people at the same spot (044, qufox Den 058 B-32). When pins overlap, as on a night when everyone is home, only the top person showed and took taps; keeping them fanned shows everyone without a tap and lets each be tapped. Grouping: pins whose screen centres are closer than --map-fan-gap (44) are one group, transitively. The group centre is the mean of their screen positions. Placement: put n people on a circle of radius r = gap / (2 sin(180°/n)) around the centre (2: 22, 3: 25.4, 4: 31.1, 5: 37.4, 6: 44, 7: 50.7, 8: 57.5). Person i (list order from 0, "(me)" first) sits at angle −90° − 180°/n + i × 360°/n (screen coordinates, up is −90°): two side by side, three as two above one, four at the corners. Neighbouring centres are 44 apart, so the 44 hit areas do not overlap and a selection ring (outer 21) clears its neighbour. A group starts at two (leave a lone pin out of .qf-map-fan; if it is inside, the CSS centres it). With nine or more on one spot, do not fan: draw qf-map-pin--cluster (a count); a tap zooms in, and at the closest zoom opens the list sheet. Regroup when a map move ends and when positions update (when 036 re-decides the flip). When regrouping after a map move, move pins without animation (app and web). When a position update regroups pins and their drawn spots change, all of them glide together by MapPin's move (067; the end spot is the spot after regrouping, and the glide starts once regrouping is done): the person leaving the group, those who stay and are fanned again, and anyone joining. When one person leaves home, their pin departs and the rest close up. Joining or leaving a count of nine or more, and the count mark itself, always switch at once. The callout (036) opens from the fanned pin's drawn spot and decides flip and panning from that y. While open, that pin is --selected and on top (otherwise list order). Stale, paused and photo pins follow the same rule. Web: one 0×0 .qf-map-fan at the group centre (--qf-fan-n: the count) holding the pins, each with --qf-fan-i (from 0); the CSS places them by the formula (sin and cos need Safari 15.4 or Chrome 111). A map that draws each pin as its own mark can apply the same translate per pin. Do not add a centring transform (translate(-50%,-50%)) to fanned pins: the DS translate already includes −50%, so they would move twice (Den web narrows its .den-pin rule to .den-pin > .qf-map-pin). CSS does not know where the callout goes, so JS computes the same offset (cos a × r, sin a × r) and adds it to the callout anchor. RN (react-native-maps, Apple): put every Marker of the group at the group-centre coordinate with centerOffset (cos a × r, sin a × r); the callout Marker uses the same coordinate plus that offset (added to 036's −65 above or +65 below). Known limit: groups come from real positions only, so a fanned pin (radius r + 18) can overlap a nearby pin or group (rare; zooming in resolves it). Numbered stops on a timeline (qf-map-stop) are merged into one mark instead (MapStop --multi).같은 자리 사람들의 핀을 부채꼴로 벌립니다(044, qufox Den 058 B-32). 모두 집에 있는 밤처럼 핀이 겹치면 맨 위 사람만 보이고 눌리던 것을, 늘 벌려 두어 누르지 않아도 모두 보이고 각자 눌리게 합니다. 묶음: 화면에서 핀 가운데 사이가 --map-fan-gap(44)보다 가까운 핀끼리 이어지면(한 다리 건너도) 한 묶음. 묶음 가운데는 그 사람들 화면 위치의 평균. 자리: n 명을 묶음 가운데를 중심으로 반지름 r = gap / (2 sin(180°/n)) 의 원 위에 둡니다(2명 22, 3명 25.4, 4명 31.1, 5명 37.4, 6명 44, 7명 50.7, 8명 57.5). i 번째(목록 순서, 0부터. "(나)"가 먼저)의 각은 −90° − 180°/n + i × 360°/n(화면 좌표, 위가 −90°): 2명은 왼쪽과 오른쪽, 3명은 위 둘 아래 하나, 4명은 네 모서리. 이웃 핀 가운데 사이가 44라 누르는 영역(44)이 겹치지 않고 선택 고리(바깥 21)도 이웃에 닿지 않습니다. 묶음은 2명부터입니다(혼자면 .qf-map-fan 에 넣지 않거나, 넣어도 CSS 가 가운데에 둠). 9명 이상이 한 자리에 겹치면 벌리지 않고 qf-map-pin--cluster(수)를 두고, 누르면 확대하고 더 확대할 수 없으면 목록 시트로 보냅니다. 다시 정하는 때: 지도 이동이 끝났을 때와 위치가 갱신될 때(036 의 뒤집기를 다시 정하는 때와 같음). 지도 이동이 끝난 뒤 다시 묶을 때는 움직임 없이 자리를 바꿉니다(앱과 웹 모두). 위치 갱신으로 다시 묶어 그려진 자리가 바뀐 핀은 묶음에서 나가는 사람, 남아서 다시 벌려지는 사람, 새로 드는 사람 모두 MapPin 의 옮겨 감(067)으로 함께 미끄러집니다(끝 자리는 다시 묶은 뒤의 자리, 다시 묶기가 끝난 뒤 출발). 한 사람이 집을 나서면 그 핀은 떠나고 남은 핀들이 오므라드는 것이 보입니다. 9명 이상 수 표시에 들고 나는 것과 수 표시 자체는 늘 바로 바꿉니다. 말풍선(036)은 벌린 핀의 그려진 자리에서 열리고, 뒤집기와 지도 옮기기도 그 자리의 y 로 정합니다. 연 동안 그 핀은 --selected 이고 위에 쌓입니다(그 밖은 목록 순서). 오래됨, 멈춤, 사진 핀도 같은 규칙. 웹: 묶음 가운데 좌표에 0×0 의 .qf-map-fan 하나(--qf-fan-n: 명수)를 두고 안에 핀을 넣고 핀마다 --qf-fan-i(0부터). CSS 가 위 식으로 자리를 잡습니다(sin, cos: Safari 15.4, Chrome 111 이상). 핀을 따로 표시로 그리는 지도면 같은 식으로 핀마다 translate 를 줘도 됩니다. 벌린 핀에는 가운데 맞춤 transform(translate(-50%,-50%))을 따로 걸지 않습니다(DS 의 translate 에 −50% 가 들어 있어 두 번 옮겨짐. Den 웹은 .den-pin 의 규칙을 .den-pin > .qf-map-pin 으로 좁힘). 말풍선의 자리는 CSS 가 모르므로 JS 가 같은 식으로 오프셋(cos a × r, sin a × r)을 구해 말풍선 기준점에 더합니다. RN(react-native-maps, Apple): 묶음의 핀 Marker 를 모두 묶음 가운데 좌표에 두고 centerOffset 을 (cos a × r, sin a × r)로. 말풍선 Marker 도 같은 좌표에 그 오프셋을 더합니다(036 의 위 −65, 아래 +65 에 더함). 알려진 한계: 묶음은 실제 위치로만 정하므로, 벌린 뒤의 핀(반지름 r + 18)이 가까운 다른 핀이나 묶음과 겹칠 수 있습니다(드묾, 확대하면 풀림). 타임라인의 머문 곳 번호(qf-map-stop)는 벌리지 않고 한 표시로 합칩니다(MapStop --multi).

.qf-map-fanlayer: generic

Preview

지훈지민엄
<span class="qf-map-fan" style="--qf-fan-n:3;margin:var(--s-10)">
  <span class="qf-map-pin qf-map-pin--duo" role="img" style="--qf-member-color:var(--viz-1);--qf-fan-i:0" aria-label="김지훈, 집, 18:10부터">지훈</span>
  <span class="qf-map-pin qf-map-pin--duo" role="img" style="--qf-member-color:var(--viz-3);--qf-fan-i:1" aria-label="김지민, 집, 18:40부터">지민</span>
  <span class="qf-map-pin" role="img" style="--qf-member-color:var(--viz-5);--qf-fan-i:2" aria-label="엄마, 집, 19:02부터">엄</span>
</span>

Examples예시

JMJMSJMSY
2, 3, 4 people at one spot (one selected)

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--map-fan-gap --sz-map-pin --m-touch --map-move-dur --map-move-ease

Accessibility

Each fanned pin keeps its own MapPin name ("Jihun, Home, since 18:10"). The fan order is the list order, so screen readers read them in the list's order. The group itself gets no name (.qf-map-fan only places).벌린 핀은 각자 MapPin 의 이름("김지훈, 집, 18:10부터")을 그대로 가집니다. 벌린 순서가 목록 순서라 화면 낭독기도 목록과 같은 차례로 읽습니다. 묶음 자체에는 이름을 붙이지 않습니다(.qf-map-fan 은 자리만 잡음).

Display & data

MapCallout

A callout that opens above a member pin (qf-map-pin) when the pin or that person's list row is tapped (036, 050). Name (__name, fs-15 600 text-strong), one status line (__status, fs-13 text-muted, the same words as the list row's second line), and a qf-i-chevron-right (16) at the end. The whole callout is one link or button that opens that person's timeline. bg-elevated, a 2px casing border (--map-casing), --r-lg, --elev-3; the same tokens serve dark and light. Width fits the content up to --sz-map-callout (240); name and status each truncate on one line (no wrapping). Padding 8 top and bottom, 12 left, 8 right; about 58 tall with two lines (at least 44). Placement: the card's bottom edge sits --map-callout-offset (40) above the pin centre, centred. The tail tip is 28 above the pin centre, 7 clear of the selection ring (outer radius 21). Seen from the card's outer edge the tail is a casing triangle 24 wide and 12 tall holding a card-colour triangle 16 wide and 8 tall (45° sides, about 2.8 of casing along them); the tail is tappable too. Flip (--below): when the pin centre's screen y is less than 40 + callout height + 8 (about 106), put the card below the pin (top edge 40 below the centre, tail on top). Measure y within the visible map (top: the map pane's top below the safe area; bottom: the pane's bottom or the top of the app's list sheet); map buttons are not subtracted (the callout may pass under them and they stay on top). When the visible map is so short that it fits neither above nor below, as on the app map, pan the map on open so the pin sits 106 from the top and open it above. Sides: when the card would come within 8 of the map's left or right edge, pan the map by that much (RN animateCamera, MapKit JS setCenterAnimated, Leaflet panBy); the tail always stays centred. These small pans apply when the callout is opened by tapping a pin visible on the map. When it is opened from a list row (a member row, including the list pane on wide screens) or switched to another person that way, keep the zoom level (do not zoom in even when far out) and move that person's pin to the horizontal centre of the visible map (measured as for the flip, the bottom being the top of the sheet) and vertically to max(half the pane height, 106), and always open it above. If the pane is so short that this point lies below the line 26 above the sheet's top, follow the "fits neither above nor below" rule above (the pin at 106 from the top, accepting that the sheet covers it). This puts the chosen person in the middle of the map even when their pin was off screen or at an edge; do the same when the pin is already visible and when the row of the person already chosen is pressed again (a row always takes you to that person and never closes the callout; close with empty map or the same pin). The pin's place is where it is drawn (its fanned spot in MapFan, or the count mark's spot when it is inside a count of nine or more). Do not compute the target by converting between off-screen coordinates and screen points (at high zoom the pin can be far off screen and the conversion may be wrong). Camera centre = pin coordinate + fan offset + (map pane centre − target point); with a sheet the target point is above the pane centre, so the camera centre lies below the pin on screen (to the south). Convert the differences at the current zoom's scale: in RN the coordinateForPoint difference of two on-screen points (animateCamera center), in Leaflet project/unproject at the current zoom (setView), in MapKit JS MapPoint conversion (MapPoints per px = visibleMapRect.size.width ÷ map pane width, setCenterAnimated). Pan only on open and when switching to another person. After the user drags the map or the position updates, do not pan; only re-decide the flip (RN onRegionChangeComplete, MapKit JS region-change-end, Leaflet moveend), and close the callout when the pin leaves the visible map. With reduced motion (iOS, prefers-reduced-motion) pan without animation. Drawing: a separate mark at the pin's coordinate, stacked on top. RN uses its own Marker (zIndex 3, above place 0, stop 1, person 2) drawing a View, not the pin Marker's Callout, with the tail as an SVG triangle or a rotated square. MapKit JS adds the DOM Annotation last (marks stack in the order added, measured in 034). Leaflet uses L.marker with a divIcon in pane popupPane, not L.popup (own chrome and autoPan), with keyboard: false (by default the icon wrapper gets tabindex and role=button, nesting with the link inside), and the divIcon with className '' and iconSize null. For the reference point (40 from the card's bottom centre, or top centre for --below), Den 036 measured the following. On the web, a 0×0 box at the coordinate with the card placed --map-callout-offset from its bottom (top for --below) and translateX(-50%) worked in both web libraries (measured in Den 036: MapKit JS anchorOffset DOMPoint(0, 0), a 0×0 Leaflet divIcon box). The MapKit JS callout Annotation needs enabled: true for the link inside to take taps (the opposite of the background places' enabled: false). In Leaflet, with interactive: false the Leaflet CSS turns off pointer events on the marker (keyboard: false is still needed, since keyboard adds tabindex and role=button), so give the card pointer-events: auto again and stop clicks reaching the map with L.DomEvent.disableClickPropagation. In RN on Apple maps the Marker anchor is not used (Google only), so make the Marker a fixed box (say 240×130), draw the card and tail 40 and 28 from its far edge, and shift it by half with centerOffset (y −65 above, +65 for --below). Start the box with an empty View of the box's size (an iOS Fabric Marker takes its position from its first child's size; see MapPin a11y). Close on a tap on empty map, a second tap on the same pin, or Esc (web); tapping another pin switches to that person. While open, the pin is qf-map-pin--selected, that list row is qf-m-row--selected, and the name label (qf-map-place__name) of the place the person stays at is hidden (a --below callout would cover it, and the status line carries the same name). When the position updates, the callout glides with the pin on the same progress (MapPin move, 067; in the app the coordinate in the floating layer, on the web setPosition of the callout Marker, on the same frame as the pin). The status text, the flip (--below) and closing are decided once, from the new spot, when the glide starts. If the new spot is outside the visible map, close with --leave then and let the pin glide out alone. If the flip changes, switch it at the start (switching midway or at the end makes the card jump once more after the glide). When the pin switches at once (reduced motion and the like), so does the callout. If the pin is tapped mid-glide, the callout opens at the pin's current spot and travels the rest of the way with it; the flip and any pan are decided from the end spot. A position update does not pan the map (below). __where bolds the 'where' of the status line (the place name or district where they stay, or 'moving') at 600 in text-secondary; not on stale, paused or no-position lines. Separate parts with commas, not middle dots ('Home, since 09:30'). Entrance (044): on open it moves in --motion-rise (8) from the pin side (from above for --below) over --dur-enter (220) with --ease-enter (default). To close, add --leave (a --dur-exit 140 fade) and remove it on animationend. When switching people or when the position updates, move the same element and change its text (re-inserting replays the entrance); toggling --below does not replay it. With reduced motion, fade only. It moves with the translate property, so it does not fight the card's translateX(-50%). RN: animate the callout View's opacity 0→1 and translateY (+8→0 above, −8→0 below) over dur-enter with Easing.bezier(...ease-enter); on close fade 1→0 over dur-exit, then remove the Marker. With Reduce Motion, opacity only. Open in Apple Maps (Den 080) does not go in the callout: it is one qf-map-link at the map's bottom-right (069, MapButton). Two-part form (--split, made in 068 and used again in 077): the card (div) is not pressable; __main on top is the usual callout content (name, status, one reason line, chevron; a link to the timeline) and __action below is one visible action line (16 icon + text, accent-text 600, 44 target). The order is __main first even when flipped. Den uses it for "지금 위치 받기" (Get location now, Den 091, 077). Myself, someone not sharing, paused, or with location permission off or 'while using' get the single form without __action (asking would bring no location). __action states: default refresh "지금 위치 받기"; after the press aria-disabled="true" with qf-spinner "위치를 묻는 중" (up to 2 minutes); when the location arrives --done (check, --live) "14:32에 받음" (not pressable until the 2-minute block ends, then back to default); when the server blocks (429) clock "14:34부터 다시 받을 수 있음"; with no answer within 2 minutes the pressable "답이 없음, 다시 받기"; when that phone has no push token (409 no_push) info "이 폰에는 물을 수 없음" (079: pressable, with the hint "다시 묻기"; each time 409 no_push comes back, the first time included, a toast "{이름}님 폰에서 Den을 한 번 열면 위치를 물을 수 있습니다"; for a device member "할머니 폰에서 …" without 님; the text is accent-text 600 like other pressable action lines). When not pressable, aria-disabled="true" gives text-secondary 500 text, no press or hover background, and the tail does not follow. The state is kept per person while the viewer's app runs, so closing and reopening the callout shows the same. 502 push_failed, 503 unavailable and network errors go back to the default with a toast. When the location arrives and the pin is outside the map pane, the map moves to it (the same move as on opening, 036). One reason line __flag (--warn): under the status, 16 icon + fs-13 text (text-secondary; --warn is text-warn with the alert icon, otherwise the info icon), the same words as qf-m-row__flag, one line with ellipsis. The long form (what to do) does not go in the callout but in a qf-notice at the top of that person's timeline for today (a callout over 200 tall does not fit a phone map).지도에서 사람 핀(qf-map-pin)이나 목록의 그 사람 줄을 눌렀을 때 핀 위에 뜨는 말풍선입니다(036, 050). 이름(__name, fs-15 600 text-strong), 상태 한 줄(__status, fs-13 text-muted, 목록 줄 둘째 줄과 같은 말), 오른쪽 qf-i-chevron-right(16). 통째로 링크나 버튼 하나이고 누르면 그 사람의 타임라인으로 갑니다. 바탕 bg-elevated, 테두리 2px casing(--map-casing), --r-lg, --elev-3이고 다크와 라이트가 같은 토큰입니다. 폭은 내용에 맞추되 최대 --sz-map-callout(240), 넘치면 이름과 상태 줄을 각각 한 줄로 말줄임합니다(줄바꿈 없음). 안쪽 여백 위아래 8, 왼쪽 12, 오른쪽 8, 두 줄 높이 약 58(최소 44). 자리: 카드 아래 가장자리가 핀 가운데에서 --map-callout-offset(40) 위, 가운데 맞춤. 꼬리 끝은 핀 가운데에서 28 위로 선택 고리(바깥 반지름 21)와 7 떨어집니다. 꼬리는 카드 바깥 가장자리에서 보아 casing 삼각형 밑변 24 높이 12, 그 안에 카드색 삼각형 밑변 16 높이 8(45° 빗변, 빗변 casing 약 2.8)이고 꼬리도 누를 수 있습니다. 뒤집기(--below): 핀 가운데의 화면 y 가 40 + 말풍선 높이 + 8(약 106)보다 작으면 카드를 핀 아래에 둡니다(위 가장자리가 핀 가운데에서 40 아래, 꼬리가 위). y 는 보이는 지도 칸 기준(위 끝은 safe area 아래 지도 칸의 위, 아래 끝은 지도 칸 아래나 앱 목록 시트의 위 끝)이고 지도 위 버튼은 빼지 않습니다(말풍선이 밑으로 들어가면 버튼이 위에 남음). 앱 지도처럼 보이는 높이가 작아 위아래 어느 쪽에도 들지 않으면 연 순간 지도를 옮겨 핀을 위에서 106 아래로 내리고 위에 띄웁니다. 옆: 카드가 지도 왼쪽, 오른쪽 끝에서 8 안쪽에 들지 않으면 지도를 그만큼 옆으로 옮깁니다(RN animateCamera, MapKit JS setCenterAnimated, Leaflet panBy). 꼬리는 늘 카드 가운데입니다. 위의 조금 옮김은 지도에 보이는 핀을 눌러 열 때입니다. 목록 줄(사람 줄, 넓은 화면의 목록 칸 포함)을 눌러 열거나 다른 사람으로 바꿀 때는 확대 수준을 그대로 두고(더 멀리 있어도 당기지 않음), 그 사람의 핀을 보이는 지도 칸(뒤집기와 같은 기준, 아래 끝은 시트의 위 끝)의 가로 가운데, 세로는 max(칸 높이의 반, 106)에 오게 옮기고 늘 위에 띄웁니다. 칸이 낮아 그 자리가 시트 위 끝보다 26 위인 선보다 아래로 내려가면 위의 "위아래 어느 쪽에도 들지 않음" 규칙을 따릅니다(핀은 위에서 106, 시트에 가려지는 것은 받아들임). 핀이 화면 밖이나 가장자리에 있어도 누른 사람이 지도 가운데에 보이게 하려는 것이고, 핀이 이미 보여도, 이미 고른 사람의 줄을 다시 눌러도 같은 동작입니다(줄은 늘 그 사람에게 데려가고 닫지 않음. 닫기는 지도 빈 곳이나 같은 핀). 핀 자리는 그려진 자리입니다(MapFan 의 벌린 자리, 9명 이상 수 표시에 들었으면 그 표시 자리). 옮길 곳은 화면 밖 좌표와 화면 점을 서로 바꿔 셈하지 않습니다(크게 확대하면 핀이 화면에서 아주 멀어 바꾼 값이 틀릴 수 있음). 카메라 가운데 = 핀 좌표 + 벌린 자리 차이 + (지도 칸 가운데 − 목표 점)이고, 시트가 있으면 목표 점이 지도 칸 가운데보다 위라 카메라 가운데는 핀보다 화면 아래(남쪽)입니다. 차이는 지금 줌의 축척으로 바꿉니다: RN 은 화면 안 두 점의 coordinateForPoint 차이(animateCamera center), Leaflet 은 project/unproject(지금 줌, setView), MapKit JS 는 MapPoint 변환(px 당 MapPoint = visibleMapRect.size.width ÷ 지도 칸 폭, setCenterAnimated). 지도를 옮기는 것은 열 때와 다른 사람으로 바꿀 때뿐입니다. 사용자가 지도를 끈 뒤나 위치 갱신 뒤에는 옮기지 않고 뒤집기만 다시 정하며(RN onRegionChangeComplete, MapKit JS region-change-end, Leaflet moveend), 핀이 보이는 지도 칸 밖으로 나가면 닫습니다. 동작 줄이기(iOS, prefers-reduced-motion)면 애니메이션 없이 옮깁니다. 그리기: 사람 핀과 같은 좌표에 따로 하나의 표시로 두고 맨 위에 쌓습니다. RN 은 핀 Marker 의 Callout 이 아닌 별도 Marker(zIndex 3, 장소 0, 머문 곳 1, 사람 2 위)에 View 로 그리고 꼬리는 SVG 삼각형이나 회전한 네모로. MapKit JS 는 DOM Annotation 을 가장 나중에 더합니다(더한 순서로 쌓임, 034 실측). Leaflet 은 L.popup(자체 틀과 autoPan)이 아니라 L.marker + divIcon 을 pane popupPane 에 두고 keyboard: false(기본 true 면 아이콘 래퍼가 tabindex 와 role=button 을 얻어 안의 링크와 겹침), divIcon 은 className '' 와 iconSize null. 기준점(카드 아래 가운데에서 40, --below 는 위 가운데에서 40)은 Den 036 실측으로 다음이 맞았습니다. 웹은 좌표에 0×0 상자를 두고 카드를 그 상자에서 bottom(--below 면 top) --map-callout-offset, translateX(-50%) 에 놓는 방식이 웹 두 라이브러리에서 맞았습니다(Den 036 실측: MapKit JS anchorOffset DOMPoint(0, 0), Leaflet divIcon 의 0×0 상자). MapKit JS 말풍선 Annotation 은 enabled: true 여야 안의 링크가 눌립니다(배경 장소의 enabled: false 와 반대). Leaflet 은 interactive: false 로 두면 Leaflet CSS 가 표시의 누름을 끄므로(그래도 keyboard: false 는 따로 필요, keyboard 가 tabindex 와 role=button 을 붙임) 카드에 pointer-events: auto 를 다시 주고 L.DomEvent.disableClickPropagation 으로 지도 클릭으로 새지 않게 합니다. RN(Apple 지도)은 Marker anchor 가 쓰이지 않으므로(Google 전용) 고정 상자(예: 240×130)를 Marker 로 두고 카드와 꼬리를 상자의 먼 끝에서 40, 28 자리에 그린 뒤 centerOffset 으로 상자 반을 옮깁니다(위는 y −65, --below 는 +65). 상자 맨 앞에는 상자 크기의 빈 View 를 둡니다(iOS Fabric Marker 는 첫 자식의 크기로 자리를 잡음, MapPin a11y). 닫기: 지도 빈 곳, 같은 핀 다시 누르기, Esc(웹). 다른 핀을 누르면 그 사람으로 바뀝니다. 열린 동안 핀은 qf-map-pin--selected, 목록의 그 줄은 qf-m-row--selected 이고, 그 사람이 머무는 장소의 이름표(qf-map-place__name)는 숨깁니다(--below 말풍선이 덮고, 상태 줄에 같은 이름이 있음). 위치가 갱신되면 말풍선도 핀과 같은 진행값으로 함께 미끄러집니다(MapPin 옮겨 감, 067. 앱은 떠 있는 층의 좌표, 웹은 말풍선 Marker 의 setPosition 을 핀과 같은 프레임에). 상태 줄 글, 뒤집기(--below), 닫기는 옮기기 시작할 때 새 자리로 한 번 정합니다. 새 자리가 보이는 지도 칸 밖이면 그때 --leave 로 닫고 핀만 계속 미끄러져 나갑니다. 뒤집기가 바뀌면 시작할 때 바꿉니다(도중이나 끝에 바꾸면 미끄러진 뒤에 카드가 한 번 더 튐). 핀이 바로 바뀌는 때(동작 줄이기 등)는 말풍선도 바로 옮깁니다. 옮기는 중에 핀을 눌러 열면 말풍선은 핀의 지금 자리에서 열려 남은 길을 함께 가고, 뒤집기와 지도 옮김은 끝 자리로 정합니다. 위치 갱신으로는 지도를 옮기지 않습니다(아래). __where 는 상태 줄의 '어디'(머문 장소 이름이나 동, '이동 중')를 600 text-secondary 로 굵게 합니다. 오래된 위치, 멈춤, 위치 없음 줄에는 걸지 않습니다. 줄 안의 나눔은 가운뎃점이 아닌 쉼표('집, 09:30부터'). 나타남(044): 열 때 핀 쪽에서 --motion-rise(8) 옮겨 오며(--below 는 위에서) --dur-enter(220) --ease-enter 로 나타납니다(기본). 닫을 때는 --leave(--dur-exit 140 페이드)를 걸고 animationend 에서 지웁니다. 다른 사람으로 바꾸거나 위치가 갱신될 때는 같은 요소를 옮기고 글만 바꿉니다(새로 넣으면 다시 나타남). --below 를 바꿔도 다시 나타나지 않습니다. 동작 줄이기에서는 옮김 없이 페이드만. translate 속성으로 옮겨 카드의 translateX(-50%)와 겹치지 않습니다. RN: 말풍선 View 에 opacity 0→1 과 translateY(위면 +8 → 0, 아래면 −8 → 0)를 dur-enter, Easing.bezier(...ease-enter). 닫을 때 opacity 1→0 dur-exit 뒤 Marker 를 뺍니다. 동작 줄이기면 opacity 만. Apple 지도에서 열기(Den 080)는 말풍선에 두지 않고 지도 오른쪽 아래의 qf-map-link 하나로 둡니다(069, MapButton). 두 칸 꼴(--split, 068 에서 만들고 077 에서 다시 씀): 카드(div)는 누를 수 없고, 위 __main 은 지금 말풍선의 내용(이름, 상태, 까닭 한 줄, ›, 누르면 타임라인)인 링크, 아래 __action 은 글이 보이는 할 일 한 줄(아이콘 16 + 글, accent-text 600, 누르는 곳 44)입니다. 차례는 위아래로 뒤집혀도 __main 먼저입니다. Den 은 이것을 "지금 위치 받기"(Den 091, 077)에 씁니다. 나 자신, 공유 안 함, 잠시 멈춤, 위치 권한 꺼짐과 '앱 사용 중'인 사람에게는 __action 을 두지 않고 한 칸 꼴입니다(물어도 위치가 오지 않음). __action 의 상태: 기본 refresh "지금 위치 받기", 누른 뒤 aria-disabled="true" 에 qf-spinner "위치를 묻는 중"(최대 2분), 받으면 --done(check, --live) "14:32에 받음"(2분 막힘이 끝날 때까지 누를 수 없음, 그 뒤 기본으로), 서버가 막으면(429) clock "14:34부터 다시 받을 수 있음", 2분 안에 답이 없으면 누를 수 있는 "답이 없음, 다시 받기", 그 폰에 푸시 토큰이 없으면(409 no_push) info "이 폰에는 물을 수 없음"(079: 누를 수 있음, 힌트 "다시 묻기". 409 no_push 를 받을 때마다, 처음도, 토스트 "{이름}님 폰에서 Den을 한 번 열면 위치를 물을 수 있습니다". 기기 구성원은 "할머니 폰에서 …"로 님 없이. 글은 다른 누를 수 있는 할 일 줄처럼 accent-text 600). 누를 수 없을 때는 aria-disabled="true" 로 글 text-secondary 500, 누름과 hover 바탕이 없고 꼬리 색도 따라가지 않습니다. 상태는 사람마다 보는 사람의 앱이 켜져 있는 동안 기억해 말풍선을 닫았다 열어도 같습니다. 502 push_failed, 503 unavailable, 망 오류는 기본으로 돌아가고 토스트로 알립니다. 받으면 핀이 지도 칸 밖이면 지도를 핀으로 옮깁니다(036 의 연 때와 같은 옮김). 까닭 한 줄 __flag(--warn): 상태 줄 아래 아이콘 16 + 글 fs-13(text-secondary, --warn 은 text-warn 과 alert 아이콘, 보통은 info 아이콘), 목록 줄의 qf-m-row__flag 와 같은 말이고 한 줄로 말줄임합니다. 긴 꼴(무엇을 하면 되는지)은 말풍선에 두지 않고 그 사람의 타임라인 오늘 목록 맨 위 qf-notice 에 둡니다(말풍선이 200 을 넘으면 폰 지도에 들지 않음).

.qf-map-calloutlayer: generic

Preview

<a class="qf-map-callout" href="#" aria-label="김지훈, 집, 09:30부터">
  <span class="qf-map-callout__body">
    <span class="qf-map-callout__name">김지훈</span>
    <span class="qf-map-callout__status">
      <span class="qf-map-callout__where">집</span>
      , 09:30부터
    </span>
  </span>
  <svg class="qf-icon" aria-hidden="true">
    <use href="#qf-i-chevron-right"/>
  </svg>
</a>

Examples예시

핀 위(기본): 머무는 곳
핀 아래(--below, 지도 위쪽 끝): 이동 중
긴 이름과 오래된 위치(말줄임, __where 없음)
민지학교, 08:09부터
077 지금 위치 받기: 기본
민지학교, 08:09부터
077 묻는 중(aria-disabled, 스피너)
077 받음(--done, 2분 막힘이 끝날 때까지)
077 까닭 한 줄(--warn)과 답 없음 뒤

Variants

qf-map-callout--below qf-map-callout__body qf-map-callout__name qf-map-callout__status qf-map-callout__where qf-map-callout--leave qf-map-callout--split qf-map-callout__main qf-map-callout__action qf-map-callout__action--done qf-map-callout__flag qf-map-callout__flag--warn

Required tokens

--sz-map-callout --map-callout-offset --map-casing --map-casing-w --bg-elevated --bg-hover --text-strong --text-secondary --text-muted --m-touch --r-lg --elev-3 --ring-focus --s-3 --s-4 --s-5 --fs-13 --fs-15 --lh-snug --font-sans --dur-enter --dur-exit --ease-enter --ease-exit --motion-rise --map-move-dur --map-move-ease --live --text-warn --accent-text --border-grouped --s-1 --s-2

Accessibility

The callout is one link (web <a href>) or button (RN accessibilityRole="button"). Set its name explicitly with aria-label (web) or accessibilityLabel (RN), like "Jihun, Home, since 09:30" (the visible text alone has no comma after the name and reads "Jihun Home, since 09:30"). The chevron is aria-hidden; RN adds accessibilityHint "Open timeline". Opening is not announced (it is the result of the tap). In RN move VoiceOver focus to the callout on open with AccessibilityInfo.setAccessibilityFocus, and check on a device that it works for a View inside a react-native-maps Marker. On the web do not move focus on open. The callout lives in the map DOM, so Tab is not guaranteed to reach it; the keyboard route is the list row (activating it pans the map and shows the same selection) and the Timeline tab. Esc closes the callout wherever focus is, and returns focus to where it was opened (pin or list row) if focus was inside the callout. Measure in MapKit JS that a tap inside the callout does not leak out as an empty-map tap that closes it. At least 44 tall. Contrast: name text-strong, status and chevron text-muted (AA on bg-elevated); on hover and press (bg-hover) they rise to text-secondary (light muted is 4.48 on bg-hover). Get location now (077): __action is a button, and when not pressable it is aria-disabled="true", not disabled, so focus stays (its name says the state). While not pressable the consumer ignores presses in its handler, and RN also sets accessibilityState.disabled. The result is read once: "민지님 위치를 14:32에 받았습니다", "민지님 폰이 답하지 않았습니다", "14:34부터 다시 받을 수 있습니다" (RN announceForAccessibility, a hidden role=status region on the web; cannot-ask has no announcement of its own, the toast is read, 079), because VoiceOver does not reread a button whose name changed after the press. The reason line is read after the name ("민지, 3시간 전, 집에서, 폰이 답하지 않음").말풍선은 하나의 링크(웹 <a href>) 또는 버튼(RN accessibilityRole="button")입니다. 이름은 aria-label(웹)이나 accessibilityLabel(RN)로 "김지훈, 집, 09:30부터" 처럼 명시합니다(보이는 글만으로는 이름 뒤 쉼표가 없어 "김지훈 집, 09:30부터"로 읽힘). ›는 aria-hidden, RN 은 accessibilityHint "타임라인 열기". 열 때 화면 낭독기에 따로 알리지 않습니다(방금 누른 결과). RN 은 열 때 AccessibilityInfo.setAccessibilityFocus 로 VoiceOver 초점을 말풍선에 옮기고, react-native-maps Marker 안 View 에서 되는지 실기기로 확인합니다. 웹은 열 때 포커스를 옮기지 않습니다. 말풍선은 지도 DOM 안에 있어 Tab 으로 닿는다는 보장이 없으므로 키보드 길은 목록 줄(줄을 누르면 지도를 옮기고 같은 선택을 보임)과 위 막대 '타임라인'입니다. Esc 는 포커스가 화면 어디에 있든 말풍선을 닫고, 포커스가 말풍선 안에 있었으면 연 곳(핀이나 목록 줄)으로 돌려보냅니다. MapKit JS 에서 말풍선 안 누름이 지도 '빈 곳 누름'으로 새어 닫히지 않는지 실측합니다. 높이 44 이상. 대비: 이름 text-strong, 상태와 › text-muted(bg-elevated 위 AA), hover와 누름(bg-hover)에서는 상태와 ›를 text-secondary 로 올립니다(라이트 muted 는 bg-hover 위 4.48). 지금 위치 받기(077): __action 은 button 이고 누를 수 없을 때 disabled 가 아니라 aria-disabled="true" 라 포커스가 남습니다(이름이 상태를 말함). 누를 수 없는 동안 소비처는 처리기에서 누름을 무시하고, RN 은 accessibilityState.disabled 도 줍니다. 결과는 한 번 읽어 줍니다: "민지님 위치를 14:32에 받았습니다", "민지님 폰이 답하지 않았습니다", "14:34부터 다시 받을 수 있습니다"(RN announceForAccessibility, 웹 role=status 숨은 칸). 물을 수 없음은 따로 알리지 않고 토스트가 읽힙니다(079). 누른 뒤 단추 이름만 바뀌면 VoiceOver 가 다시 읽지 않기 때문입니다. 까닭 한 줄은 이름에 이어 읽습니다("민지, 3시간 전, 집에서, 폰이 답하지 않음").

Display & data

MapStop

A stay marker on a map: a 20px numbered disc (same order as the list), accent-solid with text-onAccent, 2px casing. --selected scales to 1.3 with the focus ring (background unchanged — on a-500 the white number would fail AA), --live is the current stay (--live fill, bg-app digit), --muted is another day or person (hollow: bg-elevated, text-muted digit, --map-route-muted border). Route lines use the tokens --map-route and --map-route-w (selected: --map-route-w-selected). Selected move (051): when one move is selected on the timeline, draw its line in --map-route at --map-route-w-selected with its casing, above every other line. Drawing order: on every map, bring the selected move's casing up first and then its line, on top. RN on Apple maps draws overlays in the order they are added (Polyline zIndex is Google only), so put the selected move last among the children and change its key when the selection changes so it is added again. RN on Google maps uses zIndex: casing N+1, line N+2. Leaflet calls bringToFront on the casing, then the line; MapKit JS removes both when the selection changes and adds the casing, then the line, again. Draw every other line in --map-route-muted at --map-route-w, keeping the casing. Do not dim with opacity (overlapping lines would grow stronger where they cross, and the tiles would show through and shift the colour). Contrast: the selected line is 5.55 (dark) and 5.31 (light) against the casing; the muted lines are 3.57 (dark) and 2.44 (light; 2.26 on the light tiles), deliberately weak context lines (the line needed to read the content is the selected one, told apart by width as well, 6 against 4). Leave the stop marks as they are (their numbers point to list order, so they are not dimmed, and the selected line joining its two end stops is enough). Selecting a stop clears the move selection, so every line returns to --map-route (the selected stop shows itself with --selected); clearing the selection does the same. Lines of other days or other people stay --map-route-muted regardless of the selection (while a move is selected they share the colour of the same day's muted lines; the timeline map draws one day and one person today, so revisit this if both ever appear on one screen). Several stays at one spot (044; the first and last stops at home): stop marks whose screen centres are closer than 24 (20 + 2×2 casing) merge into one showing the numbers with commas, "1,5" (--multi, a pill), at the mean position. --selected when one of them is selected, --live when one is the current stay, --muted when all are another day or person. A tap selects the earliest stay in it not yet selected, the next tap the next one, and after the last it clears the selection, the same as tapping list rows. They are not fanned like people because the numbers point at list order and read better together. --live follows the MapPin staleness decision (044, 062): when the phone's last contact is past the threshold, the current stay drops --live and shows as a plain numbered stop (so the map does not say "now" while the timeline row says "Last contact 5 h ago").지도 위 머문 곳 표시입니다. 20px 원에 순서 번호(목록의 순서와 같음), accent-solid 채움에 text-onAccent 글자, 2px casing. --selected 는 1.3배 + 포커스 링(배경은 그대로 — a-500 이면 흰 번호가 AA 미달), --live 는 지금 머무는 곳(--live 배경 + bg-app 글자), --muted 는 선택되지 않은 날이나 다른 사람(속 빈 표시: bg-elevated + text-muted 번호 + --map-route-muted 테두리). 경로 선은 토큰 --map-route(굵기 --map-route-w, 선택 --map-route-w-selected)로 그립니다. 고른 이동 구간(051): 타임라인에서 이동 구간 하나를 고르면 그 선은 --map-route 를 --map-route-w-selected 굵기로, casing 과 함께 모든 선 위에 그립니다. 그리는 차례: 어느 지도든 고른 구간의 casing 을 먼저, 그 선을 나중에 맨 위로 올립니다. RN 의 Apple 지도는 overlay 를 더한 차례로 그리므로(Polyline zIndex 는 Google 전용) 고른 구간을 children 맨 뒤에 두고, 고름이 바뀔 때 key 를 바꿔 다시 더합니다. RN 의 Google 지도는 zIndex 로 casing N+1, 선 N+2 입니다. Leaflet 은 casing, 선 차례로 bringToFront, MapKit JS 는 고름이 바뀔 때 둘을 지우고 casing, 선 차례로 다시 더합니다. 고르지 않은 나머지 선은 모두 --map-route-muted, 굵기 --map-route-w 로 그리고 casing 은 그대로 둡니다. 투명도로 흐리게 하지 않습니다(선이 겹치는 곳이 더 진하거나 밝아지고, 타일이 비쳐 바탕마다 색이 달라짐). 대비: 고른 선은 casing 위 다크 5.55, 라이트 5.31 이고, 흐린 선은 casing 위 다크 3.57, 라이트 2.44(라이트 타일 위 2.26) 로 일부러 약하게 둔 맥락 선입니다(내용을 읽는 데 필요한 선은 고른 선, 색에 더해 굵기 6 대 4 로도 갈림). 머문 곳 표시는 그대로 둡니다(번호가 목록 순서를 가리키는 표시라 흐리지 않고, 고른 선이 양 끝 머묾을 잇는 것으로 충분). 머묾을 고르면 이동 고름이 풀리므로 모든 선이 --map-route 로 돌아갑니다(고른 머묾은 --selected 가 드러냄). 고름을 풀어도 같습니다. 다른 날이나 다른 사람의 선은 고름과 상관없이 --map-route-muted 입니다(이동을 고른 동안에는 같은 날의 흐린 선과 같은 색. 지금 타임라인 지도는 하루, 한 사람만 그리므로 둘이 한 화면에 함께 나오게 되면 다시 정함). 같은 자리의 머묾 여럿(044, 첫 정류장과 마지막 정류장이 집): 화면에서 가운데 사이가 24(지름 20 + casing 2×2)보다 가까운 머묾 표시는 하나로 합쳐 번호를 쉼표로 "1,5"(--multi, 알약 모양)로 씁니다. 자리는 평균. 그중 하나가 골라졌으면 --selected, 지금 머무는 곳이 있으면 --live, 모두 다른 날이나 다른 사람이면 --muted. 누르면 그 묶음에서 아직 고르지 않은 가장 이른 머묾을 고르고, 다시 누르면 다음, 마지막 다음은 고름을 풉니다. 목록 줄을 누른 것과 같습니다. 사람 핀처럼 벌리지 않는 것은 번호가 목록 순서를 가리키는 작은 표시라 묶어 읽는 편이 낫기 때문입니다. --live 는 MapPin 의 오래됨 판단(044, 062)을 따릅니다: 그 폰의 마지막 연락이 기준을 넘으면 지금 머무는 곳도 --live 를 떼고 보통 번호 표시로 둡니다(타임라인 줄이 "마지막 연락 5시간 전"일 때 지도가 "지금"이라 하지 않게).

.qf-map-stoplayer: generic

Preview

1
<span class="qf-map-stop">1</span>

Examples예시

1 2 3 4
All states: default, selected, live, muted
1,5 2,4 1,6
044 Merged stays at one spot (--multi): default, selected, live

Variants

1
qf-map-stop--selected
1
qf-map-stop--live
1
qf-map-stop--muted
1
qf-map-stop--multi

Required tokens

--sz-map-stop --map-casing --map-casing-w --map-route --map-route-w --map-route-w-selected --map-route-muted --map-accuracy-fill --map-accuracy-stroke --accent --accent-solid --text-onAccent --text-strong --live --fs-11 --font-sans --elev-1 --ring-focus --r-pill --bg-app --bg-elevated --text-muted --s-2 --tracking-tight

Accessibility

Numbers match the list rows; name the marker "stop 3, academy, 15:02–16:48". Selection is size and ring; the live stop is --live plus the wording in the list. The accuracy circle is decorative. RN (iOS, Fabric): start the marker view with an empty box of its size (the Marker takes its position from the first child's size; see MapPin a11y). Name a merged mark with all its numbers, "stops 1 and 5, Home".번호는 목록 줄 번호와 같아 "3번 머문 곳, ○○학원, 15:02–16:48" 로 이름 붙입니다. 선택은 크기와 링으로, 진행 중은 --live 색 + 목록의 글자로. 정확도 원(--map-accuracy-*)은 장식이라 이름을 붙이지 않습니다. RN(iOS, Fabric): 마커 뷰 맨 앞에 뷰 크기의 빈 상자를 둡니다(첫 자식의 크기로 자리를 잡음, MapPin a11y). 합친 표시는 "1번과 5번 머문 곳, 집" 처럼 번호를 모두 이름에 넣습니다.

Display & data

MapPlace

The centre mark of a registered place (home, school) on a map: a 28px rounded square with the place icon (qf-i-place), border and icon in --map-place (info blue), 2px casing. People (qf-map-pin) are circles, places are squares. __name is a label pill below (bg-elevated, truncated past 160px) that takes no space, so the anchor stays the square's centre. --muted is another place shown alongside (faint border, text-muted icon). The same look is used when a group's places are laid under the pins on the family and timeline maps (034). --editing is the place being edited (32px, filled blue, lifted shadow). The radius circle is drawn by the map library with tokens: editing stroke --map-place at --map-place-w (2) with --map-place-fill, other places --map-place-muted with --map-place-muted-fill. It differs from the accuracy circle (violet, 1px) in hue and weight, and sits below routes and markers. qf-map-center pins its child to the middle of the map pane: put the editing mark there and move the map to set the centre (a tap on the map pans to that point). RN: Circle strokeWidth size["map-place-w"]; the fixed centre is a pointerEvents="none" View over the map, and the centre coordinate comes from onRegionChangeComplete. Under a white-label brand whose accent is blue (ocean), the accuracy circle and routes come close to the place colour; weight and mark shape still tell them apart. Background place layer (034). Stacking: overlays go place circle < accuracy circle < route, marks go place < stop (qf-map-stop) < person (qf-map-pin). Apple maps (react-native-maps, MapKit JS) always draw overlays below marks, so place marks sit above routes; being --muted, that is acceptable (only Leaflet can put them under routes, in a pane below zIndex 400). Set the order between marks explicitly: RN Marker zIndex (place 0, stop 1, person 2), Leaflet zIndexOffset or a pane; for MapKit JS measure and decide. Scale rule, per place, by the circle's on-screen diameter (2 × radius ÷ metres per point): above the mark size (--sz-map-place, 28) show circle, mark and name; at 28 or below hide the circle and the name and keep the mark (the circle hides behind the mark anyway, and names collide); beyond 40 m per point (city scale, about 16 km across 390 pt) hide the whole layer. Metres per point: RN latitudeDelta × 111,320 ÷ map height (onLayout); MapKit JS region.span.longitudeDelta × 111,320 × cos(latitude) ÷ map width; Leaflet 40,075,016.686 × cos(latitude) ÷ (256 × 2^zoom). Decide once when the map stops moving (RN onRegionChangeComplete, MapKit JS region-change-end, Leaflet moveend) so nothing flickers at the threshold.지도 위 등록 장소(집, 학교 등)의 가운데 표시입니다. 28px 둥근 네모에 장소 아이콘(qf-i-place), 테두리와 아이콘은 --map-place(info 파랑), 2px casing. 사람(qf-map-pin)은 원, 장소는 네모라 모양으로 갈립니다. __name 은 아래에 붙는 이름표(bg-elevated 알약, 160px 넘으면 말줄임)이고 자리를 차지하지 않아 기준점은 늘 네모의 가운데입니다. --muted 는 같이 보이는 다른 장소(옅은 테두리, text-muted 아이콘)입니다. 가족과 타임라인 지도에 그룹 장소를 사람 핀 아래 배경으로 깔 때도 같은 모양을 씁니다(034). --editing 은 고치는 중인 장소(32px, 채운 파랑, 떠 있는 그림자). 반경 원은 지도 라이브러리가 토큰으로 그립니다: 편집 중 테두리 --map-place 굵기 --map-place-w(2) + 채움 --map-place-fill, 다른 장소 --map-place-muted + --map-place-muted-fill. 정확도 원(보라 1px)과 색, 굵기가 다르고, 원은 경로 선과 표시 아래에 둡니다. qf-map-center 는 지도 칸 한가운데에 고정하는 자리로, 편집 중 표시를 넣고 지도를 움직여 가운데를 맞춥니다(지도를 누르면 그 점으로 지도가 옮겨 갑니다). RN: Circle strokeWidth size["map-place-w"], 가운데 고정은 지도 위 pointerEvents="none" View, 가운데 좌표는 onRegionChangeComplete 에서 읽습니다. 화이트라벨에서 accent 가 파랑(ocean 등)이면 정확도 원, 경로와 장소 색이 가까워지므로 굵기와 표시 모양으로 갈립니다. 배경 장소 층(034). 쌓는 순서: 오버레이는 장소 원 < 정확도 원 < 경로, 표시는 장소 < 머문 곳(qf-map-stop) < 사람(qf-map-pin). Apple 지도(react-native-maps, MapKit JS)는 오버레이를 늘 표시 아래에 그려 장소 표시가 경로 위에 놓이지만, --muted 라 받아들입니다(Leaflet 만 zIndex 400 아래 pane 으로 경로 밑에 둘 수 있음). 표시끼리의 순서는 명시합니다: RN Marker zIndex(장소 0, 머문 곳 1, 사람 2), Leaflet zIndexOffset 이나 pane, MapKit JS 는 실측해 정합니다. 축척 규칙은 장소마다 화면 위 원 지름(2 × 반경 ÷ 1pt 당 미터)으로 정합니다: 표시(--sz-map-place, 28)보다 크면 원, 표시, 이름; 28 이하이면 원과 이름을 숨기고 표시만(원은 어차피 표시 뒤에 숨고 이름끼리 겹침); 1pt 당 40m 를 넘으면(도시 단위, 폭 390pt 에 약 16km) 층 전체를 숨깁니다. 1pt 당 미터: RN latitudeDelta × 111,320 ÷ 지도 높이(onLayout), MapKit JS region.span.longitudeDelta × 111,320 × cos(위도) ÷ 지도 폭, Leaflet 40,075,016.686 × cos(위도) ÷ (256 × 2^zoom). 경계에서 깜빡이지 않게 지도 이동이 끝났을 때(RN onRegionChangeComplete, MapKit JS region-change-end, Leaflet moveend) 한 번 정합니다.

.qf-map-placelayer: generic

Preview

<div style="display:flex;align-items:center;gap:var(--s-12);padding:var(--s-2) var(--s-10) var(--s-9)">
  <span class="qf-map-place" role="img" aria-label="School, radius 300 m">
    <svg class="qf-icon" aria-hidden="true">
      <use href="#qf-i-place"/>
    </svg>
    <span class="qf-map-place__name" aria-hidden="true">School</span>
  </span>
</div>

Examples예시

Default, muted, editing

Variants

qf-map-place--muted
qf-map-place--editing

Parts & more: 구성 요소, 기타: qf-map-place__name qf-map-center

Required tokens

--sz-map-place --sz-map-pin --sz-map-label --map-place --map-place-w --map-place-fill --map-place-muted --map-place-muted-fill --map-casing --map-casing-w --bg-elevated --bg-app --text-strong --text-secondary --text-muted --r-md --r-pill --s-1 --s-2 --s-3 --s-5 --s-6 --fs-12 --lh-snug --font-sans --elev-1 --elev-3 --z-sticky

Accessibility

In the editor, give the mark role="img" and a name with the radius ("Grandma's, radius 150 m"); the radius circle is decorative. The editing mark is not dragged — the map moves under it (dragging a small mark fails 44pt targets and keyboard use); put a line such as "Move the map to set the centre" and a "Locate me" button under the map, and keep the web map keyboard-pannable (Leaflet keyboard). Label text sits on bg-elevated (AA on any tile); border and icon meet 3:1 for graphics. Exception: the background place layer on the family and timeline maps (034) is decorative. The family and timeline rows (qf-m-tl__name--place) name a place when someone is there, and with up to 50 places a stop at each would bury the people. Web: Leaflet marks and circles interactive: false, marks keyboard: false (the default true adds a tabindex, which with aria-hidden gives a focus stop that reads nothing); MapKit JS Annotation and Overlay enabled: false; the mark DOM aria-hidden="true". RN (iOS): on the Marker itself accessible={false} plus accessibilityElementsHidden (aria-hidden on RN 0.71+), no onPress, child View pointerEvents="none". On iOS the annotation view itself is the selection and accessibility target, so this alone is not guaranteed; what actually protects taps is putting people and stops above by zIndex. Check on a device that a tap near a place mark still selects the person's pin and that VoiceOver does not stop on place marks. RN (iOS, Fabric): start the marker view with an empty box of its size (the Marker takes its position from the first child's size; see MapPin a11y).편집기에서 표시에는 role="img" 와 장소 이름, 반경을 이름으로 붙입니다("할머니 댁, 반경 150m"). 반경 원은 장식입니다. 편집 중 표시는 지도를 움직여 맞추므로 끌기 대상이 아니고(작은 표시를 끄는 것은 44pt 와 키보드를 지킬 수 없음), 지도 아래에 "지도를 움직여 가운데를 맞추세요" 같은 글과 "내 위치로" 버튼을 둡니다. 웹 지도는 화살표 키로 움직일 수 있어야 합니다(Leaflet keyboard). 이름표 글자는 bg-elevated 위 text-strong/secondary 라 타일과 상관없이 AA, 테두리와 아이콘은 그래픽 3:1 입니다. 단, 가족과 타임라인의 배경 장소 층(034)은 예외로 장식입니다. 사람이 있는 장소는 가족 줄과 타임라인 줄(qf-m-tl__name--place)이 이름을 전하고, 50곳까지 있을 수 있어 장소마다 멈추면 사람을 찾기 어렵습니다. 웹: Leaflet 표시와 원은 interactive: false, 표시는 keyboard: false(기본 true 는 tabindex 를 붙여, aria-hidden 과 함께면 읽히지 않는 포커스가 생김), MapKit JS Annotation 과 Overlay 는 enabled: false, 표시 DOM 은 aria-hidden="true". RN(iOS): Marker 자체에 accessible={false} + accessibilityElementsHidden(RN 0.71 이상 aria-hidden), onPress 없음, 자식 View pointerEvents="none". 다만 iOS 에서는 annotation view 자체가 선택과 접근성 대상이라 이것만으로 막힌다는 보장이 없습니다. 사람과 머문 곳을 zIndex 로 위에 두는 것이 실제로 누름을 지키고, 실기기에서 "장소 표시 근처를 눌러도 사람 핀이 눌린다", "VoiceOver 가 장소 표시에 멈추지 않는다"를 확인합니다. RN(iOS, Fabric): 마커 뷰 맨 앞에 뷰 크기의 빈 상자를 둡니다(첫 자식의 크기로 자리를 잡음, MapPin a11y).

Display & data

Battery

A battery indicator: a 16×8 cell filled by --qf-battery (0..1) with the number beside it. --low (<20%) uses --text-danger, --charging uses --live and a bolt icon.배터리 잔량 표시입니다. 셀(16×8) 안을 --qf-battery(0~1)만큼 채우고 숫자를 함께 둡니다. --low(20% 미만)는 --text-danger, --charging 은 --live 와 번개 아이콘.

.qf-batterylayer: generic

Preview

72%
<span class="qf-battery" role="img" aria-label="Battery 72%">
  <span class="qf-battery__cell" style="--qf-battery:.72" aria-hidden="true">
  </span>
  72%
</span>

Examples예시

72% 14% 55%
All states: normal, low, charging

Variants

72%
qf-battery--low
72%
qf-battery--charging

Parts & more: 구성 요소, 기타: qf-battery__cell

Required tokens

--s-1 --s-3 --s-4 --s-5 --fs-12 --font-sans --text-muted --text-danger --live --r-xs

Accessibility

The number carries the value, not the fill or color. Name it "battery 18%, charging"; the cell drawing is aria-hidden.숫자가 있어 색·채움에 기대지 않습니다. 접근 가능한 이름은 "배터리 18%, 충전 중" 처럼 상태를 말로. 셀 그림은 aria-hidden.

Display & data

OtpDisplay

Shows a short code people read out or show to someone (an invite or device-pairing code) in large type: 32px monospace in groups of three with the remaining time below. --expiring warns the time is nearly up; --expired strikes the code through. Copy and share live in buttons beside it. For entry use qf-otp-input.초대 번호·기기 연결 번호처럼 남에게 불러 주거나 보여 줄 짧은 번호를 크게 보여 주는 표시입니다. 32px 고정폭 글자를 3+3 으로 묶고 아래에 남은 시간. --expiring 은 곧 끝남(경고색 시간), --expired 는 끝남(취소선 + 위험색). 복사·공유는 옆의 버튼(CopyButton, 공유 시트)으로. 입력은 qf-otp-input.

.qf-otp-displaylayer: generic

Preview

23 h 41 min left
<div class="qf-otp-display">
  <div class="qf-otp-display__code" role="img" aria-label="Invite code K 7 M, 4 Q 9">
    <span class="qf-otp-display__group" aria-hidden="true">K7M</span>
    <span class="qf-otp-display__group" aria-hidden="true">4Q9</span>
  </div>
  <div class="qf-otp-display__timer">23 h 41 min left</div>
</div>

Examples예시

8 min left
--expiring (under an hour)
Expired. Make a new code.
--expired

Variants

23 h 41 min left
qf-otp-display--expiring
23 h 41 min left
qf-otp-display--expired

Parts & more: 구성 요소, 기타: qf-otp-display__code qf-otp-display__group qf-otp-display__timer

Required tokens

--s-3 --s-4 --s-5 --s-6 --r-lg --bg-panel --fs-13 --fs-32 --font-mono --font-sans --lh-normal --text-strong --text-muted --text-warn --text-danger --text-disabled --tracking-code

Accessibility

Give the code box role="img" with a spaced-out aria-label ("invite code K 7 M, 4 Q 9") and hide the groups (aria-hidden): aria-label on a generic div is ignored (ARIA 1.2). Keep the countdown out of live regions; announce expiry once with role="alert". Codes exclude confusable characters (0/O, 1/I/L). The code is user-select: all.번호 상자에 role="img" + 띄어 쓴 aria-label("초대 번호 K 7 M, 4 Q 9")을 주고 안의 묶음은 aria-hidden — 역할 없는 div 에 aria-label 을 주면 무시됩니다(ARIA 1.2). 남은 시간은 매초 읽히지 않게 aria-live 를 두지 않고, 끝났을 때만 role="alert" 로 한 번. 헷갈리는 글자(0/O, 1/I/L)는 번호 생성에서 빼는 것이 전제. 글자는 user-select: all.

Charts & data viz

Chart

A multi-series time-series line/area chart. The consumer computes coordinates (points/path) and tick values from the data (same contract as Sparkline); the DS provides token-based styling for axes, grid, series, hover guide, and value tooltip. Set series color on the parent group via style="color:var(--viz-N)" (1–8).멀티시리즈 시계열 라인/영역 차트입니다. 좌표(points/path)와 눈금 값은 소비처가 데이터에서 계산하고(sparkline 과 동일 계약), DS 는 축, 그리드, 시리즈, 호버 가이드, 값 툴팁의 토큰 기반 스타일을 제공합니다. 시리즈 색은 부모 그룹에 style="color:var(--viz-N)"(1~8) 로 지정합니다.

.qf-chartlayer: generic

Preview

300200100000:0012:0024:00
Downloaded 268
Failed 12
No data
  • Downloaded
  • Failed
<div class="qf-chart" style="--chart-h:200px">
  <svg class="qf-chart__svg" viewBox="0 0 320 200" role="img" aria-label="Downloads vs failures over 24h, both rising">
    <g class="qf-chart__grid">
      <line x1="36" y1="20" x2="312" y2="20">
    </line>
    <line x1="36" y1="60" x2="312" y2="60">
  </line>
  <line x1="36" y1="100" x2="312" y2="100">
</line>
<line x1="36" y1="140" x2="312" y2="140">
</line>
</g>
<text class="qf-chart__label qf-chart__label--y" x="30" y="20">300</text>
<text class="qf-chart__label qf-chart__label--y" x="30" y="60">200</text>
<text class="qf-chart__label qf-chart__label--y" x="30" y="100">100</text>
<text class="qf-chart__label qf-chart__label--y" x="30" y="140">0</text>
<line class="qf-chart__axis" x1="36" y1="20" x2="36" y2="140">
</line>
<line class="qf-chart__axis" x1="36" y1="140" x2="312" y2="140">
</line>
<g style="color:var(--viz-1)">
  <polygon class="qf-chart__area" points="36,120 105,96 174,104 243,64 312,48 312,140 36,140">
</polygon>
<polyline class="qf-chart__series" points="36,120 105,96 174,104 243,64 312,48">
</polyline>
</g>
<g style="color:var(--viz-3)">
  <polyline class="qf-chart__series" points="36,132 105,128 174,118 243,112 312,96">
</polyline>
</g>
<text class="qf-chart__label qf-chart__label--x" x="36" y="158">00:00</text>
<text class="qf-chart__label qf-chart__label--x" x="174" y="158">12:00</text>
<text class="qf-chart__label qf-chart__label--x" x="312" y="158">24:00</text>
<line class="qf-chart__guide" x1="243" y1="20" x2="243" y2="140">
</line>
<circle class="qf-chart__dot" cx="243" cy="64" r="3.5" style="color:var(--viz-1)">
</circle>
</svg>
<div class="qf-chart__tooltip" style="left:196px;top:24px">
  <div class="qf-chart__tooltip-row">
    <span class="qf-chart__tooltip-swatch" style="color:var(--viz-1)">
    </span>
    Downloaded 268
  </div>
  <div class="qf-chart__tooltip-row">
    <span class="qf-chart__tooltip-swatch" style="color:var(--viz-3)">
    </span>
    Failed 12
  </div>
</div>
<div class="qf-chart__state">No data</div>
</div>
<ul class="qf-legend" style="margin-top:var(--s-3)">
  <li class="qf-legend__item">
    <span class="qf-legend__swatch" style="color:var(--viz-1)">
    </span>
    Downloaded
  </li>
  <li class="qf-legend__item">
    <span class="qf-legend__swatch" style="color:var(--viz-3)">
    </span>
    Failed
  </li>
</ul>

Variants

qf-chart__svg qf-chart__grid qf-chart__axis qf-chart__label qf-chart__series qf-chart__area qf-chart__dot qf-chart__guide qf-chart__tooltip qf-chart__state qf-chart--loading qf-chart--empty

Required tokens

--viz-1 --viz-2 --viz-3 --chart-grid --chart-axis --chart-label --chart-tooltip-bg --chart-tooltip-text --border --bg-panel

Accessibility

Summarize the trend with role="img" + aria-label on the svg (e.g., "Downloads vs failures over the last 24h, rising"). The hover guide/tooltip is a pointer affordance; pair color with a legend and numeric labels to avoid color-only reliance. Offer an equivalent data table for keyboard/screen-reader users.svg 에 role="img" + aria-label 로 추세를 요약합니다(예: "최근 24시간 다운로드 대 실패, 상승"). 호버 가이드/툴팁은 포인터 보조 수단이며, 색 단독 의존을 피하도록 범례와 수치 라벨을 함께 둡니다. 키보드/스크린리더 사용자에게는 동일 데이터의 표 대체본 제공을 권장합니다.

Charts & data viz

BarChart

A grouped or stacked bar chart. The consumer computes bar coordinates/heights for a category axis (site/category) plus values. Groups place bars side by side; stacks pile them at the same x (both expressed via coordinates). Use --horizontal to switch label alignment for horizontal bars. Set bar color via style="color:var(--viz-N)".그룹 또는 스택 막대 차트입니다. 카테고리축(사이트/카테고리) + 값, 막대 좌표/높이는 소비처가 계산합니다. 그룹은 막대를 나란히, 스택은 같은 x 에 쌓아 배치합니다(둘 다 좌표로 표현). --horizontal 로 가로 막대 레이블 정렬을 전환합니다. 막대 색은 style="color:var(--viz-N)".

.qf-barchartlayer: generic

Preview

apicdnweb
<div class="qf-barchart" style="--chart-h:200px">
  <svg class="qf-barchart__svg" viewBox="0 0 320 200" role="img" aria-label="Downloaded vs failed by site, grouped">
    <g class="qf-barchart__grid">
      <line x1="40" y1="40" x2="312" y2="40">
    </line>
    <line x1="40" y1="100" x2="312" y2="100">
  </line>
  <line x1="40" y1="160" x2="312" y2="160">
</line>
</g>
<line class="qf-barchart__axis" x1="40" y1="20" x2="40" y2="160">
</line>
<line class="qf-barchart__axis" x1="40" y1="160" x2="312" y2="160">
</line>
<rect class="qf-barchart__bar" x="60" y="56" width="22" height="104" style="color:var(--viz-1)">
</rect>
<rect class="qf-barchart__bar" x="86" y="132" width="22" height="28" style="color:var(--viz-7)">
</rect>
<rect class="qf-barchart__bar" x="150" y="40" width="22" height="120" style="color:var(--viz-1)">
</rect>
<rect class="qf-barchart__bar" x="176" y="120" width="22" height="40" style="color:var(--viz-7)">
</rect>
<rect class="qf-barchart__bar" x="240" y="84" width="22" height="76" style="color:var(--viz-1)">
</rect>
<rect class="qf-barchart__bar" x="266" y="146" width="22" height="14" style="color:var(--viz-7)">
</rect>
<text class="qf-barchart__label" x="84" y="178">api</text>
<text class="qf-barchart__label" x="174" y="178">cdn</text>
<text class="qf-barchart__label" x="264" y="178">web</text>
</svg>
</div>

Variants

qf-barchart__svg qf-barchart__grid qf-barchart__axis qf-barchart__label qf-barchart__track qf-barchart__bar qf-barchart__value qf-barchart--horizontal

Required tokens

--viz-1 --viz-7 --chart-grid --chart-axis --chart-label --chart-track --text-secondary

Accessibility

Provide a comparison summary via role="img" + aria-label, and include value-label text so the chart does not rely on color alone. Reinforce the category×series breakdown with a legend.svg 에 role="img" + aria-label 로 비교 요약을 제공하고, 값 레이블 텍스트를 함께 둬 색 단독 의존을 피합니다. 카테고리×시리즈 분해는 범례로 보강합니다.

Charts & data viz

Donut

A multi-segment donut chart (an N-segment distribution, unlike the single-gauge Radial). Each segment is expressed with stroke-dasharray/stroke-dashoffset against the circle circumference, with lengths computed by the consumer. Place a total/label in the center and reinforce the distribution with a legend. Set segment color via style="color:var(--viz-N)".다세그먼트 도넛 차트입니다(단일 게이지인 Radial 과 달리 N 세그먼트 분포). 각 세그먼트는 원 둘레 기준 stroke-dasharray/stroke-dashoffset 로 표현하며 길이는 소비처가 계산합니다. 중앙에 합계/라벨을 두고 분포는 범례로 보강합니다. 세그먼트 색은 style="color:var(--viz-N)".

.qf-donutlayer: generic

Preview

412failures
<div class="qf-donut">
  <svg class="qf-donut__svg" viewBox="0 0 128 128" role="img" aria-label="Failure reasons: timeout 60%, auth 28%, other 12%">
    <circle class="qf-donut__track" cx="64" cy="64" r="54" stroke-width="16">
  </circle>
  <circle class="qf-donut__segment" cx="64" cy="64" r="54" stroke-width="16" stroke-dasharray="203.58 135.71" stroke-dashoffset="0" style="color:var(--viz-1)">
</circle>
<circle class="qf-donut__segment" cx="64" cy="64" r="54" stroke-width="16" stroke-dasharray="95 244.29" stroke-dashoffset="-203.58" style="color:var(--viz-5)">
</circle>
<circle class="qf-donut__segment" cx="64" cy="64" r="54" stroke-width="16" stroke-dasharray="40.71 298.58" stroke-dashoffset="-298.58" style="color:var(--viz-7)">
</circle>
</svg>
<div class="qf-donut__center">
  <span class="qf-donut__total">412</span>
  <span class="qf-donut__label">failures</span>
</div>
</div>

Variants

qf-donut__svg qf-donut__track qf-donut__segment qf-donut__center qf-donut__total qf-donut__label

Required tokens

--viz-1 --viz-5 --viz-7 --chart-track --text-strong --text-muted --fs-24

Accessibility

State the segment proportions with role="img" + aria-label on the svg (e.g., "Failure reasons: timeout 60%, auth 28%, other 12%"). Pair the centered total text and a legend to avoid color-only reliance.svg 에 role="img" + aria-label 로 세그먼트 비율을 명시합니다(예: "실패 사유: 타임아웃 60%, 인증 28%, 기타 12%"). 중앙 합계 텍스트와 범례로 색 단독 의존을 피합니다.

Charts & data viz

Heatmap

A site×time or site×category density heatmap (throughput/failures). Cells are a CSS grid; pass per-cell intensity via inline style --qf-heat (0–1) and the color interpolates between --heat-empty and currentColor. The consumer sets the column count (grid-template-columns) and cell values. Set color via style="color:var(--viz-N)".사이트×시간 또는 사이트×카테고리 밀도(처리량/실패) 히트맵입니다. CSS 그리드 셀로, 강도는 셀마다 --qf-heat(0~1) 를 인라인 style 로 전달하면 색이 --heat-empty 와 currentColor 사이를 보간합니다. 그리드 열 수(grid-template-columns)와 셀 값은 소비처가 지정합니다. 색은 style="color:var(--viz-N)".

.qf-heatmaplayer: generic

Preview

<div class="qf-heatmap" style="grid-template-columns:auto repeat(6,1fr);max-width:300px" role="img" aria-label="Throughput density by site and 4-hour bucket">
  <div class="qf-heatmap__row">
    <span class="qf-heatmap__label">api</span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.2" title="api 00:00 — 21">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.5" title="api 04:00 — 58">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.8" title="api 08:00 — 92">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:1" title="api 12:00 — 114">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.6" title="api 16:00 — 67">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.3" title="api 20:00 — 33">
    </span>
  </div>
  <div class="qf-heatmap__row">
    <span class="qf-heatmap__label">cdn</span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.5" title="cdn 00:00 — 54">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.7" title="cdn 04:00 — 78">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.9" title="cdn 08:00 — 101">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.6" title="cdn 12:00 — 64">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.4" title="cdn 16:00 — 41">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.2" title="cdn 20:00 — 19">
    </span>
  </div>
  <div class="qf-heatmap__row">
    <span class="qf-heatmap__label">web</span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.1" title="web 00:00 — 9">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.3" title="web 04:00 — 28">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.6" title="web 08:00 — 63">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.8" title="web 12:00 — 88">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.7" title="web 16:00 — 71">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.5" title="web 20:00 — 52">
    </span>
  </div>
  <div class="qf-heatmap__row">
    <span class="qf-heatmap__label">db</span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.4" title="db 00:00 — 44">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.5" title="db 04:00 — 51">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.4" title="db 08:00 — 47">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.6" title="db 12:00 — 62">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:0.9" title="db 16:00 — 103">
    </span>
    <span class="qf-heatmap__cell" style="--qf-heat:1" title="db 20:00 — 118">
    </span>
  </div>
</div>

Variants

qf-heatmap__row qf-heatmap__cell qf-heatmap__label

Required tokens

--viz-2 --heat-empty --text-muted

Accessibility

Because this is a grid (not an svg), give the container role="img" + aria-label summarizing what the density represents, and provide the exact value per cell via title (or aria-label) so it does not rely on color/brightness alone.svg 가 아닌 그리드이므로 컨테이너에 role="img" + aria-label 로 무엇의 밀도인지 요약하고, 각 셀에는 title(또는 aria-label)로 정확한 수치를 제공해 색/명도 단독 의존을 피합니다.

Charts & data viz

Legend

A legend shared by the charts (color swatch + label + optional value). Match the swatch to the series color via style="color:var(--viz-N)". The --toggle variant turns items into button[aria-pressed] to convey series show/hide state.차트들이 공유하는 범례입니다(색칩 + 라벨 + 선택적 수치). 색칩은 style="color:var(--viz-N)" 로 시리즈 색과 맞춥니다. --toggle 변형은 항목을 button[aria-pressed] 로 만들어 시리즈 표시 on/off 를 전달합니다.

.qf-legendlayer: generic

Preview

  • Downloaded 3,248
  • Skipped 412
  • Failed 96
<ul class="qf-legend">
  <li class="qf-legend__item">
    <span class="qf-legend__swatch" style="color:var(--viz-1)">
    </span>
    Downloaded
    <span class="qf-legend__value">3,248</span>
  </li>
  <li class="qf-legend__item">
    <span class="qf-legend__swatch" style="color:var(--viz-5)">
    </span>
    Skipped
    <span class="qf-legend__value">412</span>
  </li>
  <li class="qf-legend__item">
    <span class="qf-legend__swatch" style="color:var(--viz-7)">
    </span>
    Failed
    <span class="qf-legend__value">96</span>
  </li>
</ul>

Examples예시

Toggle (show/hide series)

Variants

qf-legend__item qf-legend__swatch qf-legend__value qf-legend--toggle

Required tokens

--viz-1 --viz-5 --viz-7 --text-secondary --text-muted --bg-hover --text-disabled

Accessibility

Use ul/li for the non-toggle form. For the toggle form, make each item a button + aria-pressed (true/false) so screen readers announce the visibility state, and ensure dimmed items are distinguished by state (aria-pressed), not color alone.비토글형은 ul/li 로 의미를 전달합니다. 토글형은 각 항목을 button + aria-pressed(true/false) 로 만들어 표시 상태를 스크린리더에 알리고, 흐려진 항목도 색 외 상태(aria-pressed)로 구분되게 합니다.

Media

MediaCard

A thumbnail card with an aspect-ratio-locked media slot (letterbox) plus overlay badges and toggles — for video, image, and poster grids.종횡비 고정 미디어 슬롯(레터박스)에 오버레이 배지, 토글을 얹는 썸네일 카드입니다. 비디오, 이미지, 포스터 그리드에 씁니다.

.qf-media-cardlayer: generic

Preview

12:34
Sunset over the harbor, extended cut
1080p248 MB2 days ago
<div class="qf-media-card qf-media-card--interactive" style="max-width:260px">
  <div class="qf-media-card__media">
    <div class="qf-media-card__overlay qf-media-card__overlay--start">
      <span class="qf-badge">12:34</span>
    </div>
    <div class="qf-media-card__overlay qf-media-card__overlay--end">
      <button class="qf-btn qf-btn--icon qf-btn--ghost" aria-label="Favorite" aria-pressed="false">
        <svg class="qf-icon qf-icon--md" aria-hidden="true">
          <use href="#qf-i-star"/>
        </svg>
      </button>
    </div>
  </div>
  <div class="qf-media-card__body">
    <div class="qf-media-card__title qf-clamp">Sunset over the harbor, extended cut</div>
    <div class="qf-media-card__meta">
      <span>1080p</span>
      <span>248 MB</span>
      <span>2 days ago</span>
    </div>
  </div>
</div>

Examples예시

NEW
The Lighthouse
2019Drama
Poster (--2x3)
Loading (--loading + qf-skel)
Couldn't load preview
Broken asset
Error (--error + __fallback)

Variants

qf-media-card__media qf-media-card__overlay qf-media-card__overlay--start qf-media-card__overlay--end qf-media-card__body qf-media-card__title qf-media-card__meta qf-media-card__skeleton qf-media-card__fallback qf-media-card--2x3 qf-media-card--auto qf-media-card--interactive qf-media-card--error

Required tokens

--bg-media --media-overlay-scrim --aspect-16x9 --aspect-2x3 --r-lg --border --border-strong --bg-panel --elev-3 --ring-accent --s-2 --s-3 --fs-13 --fs-12 --text --text-muted --dur-fast --ease-standard

Accessibility

Make activatable media slots operable with role=button, tabindex=0, Enter/Space, and aria-label. Overlay toggles are real buttons with aria-pressed and a 44px target; badge text keeps 4.5:1 over the scrim; skeletons set aria-busy; truncated titles carry a title attribute.활성화 가능한 미디어 슬롯은 role=button, tabindex=0, Enter/Space, aria-label 로 동작을 전달합니다. 오버레이 토글은 실제 button + aria-pressed + 44px, 배지 텍스트는 스크림 위에서 4.5:1, 스켈레톤은 aria-busy, 잘린 제목은 title 속성을 둡니다.

Media

Figure

A picture (or video) with a one-line caption below. The caption is 13px in a secondary tone; a link inside is underlined and carries a qf-i-external icon so it reads as a link beyond color. Non-link notes such as "Image: AI generated" sit in the same place without an icon. Limit the image height with --qf-figure-max-h (none by default).그림(또는 영상)과 그 아래 한 줄 캡션입니다. 캡션은 13px 보조 톤이고, 안의 링크는 밑줄과 qf-i-external 아이콘으로 링크임이 색 외에도 드러납니다. "이미지 출처: AI 생성" 같은 비링크 문구도 같은 자리에 아이콘 없이 둡니다. 그림 최대 높이는 --qf-figure-max-h 로 제한할 수 있습니다(기본 없음).

.qf-figurelayer: generic

Preview

<figure class="qf-figure" style="max-width:420px">
  <img src="brand-assets/png/og-image.png" alt="qufox brand card">
  <figcaption class="qf-figure__caption">
    Image:
    <a href="#source" target="_blank" rel="noopener">
      Ruliweb post
      <svg class="qf-icon qf-icon--sm" aria-hidden="true">
        <use href="#qf-i-external"/>
      </svg>
    </a>
  </figcaption>
</figure>

Examples예시

Linked source
Illustration of the issue
Image: AI generated
AI generated (no link)

Variants

qf-figure__caption

Required tokens

--s-2 --s-1 --r-lg --bg-media --fs-13 --lh-snug --text-muted --text-secondary --text --border-strong

Accessibility

Use figure/figcaption so image and caption are associated, and give the img an alt that describes the content (caption = source, alt = content). External links use target=_blank with rel=noopener, the icon is aria-hidden, and opening in a new window is conveyed in the link text or aria-label. Caption links are inline text links, so only vertical padding is added to help tapping.figure/figcaption 으로 두어 그림과 설명이 묶이게 하고, img 에는 내용을 설명하는 alt 를 둡니다(캡션은 출처, alt 는 내용). 외부 링크는 target=_blank 와 rel=noopener 를 쓰고 아이콘은 aria-hidden, 새 창 열림은 링크 텍스트나 aria-label 로 알립니다. 캡션 링크는 본문 안 인라인 링크라 세로 패딩만 더해 탭을 돕습니다.

Media

MediaOverlay

Glass control and status chrome that floats over a video or image stage. Stays light regardless of theme, avoids the safe area, and passes pointer events through so it never blocks native controls.영상이나 이미지 스테이지 위에 떠서 컨트롤과 상태를 보여주는 글래스 크롬입니다. 테마와 무관하게 항상 밝고, safe-area를 피하며, pointer-events 패스스루로 네이티브 컨트롤을 가리지 않습니다.

.qf-media-overlaylayer: generic

Preview

LIVE
12:34 / 48:02
<div style="position:relative;aspect-ratio:var(--aspect-16x9);max-width:440px;background:var(--bg-media);border-radius:var(--r-lg);overflow:hidden">
  <div class="qf-media-overlay">
    <div class="qf-media-overlay__top">
      <span class="qf-media-overlay__pill">LIVE</span>
      <span style="flex:1">
      </span>
      <button class="qf-media-overlay__pill qf-media-overlay__pill--button" aria-label="Settings">
        <svg class="qf-icon qf-icon--md" aria-hidden="true">
          <use href="#qf-i-settings"/>
        </svg>
      </button>
    </div>
    <div class="qf-media-overlay__bottom">
      <button class="qf-media-overlay__pill qf-media-overlay__pill--button" aria-label="Play">
        <svg class="qf-icon qf-icon--md" aria-hidden="true">
          <use href="#qf-i-video"/>
        </svg>
      </button>
      <span class="qf-media-overlay__pill">12:34 / 48:02</span>
    </div>
  </div>
</div>

Examples예시

Buffering…Reconnecting to stream
Buffering HUD (role=status)
Error HUD (role=alert)

Variants

qf-media-overlay__top qf-media-overlay__bottom qf-media-overlay__pill qf-media-overlay__pill--button qf-media-overlay__pill--danger qf-media-overlay__hud qf-media-overlay__hud--error qf-media-overlay__title qf-media-overlay__body

Required tokens

--on-media-text --on-media-text-muted --on-media-glass-bg --on-media-glass-bg-strong --on-media-border --on-media-border-hover --on-media-danger-text --on-media-danger-border --safe-top --safe-bottom --z-media-overlay --r-pill --r-lg --ring-focus --scrim-blur --fs-13 --fs-15

Accessibility

__pill--button is a real button with a focus ring visible over video and a 44px target. __hud uses role=status + aria-live=polite while buffering and role=alert on error. The container's pointer-events:none must not trap focus or block keyboard access to native controls.__pill--button은 실제 button + 영상 위에서 보이는 포커스 링 + 44px 입니다. __hud는 버퍼링 시 role=status, aria-live=polite, 에러 시 role=alert 를 둡니다. 컨테이너 pointer-events:none이 포커스를 가두거나 네이티브 컨트롤 키보드 접근을 막지 않아야 합니다.

Feedback & status

Toast

A notification message that appears briefly in a corner of the screen. --brief shows briefly and fades out (--dur-toast-brief, 2.4 s; under reduced motion it simply disappears after 2.4 s without motion. No live disappearing example is kept in the catalog). Pattern: a share button (qf-btn--ghost qf-btn--icon + qf-i-share) calls navigator.share, or falls back to copying the link and showing a qf-toast--brief "Link copied". Enter and leave (044): on insertion it moves in --motion-rise (8) from the edge it is anchored to (below for a bottom region, above for a top one) over --dur-enter (220) with --ease-enter (default on .qf-toast). To leave, add --leave: it fades over --dur-exit (140) with --ease-exit, and the consumer removes it on animationend. With reduced motion: the same timings, fade only. When only the text changes, keep the element (re-inserting replays the entrance). It moves with the translate property, so it does not fight a consumer transform. The top-region check looks only at direct children of qf-toast-region (wrapped toasts rise from below). RN: Animated opacity 0→1 and translateY (+motion-rise→0 when anchored at the bottom, −motion-rise→0 at the top) over dur-enter with Easing.bezier(...ease-enter); leave with opacity 1→0 over dur-exit. When AccessibilityInfo.isReduceMotionEnabled(), opacity only.화면 모서리에 잠깐 뜨는 알림 메시지입니다. --brief 는 짧게 떠 있다 사라집니다(--dur-toast-brief, 2.4초. 축소 모션에서는 모션 없이 2.4초 뒤 사라짐. 카탈로그에는 사라지는 라이브 예제를 두지 않습니다). 패턴: 공유 버튼(qf-btn--ghost qf-btn--icon + qf-i-share)은 navigator.share 를 쓰고, 없으면 링크를 복사한 뒤 qf-toast--brief 로 "링크를 복사했습니다" 를 띄웁니다. 나타남, 사라짐(044): 넣는 순간 붙은 쪽(아래 영역이면 아래, 위면 위)에서 --motion-rise(8) 옮겨 오며 --dur-enter(220) --ease-enter 로 나타납니다(.qf-toast 기본). 사라질 때는 --leave 를 걸어 --dur-exit(140) --ease-exit 로 흐려지고, 소비처가 animationend 에서 지웁니다. 동작 줄이기에서는 옮김 없이 같은 시간의 페이드만. 같은 토스트의 글만 바꿀 때는 요소를 다시 넣지 않습니다(다시 나타남). translate 속성으로 옮겨 소비처의 transform 과 겹치지 않습니다. 위 영역 판정은 qf-toast-region 의 직계 자식만 봅니다(감싸면 아래에서 올라옴). RN: Animated 로 opacity 0→1 과 translateY(아래에 붙으면 +motion-rise → 0, 위에 붙으면 −motion-rise → 0)를 duration dur-enter, Easing.bezier(...ease-enter), 사라질 때 opacity 1→0 dur-exit. AccessibilityInfo.isReduceMotionEnabled() 이면 translateY 없이 opacity 만.

.qf-toastlayer: generic

Preview

Saved
<div class="qf-toast qf-toast--success" role="status" aria-live="polite">
  <div class="qf-toast__title">Saved</div>
</div>

Examples예시

저장했습니다
044 Leaving (fades out, then remove on animationend; held at its first frame in this catalog)

Variants

Saved
qf-toast--success
Saved
qf-toast--danger
Saved
qf-toast--warn
Saved
qf-toast--brief
Saved
qf-toast--leave

Parts & more: 구성 요소, 기타: qf-toast__title qf-toast__body

Required tokens

--bg-elevated --border --accent --ok-400 --danger-400 --warn-400 --r-md --elev-3 --dur-toast-brief --ease-standard --s-2 --dur-enter --dur-exit --ease-enter --ease-exit --motion-rise

Accessibility

Announce with role="status" and aria-live="polite", and use role="alert" for errors. Include title and body text so meaning is not conveyed by the left color bar alone. Remove a --brief toast on animationend, and give the toast region role="status" (aria-live=polite) so it is announced.role="status" 와 aria-live="polite" 로 알리고 오류는 role="alert" 를 씁니다. 좌측 색 막대만으로 의미를 전하지 않도록 제목과 본문 텍스트를 함께 둡니다. --brief 는 animationend 에서 요소를 제거하고, 토스트 영역을 role="status"(aria-live=polite) 로 두어 낭독되게 합니다.

Feedback & status

ToastRegion

A fixed container that stacks multiple qf-toast elements, defaulting to the top right and repositionable with --bottom/--left.여러 qf-toast 를 쌓아 올리는 고정 컨테이너입니다. 기본 우상단, --bottom/--left 로 위치를 바꿉니다.

.qf-toast-regionlayer: generic

Preview

Saved
Sync delayed
<div class="qf-toast-region" aria-live="polite">
  <div class="qf-toast qf-toast--success" role="status">
    <div class="qf-toast__title">Saved</div>
  </div>
  <div class="qf-toast qf-toast--warn" role="status">
    <div class="qf-toast__title">Sync delayed</div>
  </div>
</div>

Variants

Saved
Sync delayed
qf-toast-region--bottom
Saved
Sync delayed
qf-toast-region--left

Required tokens

--z-toast --s-5 --s-3

Accessibility

Set aria-live=polite (assertive for urgent) on the region so screen readers announce toasts as they are added. Apply pointer-events to the toasts only.region 에 aria-live=polite(긴급은 assertive)를 두어 추가되는 토스트를 스크린리더가 읽게 합니다. pointer-events 는 토스트에만.

Feedback & status

Callout

Obsidian-style callouts — 13 typed notice blocks rendered inside qf-prose body, with optional collapsing via details/summary.Obsidian 스타일 콜아웃 — qf-prose 본문 안에 렌더하는 13종 안내 블록입니다. 접기(details/summary)를 지원합니다.

.qf-calloutlayer: generic

Preview

Tip
Use tokens and dark, light adapt automatically.
<div class="qf-callout qf-callout--tip">
  <div class="qf-callout__title">
    <span class="qf-callout__icon">
      <svg class="qf-icon qf-icon--sm" aria-hidden="true">
        <use href="#qf-i-sparkle"/>
      </svg>
    </span>
    Tip
  </div>
  <div class="qf-callout__body">Use tokens and dark, light adapt automatically.</div>
</div>

Examples예시

Note
A general note in body flow.
note
Abstract
A short summary of what follows.
abstract
Info
Contextual information.
info
Todo
Something still to do.
todo
Tip
Use tokens and dark, light adapt automatically.
tip
Success
The step completed.
success
Question
Is this the right approach?
question
Warning
Double-check before continuing.
warning
Failure
The check did not pass.
failure
Danger
This action cannot be undone.
danger
Bug
Known issue, tracked in #142.
bug
Example
A worked example follows.
example
Quote
Design is how it works.
quote
Collapsible
Click the summary to fold and unfold.
collapsible (details/summary)

Variants

Tip
Use tokens and dark, light adapt automatically.
qf-callout--note
Tip
Use tokens and dark, light adapt automatically.
qf-callout--abstract
Tip
Use tokens and dark, light adapt automatically.
qf-callout--info
Tip
Use tokens and dark, light adapt automatically.
qf-callout--todo
Tip
Use tokens and dark, light adapt automatically.
qf-callout--tip
Tip
Use tokens and dark, light adapt automatically.
qf-callout--success
Tip
Use tokens and dark, light adapt automatically.
qf-callout--question
Tip
Use tokens and dark, light adapt automatically.
qf-callout--warning
Tip
Use tokens and dark, light adapt automatically.
qf-callout--failure
Tip
Use tokens and dark, light adapt automatically.
qf-callout--danger
Tip
Use tokens and dark, light adapt automatically.
qf-callout--bug
Tip
Use tokens and dark, light adapt automatically.
qf-callout--example
Tip
Use tokens and dark, light adapt automatically.
qf-callout--quote

Parts & more: 구성 요소, 기타: qf-callout__title qf-callout__icon qf-callout__body

Required tokens

--text-info --text-ok --text-warn --text-danger --accent-text --text-muted --border --border-strong --bg-elevated --text-strong --r-md --s-1 --ring-focus

Accessibility

Convey the type via the title text in addition to the left accent bar and icon color, avoiding reliance on color alone (WCAG 1.4.1). Icons are aria-hidden; collapsing uses native details/summary to preserve keyboard and screen reader behavior, with a focus ring on the summary.타입 의미를 좌측 강조선과 아이콘 색뿐 아니라 제목 텍스트로 함께 전달해 색 단독 의존을 피합니다(WCAG 1.4.1). 아이콘은 aria-hidden, 접기는 네이티브 details/summary 로 키보드, 스크린리더 동작을 보존하고 summary 에 포커스 링을 둡니다.

Feedback & status

Banner

A banner that displays a notice at the top of the page or inline. Terms change notice (062, Den 071 O-69): on the web, one full-width qf-banner--info right under the top bar: __icon (qf-i-info) and in __msg "The <strong>privacy policy and terms</strong> change on 2 November." with an inline "Read more" link (--link, underlined). Shown on every page, signed in or not, while the server serves the notice (7 days before, 30 if adverse, to the end of the effective day), with a __close at the end (name "약관 변경 알림 닫기", qf-i-x 16, 24 visible, 44 target; 081, Den 095). A closed id (the effective date) is kept in that browser and not shown again; the next change has a new id and shows. Adverse changes close the same way (the design's view; if the operator decides otherwise, only adverse changes lose the close). The app uses a link row at the top of Settings (MobileGroup), not a strip. In-app notice (074, Den 087): during an outage or maintenance the one line from the server's /config notice shows as qf-banner--warn (qf-i-alert) or --info (qf-i-info), plain text in __msg (no links), and a __close ("Close notice", 24, 44 target). The app puts it right under the Location tab's top bar at full width, pushing the map down (never over the map). The web puts it in the strip under the top bar, above the terms-change strip, on every page including sign-in. Once closed, that id stays hidden until its end time. Keep the text within two lines (about 60 characters). Details in docs/tasks/074-den-notice.md in git.상단 또는 본문에 알림을 표시하는 배너입니다. 약관 변경 알림(062, Den 071 O-69): 웹은 위 막대 바로 밑, 폭 전체에 qf-banner--info 하나. __icon(qf-i-info), __msg 에 "<strong>개인정보 처리방침과 이용약관</strong>이 11월 2일부터 바뀝니다." 와 글 안 링크 "자세히 보기"(--link, 밑줄). 서버가 알림을 주는 동안(시행 7일 전부터, 불리하면 30일 전부터, 시행일 당일 끝까지) 로그인 여부와 상관없이 모든 쪽에 둡니다. 끝에 __close(이름 "약관 변경 알림 닫기", qf-i-x 16, 보이는 크기 24, 누르는 곳 44, 081, Den 095)를 둡니다. 닫은 id(시행일)는 그 브라우저에 적어 다시 띄우지 않고, 다음 변경은 새 id 라 다시 뜹니다. 불리한 변경도 같게 닫습니다(판의 의견, 운영자가 달리 정하면 불리한 변경만 닫기 없음). 앱은 띠가 아니라 설정 맨 위 링크 줄(MobileGroup). 앱 안 공지(074, Den 087): 장애나 점검 때 서버 /config 의 notice 한 줄을 qf-banner--warn(qf-i-alert) 또는 --info(qf-i-info)로, __msg 에 글만(링크 없음), 끝에 __close("공지 닫기", 24, 누르는 곳 44). 앱은 위치 탭 위 막대 바로 아래, 폭 전체로 지도를 밀어 내립니다(지도 위에 띄우지 않음). 웹은 위 막대 밑 띠 자리에서 약관 변경 띠보다 위, 모든 쪽(로그인 포함). 닫으면 그 id 는 끝 시각까지 다시 띄우지 않습니다. 글은 두 줄(약 60자) 안을 권합니다. 자세한 것은 git 의 docs/tasks/074-den-notice.md.

.qf-bannerlayer: generic

Preview

Your connection is unstable.
<div class="qf-banner qf-banner--warn" role="status">
  <span class="qf-banner__msg">Your connection is unstable.</span>
  <button class="qf-banner__close" aria-label="Close">×</button>
</div>

Examples예시

062 약관 변경 띠(웹 위 막대 밑)

Variants

Your connection is unstable.
qf-banner--info
Your connection is unstable.
qf-banner--warn
Your connection is unstable.
qf-banner--danger
Your connection is unstable.
qf-banner--accent

Parts & more: 구성 요소, 기타: qf-banner__icon qf-banner__msg qf-banner__actions qf-banner__close

Required tokens

--accent --accent-subtle --bg-panel --s-3 --text-strong --text-info --text-warn --text-danger --link --link-hover --accent-on-subtle --r-xs --s-1

Accessibility

Assign role=status or role=alert to match its nature, and convey the informational meaning with an icon and text, not color alone. Give the close button an aria-label. The terms notice exists from page load, so no role=status: use <aside aria-label="Terms change notice">. Its link is inline text, exempt from the 44 target size. The in-app notice (074) is announced once when it appears, without taking focus. iOS ignores accessibilityLiveRegion, so call AccessibilityInfo.announceForAccessibility("공지, " + text); the web uses role="status". On close, move focus to the next content (the app's map area, the first focusable element of the web's main). When the terms strip is closed (081), move focus to the first focusable element in main (as in 074). The close is named "약관 변경 알림 닫기" (Close terms change notice), not just "알림 닫기" (Close notification), so it is not confused with the Notifications row or list.성격에 맞춰 role=status 또는 role=alert를 부여하고 정보 의미를 색뿐 아니라 아이콘과 텍스트로 전달합니다. 닫기 버튼에는 aria-label을 둡니다. 약관 변경 띠는 페이지를 열 때부터 있는 것이라 role=status 를 두지 않고 <aside aria-label="약관 변경 알림"> 으로 둡니다. 링크는 글 안 링크라 44 누름 크기 예외입니다. 앱 안 공지(074)는 처음 뜰 때 한 번 읽고 초점은 빼앗지 않습니다. iOS 는 accessibilityLiveRegion 을 무시하므로 AccessibilityInfo.announceForAccessibility("공지, " + 글)을 부르고, 웹은 role="status". 닫으면 초점을 다음 내용(앱 지도 칸, 웹 main 의 첫 초점 요소)으로 옮깁니다. 약관 변경 띠를 닫으면(081) 초점을 main 의 첫 초점 요소로 옮깁니다(074 와 같음). 닫기 이름은 "알림 닫기"가 아니라 "약관 변경 알림 닫기"입니다(설정의 "알림" 줄, 알림 목록과 헷갈리지 않게).

Feedback & status

Notice

An inline message box that surfaces info, warning, or danger states.정보, 경고, 위험을 알리는 인라인 안내 박스입니다.

.qf-noticelayer: generic

Preview

<div class="qf-notice qf-notice--warn" role="alert">
  <span class="qf-notice__icon">
    <svg class="qf-icon qf-icon--md" aria-hidden="true">
      <use href="#qf-i-alert"/>
    </svg>
  </span>
  <div class="qf-notice__body">
    <p class="qf-notice__title">Caution</p>
    You have unsaved changes.
  </div>
</div>

Examples예시

Load failed + retry (end of an infinite list)

Variants

qf-notice--info
qf-notice--warn
qf-notice--danger

Parts & more: 구성 요소, 기타: qf-notice__icon qf-notice__body qf-notice__title

Required tokens

--border --s-1 --r-md --bg-elevated --text-secondary --text-info --text-warn --text-danger

Accessibility

Meaning is carried by a title and body text in addition to the left border color and icon, avoiding reliance on color alone. Warning and danger use role=alert, while info uses role=status to announce to screen readers.좌측 보더 색과 아이콘에 더해 제목, 본문 텍스트로 의미를 전달해 색 단독 의존을 피합니다. 경고, 위험은 role=alert로, 정보는 role=status로 스크린리더에 알립니다.

Feedback & status

Spinner

A spinning loader that indicates work is in progress. Inside a button, qf-btn--busy sets its size (16) and colour (the label colour) (044).작업이 진행 중임을 나타내는 회전 로더입니다. 버튼 안에서는 qf-btn--busy 가 크기(16)와 색(글자색)을 정합니다(044).

.qf-spinnerlayer: generic

Preview

<span class="qf-spinner" role="status" aria-label="Loading">
</span>

Variants

qf-spinner--sm
qf-spinner--lg

Required tokens

--bg-selected --accent --r-pill

Accessibility

Announce progress with role=status and an aria-label (e.g., Loading). prefers-reduced-motion is honored by the global guard in tokens.css.role=status 와 aria-label(예: 불러오는 중)로 진행을 알립니다. prefers-reduced-motion 은 tokens.css 전역 가드가 존중합니다.

Feedback & status

Progress

Displays task progress as a bar.작업 진행률을 막대로 표시합니다.

.qf-progresslayer: generic

Preview

<div class="qf-progress" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100">
  <span class="qf-progress__bar" style="width: 60%">
  </span>
</div>

Variants

qf-progress--success
qf-progress--danger
qf-progress--indeterminate

Parts & more: 구성 요소, 기타: qf-progress__bar

Required tokens

--bg-hover --accent --ok-400 --danger-400 --r-pill --s-2 --dur-base

Accessibility

Convey the value with role=progressbar and aria-valuenow/valuemin/valuemax. Express an indeterminate state with aria-busy=true or by omitting the value attributes.role=progressbar 와 aria-valuenow/valuemin/valuemax 로 값을 전달합니다. 진행률 미정 상태는 aria-busy=true 또는 값 속성 생략으로 표현합니다.

Feedback & status

Radial

Shows a single value such as capacity or utilization as a radial gauge. Pass --qf-radial-value (0–100) via inline style.용량, 사용률 등 단일 값을 방사형(게이지)으로 보여줍니다. --qf-radial-value(0~100) 를 인라인 style 로 전달합니다.

.qf-radiallayer: generic

Preview

72%
<div class="qf-radial qf-radial--warn" style="--qf-radial-value:72" role="progressbar" aria-valuenow="72" aria-valuemin="0" aria-valuemax="100" aria-label="Disk usage">
  <span class="qf-radial__value">72%</span>
</div>

Variants

72%
qf-radial--ok
72%
qf-radial--warn
72%
qf-radial--danger

Parts & more: 구성 요소, 기타: qf-radial__value

Required tokens

--accent --bg-hover --bg-elevated --text-strong --ok-400 --warn-400 --danger-400 --fs-18

Accessibility

Convey the value with role=progressbar + aria-valuenow/min/max, and use the centered numeric text to avoid reliance on color alone.role=progressbar + aria-valuenow/min/max 로 값을 전달하고, 중앙 수치 텍스트로 색 단독 의존을 피합니다.

Feedback & status

Nudge

A pill button floating centered under the top bar that says something like "3 new issues" and, when pressed, scrolls to the top and refreshes. The consumer inserts it only when there is something new (short slide-down mount motion) and removes it on press or when handled — no state classes. If the top bar is not --h-navbar tall, set --qf-nudge-top. 44px on phones. It may be a button or an a (no underline).상단 바 아래 가운데에 떠서 "새 이슈 3건" 처럼 알리고, 누르면 맨 위로 가며 새로 고치는 알약 버튼입니다. 새 항목이 있을 때만 소비처가 DOM 에 넣고(위에서 내려오는 짧은 마운트 모션), 누르거나 처리되면 제거합니다 — 상태 클래스가 없습니다. 상단 바 높이가 기본(--h-navbar)과 다르면 --qf-nudge-top 으로 맞춥니다. 폰에서는 44px. button 또는 a 로 쓸 수 있습니다(밑줄 없음).

.qf-nudgelayer: generic

Preview

<div style="position:relative;height:88px">
  <button class="qf-nudge" type="button" style="position:absolute;top:var(--s-3)">
    <svg class="qf-icon qf-icon--sm" aria-hidden="true">
      <use href="#qf-i-chevron-up"/>
    </svg>
    3 new issues
  </button>
</div>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--h-navbar --s-3 --s-2 --s-5 --s-6 --s-9 --z-sticky --r-pill --accent-solid --accent-solid-hover --accent-solid-press --text-onAccent --elev-3 --fs-13 --dur-base --ease-emphasized --m-touch --ring-focus

Accessibility

A button whose text is its name (icon aria-hidden). Place it inside an aria-live=polite region so its appearance is announced. White text on the solid accent passes AA. The mount motion is disabled under prefers-reduced-motion.button 이며 문구 자체가 이름입니다(아이콘은 aria-hidden). 새로 나타났음을 알리려면 aria-live=polite 영역 안에 넣습니다. 흰 글자는 solid accent 위에서 AA 를 넘습니다. 마운트 모션은 prefers-reduced-motion 에서 꺼집니다.

Feedback & status

Steps

Displays the progress steps of a multi-step flow.다단계 흐름의 진행 단계를 표시합니다.

.qf-stepslayer: generic

Preview

  1. ✓Account
  2. 2Profile
<ol class="qf-steps">
  <li class="qf-steps__step qf-steps__step--done">
    <span class="qf-steps__marker">✓</span>
    Account
  </li>
  <li class="qf-steps__bar" aria-hidden="true">
  </li>
  <li class="qf-steps__step" aria-current="step">
    <span class="qf-steps__marker">2</span>
    Profile
  </li>
</ol>

Variants

qf-steps__step qf-steps__marker qf-steps__bar qf-steps__step--done

Required tokens

--s-2 --r-pill --bg-hover --accent --text-onAccent --ok-400 --divider --text-muted

Accessibility

Convey order with an ol and set aria-current="step" on the current step. Communicate the completed/current state with marker numbers and text, not color alone.ol 로 순서를 전달하고 현재 단계에 aria-current=step 을 둡니다. 완료/현재 상태를 색뿐 아니라 마커 숫자, 텍스트로 함께 전달합니다.

Feedback & status

TypingDots

A three-dot staggered bounce that signals 'generating' or 'typing' — semantically distinct from a spinner (working) or progress (quantified).standalone 3점 staggered bounce로 '생성 중'/입력 중을 표시합니다. spinner(작업 중), progress(정량)와 의미가 다릅니다.

.qf-typing-dotslayer: generic

Preview

<span class="qf-typing-dots" role="status" aria-label="Generating">
  <span class="qf-typing-dots__dot" aria-hidden="true">
  </span>
  <span class="qf-typing-dots__dot" aria-hidden="true">
  </span>
  <span class="qf-typing-dots__dot" aria-hidden="true">
  </span>
</span>

Examples예시

On accent surface (--onAccent)
Large (--lg)

Variants

qf-typing-dots--onAccent
qf-typing-dots--sm
qf-typing-dots--lg

Parts & more: 구성 요소, 기타: qf-typing-dots__dot

Required tokens

--size-typing-dot --motion-typing --text-muted --accent --s-1 --r-pill --ease-standard

Accessibility

Give the root role=status, aria-live=polite, and an accessible name (e.g. aria-label='Generating'); the dots are aria-hidden. Under prefers-reduced-motion, replace the bounce with an opacity fade — never freeze it at scale(0).루트에 role=status, aria-live=polite, 접근명(예: aria-label='생성 중')을 두고 점은 aria-hidden 입니다. prefers-reduced-motion 에서 bounce를 opacity 페이드로 대체하고 scale(0)로 얼려 안 보이게 두지 않습니다.

Navigation

Menu

A dropdown menu that presents a list of actions.동작 목록을 보여주는 드롭다운 메뉴입니다.

.qf-menulayer: generic

Preview

<div class="qf-menu" role="menu">
  <button class="qf-menu__item" role="menuitem">
    Edit
    <kbd class="qf-menu__kbd">⌘E</kbd>
  </button>
  <button class="qf-menu__item" role="menuitem">
    Copy
    <kbd class="qf-menu__kbd">⌘C</kbd>
  </button>
  <div class="qf-menu__separator" role="separator">
  </div>
  <button class="qf-menu__item qf-menu__item--danger" role="menuitem">Delete</button>
</div>

Variants

qf-menu__item qf-menu__item--danger qf-menu__separator qf-menu__kbd

Required tokens

--bg-elevated --border --bg-hover --r-lg --r-sm --divider --s-2 --elev-3 --text-danger

Accessibility

Set role="menu" and role="menuitem", navigate with the up and down arrows, and close on Esc. Show shortcuts as text so meaning is not conveyed by color alone.role="menu" 와 role="menuitem" 을 지정하고, 위아래 화살표로 이동하며 Esc 로 닫습니다. 단축키는 텍스트로 함께 보여 색만으로 의미를 전하지 않습니다.

Navigation

Tabs

A set of tabs for switching between multiple views. Tab labels never split inside a word (keep-all, and the inherited overflow-wrap: anywhere is reset, 030); multi-word labels and count badges still wrap inside the tab. If many tabs don't fit a narrow width the bar overflows, so the bar layout (wrapping or horizontal scroll) is up to the consumer. If you use <a class="qf-tabs__item">, the DS removes the link underline. role="tab" also requires arrow-key movement and aria-controls (a tabpanel). For a bar of links that change pages, skip the tab roles: put <a class="qf-tabs__item"> directly inside <nav class="qf-tabs" aria-label="…"> and mark the current page with aria-current="page"; it gets the same selected style (text-strong plus the accent underline) as aria-selected="true" (033; only the value "page" is matched). Wrapping the links in <ul>/<li> breaks the flex layout, so keep them as direct children of the nav.여러 뷰를 전환하는 탭 모음입니다. 탭 이름은 어절 안에서 쪼개지지 않습니다(keep-all, 본문의 overflow-wrap: anywhere 를 끊음, 030). 여러 어절 이름과 개수 배지는 탭 안에서 줄을 바꿉니다. 탭이 많아 좁은 폭에 다 안 들어가면 막대가 넘치므로, 줄바꿈이나 가로 스크롤 같은 막대 배치는 소비처 몫입니다. <a class="qf-tabs__item"> 로 쓰면 링크 밑줄은 DS 가 지웁니다. 다만 role="tab" 을 붙이면 좌우 화살표 이동과 aria-controls(tabpanel)까지 갖춰야 합니다. 페이지를 옮기는 링크 막대는 tab 역할 대신 <nav class="qf-tabs" aria-label="…"> 안에 <a class="qf-tabs__item"> 를 바로 두고 현재 페이지에 aria-current="page" 를 겁니다. 선택 표시(text-strong + accent 밑줄)는 aria-selected="true" 와 같습니다(033, 값 "page" 만 잡음). <ul>/<li> 로 감싸면 flex 짜임이 깨지니 링크를 nav 의 바로 아래 자식으로 둡니다.

.qf-tabslayer: generic

Preview

<div class="qf-tabs" role="tablist">
  <button class="qf-tabs__item" role="tab" aria-selected="true">All</button>
  <button class="qf-tabs__item" role="tab" aria-selected="false">Mentions</button>
  <button class="qf-tabs__item" role="tab" aria-selected="false">Unread</button>
</div>

Examples예시

뷰 전환(tablist, aria-selected)
페이지 막대(nav, aria-current="page")

Variants

qf-tabs__item

Required tokens

--divider --text-secondary --text-strong --accent --s-3 --s-4 --fs-14

Accessibility

For switching views within a page use role="tablist" and role="tab", mark the active tab with aria-selected="true", move with the left and right arrows, and link each tab to its tabpanel with aria-controls. For a bar of links that change pages use <nav aria-label> and aria-current="page" on the current link (no attribute on the others); links are reached with Tab, with no arrow-key movement. Either way the state reaches screen readers ("current page", "selected"), not only the underline.뷰 전환(같은 페이지 안)은 role="tablist" 과 role="tab", 선택 탭은 aria-selected="true", 좌우 화살표로 이동하고 aria-controls 로 tabpanel 을 잇습니다. 페이지 이동 링크 막대는 <nav aria-label> + 현재 링크 aria-current="page"(다른 링크에는 속성 없음), Tab 키로 링크 사이를 오가며 화살표 이동은 없습니다. 어느 쪽이든 밑줄 표시 외에 상태가 스크린 리더에 전해집니다("현재 페이지", "선택됨").

Navigation

TableOfContents

An 'on this page' table of contents that sticks to the right (qf-app-shell__aside) of a blog or doc page.블로그, 문서 우측(qf-app-shell__aside)에 sticky 로 붙는 '이 페이지에서' 목차입니다.

.qf-toclayer: generic

Preview

<nav class="qf-toc" aria-label="On this page">
  <div class="qf-toc__title">On this page</div>
  <ul>
    <li class="qf-toc__item">
      <a class="qf-toc__link qf-toc__link--active" href="#intro">Introduction</a>
    </li>
    <li class="qf-toc__item qf-toc__item--d2">
      <a class="qf-toc__link" href="#setup">Setup</a>
    </li>
    <li class="qf-toc__item qf-toc__item--d3">
      <a class="qf-toc__link" href="#install">Install the CLI</a>
    </li>
  </ul>
</nav>

Variants

qf-toc__title qf-toc__item qf-toc__item--d2 qf-toc__item--d3 qf-toc__link qf-toc__link--active

Required tokens

--accent --text-strong --text-secondary --text-muted --fs-11 --fs-13 --tracking-caps --s-4 --s-7 --lh-snug

Accessibility

Give the nav an aria-label to convey the landmark, and mark the active item with a left vertical indicator (--accent) plus text emphasis so meaning is not carried by color alone. Links meet a 44px touch target and long titles are truncated with an ellipsis.nav 에 aria-label 을 두어 랜드마크 의미를 전달하고, 활성 항목은 좌측 세로 인디케이터(--accent) + 텍스트 강조로 색 단독 의존을 피합니다. 링크는 44px 터치 타깃을 확보하고 긴 제목은 말줄임합니다.

Navigation

Breadcrumb

A breadcrumb trail that shows the path to the current location.현재 위치까지의 경로를 보여주는 이동 경로 내비게이션입니다.

.qf-breadcrumblayer: generic

Preview

<nav aria-label="Breadcrumb">
  <ol class="qf-breadcrumb">
    <li>
      <a class="qf-breadcrumb__item" href="/">Home</a>
    </li>
    <li class="qf-breadcrumb__sep" aria-hidden="true">/</li>
    <li>
      <a class="qf-breadcrumb__item" aria-current="page">Settings</a>
    </li>
  </ol>
</nav>

Variants

qf-breadcrumb__item qf-breadcrumb__sep

Required tokens

--s-2 --link --text-muted --fs-13

Accessibility

Build it as an ol inside nav[aria-label="breadcrumb"], and set aria-current="page" on the current page's item. Mark the separator (__sep) as decorative with aria-hidden.nav[aria-label=경로] 안의 ol 로 만들고, 현재 페이지 항목에 aria-current=page 를 둡니다. 구분 기호(__sep)는 aria-hidden 으로 장식 처리합니다.

Navigation

Pagination

Pagination controls for moving between pages.페이지 사이를 이동하는 페이지네이션입니다.

.qf-paginationlayer: generic

Preview

<nav aria-label="Pagination">
  <ul class="qf-pagination">
    <li>
      <button class="qf-pagination__item" aria-label="Previous">‹</button>
    </li>
    <li>
      <button class="qf-pagination__item" aria-current="page">1</button>
    </li>
    <li>
      <button class="qf-pagination__item">2</button>
    </li>
  </ul>
</nav>

Variants

qf-pagination__item

Required tokens

--s-1 --r-sm --text-secondary --bg-hover --bg-selected --text-strong --fs-14

Accessibility

Wrap it in nav[aria-label="pagination"] and set aria-current="page" on the current page. Give the previous/next buttons an aria-label, and signal unavailable states with disabled.nav[aria-label=페이지] 로 감싸고 현재 페이지에 aria-current=page 를 둡니다. 이전/다음 버튼에는 aria-label 을 주고, 불가 상태는 disabled 로 알립니다.

Navigation

Navbar

A top app bar that holds branding, navigation links, and actions. --sticky pins the bar to the top; use it on long lists and reading pages where search and a way back up must stay reachable. Class contract: consumer JS toggles is-stuck when scrolled past 0 (shadow and line) and is-hidden while scrolling down (slides up out of view). Narrow-width contract: the bar stays one line — the brand truncates with an ellipsis, the link group (qf-navbar__nav) scrolls horizontally when it overflows, icon buttons never shrink, and gaps/padding step down at ≤600px. On phones keep to brand + two links + three icon buttons; move a select or long links into a drawer or menu on the consumer side (the DS hides nothing).브랜드, 내비 링크, 액션을 담는 상단 앱 바입니다. --sticky 는 위에 붙는 고정 상단 바입니다 — 긴 목록이나 읽기 페이지처럼 내려간 뒤에도 찾기와 맨 위로 가는 길이 필요할 때 씁니다. 클래스 계약: 소비처 JS 가 스크롤이 0 이 아니면 is-stuck(그림자·선), 아래로 스크롤 중이면 is-hidden(위로 숨음)을 붙였다 뗍니다. 좁은 폭 계약: 바는 한 줄을 지킵니다 — 브랜드는 말줄임, 링크 묶음(qf-navbar__nav)은 넘치면 가로 스크롤, 아이콘 버튼은 줄지 않음, ≤600px 에서 간격·여백 한 단계 축소. 폰에 둘 것은 브랜드 + 링크 2개 + 아이콘 버튼 3개까지이고 select·긴 링크는 소비처가 드로어나 메뉴로 옮깁니다(DS 는 아무것도 숨기지 않습니다).

.qf-navbarlayer: generic

Preview

<nav class="qf-navbar" aria-label="Main menu">
  <span class="qf-navbar__brand">Acme</span>
  <div class="qf-navbar__nav">
    <a class="qf-navbar__link" aria-current="page">Dashboard</a>
    <a class="qf-navbar__link" href="/r">Reports</a>
  </div>
  <span class="qf-navbar__spacer">
  </span>
  <button class="qf-btn qf-btn--ghost qf-btn--icon" type="button" aria-pressed="true" aria-label="Light theme">
    <svg class="qf-icon qf-icon--md" aria-hidden="true">
      <use href="#qf-i-sun"/>
    </svg>
  </button>
  <button class="qf-btn qf-btn--primary qf-btn--sm">New</button>
</nav>

Variants

qf-navbar--sticky

Parts & more: 구성 요소, 기타: qf-navbar__brand qf-navbar__nav qf-navbar__link qf-navbar__spacer

Required tokens

--h-navbar --bg-panel --divider --s-5 --text-strong --bg-hover --bg-selected --z-header-sticky --elev-2 --border --dur-base --ease-standard --dur-fast --m-touch --s-4 --s-3 --s-2 --s-1 --fs-16 --fs-14 --tracking-tight --text-secondary --r-sm --text

Accessibility

Wrap it in header > nav[aria-label] and set aria-current="page" on the link for the current location. Use a[href] for links, with a visible keyboard focus. A theme toggle is a qf-btn--ghost qf-btn--icon with aria-pressed (light mode = true); consumer JS swaps the sun (qf-i-sun) / moon (qf-i-moon) icon. The pressed state shows as the selected surface. A pinned bar covers part of the viewport: place in-page sticky elements (qf-dayrule) below it with --qf-dayrule-top: var(--h-navbar) and give focus targets a scroll-margin-top. The hide transition becomes instant under prefers-reduced-motion. For --sticky, put the nav directly under body (or make the header itself the bar); a nav inside a header only sticks within the header box. If keyboard focus enters a hidden bar it reappears. Icon buttons inside the bar get a 44px hit area on touch devices automatically. If the brand is icon + text, put the ellipsis styling on the text span (an inline-flex brand needs text-overflow on the text element) and give the full name via title. __nav shows no overflow hint, so keep to two links on phones (keyboard focus scrolls automatically).header > nav[aria-label] 로 감싸고, 현재 위치 링크에 aria-current=page 를 둡니다. 링크는 a[href], 키보드 포커스 가시. 밝기 토글은 qf-btn--ghost qf-btn--icon 에 aria-pressed(밝은 모드 = true)를 두고 해(qf-i-sun)/달(qf-i-moon) 아이콘을 소비처 JS 가 바꿉니다. 눌린 상태는 selected 표면으로 보입니다. 고정 바는 뷰포트를 가리므로 페이지 안 sticky(qf-dayrule)는 --qf-dayrule-top: var(--h-navbar) 로 그 아래에 두고, 포커스 이동 대상에는 scroll-margin-top 을 줍니다. 숨김 전환은 prefers-reduced-motion 에서 즉시 바뀝니다. --sticky 는 nav 를 body 직하(또는 header 자체)에 두어야 뷰포트에 붙습니다(header 안의 nav 는 header 박스 안에서만 붙음). 숨은 바 안으로 키보드 포커스가 들어오면 다시 보입니다. 바 안의 아이콘 버튼은 터치 환경에서 44px 히트 영역을 자동으로 받습니다. 브랜드가 아이콘 + 글자면 글자 span 에 말줄임 스타일을 두고(inline-flex 브랜드는 text-overflow 가 글자 요소에 걸려야 함) title 로 전체 이름을 줍니다. __nav 는 넘침 단서가 없으므로 폰에서 링크 2개까지(키보드 포커스는 자동 스크롤).

Navigation

SideNav

A general-purpose vertical navigation organized into sections and items (unrelated to a chat channel list).섹션과 항목으로 구성된 범용 세로 내비게이션입니다(채팅 채널 목록과 무관).

.qf-sidenavlayer: generic

Preview

<nav class="qf-sidenav" aria-label="Sections">
  <div class="qf-sidenav__section">Workspace</div>
  <a class="qf-sidenav__item" aria-current="page">Overview</a>
  <a class="qf-sidenav__item" href="/m">Members</a>
</nav>

Variants

qf-sidenav__section qf-sidenav__item

Required tokens

--bg-panel --divider --s-3 --r-sm --text-secondary --bg-hover --bg-selected --text-muted

Accessibility

Wrap it in nav[aria-label] and set aria-current="page" on the current item. Distinguish groups with section headings (qf-sidenav__section).nav[aria-label] 로 감싸고, 현재 항목에 aria-current=page 를 둡니다. 섹션 제목(qf-sidenav__section)으로 그룹을 구분합니다.

Navigation

PostNav

Previous / next post links at the end of an article (end of the reading column, before the footer — the "after reading" slot). Two cells; at ≤600px they stack so titles do not wrap into many lines. Each cell is a card-toned block link (qf-postnav__link, --prev / --next) holding an eyebrow (qf-postnav__eyebrow: "← Previous" / "Next →") and a title (qf-postnav__title, 15px 600, two-line clamp); the next cell is right-aligned. If only one neighbour exists, render just that cell.글 끝의 이전 글 / 다음 글입니다(읽기 열 끝, 바닥글 앞 — "읽은 다음"의 자리). 두 칸이며 ≤600px 에서는 한 칸씩 세로로 쌓여 제목이 여러 줄로 감기지 않습니다. 각 칸은 카드 톤의 블록 링크(qf-postnav__link, --prev / --next)로 머리말(qf-postnav__eyebrow: "← 이전 글" / "다음 글 →")과 제목(qf-postnav__title, 15px 600, 두 줄 clamp)을 담고, 다음 글은 오른쪽 정렬입니다. 한쪽만 있으면 그 칸만 둡니다.

.qf-postnavlayer: generic

Preview

<nav class="qf-postnav" aria-label="Adjacent posts">
  <a class="qf-postnav__link qf-postnav__link--prev" href="#prev">
    <span class="qf-postnav__eyebrow">← Previous</span>
    <span class="qf-postnav__title">.NET - WPF JumpList</span>
  </a>
  <a class="qf-postnav__link qf-postnav__link--next" href="#next">
    <span class="qf-postnav__eyebrow">Next →</span>
    <span class="qf-postnav__title">PowerShell - Creating a Credential for remote access</span>
  </a>
</nav>

Variants

qf-postnav__link qf-postnav__link--prev qf-postnav__link--next qf-postnav__eyebrow qf-postnav__title

Required tokens

--s-9 --s-4 --s-5 --s-2 --border --border-strong --r-lg --bg-panel --bg-elevated --fs-12 --fs-15 --lh-tight --lh-snug --tracking-caps --text-muted --text-strong --accent-text --ring-focus --dur-fast --ease-standard

Accessibility

Wrap in nav[aria-label="Adjacent posts"]; each cell is an a[href]. The eyebrow arrows are text and are read, so the link name reads like "Previous post, title". The focus ring surrounds the whole cell. Provide clamped titles in full via a title attribute.nav[aria-label="앞뒤 글"] 로 감싸고 각 칸은 a[href] 입니다. 머리말의 화살표는 텍스트라 낭독되며 링크 이름은 "이전 글 제목" 처럼 읽힙니다. 포커스 링이 칸 전체에 보입니다. 두 줄 clamp 로 잘린 제목은 title 속성으로 전체를 줄 수 있습니다.

Navigation

Chip

Desktop filter chips and their group (qf-chips). Works as links (a + aria-current="page") or buttons (button + aria-pressed="true"); the selected state uses an accent-subtle background, accent border, and a bold label. The group wraps by default; --scroll makes a single horizontally scrolling row on narrow screens (scrollbar hidden). Shares tokens with the mobile qf-m-filter-chip (--r-pill, --accent-subtle, --accent) for visual consistency; only the label color is --accent-on-subtle for AA. --scroll fades its right edge into the background to hint there is more, only when the row overflows, and the fade clears at the end (automatically where scroll-driven animations are supported; otherwise consumer JS adds is-end). On touch devices chips are 40px tall with a transparent 44px hit area. qf-picks (image pick rows) shares the same fade.데스크톱 필터 칩과 그 묶음(qf-chips)입니다. 링크(a + aria-current="page")와 버튼(button + aria-pressed="true") 모두 지원하며 선택 상태는 accent-subtle 배경, accent 테두리, 굵은 라벨로 표시합니다. 기본은 줄바꿈(wrap), --scroll 은 좁은 폭에서 한 줄 가로 스크롤(스크롤바 숨김)입니다. 모바일 qf-m-filter-chip 과 같은 토큰(--r-pill, --accent-subtle, --accent)을 써서 시각이 일관되며, 라벨 색만 AA 를 위해 --accent-on-subtle 입니다. --scroll 은 오른쪽 끝을 배경으로 녹아들게 페이드해 더 있음을 암시하고, 넘칠 때만 생기며 끝까지 스크롤하면 걷힙니다(스크롤 타임라인 지원 브라우저는 자동, 그 밖은 소비처 JS 가 is-end 를 붙임). 터치 환경에서 칩은 40px 이고 투명 영역으로 44px 히트를 확보합니다. 같은 페이드를 qf-picks(이미지 선택 타일 줄)도 씁니다.

.qf-chiplayer: generic

Preview

<nav class="qf-chips" aria-label="Category">
  <a class="qf-chip" href="#all" aria-current="page">All</a>
  <a class="qf-chip" href="#politics">Politics</a>
  <a class="qf-chip" href="#society">Society</a>
  <a class="qf-chip" href="#economy">Economy</a>
  <a class="qf-chip" href="#culture">Culture</a>
  <a class="qf-chip" href="#sports">Sports</a>
  <a class="qf-chip" href="#tech">Tech</a>
  <a class="qf-chip" href="#world">World</a>
</nav>

Examples예시

Buttons (aria-pressed) with counts
--scroll (single row, scrolls sideways)

Variants

qf-chips qf-chips--scroll qf-chip__count

Required tokens

--bg-panel --bg-hover --border --border-strong --text-secondary --text --text-muted --accent-subtle --accent --accent-on-subtle --r-pill --fs-13 --s-2 --s-3 --s-4 --m-touch --ring-focus --s-1 --lh-tight --dur-fast --ease-standard --s-9 --s-10

Accessibility

Link chips are anchors inside nav[aria-label] with aria-current="page" on the current one; button chips use aria-pressed. The selected state is conveyed by border and weight as well as color. The focus ring stays visible (--scroll keeps a 4px inner padding for the halo and a matching negative margin to stay aligned, so the parent needs at least 4px of horizontal room), and on touch devices (any-pointer: coarse, including touch laptops) chips are 40px tall with a transparent 44px hit area (hit areas of adjacent rows touch but do not overlap). In --scroll, tabbing brings each chip into view. The --scroll fade appears only when the row overflows (with scroll-driven animation support), and tabbing to a chip stops left of the fade via scroll-padding. Without support, consumer JS adds is-end on load, resize and scroll when the row is at its end or does not overflow.링크 칩은 nav[aria-label] 안의 a 로 두고 현재 항목에 aria-current="page" 를, 버튼 칩은 aria-pressed 를 씁니다. 선택 상태는 색과 함께 테두리와 굵기로도 전달합니다. 포커스 링이 보이고(--scroll 은 halo 까지 보이도록 4px 여백을 안쪽에 두고 같은 크기의 음수 margin 으로 정렬을 유지하므로, 부모에 4px 이상 좌우 여백이 필요합니다), 터치 환경(any-pointer: coarse, 터치 노트북 포함)에서는 칩이 40px 이고 투명 영역으로 44px 히트를 확보합니다(인접 행의 히트 영역은 맞닿기만 함). --scroll 은 키보드로 Tab 이동 시 브라우저가 칩을 뷰로 스크롤합니다. --scroll 의 페이드는 넘칠 때만 생기고(스크롤 타임라인 지원 시), Tab 으로 칩에 가면 scroll-padding 으로 페이드 왼쪽에 멈춥니다. 미지원 브라우저는 소비처 JS 가 load·resize·scroll 에서 끝에 닿았거나 넘치지 않으면 is-end 를 붙입니다.

Overlays

Tooltip

A bubble that shows a short description when an element is pointed at.요소를 가리킬 때 짧은 설명을 띄우는 말풍선입니다.

.qf-tooltiplayer: generic

Preview

Open settings
<span class="qf-tooltip" role="tooltip" id="tt-1">Open settings</span>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--bg-inverse --text-inverse --r-sm --fs-12 --elev-2

Accessibility

Mark it with role="tooltip" and associate it with the target via aria-describedby. Since it has no pointer-events, ensure the content is also reachable via keyboard focus.role="tooltip" 으로 표시하고 대상에 aria-describedby 로 연결합니다. pointer-events 가 없으므로 키보드 포커스로도 내용을 접근할 수 있게 합니다.

Overlays

Modal

A modal dialog presented over the screen.화면 위에 띄우는 모달 대화상자입니다.

.qf-modallayer: generic

Preview

<div class="qf-modal" role="dialog" aria-modal="true" aria-labelledby="m-t">
  <div class="qf-modal__header">
    <h2 class="qf-modal__title" id="m-t">Delete project</h2>
    <button class="qf-btn qf-btn--icon qf-btn--lg qf-btn--ghost" aria-label="Close">
      <svg class="qf-icon qf-icon--md" aria-hidden="true">
        <use href="#qf-i-x"/>
      </svg>
    </button>
  </div>
  <div class="qf-modal__body">This action cannot be undone. The project and all its data will be permanently deleted.</div>
  <div class="qf-modal__footer">
    <button class="qf-btn qf-btn--ghost">Cancel</button>
    <button class="qf-btn qf-btn--danger">Delete</button>
  </div>
</div>

Variants

qf-modal-backdrop qf-modal__header qf-modal__title qf-modal__body qf-modal__footer

Required tokens

--bg-elevated --border --r-xl --elev-4 --s-7 --divider --z-modal --z-modal-bg

Accessibility

Set role="dialog" and aria-modal="true", and associate the title via aria-labelledby. Trap focus within the modal, close on Esc, and move focus into it when it opens.role="dialog" 와 aria-modal="true" 를 지정하고 aria-labelledby 로 제목과 연결합니다. 포커스를 모달 안에 가두고 Esc 로 닫으며, 열릴 때 포커스를 옮깁니다.

Overlays

SettingsLayout

A settings layout split into a left navigation and a main content area.좌측 내비게이션과 본문 영역으로 나뉜 설정 레이아웃입니다.

.qf-settingslayer: generic

Preview

Content
<div class="qf-settings">
  <nav class="qf-settings__nav">
    <a class="qf-settings__nav-item" aria-selected="true">General</a>
  </nav>
  <div class="qf-settings__main">Content</div>
</div>

Variants

qf-settings__nav qf-settings__nav-head qf-settings__nav-item qf-settings__main

Required tokens

--bg-panel --divider --s-4 --s-8 --r-sm --text-secondary --bg-selected

Accessibility

Express the current selection on nav items with aria-selected and keep keyboard focus visible. Convey the selected state via aria attributes, not background color alone.내비 항목은 aria-selected로 현재 선택을 표현하고 키보드 포커스가 보이게 합니다. 선택 상태는 배경색뿐 아니라 aria 속성으로 함께 전달합니다.

Overlays

SettingsOverlay

A settings overlay presented over the full screen.전체 화면 위에 띄우는 설정 오버레이입니다.

.qf-settings-overlaylayer: generic

Preview

<div class="qf-settings-overlay__backdrop">
</div>
<div class="qf-settings-overlay__card" role="dialog" aria-modal="true" aria-label="Settings">
  <button class="qf-settings-overlay__close" aria-label="Close">×</button>
  <div class="qf-stack" style="padding:var(--s-8)">
    <h2>Settings</h2>
    <p style="color:var(--text-secondary);max-width:560px">Edit app-wide settings such as account, notifications, and theme in a full-screen overlay. Lay it out with navigation on the left and a content area on the right.</p>
  </div>
</div>

Variants

qf-settings-overlay__backdrop qf-settings-overlay__card qf-settings-overlay__close

Required tokens

--z-settings --z-settings-bg --bg-app --r-xl --elev-4 --s-8 --dur-base

Accessibility

Mark the card as a modal with role=dialog and aria-modal="true", trap focus, and close on Esc. Give the close button an aria-label.카드는 role=dialog와 aria-modal="true"로 모달임을 알리고 포커스를 가두며 Esc로 닫습니다. 닫기 버튼에는 aria-label을 둡니다.

Overlays

CommandPalette

A command and search palette opened via a keyboard shortcut.단축키로 여는 명령, 검색 팔레트입니다.

.qf-cmd-palettelayer: generic

Preview

<div class="qf-cmd-palette" role="dialog" aria-label="Command palette">
  <div class="qf-cmd-palette__search">
    <input class="qf-cmd-palette__input" role="combobox" aria-expanded="true" aria-controls="cmd-list" placeholder="Search commands">
  </div>
  <ul id="cmd-list" class="qf-cmd-palette__list" role="listbox">
    <li class="qf-cmd-palette__row" role="option" aria-selected="true">
      <span class="qf-cmd-palette__label">New document</span>
    </li>
  </ul>
</div>

Variants

qf-cmd-palette-backdrop qf-cmd-palette__search qf-cmd-palette__input qf-cmd-palette__list qf-cmd-palette__section qf-cmd-palette__row qf-cmd-palette__row-icon qf-cmd-palette__label qf-cmd-palette__path qf-cmd-palette__kbd qf-cmd-palette__empty

Required tokens

--bg-elevated --border --r-xl --elev-4 --accent --bg-selected --s-4

Accessibility

Indicate the current selection on result rows with aria-selected, and provide a cue beyond color via a left accent bar on the selected row. Ensure up and down keyboard navigation and visible focus, and convey empty results with text.결과 행은 aria-selected로 현재 선택을 알리고 선택 행은 좌측 accent bar로 색 외 단서를 함께 제공합니다. 키보드 위아래 이동과 포커스 가시를 보장하고, 빈 결과는 텍스트로 안내합니다.

Overlays

EmojiPicker

A picker for searching emoji and choosing them by category.이모지를 검색, 카테고리별로 골라 넣는 선택기입니다.

.qf-emoji-pickerlayer: generic

Preview

<div class="qf-emoji-picker" role="dialog" aria-label="Select emoji">
  <div class="qf-emoji-picker__search">
    <div class="qf-emoji-picker__search-field">
      <span class="qf-emoji-picker__search-icon">
        <svg class="qf-icon qf-icon--sm" aria-hidden="true">
          <use href="#qf-i-search"/>
        </svg>
      </span>
      <input class="qf-emoji-picker__search-input" type="search" aria-label="Search emoji" placeholder="Search">
    </div>
  </div>
  <div class="qf-emoji-picker__tabs" role="tablist">
    <button class="qf-emoji-picker__tab" role="tab" aria-selected="true" aria-label="Smileys">😀</button>
    <button class="qf-emoji-picker__tab" role="tab" aria-selected="false" aria-label="Animals">🐶</button>
    <button class="qf-emoji-picker__tab" role="tab" aria-selected="false" aria-label="Food">🍔</button>
    <button class="qf-emoji-picker__tab" role="tab" aria-selected="false" aria-label="Activities">⚽</button>
    <button class="qf-emoji-picker__tab" role="tab" aria-selected="false" aria-label="Symbols">🎵</button>
  </div>
  <div class="qf-emoji-picker__grid">
    <div class="qf-emoji-picker__category-label">Smileys</div>
    <div class="qf-emoji-picker__row">
      <button class="qf-emoji-picker__cell" aria-selected="true" aria-label="Emoji">😀</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😃</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😄</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😁</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😆</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😅</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😂</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">🤣</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😊</button>
    </div>
    <div class="qf-emoji-picker__row">
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😇</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">🙂</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">🙃</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😉</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😌</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😍</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">🥰</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😘</button>
      <button class="qf-emoji-picker__cell" aria-label="Emoji">😗</button>
    </div>
  </div>
  <div class="qf-emoji-picker__preview">
    <span class="qf-emoji-picker__preview-emoji">😀</span>
    <span class="qf-emoji-picker__preview-shortcode">:grinning:</span>
  </div>
</div>

Variants

qf-emoji-picker__search qf-emoji-picker__search-field qf-emoji-picker__search-input qf-emoji-picker__tabs qf-emoji-picker__tab qf-emoji-picker__grid qf-emoji-picker__category-label qf-emoji-picker__row qf-emoji-picker__cell qf-emoji-picker__preview qf-emoji-picker__preview-shortcode qf-emoji-picker__preview--empty

Required tokens

--bg-elevated --border --r-xl --elev-4 --accent --bg-hover --bg-selected --s-3

Accessibility

Convey state on category tabs and emoji cells with aria-selected, and add a cue beyond color via a bottom accent indicator on the selected tab. Surface the shortcode text in the bottom preview and ensure visible focus.카테고리 탭과 이모지 셀은 aria-selected로 상태를 전하고, 선택 탭은 하단 accent 표시로 색 외 단서를 더합니다. 하단 미리보기에 shortcode 텍스트를 함께 노출하고 포커스 가시를 보장합니다.

Overlays

UploadOverlay

A drag-and-drop guidance overlay shown while files are being dragged over a drop target.파일을 끌어다 놓는 동안 표시되는 드래그 앤 드롭 안내 오버레이입니다.

.qf-upload-overlaylayer: generic

Preview

Drop here to upload

Up to 50MB

<div class="qf-upload-overlay" role="status" aria-live="polite">
  <div class="qf-upload-overlay__icon">
    <svg class="qf-icon" aria-hidden="true">
      <use href="#qf-i-upload"/>
    </svg>
  </div>
  <p class="qf-upload-overlay__title">Drop here to upload</p>
  <p class="qf-upload-overlay__hint">Up to 50MB</p>
</div>

Variants

qf-upload-overlay__icon qf-upload-overlay__title qf-upload-overlay__hint

Required tokens

--accent-bg --accent --r-xl --s-3 --s-4 --text-strong --text-secondary

Accessibility

The overlay is purely visual with no pointer-events, conveying its action through a title and hint text. A dashed border is paired with guidance text so meaning is not carried by color alone.오버레이는 pointer-events 없이 시각 안내만 담당하며, 제목과 힌트 텍스트로 동작을 명확히 전달합니다. 점선 테두리와 함께 안내 문구를 두어 색 단독 의존을 피합니다.

Overlays

Popover

A floating panel of arbitrary content anchored to a trigger (free-form content, unlike a menu).트리거 기준으로 떠 있는 임의 콘텐츠 패널입니다(메뉴와 달리 자유 콘텐츠).

.qf-popoverlayer: generic

Preview

<div class="qf-popover" role="dialog" aria-label="Filter">
  <p>This is floating content.</p>
</div>

Variants

No variants — single style.변형 없음 — 단일 스타일.

Required tokens

--bg-floating --border --r-lg --elev-3 --s-4 --z-dropdown

Accessibility

Set aria-haspopup/aria-expanded on the trigger and link it to the panel with aria-controls. Close on Esc and restore focus to the trigger, and move focus into the panel when it opens.트리거에 aria-haspopup/aria-expanded 를 두고 패널과 aria-controls 로 연결합니다. Esc 로 닫고 포커스를 트리거로 복원하며, 열릴 때 포커스를 패널로 옮깁니다.

Overlays

Drawer

A panel that slides in from the edge of the screen (right by default, with a left variant).화면 측면에서 슬라이드되는 패널입니다(우측 기본, 좌측 변형).

.qf-drawerlayer: generic

Preview

<div class="qf-drawer-backdrop">
</div>
<aside class="qf-drawer" role="dialog" aria-modal="true" aria-label="Settings">
  <div class="qf-drawer__header">
    <h2 class="qf-drawer__title">Settings</h2>
  </div>
  <div class="qf-drawer__body">Content</div>
</aside>

Variants

qf-drawer--left

Parts & more: 구성 요소, 기타: qf-drawer-backdrop qf-drawer__header qf-drawer__title qf-drawer__body qf-drawer__footer

Required tokens

--bg-elevated --border --elev-4 --z-modal --z-modal-bg --scrim --s-6 --divider

Accessibility

Announce it with role="dialog" and aria-modal="true", and trap focus inside the panel. Close on Esc and backdrop click, and restore focus to where it was before opening.role=dialog 와 aria-modal=true 로 알리고 포커스를 패널 안에 가둡니다. Esc 와 backdrop 클릭으로 닫고, 열기 전 포커스를 복원합니다.

Overlays

Lightbox

A chrome-free fullscreen contain-fit media viewer (zoom) or a full-bleed scrolling contact sheet. Unlike a dialog (qf-modal), it holds only media — no panel chrome.크롬 없는 풀스크린 contain-fit 미디어 뷰어(줌) 또는 풀블리드 스크롤 컨택트 시트입니다. 다이얼로그(qf-modal)와 달리 패널 크롬 없이 미디어만 담습니다.

.qf-lightboxlayer: generic

Preview

<div class="qf-lightbox">
  <button class="qf-lightbox__close" aria-label="Close">
    <svg class="qf-icon qf-icon--md" aria-hidden="true">
      <use href="#qf-i-x"/>
    </svg>
  </button>
  <div class="qf-lightbox__stage">
    <div class="qf-lightbox__media" style="width:260px;aspect-ratio:3 / 2;background:var(--bg-media)">
    </div>
  </div>
</div>

Examples예시

Contact sheet (--sheet)

Variants

qf-lightbox__close qf-lightbox__stage qf-lightbox__media qf-lightbox__sheet qf-lightbox__frame qf-lightbox__caption qf-lightbox--dim qf-lightbox--sheet

Required tokens

--scrim --scrim-strong --scrim-blur --z-modal --on-media-glass-bg --on-media-border --on-media-text --r-md --safe-top --ring-focus --s-8

Accessibility

role=dialog + aria-modal=true + aria-label. Trap focus, move focus to the close button on open, and restore it to the trigger on close. Close on Esc and scrim click (stop propagation on media clicks); the close button is 44px; respect prefers-reduced-motion.role=dialog + aria-modal=true + aria-label. 포커스를 가두고 열 때 닫기 버튼으로 포커스 이동, 닫을 때 트리거로 복원. Esc와 스크림 클릭으로 닫고(미디어 클릭은 stopPropagation), 닫기 버튼은 44px, prefers-reduced-motion을 존중합니다.

Disclosure

Accordion

A disclosure list whose sections expand and collapse when you click their header.제목을 눌러 내용을 펼치고 접는 디스클로저 목록입니다.

.qf-accordionlayer: generic

Preview

Shipping policy
Ships within 3 days.
<div class="qf-accordion">
  <details class="qf-accordion__item" open>
    <summary class="qf-accordion__trigger">Shipping policy</summary>
    <div class="qf-accordion__panel">Ships within 3 days.</div>
  </details>
</div>

Variants

qf-accordion__item qf-accordion__trigger qf-accordion__panel

Required tokens

--border --divider --r-lg --s-4 --s-5 --text-strong --bg-hover

Accessibility

Built on native details/summary, so keyboard toggling and expanded-state communication come for free. Put meaningful header text in the summary (qf-accordion__trigger).네이티브 details/summary 기반이라 키보드 토글과 펼침 상태 전달이 기본 제공됩니다. summary(qf-accordion__trigger)에 의미 있는 제목 텍스트를 둡니다.

Pattern

Full chat mockup

A real screen assembled entirely from the components above. The same 3-column layout as Discord.위 컴포넌트로만 조립한 실제 화면. Discord와 동일한 3-column 레이아웃.

qufox team
▾ PRODUCT
announcements 2
general
design
voice-lounge
▾ ENGINEERING
frontend
backend 12
general
Announcements, General chat공지, 일반 대화
dev_leeMOD2:34 PM오후 2:34

All the brand assets are in. @designer_kim please take a look!브랜드 에셋 다 반영했습니다. @designer_kim 확인 부탁!

🦊5
🚀2
designer_kim2:38 PM오후 2:38

Looks good! Just double-check that the --r-xl value is applied to the cards.좋아요! --r-xl 값 카드에 적용했는지만 확인해주세요.

And the favicon looks great too 👀그리고 파비콘도 잘 보이네요 👀
pm_choi is typing…pm_choi 입력 중…
ONLINE — 3
founder_park
dev_lee
designer_kim
OFFLINE — 8
eng_jung
ops_han
Assets

Icon pack: 100+

All the icons your chat UI needs in one set. Every icon is drawn as 24×24 viewBox, SVG path, stroke=currentColor and covers Discord/Slack patterns. Set the color via CSS color and the size via the size modifier.채팅 UI에 필요한 아이콘을 한 세트로. 모두 24×24 viewBox, SVG path, stroke=currentColor로 그려졌고, Discord/Slack 패턴을 덮습니다. 색상은 CSS color로, 크기는 사이즈 modifier로 조절해요.

Usage

<!-- 1. Load once in the document -->
<link rel="stylesheet" href="icons.css">

<!-- 2. Reference by symbol ID -->
<svg class="qf-icon"><use href="icons.svg#qf-i-send"/></svg>

<!-- Size / color modifiers -->
<svg class="qf-icon qf-icon--sm">...</svg>      /* 16 */
<svg class="qf-icon qf-icon--lg qf-icon--accent">...</svg>

Sizes

sm: 16
md: 20
lg: 24
xl: 28

Colors

currentColor
--accent
--muted
success
danger

In-context examples

in buttons
message hover toolbar
Message #general
composer
voice controls
Online
Idle
Do not disturb
presence
Edit message
Pin message
Copy link
Delete
dropdown menu

Full list전체 목록

Click to copy the <use href="#..."/> string.클릭하면 <use href="#..."/> 문자열이 복사돼요.
copied
Pattern

Auth — Login & sign-up

Drop-in authentication screens built only from generic components — qf-card, qf-field, qf-input, qf-btn, qf-notice, qf-strength-meter. Accent and surfaces follow the active brand — switch Brand or theme in the top bar to watch them re-skin — and the symbol comes from brand.config.json, so every white-label customer gets these screens for free.범용 컴포넌트(qf-card, qf-field, qf-input, qf-btn, qf-notice, qf-strength-meter)만으로 구성한 즉시 사용 가능한 인증 화면입니다. accent와 표면은 활성 브랜드를 따라 — 상단에서 Brand나 테마를 바꾸면 다시 칠해집니다 — 심볼은 brand.config.json에서 와서, 모든 화이트라벨 고객이 이 화면을 그대로 쓸 수 있습니다.

Log in

qufox: sign in

Welcome back다시 만나 반가워요

Pick up right where you left off.바로 이어서 시작하세요.

No account yet? 계정이 없으신가요? Sign up가입하기

Forgot your password?비밀번호를 잊으셨나요?

Sign up

qufox: sign up

Create your account계정을 만들어요

It only takes a minute to get started.1분이면 시작할 수 있어요.

Password

Strong강함

Already have an account? 이미 계정이 있으신가요? Log in로그인

States & messaging상태와 메시지

Form feedback uses the same notice and field-error patterns, so the affordance never relies on color alone — each message carries an icon and text, and live regions announce errors to screen readers.폼 피드백은 동일한 notice와 field-error 패턴을 써서 색에만 의존하지 않습니다 — 각 메시지는 아이콘과 텍스트를 함께 두고, 라이브 영역이 오류를 스크린리더에 통지합니다.
Your session expired, so you were signed out. Please log in again.세션이 만료되어 로그아웃되었습니다. 다시 로그인해 주세요.
App screens

Workspace, Discover

New workspace creation flow and browsing public workspaces. Category metadata (emoji, labels) follows WORKSPACE_CATEGORY_META.새 워크스페이스 생성 플로우와 공개 워크스페이스 둘러보기. 카테고리 메타(이모지, 라벨)는 WORKSPACE_CATEGORY_META를 따릅니다.

Discover: Desktop

Top search + category segment + card grid. The join button is .qf-btn--primary.상단 검색 + 카테고리 segment + 카드 그리드. 참여 버튼은 .qf-btn--primary.

Public workspaces공개 워크스페이스

Q
qufox Design Guildqufox 디자인 길드
🎨 Art, 248 members🎨 예술, 248명

A space where designers gather to share their process and exchange feedback.디자이너들이 모여 작업 과정을 공유하고 피드백을 주고받는 공간.

F
Frontend KoreaFrontend 한국
💻 Dev, 1,204 members💻 개발, 1,204명

A community studying modern frontend together — React, Vue, Svelte, and more.React, Vue, Svelte 등 모던 프론트엔드를 함께 공부하는 커뮤니티.

G
Game Dev Lounge
🎮 Gaming, 87 members🎮 게임, 87명

A small gathering where indie game developers share their work and trade feedback.인디 게임 개발자들이 작업물 공유하고 피드백하는 작은 모임.

Create workspace: Desktop modal

Create a new workspace새 워크스페이스 만들기

Create a space to chat with your friends and team. You can change this later.내 친구들, 팀과 대화할 공간을 만들어보세요. 나중에 변경할 수 있어요.

qufox.app/w/
Lowercase letters, numbers, and hyphens only소문자, 숫자, 하이픈만 가능
Public workspace공개 워크스페이스
Listed in Discover so anyone can request to joinDiscover에 노출되어 누구나 참여 요청 가능

Mobile

Discover찾기
Public workspaces공개 워크스페이스
New workspace새 워크스페이스
/w/
Public공개
Listed in DiscoverDiscover에 노출
App screens

Channel settings

Split into Overview, Members, and Permissions tabs. A Discord-style left nav pattern, but on mobile it collapses into a single scroll plus a segment control.개요, 멤버, 권한 탭으로 분리. Discord와 같은 좌측 nav 패턴이지만 모바일에서는 단일 스크롤 + segment로 압축.

Desktop: Overview tab

Overview개요

Configure the channel's basic information.채널의 기본 정보를 설정합니다.

Shown in the channel header.채널 헤더에 표시됩니다.
Private channel비공개 채널
Only invited members can view it.초대된 멤버만 볼 수 있어요.
Slow mode슬로우 모드
Minimum 5-second interval between messages메시지 사이 최소 5초 간격

Desktop: Members tab

Members멤버 42

Member멤버
Role역할
Joined가입
Y유
Yujin유진
@yujin
Owner소유자
2024.01.12
M민
Minseo민서
@minseo
Admin관리자
2024.02.03
J지
Jiho지호
@jiho
Member멤버
2024.03.18
S소
Soyoung소영
@soyoung
Member멤버
2024.04.02

Mobile

#general
Channel settings채널 설정
Private비공개
Invited members only초대된 멤버만
Slow mode슬로우 모드
5-second interval5초 간격
Members: 42멤버: 42
#general
Admins: 3관리자: 3
Members: 39멤버: 39
App screens

Channel, Category modals

New channel, new category, creating a channel inside a category. All use the same modal component + .qf-toggle-row pattern.새 채널, 새 카테고리, 카테고리 안에 채널 만들기. 모두 같은 modal 컴포넌트 + .qf-toggle-row 패턴.

Desktop: Create Channel

Create Channel채널 만들기

Add a new channel to the PRODUCT category.PRODUCT 카테고리에 새 채널을 추가합니다.

Private channel비공개 채널
Only selected members and roles can see it.선택한 멤버와 역할만 볼 수 있어요.

Desktop: Create Category

Create Category카테고리 만들기

Group related channels together to keep things organized.관련된 채널들을 묶어서 정리할 수 있어요.

Private category비공개 카테고리
All sub-channels are synced to private.하위 채널이 모두 비공개로 동기화됩니다.

Mobile: Bottom sheet

Create Channel채널 만들기
Private비공개
ENGINEERING categoryENGINEERING 카테고리
App screens

Threads

Split follow-up conversations off a message inline. Desktop uses a right-hand side panel, mobile uses a full-screen route.메시지의 후속 대화를 인라인으로 분리. 데스크톱은 우측 사이드 패널, 모바일은 풀스크린 라우트.

Desktop: Thread panel beside chat

qufox team
▾ PRODUCT
general
design
announcements 2
general
Team-wide announcements팀 전체 공지
E유
Eugene유진Today 10:42 AM오늘 오전 10:42
It would be good to write up the major changes going into the next release. Please review the PR below 🙏다음 릴리즈에 들어갈 큰 변경사항 정리해두면 좋을 것 같아요. 아래 PR 리뷰 부탁드립니다 🙏
M민
Minseo민서10:48 AM오전 10:48
This behaves the same on mobile too, right? I added test cases.이거 모바일에서도 같은 동작 맞죠? 테스트 케이스 추가했어요.
7 replies7개의 답글 , Latest: 12 minutes ago, 가장 최근: 12분 전
J지
Jiho지호11:02 AM오전 11:02
I think we should merge the design token PR along with it.디자인 토큰 PR도 같이 머지하면 좋을 것 같아요.

Mobile: Full-screen thread

Thread스레드
#general, 7 replies7개의 답글
Minseo민서 10:48 AM오전 10:48
This behaves the same on mobile too, right? I added test cases.이거 모바일에서도 같은 동작 맞죠? 테스트 케이스 추가했어요.
7 replies7개의 답글
E유
Eugene유진11:05
Right. Please double-check once more on iOS Safari.맞아요. iOS Safari에서 한 번 더 확인 부탁드려요.
Please look at the scroll performance too 🙏스크롤 성능도 같이 봐주세요 🙏
M민
Minseo민서11:14
Tests passed ✅테스트 통과했습니다 ✅
J지
Jiho지호11:22
I think you can go ahead and merge!머지하셔도 될 것 같아요!
App screens

DM shell

One-on-one conversations with friends, no workspace required. DM list on the left plus the main conversation area. On mobile, the list and conversation are separate routes.워크스페이스 없이도 친구와 1:1 대화. 좌측 DM 리스트 + 메인 대화 영역. 모바일은 리스트와 대화가 별도 라우트.

Desktop: DM list + active conversation

Friends친구 Activity활동
Direct Messages다이렉트 메시지
M민
Minseo민서
All tests passed ✅테스트 통과했습니다 ✅
J지
Jiho 3지호 3
Merged the design tokens PR디자인 토큰 PR 머지했어요
S소
Soyoung, Gunwoo소영, 건우
Gunwoo: How about tomorrow afternoon?건우: 내일 오후 어때요?
G건
Gunwoo건우
See you tomorrow!내일 봬요!
M민
Minseo민서
@minseo, Online@minseo, 온라인
Wednesday, May 22, 20242024년 5월 22일 수요일
M민
Minseo민서10:14 AM오전 10:14
Finished the PR review. I left a few comments.PR 리뷰 끝났어요. 코멘트 몇 개 남겨놨습니다.
Y유
Yujin유진10:32 AM오전 10:32
Thank you! I'll make the changes and let you know.감사합니다! 반영하고 다시 알려드릴게요.
M민
Minseo민서11:14 AM오전 11:14
All tests passed ✅테스트 통과했습니다 ✅
I think it's good to merge머지해도 될 것 같아요

Mobile

Messages메시지
M민
Minseo민서
Direct message, Online다이렉트 메시지, 온라인
Wednesday, May 225월 22일 수요일
M민
Minseo민서10:14
Finished the PR review. I left a few comments.PR 리뷰 끝났어요. 코멘트 몇 개 남겨놨습니다.
Y유
Yujin유진10:32
Thank you! I'll make the changes and let you know.감사합니다! 반영하고 다시 알려드릴게요.
M민
Minseo민서11:14
All tests passed ✅테스트 통과했습니다 ✅
I think it's good to merge머지해도 될 것 같아요
App screens

Friends

Friends list + incoming/outgoing requests + user blocking. The 4-tab segment pattern is identical on desktop and mobile.친구 목록 + 받은/보낸 요청 + 사용자 차단. 4-탭 segment 패턴은 데스크톱, 모바일 동일.

Desktop: All friends

Friends친구
All friends — 8전체 친구 — 8
M민
Minseo민서
@minseo, Online@minseo, 온라인
J지
Jiho지호
@jiho, Away@jiho, 자리 비움
S소
Soyoung소영
@soyoung, Offline@soyoung, 오프라인
G건
Gunwoo건우
@gunwoo, Do not disturb@gunwoo, 방해 금지

Desktop: Pending requests

Friend requests친구 요청

Incoming requests — 2받은 요청 — 2
H하
Haneul하늘
@haneul, Incoming request@haneul, 받은 요청
B바
Bada바다
@bada, Incoming request@bada, 받은 요청
Outgoing requests — 1보낸 요청 — 1
G강
Gangsan강산
@gangsan, Awaiting response@gangsan, 응답 대기 중

Mobile

Friends친구
All friends, 8전체 친구, 8
Pending대기 중
Incoming requests, 2받은 요청, 2
H하
Haneul하늘
@haneul
B바
Bada바다
@bada
Outgoing requests, 1보낸 요청, 1
Mobile

Mobile system

Mobile layout based on Discord/Slack patterns. Touch targets 44×44 or larger, automatic safe-area inset handling, optimized for one-handed operation with a bottom tab + bottom sheet combination.Discord/Slack 패턴 기반의 모바일 레이아웃. 터치 타겟 44×44 이상, safe-area inset 자동 처리, bottom tab + bottom sheet 조합으로 한 손 조작 최적화.

Layout patterns

The mobile primitives (qf-m-*) are documented individually — see the qufox app (chat module) group in the sidebar (topbar, tab bar, bottom sheet, list rows, composer) and the full chat mockup for assembled iOS/Android screens (same classes on both).qf-m-* 모바일 프리미티브는 개별 페이지로 문서화돼 있습니다 — 사이드바 qufox app (chat module) 그룹(topbar, tab bar, bottom sheet, list row, composer)과 조립된 iOS/Android 화면은 full chat mockup을 참고하세요(양 플랫폼 동일 클래스).

Mobile-only tokens

--m-topbar-h:   52px;     /* top nav height */
--m-tabbar-h:   56px;     /* bottom tab bar (excludes safe-area) */
--m-rail-w:     72px;     /* side tab bar width, wide side-by-side only (excludes safe-area) */
--m-composer-h: 56px;     /* message input field */
--m-touch:      44px;     /* minimum hit target (Apple HIG) */
--m-gutter:     16px;     /* left/right padding */
--m-sheet-r:    20px;     /* bottom sheet top radius */

Core components핵심 컴포넌트

.qf-m-screen

Top-level shell. topbar + scrollable body + tabbar/composer structure.최상위 쉘. topbar + scrollable body + tabbar/composer 구조.

.qf-m-topbar

3-column (back, title, actions). Fixed 52px height.3-컬럼 (back, title, actions). 높이 52px 고정.

.qf-m-tabbar

Bottom nav with 4 tabs (Home, DMs, Activity, You). Automatic safe-area.바닥 네비 4탭 (Home, DMs, Activity, You). safe-area 자동.

.qf-m-composer

Chat input field. 3 elements: + / text / send. Rounded pill.채팅 입력창. + / 텍스트 / 전송 3요소. 라운드 pill.

.qf-m-sheet

Bottom sheet (action menu, emoji reactions). grab bar + items.Bottom sheet (액션 메뉴, 이모지 반응). grab bar + items.

.qf-m-fab

Floating action button. Primary actions such as new DM, new post.플로팅 액션 버튼. 새 DM, 새 글 등 primary action.

.qf-m-row

List row (DM, member, server). 64px minimum height, left avatar + 2-line text + aside.리스트 행 (DM, 멤버, 서버). 64px 최소 높이, 좌측 avatar + 2단 텍스트 + aside.

.qf-m-segment

Segmented control (filter switching like All/Mentions/Threads).Segmented control (All/Mentions/Threads 같은 필터 전환).

.qf-m-voice

Voice room grid + controls. speaking state outline.보이스 룸 그리드 + 컨트롤. speaking 상태 outline.

Rules규칙

  • Touch targets: Every interactive element is at least 44×44. When it needs to look smaller, secure the hit area with padding.터치 타겟: 모든 인터랙티브 요소는 최소 44×44. 작아 보여야 하는 경우 padding으로 hit area 확보.
  • Safe area: topbar uses env(safe-area-inset-top), tabbar/composer reflect the bottom inset. Already built into the components.Safe area: topbar는 env(safe-area-inset-top), tabbar/composer는 bottom inset 반영. 이미 컴포넌트에 내장.
  • Drawer pattern: Server/channel lists use a hamburger menu → left drawer. The member list is a right drawer (Discord style).Drawer 패턴: 서버/채널 리스트는 햄버거 메뉴 → 좌측 drawer. 멤버 리스트는 우측 drawer (Discord 방식).
  • Bottom sheet: Desktop context menus/modals convert to bottom sheets on mobile. Make it scrollable when there are 5 or more options.Bottom sheet: 데스크톱의 context menu/modal은 모바일에서 bottom sheet로 변환. 옵션 5개 이상이면 스크롤 가능하게.
  • Long-press = context menu: Long-press a message → bottom sheet + reaction emoji row.Long-press = context menu: 메시지 long-press → bottom sheet + 반응 이모지 row.
  • Swipe to reply: Swipe a message right → reply mode (native pattern).Swipe to reply: 메시지 우측 스와이프 → 답글 모드 (네이티브 패턴).
  • Keyboard dodge: The composer rises together with the keyboard. The body shrinks automatically.키보드 dodge: composer는 키보드 올라올 때 함께 올라감. body는 자동 축소.

React component mapping exampleReact 컴포넌트 매핑 예시

// Discord-style mobile chat screen
<div className="qf-m-screen">
  <header className="qf-m-topbar">
    <button className="qf-m-topbar__back">☰</button>
    <div className="qf-m-topbar__titleBlock">
      <div className="qf-m-topbar__title"># general</div>
      <div className="qf-m-topbar__subtitle">qufox team</div>
    </div>
    <button className="qf-m-topbar__action">👥</button>
  </header>

  <main className="qf-m-body">
    {messages.map(m => <MobileMessage key={m.id} {...m}/>)}
  </main>

  <footer className="qf-m-composer">
    <button className="qf-m-composer__plus">+</button>
    <textarea className="qf-m-composer__input" />
    <button className="qf-m-composer__send">➤</button>
  </footer>
</div>
v4: Task 050

Composer, Autocomplete

A Slack-grade rich composer with drop-up autocomplete. The format bar expands with qf-composer--rich or on focus-within, and @mentions, #channels, :emoji, and slash commands all share one skeleton.Slack 수준의 rich 컴포저와 드롭업 자동완성이에요. 포맷바는 qf-composer--rich 또는 focus-within 시 펼쳐지고, @멘션, #채널, :이모지, 슬래시 커맨드가 한 골격을 공유합니다.

Composer

A rich state with the format bar forced open, and an empty default state (send disabled).포맷바를 강제로 펼친 rich 상태와, 비어 있는 기본 상태(전송 비활성).
Enter Send, Shift+Enter New lineEnter 전송, Shift+Enter 줄바꿈 42 / 2000
.qf-composer, .qf-composer--rich

Autocomplete

A drop-up that appears above the composer. The demo lays out only the inner card inline, without a backdrop (position:static).컴포저 위로 뜨는 드롭업. 데모는 backdrop 없이 inner 카드만 인라인 배치(position:static).
Members
Design_Kim디자인_김 @designer_kim
Dev_Lee개발_이 @dev_lee
@mention: --mention@멘션: --mention
Channels
#
general일반 120 members멤버 120명
#
design-system디자인-시스템 24 members멤버 24명
#
deploy-alerts배포-알림 8 members멤버 8명
#channel: --channel#채널: --channel
Emoji
🎉 :tada:
🚀 :rocket:
🦊 :fox:
:emoji: --emoji:이모지: --emoji

Slash menu

A slash-command-only variant — leading slash icon + monospace command name + description hierarchy.슬래시 커맨드 전용 변형 — 좌측 슬래시 아이콘 + monospace 커맨드명 + 설명 위계.
Commands
/
/giphy[search term][검색어]
Sends a searched GIF to the channel검색한 GIF를 채널에 보냅니다
↵
/
/remind[who] [what] [when][누가] [무엇] [언제]
Sends a reminder at the specified time지정한 시각에 리마인더를 보냅니다
/
/shrug
Appends ¯\_(ツ)_/¯ to the end of your message¯\_(ツ)_/¯ 를 메시지 끝에 덧붙입니다
.qf-slash-menu
v4: Task 050

Command Palette, Emoji

A ⌘K quick switcher and emoji picker. In this demo we show only the inner card inline, without a fixed backdrop — in the actual app it floats above .qf-cmd-palette-backdrop.⌘K 빠른 전환기와 이모지 피커예요. 데모에서는 fixed backdrop 없이 inner 카드만 인라인으로 보여줍니다 — 실제 앱에서는 .qf-cmd-palette-backdrop 위에 떠 있어요.

Command palette

A large search input on top + section headers + result rows (icon, label, path/kbd). The selected row is highlighted with a left accent bar.상단 큰 검색 입력 + 섹션 헤더 + 결과 row(아이콘, 라벨, 경로/kbd). 선택 행은 좌측 accent bar로 강조.
Channels채널
general일반 qufox HQ
general-design일반-디자인 qufox HQ
Direct messages다이렉트 메시지
designer_kim Online온라인
Commands커맨드
Toggle theme테마 전환 ⌘⇧T
Open preferences환경설정 열기 ⌘,
.qf-cmd-palette: section / row / kbd

Emoji picker

Search + category tabs + 9-column grid + preview at the bottom. Fixed 350×420 card.검색 + 카테고리 탭 + 9열 그리드 + 하단 preview. 350×420 고정 카드.
Smileys, People스마일, 사람
😀 :grinning:
.qf-emoji-picker: tabs / grid / preview
v4: Task 050

Overlays, Banners

Status picker, hovercard, 4 banner types, shortcut sheet, role chips, search/upload overlays, and embed variants. The floating surfaces are rendered inline as cards only, without a backdrop.상태 피커, hovercard, 배너 4종, 단축키 시트, 역할 칩, 검색/업로드 오버레이, 임베드 변형이에요. 플로팅 면은 backdrop 없이 카드만 인라인으로 렌더했습니다.

Status picker, Hovercard

Status selection popover and user profile hovercard.상태 선택 팝오버와 유저 프로필 hovercard.
Online온라인
Away자리 비움
Do Not Disturb방해 금지You will not receive notifications알림을 받지 않습니다
Offline오프라인
Yuna Park박유나
@yuna
Online, Designing온라인, 디자인 중
Admin Design
The person building the qufox design system. Loves the color purple.qufox 디자인 시스템을 만드는 사람. 보라색을 좋아합니다.
.qf-status-picker, .qf-hovercard

Banner

info, warn, danger, accent — 4 variants. 4px left status-color bar + tint.info, warn, danger, accent 4변형. 좌측 4px 상태색 바 + 틴트.
A new version has been deployed. Refresh to apply it.새 버전이 배포되었습니다. 새로고침하면 적용됩니다.
Your connection is unstable. Message delivery may be delayed.연결이 불안정합니다. 메시지 전송이 지연될 수 있습니다.
Subscription expired — some features are now restricted.구독 만료 — 일부 기능이 제한되었습니다.
Try out the voice channel beta.음성 채널 베타에 참여해 보세요.

Keyboard shortcut sheet, Role chips

Shortcut sheet (two-column groups) and role chip variants.단축키 시트(2열 그룹)와 역할 칩 변형.
Navigation탐색
Quick switcher빠른 이동⌘+K
Search검색⌘+F
Mark as read읽음 처리Esc
Messages메시지
Edit last마지막 편집↑
Reply답장R
Emoji이모지⌘+E
Admin Moderator Active Bot
.qf-kbd-sheet, .qf-role-chip

Search overlay

Search bar + from:/in:/has: filter chips + result preview.검색바 + from:/in:/has: 필터 칩 + 결과 미리보기.
from:designer_kim in:general일반 has:link
designer_kim, # general, 2:34 PMdesigner_kim, # 일반, 오후 2:34
Finalized the logo size at 120×40. I'll send over the SVG.로고 크기 120×40으로 확정했어요. SVG 넘겨드릴게요.
Jump
dev_lee, # deploy-alerts, Yesterdaydev_lee, # 배포-알림, 어제
Finished deploying the new logo assets.새 로고 에셋 배포 완료했습니다.
Jump
.qf-search-overlay

Upload overlay

A dashed drag-and-drop overlay above the chat area (it is position:absolute, so it nests inside a position:relative box).채팅 영역 위 드래그앤드롭 점선 오버레이(position:absolute이므로 position:relative 박스 안에 안착).
Upload to # general# 일반에 업로드
Drag and drop your files here: 25MB max파일을 여기에 끌어다 놓으세요: 최대 25MB
.qf-upload-overlay

Embed variants

Image, video, bot/app message embeds.이미지, 비디오, 봇/앱 메시지 임베드.
.qf-embed--image
.qf-embed--video
qufox-bot APP
Deployment complete배포가 완료되었어요
main → NAS auto-deploy succeeded. /readyz 200 OK.main → NAS 자동 배포 성공. /readyz 200 OK.
.qf-embed--bot
v4: Task 050

Message actions, Density

Quick reactions on message hover, a reaction-add pill, code-block headers with copy, thread-follow avatar stacks, and a side-by-side comparison of the same message at cozy and compact densities.메시지 hover 빠른 반응, 반응 추가 pill, 코드블록 헤더/복사, 스레드 참여 아바타 스택, 그리고 같은 메시지를 cozy와 compact 밀도로 나란히 비교합니다.

Quick-react, Reaction add

Three quick-reaction slots plus a more button inside the hover action bar, with a dashed add pill at the end of the reaction row.hover 액션바 내부 빠른 반응 3슬롯 + 더보기, 그리고 반응 행 끝의 dashed 추가 pill.
dev_lee MOD Today 2:34 PM오늘 오후 2:34

Shipping the density toggle today. I'll wire up reactions right away too.밀도 토글 오늘 배포합니다. 반응도 바로 붙여볼게요.

.qf-msg-quickreact, .qf-reaction--add

Code block header, Thread follow-up

A header atop the code block (language + copy) and a thread-follow avatar stack with an accent count.코드블록 상단 헤더(lang + 복사)와 스레드 참여 아바타 스택 + accent 카운트.
typescript
const density = useDensity(); // 'cozy' | 'compact'
7 replies답글 7개 Last reply 2 hours ago마지막 답글 2시간 전
.qf-codeblock__header, .qf-thread-followup__avatars

Density — cozy vs compact

The same message group rendered side by side in the default container and a data-density="compact" container for comparison.같은 메시지 그룹을 기본 컨테이너와 data-density="compact" 컨테이너로 나란히 렌더해 비교.
Cozy (default)(기본)
designer_kim 10:24 AM오전 10:24

Cozy keeps the 40px avatar and generous spacing.cozy는 40px 아바타와 넉넉한 간격을 유지해요.

Consecutive messages align to the same width.연속 메시지도 같은 폭으로 정렬됩니다.

The reading flow carries smoothly through.읽기 흐름이 부드럽게 이어져요.

Default container기본 컨테이너
Compact
designer_kim 10:24 AM오전 10:24

Compact shrinks the avatar and tightens the gap between groups.compact는 아바타를 줄이고 그룹 간격을 좁혀요.

Consecutive messages are indented by the avatar width.연속 메시지는 아바타 폭만큼 인덴트됩니다.

Vertical density goes up while alignment stays the same.세로 밀도는 높이고 정렬은 그대로.

data-density="compact"
v4: Task 050

Mobile nav, IA

This is the mobile information-architecture upgrade. It shows, one screen at a time, the bottom tab bar with active pill, the OverlappingPanels left drawer, message-screen ergonomics, Home quick tiles/filters/profile, and the emoji drawer.모바일 정보구조 업그레이드예요. 하단 탭바 활성 pill, OverlappingPanels 좌 드로어, 메시지 화면 ergonomics, Home 퀵타일/필터/프로필, 그리고 이모지 드로어를 한 컷씩 보여줍니다.

Tab bar, Panels, Message ergonomics

(a) Tab bar with active pill + badges, (b) OverlappingPanels with the left drawer open, (c) unread divider + jump button + accessory bar.(a) 활성 pill + 배지 탭바, (b) 좌 드로어 열린 OverlappingPanels, (c) 읽지 않음 divider + jump 버튼 + accessory 바.
Home홈
Recent conversations최근 대화
designer_kim
Sent over the SVG, please take a look!SVG 넘겨드렸어요 확인 부탁!
2:34
# deploy-alerts# 배포-알림
Deployment completed배포가 완료되었어요
Yesterday어제
Text channels텍스트 채널
# general# 일반
# design# 디자인
# deploy# 배포
# design# 디자인
designer_kim2:14 PM오후 2:14
Putting the panel skeleton in place.패널 골격 들어갑니다.
# general# 일반
New messages새 메시지 7
designer_kim9:41 AM오전 9:41
Uploading a few photos사진 몇 장 올려요
+5

Home IA, You, Emoji drawer

(d) Home quick tiles + filter chips + You header, plus a single shot of the mobile emoji drawer.(d) Home 퀵타일 + 필터칩 + You 헤더, 그리고 모바일 이모지 드로어 한 컷.
Home홈
Members멤버
dev_lee
Active just now방금 전 활동
You나
Yuna Park박유나
@yuna
Online, Designing온라인, 디자인 중
Set a status message상태 메시지 설정
Settings설정
Notifications알림
Privacy, Security개인정보, 보안
Frequently used자주 쓰는

Side tab bar (076)옆 탭 막대 (076)

qf-m-tabbar--side: only in the wide side-by-side arrangement (iPhone Duo inner landscape, iPad landscape, iPad 13 portrait). The top bar keeps the full width; tabs gather at the bottom end; the selected tab adds a vertical pill on the outer edge. The bar comes after the body in the markup (reading order) and shows at the leading edge through order: -1.qf-m-tabbar--side: 넓은 화면의 나란히 모양(iPhone Duo 안쪽 가로, iPad 가로, iPad 13 세로)에서만. 위 막대는 폭 전체 그대로, 탭은 아래 끝에 모으고, 고른 탭은 바깥 끝의 세로 알약을 더합니다. 막대는 마크업에서 본문 뒤(읽는 차례)이고 order: -1 로 앞쪽에 보입니다.
Home우리집
Map지도
List목록