<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="3.10.0">Jekyll</generator><link href="https://saejinpark.github.io/feed.xml" rel="self" type="application/atom+xml" /><link href="https://saejinpark.github.io/" rel="alternate" type="text/html" /><updated>2026-11-15T10:15:22+09:00</updated><id>https://saejinpark.github.io/feed.xml</id><title type="html">고래뱃속</title><subtitle>웹 디자인론을 iOS와 SwiftUI의 언어로 다시 읽고, 만들면서 배운 것을 기록합니다.</subtitle><author><name>Geppetto</name></author><entry><title type="html">디자인 시리즈 읽기 안내: 웹 디자인론을 iOS로 옮겨 읽기</title><link href="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/designSeriesHub/" rel="alternate" type="text/html" title="디자인 시리즈 읽기 안내: 웹 디자인론을 iOS로 옮겨 읽기" /><published>2026-11-15T00:08:00+09:00</published><updated>2026-11-15T00:08:00+09:00</updated><id>https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/designSeriesHub</id><content type="html" xml:base="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/designSeriesHub/"><![CDATA[<p>이 블로그의 디자인 글은 한 가지 전제 위에 있다.</p>

<blockquote>
  <p>웹에서 이름 붙은 디자인 이론은 매체가 아니라 사람의 눈과 손에 대한 이론이다. 그래서 iOS 앱에도 그대로 적용된다. 다만 도구가 다르다.</p>
</blockquote>

<p>그리드, 여백, 타이포그래피 계층, 마이크로인터랙션 같은 개념은 CSS와 JavaScript로 정리되었지만, 원리는 SwiftUI에서도 같다.
웹이 <code class="language-plaintext highlighter-rouge">@media</code> 쿼리로 푸는 문제를 iOS는 사이즈 클래스로 풀고, <code class="language-plaintext highlighter-rouge">backdrop-filter</code>로 만들던 유리는 <code class="language-plaintext highlighter-rouge">Material</code>로 만든다.
이 시리즈는 <strong>웹 일반론을 유지한 채, 각 글에 iOS·SwiftUI·HIG(Human Interface Guidelines)의 대응을 붙인</strong> 글 모음이다.</p>

<h2 id="글의-구조">글의 구조</h2>

<p>2024년에 쓴 24편은 모두 같은 틀을 따른다.</p>

<ol>
  <li><strong>웹 일반론</strong>: 특징, 역사적 배경, 주요 요소, 장단점, 적용 사례</li>
  <li><strong>iOS에서는</strong>: HIG가 말하는 것 → SwiftUI로 구현하기 → 주의할 점</li>
  <li><strong>웹과 iOS 대응표</strong>: CSS/JS 개념과 SwiftUI API의 1:1 매핑</li>
  <li><strong>함께 읽기</strong>: 관련 글 링크</li>
</ol>

<p>2026년에 추가한 iOS 전용 7편은 웹에 대응물이 없는 주제를 다루며, HIG 원칙 → 선택 기준 → SwiftUI 구현 → 자주 하는 실수 → 체크리스트의 틀을 쓴다.</p>

<h2 id="읽는-순서">읽는 순서</h2>

<h3 id="처음이라면">처음이라면</h3>

<ol>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/designStyle/">디자인 스타일: UI/UX의 시각적 언어</a> — 스타일이 무엇인지, 어떤 스타일들이 있는지</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/disignTechniques/">디자인 기법: UI/UX의 실행 도구</a> — 기법이 무엇인지, 어떤 기법들이 있는지</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/designSystem/">디자인 시스템: 일관된 사용자 경험의 기반</a> — 스타일과 기법을 재사용 가능한 자산으로 굳히는 법</li>
</ol>

<h3 id="ios-앱을-만들고-있다면">iOS 앱을 만들고 있다면</h3>

<p>바로 쓸 수 있는 순서로 골랐다.</p>

<ol>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/visualHierarchy/">비주얼 계층구조</a> — 텍스트 스타일과 의미론적 색으로 위계 만들기. 모든 화면의 기본</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/typography/">타이포그래피</a> — Dynamic Type을 따르는 법</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/whitespaceDesign/">화이트 스페이스</a> — 시스템 여백에 맞추기</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/responsiveDesign/">반응형 디자인</a> — iPhone과 iPad, 큰 글자 설정에 적응하기</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosAccessibility/">접근성: 모두를 위한 기본값</a> — 위 네 가지를 왜 지켜야 하는지</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/microInteraction/">마이크로인터랙션</a> — 햅틱과 심볼 애니메이션</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosNavigation/">iOS 내비게이션</a> — 앱의 뼈대 고르기</li>
</ol>

<h3 id="스타일을-고르고-있다면">스타일을 고르고 있다면</h3>

<p><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/designStyle/">디자인 스타일 개념 글</a>의 표를 먼저 보고, 끌리는 것부터 읽는다.
iOS에서 현실적인 선택지는 <a href="/%EB%94%94%EC%9E%90%EC%9D%B8/flatDesign/">플랫</a>을 기본으로 <a href="/%EB%94%94%EC%9E%90%EC%9D%B8/glassmorphism/">글라스모피즘</a>의 재질을 얹는 것이다. 나머지는 그 선택의 이유를 설명한다.</p>

<h2 id="전체-지도">전체 지도</h2>

<h3 id="개념-3편">개념 (3편)</h3>

<table>
  <thead>
    <tr>
      <th>글</th>
      <th>한 줄</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/designStyle/">디자인 스타일</a></td>
      <td>분위기. 9가지 스타일의 지도</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/disignTechniques/">디자인 기법</a></td>
      <td>방법. 12가지 기법의 지도</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/designSystem/">디자인 시스템</a></td>
      <td>자산. HIG 위에 얇은 층을 얹는 법</td>
    </tr>
  </tbody>
</table>

<h3 id="디자인-스타일-9편">디자인 스타일 (9편)</h3>

<table>
  <thead>
    <tr>
      <th>글</th>
      <th>iOS에서의 위치</th>
      <th>핵심 SwiftUI</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/skeuomorphism/">스큐어모피즘</a></td>
      <td>iOS 6 이전. 지금은 “작동을 설명하는 모방”만</td>
      <td><code class="language-plaintext highlighter-rouge">Gradient</code>, <code class="language-plaintext highlighter-rouge">.shadow</code>, 햅틱</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/flatDesign/">플랫 디자인</a></td>
      <td>iOS 7 이후의 기본. 깊이는 레이어로</td>
      <td><code class="language-plaintext highlighter-rouge">.borderedProminent</code>, 의미론적 색</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/materialDesign/">머티리얼 디자인</a></td>
      <td>Android의 언어. iOS로 번역하는 표</td>
      <td><code class="language-plaintext highlighter-rouge">TabView</code>, <code class="language-plaintext highlighter-rouge">ToolbarItem</code></td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/minimalism/">미니멀리즘</a></td>
      <td>HIG의 기본 태도. 점진적 공개</td>
      <td><code class="language-plaintext highlighter-rouge">Menu</code>, <code class="language-plaintext highlighter-rouge">ContentUnavailableView</code></td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/neumorphism/">뉴모피즘</a></td>
      <td>접근성과 충돌. 컨트롤 장식으로만</td>
      <td><code class="language-plaintext highlighter-rouge">.shadow</code> 두 겹, <code class="language-plaintext highlighter-rouge">colorSchemeContrast</code></td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/glassmorphism/">글라스모피즘</a></td>
      <td>시스템 Material, iOS 26 Liquid Glass</td>
      <td><code class="language-plaintext highlighter-rouge">.regularMaterial</code>, <code class="language-plaintext highlighter-rouge">glassEffect</code></td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/typographyCentricDesign/">타이포그래피 중심</a></td>
      <td>SF와 Dynamic Type이 곧 이 스타일</td>
      <td><code class="language-plaintext highlighter-rouge">@ScaledMetric</code>, <code class="language-plaintext highlighter-rouge">design: .serif</code></td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/visuallyRich/">비주얼 리치</a></td>
      <td>콘텐츠는 풍부하게, UI는 얇게</td>
      <td><code class="language-plaintext highlighter-rouge">scrollTransition</code>, Metal 셰이더</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/retro_vintage/">레트로/빈티지</a></td>
      <td>모양은 바꿔도 행동은 그대로</td>
      <td><code class="language-plaintext highlighter-rouge">.interpolation(.none)</code>, <code class="language-plaintext highlighter-rouge">.monospaced</code></td>
    </tr>
  </tbody>
</table>

<h3 id="디자인-기법-12편">디자인 기법 (12편)</h3>

<table>
  <thead>
    <tr>
      <th>분류</th>
      <th>글</th>
      <th>핵심 SwiftUI</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>시각</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/skeletonUI/">스켈레톤 UI</a></td>
      <td><code class="language-plaintext highlighter-rouge">.redacted(reason: .placeholder)</code></td>
    </tr>
    <tr>
      <td>시각</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/cardBasedDesign/">카드 기반 디자인</a></td>
      <td><code class="language-plaintext highlighter-rouge">.insetGrouped</code>, <code class="language-plaintext highlighter-rouge">RoundedRectangle(style: .continuous)</code></td>
    </tr>
    <tr>
      <td>시각</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/visualHierarchy/">비주얼 계층구조</a></td>
      <td>텍스트 스타일, <code class="language-plaintext highlighter-rouge">.primary/.secondary/.tertiary</code></td>
    </tr>
    <tr>
      <td>상호작용</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/microInteraction/">마이크로인터랙션</a></td>
      <td><code class="language-plaintext highlighter-rouge">sensoryFeedback</code>, <code class="language-plaintext highlighter-rouge">symbolEffect</code></td>
    </tr>
    <tr>
      <td>상호작용</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/gestureBasedInterface/">제스처 기반 인터페이스</a></td>
      <td><code class="language-plaintext highlighter-rouge">DragGesture</code>, <code class="language-plaintext highlighter-rouge">.swipeActions</code>, <code class="language-plaintext highlighter-rouge">accessibilityAction</code></td>
    </tr>
    <tr>
      <td>상호작용</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/animationMotion/">애니메이션과 모션</a></td>
      <td><code class="language-plaintext highlighter-rouge">withAnimation(.spring)</code>, <code class="language-plaintext highlighter-rouge">matchedGeometryEffect</code></td>
    </tr>
    <tr>
      <td>레이아웃</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/gridSystem/">그리드 시스템</a></td>
      <td><code class="language-plaintext highlighter-rouge">LazyVGrid(.adaptive)</code>, <code class="language-plaintext highlighter-rouge">Grid</code></td>
    </tr>
    <tr>
      <td>레이아웃</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/whitespaceDesign/">화이트 스페이스</a></td>
      <td><code class="language-plaintext highlighter-rouge">.scenePadding</code>, <code class="language-plaintext highlighter-rouge">.contentMargins</code></td>
    </tr>
    <tr>
      <td>레이아웃</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/responsiveDesign/">반응형 디자인</a></td>
      <td>사이즈 클래스, <code class="language-plaintext highlighter-rouge">ViewThatFits</code></td>
    </tr>
    <tr>
      <td>콘텐츠</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/typography/">타이포그래피</a></td>
      <td>Dynamic Type, <code class="language-plaintext highlighter-rouge">Font.custom(_:relativeTo:)</code></td>
    </tr>
    <tr>
      <td>콘텐츠</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iconDesign/">아이콘 디자인</a></td>
      <td>SF Symbols, <code class="language-plaintext highlighter-rouge">symbolRenderingMode</code></td>
    </tr>
    <tr>
      <td>콘텐츠</td>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/dataVisualization/">데이터 시각화</a></td>
      <td>Swift Charts, Audio Graph</td>
    </tr>
  </tbody>
</table>

<h3 id="ios-전용-7편">iOS 전용 (7편)</h3>

<p>웹에 직접 대응하는 개념이 없거나, iOS에서 전혀 다르게 풀리는 주제들.</p>

<table>
  <thead>
    <tr>
      <th>글</th>
      <th>다루는 것</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosNavigation/">iOS 내비게이션: 탭, 스택, 스플릿 뷰</a></td>
      <td>앱의 뼈대를 고르는 기준, <code class="language-plaintext highlighter-rouge">NavigationStack</code>과 <code class="language-plaintext highlighter-rouge">NavigationSplitView</code></td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosModality/">모달의 위계: 알림, 시트, 팝오버</a></td>
      <td>언제 무엇으로 끼어들 것인가</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosAccessibility/">접근성: 모두를 위한 기본값</a></td>
      <td>VoiceOver, Dynamic Type, 대비, 모션, 감사 방법</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosColorDarkMode/">색상과 다크 모드: 의미론적 색 체계</a></td>
      <td>시스템 색, 에셋 카탈로그, <code class="language-plaintext highlighter-rouge">tint</code>, 고대비</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosWidgets/">위젯과 라이브 액티비티: 한눈에 보는 디자인</a></td>
      <td>홈 화면과 잠금 화면에서의 정보 디자인</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosHaptics/">햅틱: 손끝으로 전하는 피드백</a></td>
      <td>촉각 언어의 문법과 절제</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/watchOSDesign/">손목 위의 디자인: watchOS</a></td>
      <td>디지털 크라운, 컴플리케이션, 2초 안에 끝나는 상호작용</td>
    </tr>
  </tbody>
</table>

<h2 id="번역의-원칙">번역의 원칙</h2>

<p>24편을 쓰면서 반복해서 나온 “웹 → iOS” 번역 규칙을 모으면 다섯 가지다.</p>

<ol>
  <li><strong>값 대신 이름을 쓴다</strong>: <code class="language-plaintext highlighter-rouge">17px</code> 대신 <code class="language-plaintext highlighter-rouge">.body</code>, <code class="language-plaintext highlighter-rouge">#333</code> 대신 <code class="language-plaintext highlighter-rouge">.primary</code>, <code class="language-plaintext highlighter-rouge">16px</code> 여백 대신 <code class="language-plaintext highlighter-rouge">.scenePadding()</code>. 이름을 쓰면 다크 모드, Dynamic Type, 고대비가 따라온다</li>
  <li><strong>브레이크포인트 대신 적응</strong>: 화면 폭을 재지 않는다. <code class="language-plaintext highlighter-rouge">.adaptive</code>, <code class="language-plaintext highlighter-rouge">ViewThatFits</code>, 사이즈 클래스가 알아서 맞춘다</li>
  <li><strong>시스템 컴포넌트 먼저</strong>: <code class="language-plaintext highlighter-rouge">List</code>, <code class="language-plaintext highlighter-rouge">Toggle</code>, <code class="language-plaintext highlighter-rouge">TabView</code>에는 햅틱·제스처·접근성이 이미 들어 있다. 직접 만들면 그것들을 다시 만들어야 한다</li>
  <li><strong>접근성 설정 네 가지를 항상 본다</strong>: 동작 줄이기, 투명도 줄이기, 대비 높이기, 글자 크기. 스타일이 강할수록 이 설정들에 대한 대체 모습이 필요하다</li>
  <li><strong>구조는 플랫폼, 개성은 색과 톤</strong>: 내비게이션 구조와 제스처는 iOS 관례를 따르고, 브랜드는 <code class="language-plaintext highlighter-rouge">tint</code>, 서체 느낌, 모션의 성격으로 표현한다</li>
</ol>

<h2 id="자주-쓰는-대응표-모음">자주 쓰는 대응표 모음</h2>

<p>시리즈 전체에서 가장 자주 등장한 대응만 추렸다.</p>

<table>
  <thead>
    <tr>
      <th>웹</th>
      <th>iOS / SwiftUI</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">@media (min-width)</code></td>
      <td><code class="language-plaintext highlighter-rouge">horizontalSizeClass</code>, <code class="language-plaintext highlighter-rouge">ViewThatFits</code></td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">rem</code> + 브라우저 글자 설정</td>
      <td>Dynamic Type 텍스트 스타일</td>
    </tr>
    <tr>
      <td>CSS 변수 (디자인 토큰)</td>
      <td>에셋 카탈로그 색상 세트, 상수 확장</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">prefers-color-scheme</code></td>
      <td><code class="language-plaintext highlighter-rouge">colorScheme</code>, 의미론적 색</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">prefers-reduced-motion</code></td>
      <td><code class="language-plaintext highlighter-rouge">accessibilityReduceMotion</code></td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">backdrop-filter: blur()</code></td>
      <td><code class="language-plaintext highlighter-rouge">Material</code>, <code class="language-plaintext highlighter-rouge">glassEffect</code></td>
    </tr>
    <tr>
      <td>CSS transition</td>
      <td><code class="language-plaintext highlighter-rouge">.animation(_:value:)</code>, <code class="language-plaintext highlighter-rouge">withAnimation</code></td>
    </tr>
    <tr>
      <td>아이콘 폰트 / SVG</td>
      <td>SF Symbols</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">aria-label</code></td>
      <td><code class="language-plaintext highlighter-rouge">accessibilityLabel</code>, <code class="language-plaintext highlighter-rouge">Label</code></td>
    </tr>
    <tr>
      <td>Chart.js / D3</td>
      <td>Swift Charts</td>
    </tr>
    <tr>
      <td>Storybook</td>
      <td>Xcode Previews</td>
    </tr>
  </tbody>
</table>]]></content><author><name>Geppetto</name></author><category term="디자인" /><category term="개념" /><category term="iOS" /><category term="시리즈" /><summary type="html"><![CDATA[디자인 스타일 9편, 기법 12편, 개념 3편, iOS 전용 7편. 어디서부터 어떻게 읽으면 좋은지 정리한 입구 글.]]></summary></entry><entry><title type="html">손목 위의 디자인: watchOS</title><link href="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/watchOSDesign/" rel="alternate" type="text/html" title="손목 위의 디자인: watchOS" /><published>2026-11-15T00:07:00+09:00</published><updated>2026-11-15T00:07:00+09:00</updated><id>https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/watchOSDesign</id><content type="html" xml:base="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/watchOSDesign/"><![CDATA[<p>Apple Watch 앱은 작은 iPhone 앱이 아니다. 화면이 작아서가 아니라, <strong>사용 상황</strong>이 다르기 때문이다.
사용자는 손목을 들어 2초 보고 내린다. 걷는 중이고, 한 손은 다른 것을 들고 있고, 화면을 가린 손가락 때문에 보이는 영역은 더 작다.</p>

<p>HIG의 watchOS 섹션은 이 상황을 한 문장으로 요약한다. <strong>“상호작용은 짧고, 정보는 한눈에, 조작은 한 손으로.”</strong></p>

<h2 id="iphone과-다른-점">iPhone과 다른 점</h2>

<table>
  <thead>
    <tr>
      <th> </th>
      <th>iPhone</th>
      <th>Apple Watch</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>사용 시간</td>
      <td>분 단위</td>
      <td>초 단위 (평균 2~5초)</td>
    </tr>
    <tr>
      <td>입력</td>
      <td>양손, 키보드</td>
      <td>한 손가락, 디지털 크라운, 음성, 더블 탭 제스처</td>
    </tr>
    <tr>
      <td>화면</td>
      <td>손이 가리지 않음</td>
      <td>손가락이 화면의 1/4을 가림</td>
    </tr>
    <tr>
      <td>내비게이션</td>
      <td>탭 바, 스택</td>
      <td>세로 페이지, 리스트, 스택 (얕게)</td>
    </tr>
    <tr>
      <td>앱 진입</td>
      <td>홈 화면 아이콘</td>
      <td>컴플리케이션, 스마트 스택, 알림이 대부분</td>
    </tr>
    <tr>
      <td>배경</td>
      <td>흰색 / 검정</td>
      <td>항상 검정 (화면 가장자리가 베젤과 녹아든다)</td>
    </tr>
    <tr>
      <td>텍스트</td>
      <td>SF Pro</td>
      <td>SF Compact (좁은 폭에서 읽히도록 설계)</td>
    </tr>
  </tbody>
</table>

<h2 id="hig가-말하는-것">HIG가 말하는 것</h2>

<ul>
  <li><strong>한눈에(Glanceable)</strong>: 가장 중요한 정보가 화면 중앙, 가장 크게. 손목을 올렸을 때 첫 0.5초에 보여야 한다</li>
  <li><strong>실행 가능하게(Actionable)</strong>: 보고 나서 할 수 있는 일이 하나는 있어야 한다. 그 하나는 큰 버튼으로</li>
  <li><strong>반응적으로(Responsive)</strong>: 로딩 스피너는 손목에서 특히 치명적이다. 마지막 데이터를 먼저 보여 주고 갱신한다</li>
  <li><strong>디지털 크라운을 활용하라</strong>: 스크롤, 값 조절, 확대는 크라운으로. 손가락이 화면을 가리지 않는다</li>
  <li><strong>검정 배경</strong>: 화면 가장자리가 보이지 않게. 밝은 배경은 배터리와 눈 모두에 좋지 않다</li>
  <li><strong>컴플리케이션이 진입점</strong>: 앱 아이콘을 눌러 들어오는 사용자는 적다. 시계 페이스의 컴플리케이션과 스마트 스택이 주 진입점이다</li>
  <li><strong>알림은 짧게</strong>: 손목에서 긴 알림은 읽지 않는다. 핵심 한 줄 + 동작 버튼 하나</li>
</ul>

<h2 id="내비게이션">내비게이션</h2>

<p>watchOS의 내비게이션은 세 가지뿐이고, 깊이는 2~3단계를 넘지 않는다.</p>

<ul>
  <li><strong>세로 페이지 (<code class="language-plaintext highlighter-rouge">TabView</code> + <code class="language-plaintext highlighter-rouge">.verticalPage</code>)</strong>: watchOS 10부터 기본. 크라운을 돌리면 페이지가 넘어간다. 날씨 앱의 현재 → 시간별 → 주간</li>
  <li><strong>리스트 (<code class="language-plaintext highlighter-rouge">List</code>)</strong>: 항목이 여럿일 때. 크라운으로 스크롤</li>
  <li><strong>스택 (<code class="language-plaintext highlighter-rouge">NavigationStack</code>)</strong>: 리스트에서 상세로. 왼쪽 가장자리 스와이프로 돌아간다</li>
</ul>

<p>탭 바(가로 탭)는 watchOS 10부터 권장하지 않는다. 손가락으로 가로 스와이프하면 화면을 가린다.</p>

<h2 id="swiftui로-구현하기">SwiftUI로 구현하기</h2>

<p><strong>세로 페이지 구조</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">WatchRootView</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="kt">TabView</span> <span class="p">{</span>
            <span class="kt">NowView</span><span class="p">()</span>          <span class="c1">// 지금 가장 중요한 것</span>
            <span class="kt">TodayView</span><span class="p">()</span>        <span class="c1">// 오늘</span>
            <span class="kt">SettingsView</span><span class="p">()</span>     <span class="c1">// 설정</span>
        <span class="p">}</span>
        <span class="o">.</span><span class="nf">tabViewStyle</span><span class="p">(</span><span class="o">.</span><span class="n">verticalPage</span><span class="p">)</span>   <span class="c1">// 크라운으로 넘김</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>한눈에 보는 화면: 숫자 하나가 주인공</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">NowView</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="k">let</span> <span class="nv">remaining</span><span class="p">:</span> <span class="kt">Date</span>

    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="kt">VStack</span><span class="p">(</span><span class="nv">spacing</span><span class="p">:</span> <span class="mi">4</span><span class="p">)</span> <span class="p">{</span>
            <span class="kt">Text</span><span class="p">(</span><span class="s">"집중"</span><span class="p">)</span>
                <span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">caption2</span><span class="p">)</span>
                <span class="o">.</span><span class="nf">foregroundStyle</span><span class="p">(</span><span class="o">.</span><span class="n">secondary</span><span class="p">)</span>
            <span class="kt">Text</span><span class="p">(</span><span class="n">remaining</span><span class="p">,</span> <span class="nv">style</span><span class="p">:</span> <span class="o">.</span><span class="n">timer</span><span class="p">)</span>
                <span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="nf">system</span><span class="p">(</span><span class="nv">size</span><span class="p">:</span> <span class="mi">48</span><span class="p">,</span> <span class="nv">weight</span><span class="p">:</span> <span class="o">.</span><span class="n">light</span><span class="p">,</span> <span class="nv">design</span><span class="p">:</span> <span class="o">.</span><span class="n">rounded</span><span class="p">))</span>
                <span class="o">.</span><span class="nf">monospacedDigit</span><span class="p">()</span>
                <span class="o">.</span><span class="nf">minimumScaleFactor</span><span class="p">(</span><span class="mf">0.5</span><span class="p">)</span>
            <span class="kt">Button</span><span class="p">(</span><span class="s">"일시정지"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"pause.fill"</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span>
                <span class="o">.</span><span class="nf">buttonStyle</span><span class="p">(</span><span class="o">.</span><span class="n">borderedProminent</span><span class="p">)</span>
                <span class="o">.</span><span class="nf">controlSize</span><span class="p">(</span><span class="o">.</span><span class="n">large</span><span class="p">)</span>                    <span class="c1">// 손가락 크기</span>
        <span class="p">}</span>
        <span class="o">.</span><span class="nf">containerBackground</span><span class="p">(</span><span class="o">.</span><span class="n">indigo</span><span class="o">.</span><span class="n">gradient</span><span class="p">,</span> <span class="nv">for</span><span class="p">:</span> <span class="o">.</span><span class="n">tabView</span><span class="p">)</span>   <span class="c1">// watchOS 10 배경</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>디지털 크라운으로 값 조절</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">TimerPicker</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="kd">@State</span> <span class="kd">private</span> <span class="k">var</span> <span class="nv">minutes</span><span class="p">:</span> <span class="kt">Double</span> <span class="o">=</span> <span class="mi">25</span>

    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="kt">VStack</span> <span class="p">{</span>
            <span class="kt">Text</span><span class="p">(</span><span class="s">"</span><span class="se">\(</span><span class="kt">Int</span><span class="p">(</span><span class="n">minutes</span><span class="p">)</span><span class="se">)</span><span class="s">분"</span><span class="p">)</span>
                <span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">title</span><span class="p">)</span>
            <span class="kt">Text</span><span class="p">(</span><span class="s">"크라운을 돌려 조절"</span><span class="p">)</span>
                <span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">caption2</span><span class="p">)</span><span class="o">.</span><span class="nf">foregroundStyle</span><span class="p">(</span><span class="o">.</span><span class="n">secondary</span><span class="p">)</span>
        <span class="p">}</span>
        <span class="o">.</span><span class="nf">focusable</span><span class="p">()</span>
        <span class="o">.</span><span class="nf">digitalCrownRotation</span><span class="p">(</span><span class="err">$</span><span class="n">minutes</span><span class="p">,</span> <span class="nv">from</span><span class="p">:</span> <span class="mi">1</span><span class="p">,</span> <span class="nv">through</span><span class="p">:</span> <span class="mi">90</span><span class="p">,</span> <span class="nv">by</span><span class="p">:</span> <span class="mi">1</span><span class="p">,</span>
                              <span class="nv">sensitivity</span><span class="p">:</span> <span class="o">.</span><span class="n">medium</span><span class="p">,</span> <span class="nv">isContinuous</span><span class="p">:</span> <span class="kc">false</span><span class="p">,</span>
                              <span class="nv">isHapticFeedbackEnabled</span><span class="p">:</span> <span class="kc">true</span><span class="p">)</span>     <span class="c1">// 한 칸마다 틱</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>툴바: 상단 모서리 버튼 (watchOS 10+)</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">.</span><span class="n">toolbar</span> <span class="p">{</span>
    <span class="kt">ToolbarItem</span><span class="p">(</span><span class="nv">placement</span><span class="p">:</span> <span class="o">.</span><span class="n">topBarTrailing</span><span class="p">)</span> <span class="p">{</span>
        <span class="kt">Button</span><span class="p">(</span><span class="s">"추가"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"plus"</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span>
    <span class="p">}</span>
    <span class="kt">ToolbarItemGroup</span><span class="p">(</span><span class="nv">placement</span><span class="p">:</span> <span class="o">.</span><span class="n">bottomBar</span><span class="p">)</span> <span class="p">{</span>       <span class="c1">// 하단 양쪽 모서리</span>
        <span class="kt">Button</span><span class="p">(</span><span class="s">"초기화"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"arrow.counterclockwise"</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span>
        <span class="kt">Spacer</span><span class="p">()</span>
        <span class="kt">Button</span><span class="p">(</span><span class="s">"시작"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"play.fill"</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>컴플리케이션 (WidgetKit)</strong></p>

<p>watchOS 9부터 컴플리케이션은 WidgetKit으로 만든다. iPhone 잠금 화면 위젯과 같은 코드를 공유한다.</p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">TimerComplication</span><span class="p">:</span> <span class="kt">Widget</span> <span class="p">{</span>
    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">WidgetConfiguration</span> <span class="p">{</span>
        <span class="kt">StaticConfiguration</span><span class="p">(</span><span class="nv">kind</span><span class="p">:</span> <span class="s">"timer"</span><span class="p">,</span> <span class="nv">provider</span><span class="p">:</span> <span class="kt">TimerProvider</span><span class="p">())</span> <span class="p">{</span> <span class="n">entry</span> <span class="k">in</span>
            <span class="kt">TimerComplicationView</span><span class="p">(</span><span class="nv">entry</span><span class="p">:</span> <span class="n">entry</span><span class="p">)</span>
                <span class="o">.</span><span class="nf">containerBackground</span><span class="p">(</span><span class="o">.</span><span class="n">clear</span><span class="p">,</span> <span class="nv">for</span><span class="p">:</span> <span class="o">.</span><span class="n">widget</span><span class="p">)</span>
        <span class="p">}</span>
        <span class="o">.</span><span class="nf">supportedFamilies</span><span class="p">([</span><span class="o">.</span><span class="n">accessoryCircular</span><span class="p">,</span> <span class="o">.</span><span class="n">accessoryRectangular</span><span class="p">,</span>
                            <span class="o">.</span><span class="n">accessoryInline</span><span class="p">,</span> <span class="o">.</span><span class="n">accessoryCorner</span><span class="p">])</span>   <span class="c1">// .accessoryCorner는 watchOS 전용</span>
    <span class="p">}</span>
<span class="p">}</span>

<span class="kd">struct</span> <span class="kt">TimerComplicationView</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="kd">@Environment</span><span class="p">(\</span><span class="o">.</span><span class="n">widgetFamily</span><span class="p">)</span> <span class="k">var</span> <span class="nv">family</span>
    <span class="k">let</span> <span class="nv">entry</span><span class="p">:</span> <span class="kt">TimerEntry</span>

    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="k">switch</span> <span class="n">family</span> <span class="p">{</span>
        <span class="k">case</span> <span class="o">.</span><span class="nv">accessoryCorner</span><span class="p">:</span>
            <span class="kt">Text</span><span class="p">(</span><span class="n">entry</span><span class="o">.</span><span class="n">remaining</span><span class="o">.</span><span class="nf">formatted</span><span class="p">(</span><span class="o">.</span><span class="nf">time</span><span class="p">(</span><span class="nv">pattern</span><span class="p">:</span> <span class="o">.</span><span class="n">minuteSecond</span><span class="p">)))</span>
                <span class="o">.</span><span class="nf">widgetCurvesContent</span><span class="p">()</span>                           <span class="c1">// 모서리 곡선을 따라 휘어짐</span>
                <span class="o">.</span><span class="n">widgetLabel</span> <span class="p">{</span> <span class="kt">Gauge</span><span class="p">(</span><span class="nv">value</span><span class="p">:</span> <span class="n">entry</span><span class="o">.</span><span class="n">progress</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span> <span class="p">}</span>
        <span class="k">case</span> <span class="o">.</span><span class="nv">accessoryCircular</span><span class="p">:</span>
            <span class="kt">Gauge</span><span class="p">(</span><span class="nv">value</span><span class="p">:</span> <span class="n">entry</span><span class="o">.</span><span class="n">progress</span><span class="p">)</span> <span class="p">{</span> <span class="kt">Image</span><span class="p">(</span><span class="nv">systemName</span><span class="p">:</span> <span class="s">"timer"</span><span class="p">)</span> <span class="p">}</span>
                <span class="o">.</span><span class="nf">gaugeStyle</span><span class="p">(</span><span class="o">.</span><span class="n">accessoryCircular</span><span class="p">)</span>
        <span class="k">default</span><span class="p">:</span>
            <span class="kt">Label</span><span class="p">(</span><span class="n">entry</span><span class="o">.</span><span class="n">label</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"timer"</span><span class="p">)</span>
        <span class="p">}</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>더블 탭 제스처 (Series 9 / Ultra 2 이상)</strong></p>

<p>엄지와 검지를 두 번 맞대면 화면의 <strong>주 동작</strong>이 실행된다. 시스템이 알아서 고르지만, <code class="language-plaintext highlighter-rouge">.handGestureShortcut(.primaryAction)</code>으로 어떤 버튼인지 지정할 수 있다.</p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">Button</span><span class="p">(</span><span class="s">"시작"</span><span class="p">)</span> <span class="p">{</span> <span class="nf">start</span><span class="p">()</span> <span class="p">}</span>
    <span class="o">.</span><span class="nf">handGestureShortcut</span><span class="p">(</span><span class="o">.</span><span class="n">primaryAction</span><span class="p">)</span>
</code></pre></div></div>

<h2 id="자주-하는-실수">자주 하는 실수</h2>

<ul>
  <li><strong>iPhone 화면을 축소</strong>: 정보를 줄여야 한다. 화면 하나에 숫자 하나, 버튼 하나</li>
  <li><strong>가로 스크롤과 가로 탭</strong>: 손가락이 화면을 가린다. 세로 페이지로</li>
  <li><strong>작은 버튼 여러 개</strong>: 손목에서 정확한 탭은 어렵다. 버튼은 크게, 적게. 한 줄에 둘까지</li>
  <li><strong>흰 배경</strong>: 베젤 경계가 드러나고 배터리를 먹는다. 검정 또는 어두운 그라데이션</li>
  <li><strong>로딩 스피너로 시작</strong>: 손목을 내린다. 이전 데이터를 즉시 보여 주고 뒤에서 갱신</li>
  <li><strong>컴플리케이션 없음</strong>: 진입점이 없는 앱은 열리지 않는다. 최소 원형 하나, 직사각형 하나</li>
  <li><strong>크라운 무시</strong>: 리스트가 스크롤되는 것 외에 크라운이 하는 일이 없으면 손해다. 값 조절, 페이지 넘김, 확대에 쓴다</li>
  <li><strong>iPhone 없이 안 되는 앱</strong>: 셀룰러 모델과 iPhone이 멀리 있는 상황을 고려한다. 핵심 기능은 워치 단독으로</li>
  <li><strong>알림에 긴 문장</strong>: 첫 줄만 읽힌다. 핵심을 앞에</li>
  <li><strong>햅틱 생략</strong>: 손목에서는 햅틱이 시각보다 먼저 도착한다. 타이머 종료, 목표 달성은 반드시 햅틱과 함께</li>
</ul>

<h2 id="체크리스트">체크리스트</h2>

<ul class="task-list">
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />손목을 올렸을 때 0.5초 안에 핵심 정보가 보인다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />화면당 주 동작이 하나이고, 버튼이 <code class="language-plaintext highlighter-rouge">.controlSize(.large)</code>다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />내비게이션 깊이가 3단계 이하다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />세로 페이지 또는 리스트, 가로 스와이프가 없다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />디지털 크라운으로 할 수 있는 일이 스크롤 외에 하나는 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />컴플리케이션이 원형·직사각형·인라인 중 둘 이상 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />배경이 검정 또는 어두운 색이다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />앱을 열면 로딩 없이 마지막 상태가 바로 보인다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />중요한 순간(완료, 목표 달성)에 햅틱이 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />큰 글자 설정(워치에도 있다)에서 레이아웃이 유지된다</li>
</ul>

<h2 id="함께-읽기">함께 읽기</h2>

<ul>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosWidgets/">위젯과 라이브 액티비티: 한눈에 보는 디자인</a> — 컴플리케이션의 바탕이 되는 WidgetKit</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosHaptics/">햅틱: 손끝으로 전하는 피드백</a> — 손목에서 더 중요한 피드백</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/minimalism/">미니멀리즘 디자인: 적은 것이 더 많은 것이다</a> — 손목이 강제하는 미니멀리즘</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/gestureBasedInterface/">제스처 기반 인터페이스: 직관적 조작의 혁신</a> — 크라운과 더블 탭</li>
</ul>]]></content><author><name>Geppetto</name></author><category term="디자인" /><category term="iOS 디자인" /><category term="HIG" /><category term="watchOS" /><summary type="html"><![CDATA[2초 안에 끝나는 상호작용. 디지털 크라운, 컴플리케이션, 손목 올림, 그리고 iPhone 앱을 축소하면 안 되는 이유.]]></summary></entry><entry><title type="html">햅틱: 손끝으로 전하는 피드백</title><link href="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosHaptics/" rel="alternate" type="text/html" title="햅틱: 손끝으로 전하는 피드백" /><published>2026-11-15T00:06:00+09:00</published><updated>2026-11-15T00:06:00+09:00</updated><id>https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosHaptics</id><content type="html" xml:base="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosHaptics/"><![CDATA[<p>햅틱은 진동으로 전하는 피드백이다. iPhone의 Taptic Engine은 “윙” 하는 진동이 아니라 <strong>똑, 톡, 두둑</strong> 같은 짧고 정확한 촉감을 만든다.
웹에는 대응물이 없다. <code class="language-plaintext highlighter-rouge">navigator.vibrate()</code>가 있지만 iOS Safari는 지원하지 않고, 지원하는 기기에서도 정밀하지 않다.</p>

<p>햅틱은 iOS 앱이 “진짜처럼” 느껴지는 이유의 절반이다. 토글이 넘어갈 때, 피커가 한 칸 굴러갈 때, 당겨서 새로 고침이 걸릴 때 손끝에 오는 작은 신호가 화면 속 물건에 무게를 준다.</p>

<h2 id="hig가-말하는-것">HIG가 말하는 것</h2>

<ul>
  <li><strong>시스템 패턴을 쓴다</strong>: Apple이 정의한 패턴(성공, 경고, 실패, 선택, 충격)은 OS 전체에서 같은 의미로 쓰인다. 사용자는 이미 이 언어를 안다</li>
  <li><strong>시각·청각과 동기화한다</strong>: 햅틱은 눈에 보이는 변화와 같은 순간에 와야 한다. 0.1초만 어긋나도 이상하다</li>
  <li><strong>의미 있을 때만</strong>: 모든 탭에 햅틱을 넣으면 아무 햅틱도 의미가 없다. 결과가 있는 순간에만</li>
  <li><strong>일관되게</strong>: 같은 동작에는 항상 같은 햅틱. 저장이 <code class="language-plaintext highlighter-rouge">.success</code>면 모든 저장이 <code class="language-plaintext highlighter-rouge">.success</code></li>
  <li><strong>없어도 되게</strong>: 햅틱이 꺼진 기기(대부분의 iPad), 무음 모드, 설정에서 끈 사용자가 있다. 햅틱 없이도 앱은 완전해야 한다</li>
  <li><strong>시스템 컨트롤은 이미 갖고 있다</strong>: <code class="language-plaintext highlighter-rouge">Toggle</code>, <code class="language-plaintext highlighter-rouge">Picker</code>, <code class="language-plaintext highlighter-rouge">Slider</code>, 스와이프 동작, 당겨서 새로 고침, 컨텍스트 메뉴는 햅틱이 내장되어 있다</li>
</ul>

<h2 id="햅틱의-문법">햅틱의 문법</h2>

<table>
  <thead>
    <tr>
      <th>종류</th>
      <th>느낌</th>
      <th>쓰는 때</th>
      <th>예</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">.success</code></td>
      <td>두-둑 (가볍게 두 번)</td>
      <td>과제 완료</td>
      <td>저장됨, 결제 완료, 체크 표시</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">.warning</code></td>
      <td>둑-두 (무겁게 두 번)</td>
      <td>주의 필요</td>
      <td>입력 오류, 한도 접근</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">.error</code></td>
      <td>두두둑 (세 번)</td>
      <td>실패</td>
      <td>로그인 실패, 잘못된 비밀번호</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">.selection</code></td>
      <td>틱 (아주 가볍게)</td>
      <td>선택이 바뀜</td>
      <td>피커 굴러감, 세그먼트 전환, 슬라이더 눈금</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">.impact(.light)</code></td>
      <td>톡</td>
      <td>가벼운 물체 접촉</td>
      <td>카드 스냅, 토글</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">.impact(.medium)</code></td>
      <td>툭</td>
      <td>보통 접촉</td>
      <td>드래그 끝, 버튼 눌림</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">.impact(.heavy)</code></td>
      <td>쿵</td>
      <td>무거운 물체 접촉</td>
      <td>큰 전환, 임계점 통과</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">.impact(.soft)</code> / <code class="language-plaintext highlighter-rouge">.rigid</code></td>
      <td>부드럽게 / 딱딱하게</td>
      <td>재질 표현</td>
      <td>고무 / 유리</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">.levelChange</code></td>
      <td>단계 전환</td>
      <td>단계가 바뀜</td>
      <td>볼륨 단계, 확대 레벨</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">.alignment</code></td>
      <td>맞춤</td>
      <td>정렬 가이드에 붙음</td>
      <td>그리기 앱에서 선이 맞음</td>
    </tr>
  </tbody>
</table>

<p><strong>세 가지 질문으로 고른다</strong></p>

<ol>
  <li>결과를 알리는가? → <code class="language-plaintext highlighter-rouge">.success</code> / <code class="language-plaintext highlighter-rouge">.warning</code> / <code class="language-plaintext highlighter-rouge">.error</code></li>
  <li>선택이 바뀌는가? → <code class="language-plaintext highlighter-rouge">.selection</code></li>
  <li>물건이 부딪히는가? → <code class="language-plaintext highlighter-rouge">.impact</code> (무게는 물건의 무게)</li>
</ol>

<h2 id="swiftui로-구현하기">SwiftUI로 구현하기</h2>

<p><strong>기본: <code class="language-plaintext highlighter-rouge">sensoryFeedback</code> (iOS 17+)</strong></p>

<p>값이 바뀌면 햅틱이 울린다. 상태 기반이라 SwiftUI와 잘 맞는다.</p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">SaveButton</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="kd">@State</span> <span class="kd">private</span> <span class="k">var</span> <span class="nv">saveCount</span> <span class="o">=</span> <span class="mi">0</span>

    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="kt">Button</span><span class="p">(</span><span class="s">"저장"</span><span class="p">)</span> <span class="p">{</span>
            <span class="nf">save</span><span class="p">()</span>
            <span class="n">saveCount</span> <span class="o">+=</span> <span class="mi">1</span>
        <span class="p">}</span>
        <span class="o">.</span><span class="nf">sensoryFeedback</span><span class="p">(</span><span class="o">.</span><span class="n">success</span><span class="p">,</span> <span class="nv">trigger</span><span class="p">:</span> <span class="n">saveCount</span><span class="p">)</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>조건부: 특정 전이에서만</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">.</span><span class="nf">sensoryFeedback</span><span class="p">(</span><span class="o">.</span><span class="n">success</span><span class="p">,</span> <span class="nv">trigger</span><span class="p">:</span> <span class="n">isValid</span><span class="p">)</span> <span class="p">{</span> <span class="n">old</span><span class="p">,</span> <span class="k">new</span> <span class="k">in</span> <span class="k">new</span> <span class="o">&amp;&amp;</span> <span class="o">!</span><span class="n">old</span> <span class="p">}</span>   <span class="c1">// 유효해지는 순간만</span>
<span class="o">.</span><span class="nf">sensoryFeedback</span><span class="p">(</span><span class="o">.</span><span class="n">error</span><span class="p">,</span> <span class="nv">trigger</span><span class="p">:</span> <span class="n">attempts</span><span class="p">)</span> <span class="p">{</span> <span class="n">_</span><span class="p">,</span> <span class="n">_</span> <span class="k">in</span> <span class="n">lastResult</span> <span class="o">==</span> <span class="o">.</span><span class="n">failed</span> <span class="p">}</span>
</code></pre></div></div>

<p><strong>드래그 임계점</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">DismissCard</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="kd">@State</span> <span class="kd">private</span> <span class="k">var</span> <span class="nv">offset</span><span class="p">:</span> <span class="kt">CGFloat</span> <span class="o">=</span> <span class="mi">0</span>
    <span class="kd">@State</span> <span class="kd">private</span> <span class="k">var</span> <span class="nv">passedThreshold</span> <span class="o">=</span> <span class="kc">false</span>

    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="kt">CardContent</span><span class="p">()</span>
            <span class="o">.</span><span class="nf">offset</span><span class="p">(</span><span class="nv">x</span><span class="p">:</span> <span class="n">offset</span><span class="p">)</span>
            <span class="o">.</span><span class="nf">gesture</span><span class="p">(</span>
                <span class="kt">DragGesture</span><span class="p">()</span>
                    <span class="o">.</span><span class="n">onChanged</span> <span class="p">{</span> <span class="n">v</span> <span class="k">in</span>
                        <span class="n">offset</span> <span class="o">=</span> <span class="n">v</span><span class="o">.</span><span class="n">translation</span><span class="o">.</span><span class="n">width</span>
                        <span class="n">passedThreshold</span> <span class="o">=</span> <span class="nf">abs</span><span class="p">(</span><span class="n">offset</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">120</span>          <span class="c1">// 넘는 순간 한 번만</span>
                    <span class="p">}</span>
                    <span class="o">.</span><span class="n">onEnded</span> <span class="p">{</span> <span class="n">_</span> <span class="k">in</span> <span class="cm">/* ... */</span> <span class="p">}</span>
            <span class="p">)</span>
            <span class="o">.</span><span class="nf">sensoryFeedback</span><span class="p">(</span><span class="o">.</span><span class="nf">impact</span><span class="p">(</span><span class="nv">weight</span><span class="p">:</span> <span class="o">.</span><span class="n">medium</span><span class="p">),</span> <span class="nv">trigger</span><span class="p">:</span> <span class="n">passedThreshold</span><span class="p">)</span> <span class="p">{</span> <span class="n">_</span><span class="p">,</span> <span class="k">new</span> <span class="k">in</span> <span class="k">new</span> <span class="p">}</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>피커처럼 한 칸씩</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">.</span><span class="nf">sensoryFeedback</span><span class="p">(</span><span class="o">.</span><span class="n">selection</span><span class="p">,</span> <span class="nv">trigger</span><span class="p">:</span> <span class="n">selectedIndex</span><span class="p">)</span>
</code></pre></div></div>

<p><strong>iOS 16 이하 또는 세밀한 제어: UIKit 제너레이터</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">let</span> <span class="nv">generator</span> <span class="o">=</span> <span class="kt">UIImpactFeedbackGenerator</span><span class="p">(</span><span class="nv">style</span><span class="p">:</span> <span class="o">.</span><span class="n">light</span><span class="p">)</span>
<span class="n">generator</span><span class="o">.</span><span class="nf">prepare</span><span class="p">()</span>           <span class="c1">// 지연을 줄이려면 미리 준비 (0.1초 전쯤)</span>
<span class="n">generator</span><span class="o">.</span><span class="nf">impactOccurred</span><span class="p">(</span><span class="nv">intensity</span><span class="p">:</span> <span class="mf">0.7</span><span class="p">)</span>

<span class="kt">UINotificationFeedbackGenerator</span><span class="p">()</span><span class="o">.</span><span class="nf">notificationOccurred</span><span class="p">(</span><span class="o">.</span><span class="n">success</span><span class="p">)</span>
<span class="kt">UISelectionFeedbackGenerator</span><span class="p">()</span><span class="o">.</span><span class="nf">selectionChanged</span><span class="p">()</span>
</code></pre></div></div>

<p><strong>커스텀 패턴: Core Haptics</strong></p>

<p>게임이나 악기 앱처럼 고유한 촉감이 필요할 때. <code class="language-plaintext highlighter-rouge">CHHapticPattern</code>으로 강도와 선명도를 시간축에 그린다. 일반 앱에는 거의 필요 없다.</p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">let</span> <span class="nv">engine</span> <span class="o">=</span> <span class="k">try</span> <span class="kt">CHHapticEngine</span><span class="p">()</span>
<span class="k">try</span> <span class="n">engine</span><span class="o">.</span><span class="nf">start</span><span class="p">()</span>
<span class="k">let</span> <span class="nv">event</span> <span class="o">=</span> <span class="kt">CHHapticEvent</span><span class="p">(</span><span class="nv">eventType</span><span class="p">:</span> <span class="o">.</span><span class="n">hapticTransient</span><span class="p">,</span>
                          <span class="nv">parameters</span><span class="p">:</span> <span class="p">[</span><span class="o">.</span><span class="nf">init</span><span class="p">(</span><span class="nv">parameterID</span><span class="p">:</span> <span class="o">.</span><span class="n">hapticIntensity</span><span class="p">,</span> <span class="nv">value</span><span class="p">:</span> <span class="mf">0.8</span><span class="p">),</span>
                                       <span class="o">.</span><span class="nf">init</span><span class="p">(</span><span class="nv">parameterID</span><span class="p">:</span> <span class="o">.</span><span class="n">hapticSharpness</span><span class="p">,</span> <span class="nv">value</span><span class="p">:</span> <span class="mf">0.5</span><span class="p">)],</span>
                          <span class="nv">relativeTime</span><span class="p">:</span> <span class="mi">0</span><span class="p">)</span>
<span class="k">let</span> <span class="nv">pattern</span> <span class="o">=</span> <span class="k">try</span> <span class="kt">CHHapticPattern</span><span class="p">(</span><span class="nv">events</span><span class="p">:</span> <span class="p">[</span><span class="n">event</span><span class="p">],</span> <span class="nv">parameters</span><span class="p">:</span> <span class="p">[])</span>
<span class="k">try</span> <span class="n">engine</span><span class="o">.</span><span class="nf">makePlayer</span><span class="p">(</span><span class="nv">with</span><span class="p">:</span> <span class="n">pattern</span><span class="p">)</span><span class="o">.</span><span class="nf">start</span><span class="p">(</span><span class="nv">atTime</span><span class="p">:</span> <span class="mi">0</span><span class="p">)</span>
</code></pre></div></div>

<h2 id="자주-하는-실수">자주 하는 실수</h2>

<ul>
  <li><strong>모든 버튼에 햅틱</strong>: 시스템 버튼에는 햅틱이 없다. 버튼에 햅틱을 넣으면 iOS답지 않다. 결과(저장 완료)에 넣는다</li>
  <li><strong>스크롤마다 햅틱</strong>: 리스트를 스크롤할 때 셀마다 울리면 피로하다. 피커처럼 “칸”이 의미 있을 때만 <code class="language-plaintext highlighter-rouge">.selection</code></li>
  <li><strong>의미 뒤섞기</strong>: 삭제 성공에 <code class="language-plaintext highlighter-rouge">.error</code>를 쓰거나, 오류에 <code class="language-plaintext highlighter-rouge">.impact</code>를 쓰면 사용자의 학습이 깨진다</li>
  <li><strong>시각 피드백 없이 햅틱만</strong>: 햅틱이 꺼진 사용자는 아무것도 모른다. 항상 눈에 보이는 변화와 함께</li>
  <li><strong>타이밍 어긋남</strong>: 애니메이션 끝에 햅틱을 넣으면 늦다. 상태가 바뀌는 순간(애니메이션 시작)에</li>
  <li><strong><code class="language-plaintext highlighter-rouge">prepare()</code> 없이 UIKit 제너레이터 즉시 호출</strong>: 첫 햅틱이 늦게 온다. 제스처가 시작될 때 미리 준비한다</li>
  <li><strong>햅틱으로 알림 대체</strong>: 백그라운드에서는 햅틱이 울리지 않는다. 알림은 알림으로</li>
  <li><strong>iPad 테스트만</strong>: iPad 대부분은 햅틱이 없다. iPhone 실기기에서 확인한다. 시뮬레이터도 햅틱을 재생하지 않는다</li>
</ul>

<h2 id="체크리스트">체크리스트</h2>

<ul class="task-list">
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />시스템 컨트롤(토글, 피커, 스와이프)에 햅틱을 중복으로 넣지 않았다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />결과 햅틱(<code class="language-plaintext highlighter-rouge">.success</code> / <code class="language-plaintext highlighter-rouge">.warning</code> / <code class="language-plaintext highlighter-rouge">.error</code>)이 의미에 맞게 쓰였다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />같은 동작에는 항상 같은 햅틱</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />모든 햅틱에 동시에 일어나는 시각 변화가 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />햅틱을 끈 기기에서도 앱 사용에 문제가 없다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />연속 제스처에서는 임계점 통과 한 번만 울린다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />iPhone 실기기에서 타이밍을 확인했다</li>
</ul>

<h2 id="함께-읽기">함께 읽기</h2>

<ul>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/microInteraction/">마이크로인터랙션: 작은 디테일의 큰 영향</a> — 햅틱이 속한 더 큰 범주</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/gestureBasedInterface/">제스처 기반 인터페이스: 직관적 조작의 혁신</a> — 제스처와 햅틱의 동기화</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosModality/">모달의 위계: 알림, 시트, 팝오버</a> — 알림 대신 햅틱으로 성공 알리기</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/watchOSDesign/">손목 위의 디자인: watchOS</a> — 손목에서는 햅틱이 더 중요하다</li>
</ul>]]></content><author><name>Geppetto</name></author><category term="디자인" /><category term="iOS 디자인" /><category term="HIG" /><category term="iOS" /><summary type="html"><![CDATA[진동이 아니라 촉감. 성공·경고·실패·선택·충격 다섯 패턴의 문법과 sensoryFeedback 구현, 그리고 절제의 규칙.]]></summary></entry><entry><title type="html">위젯과 라이브 액티비티: 한눈에 보는 디자인</title><link href="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosWidgets/" rel="alternate" type="text/html" title="위젯과 라이브 액티비티: 한눈에 보는 디자인" /><published>2026-11-15T00:05:00+09:00</published><updated>2026-11-15T00:05:00+09:00</updated><id>https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosWidgets</id><content type="html" xml:base="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosWidgets/"><![CDATA[<p>위젯은 앱을 열지 않고 보는 앱이다. 사용자는 위젯을 <strong>0.5초 보고 지나간다</strong>. 그 짧은 시간에 가장 중요한 정보 하나를 전달하는 것이 위젯 디자인의 전부다.</p>

<p>웹에 대응물이 없는 주제다. 가장 가까운 것은 대시보드의 타일이지만, 대시보드는 사용자가 보러 오는 곳이고 위젯은 사용자의 홈 화면에 얹혀 있다. 그래서 규칙이 훨씬 엄격하다.</p>

<h2 id="종류">종류</h2>

<table>
  <thead>
    <tr>
      <th>종류</th>
      <th>어디에</th>
      <th>크기</th>
      <th>갱신</th>
      <th>상호작용</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>홈 화면 위젯</strong></td>
      <td>홈 화면, 투데이 뷰</td>
      <td>소 / 중 / 대 / 특대(iPad)</td>
      <td>타임라인 (시스템이 예산 관리)</td>
      <td>탭하면 앱 열기, 버튼·토글 (iOS 17+)</td>
    </tr>
    <tr>
      <td><strong>잠금 화면 위젯</strong></td>
      <td>잠금 화면 시계 아래, 위</td>
      <td>원형 / 직사각형 / 인라인</td>
      <td>타임라인</td>
      <td>탭하면 앱 열기</td>
    </tr>
    <tr>
      <td><strong>StandBy</strong></td>
      <td>가로로 충전 중인 iPhone</td>
      <td>홈 화면 위젯 재사용</td>
      <td>타임라인</td>
      <td>동일</td>
    </tr>
    <tr>
      <td><strong>라이브 액티비티</strong></td>
      <td>잠금 화면, 다이내믹 아일랜드</td>
      <td>잠금 화면 배너, 아일랜드 소/확장</td>
      <td>실시간 (푸시 또는 앱)</td>
      <td>버튼 (iOS 17+)</td>
    </tr>
    <tr>
      <td><strong>컨트롤</strong> (iOS 18+)</td>
      <td>제어 센터, 잠금 화면, 동작 버튼</td>
      <td>작은 버튼/토글</td>
      <td>즉시</td>
      <td>토글, 실행</td>
    </tr>
    <tr>
      <td><strong>Apple Watch 컴플리케이션</strong></td>
      <td>시계 페이스</td>
      <td>페이스별 다양</td>
      <td>타임라인</td>
      <td>탭하면 앱 열기</td>
    </tr>
  </tbody>
</table>

<h2 id="hig가-말하는-것">HIG가 말하는 것</h2>

<ul>
  <li><strong>한눈에(Glanceable)</strong>: 위젯은 읽는 것이 아니라 보는 것이다. 핵심 정보 하나, 보조 정보 둘까지</li>
  <li><strong>적절한 시점에(Relevant)</strong>: 시간과 상황에 맞는 정보. 아침에는 오늘 일정, 저녁에는 내일 첫 일정</li>
  <li><strong>개인화(Personalized)</strong>: 사용자가 위젯을 편집해 원하는 것을 고를 수 있게</li>
  <li><strong>앱의 축소판이 아니다</strong>: 위젯은 앱의 기능을 다 담지 않는다. 정보를 보여 주고, 탭하면 앱의 해당 화면으로 데려간다</li>
  <li><strong>콘텐츠가 가장자리까지</strong>: 위젯 안에 또 카드를 그리지 않는다. 위젯 자체가 카드다</li>
  <li><strong>다크 모드, 틴트 모드, 투명 모드</strong>: iOS 18부터 사용자가 홈 화면을 틴트 색으로 물들일 수 있다. 위젯은 단색 렌더링에서도 읽혀야 한다</li>
  <li><strong>라이브 액티비티는 진행 중인 것에만</strong>: 배달, 운동, 타이머, 경기 점수처럼 시작과 끝이 있는 것. 광고나 정적 정보에 쓰면 안 된다</li>
</ul>

<h2 id="정보-설계">정보 설계</h2>

<p>위젯 크기별로 담을 수 있는 정보의 양이 정해져 있다.</p>

<table>
  <thead>
    <tr>
      <th>크기</th>
      <th>담을 것</th>
      <th>예: 날씨</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>인라인 (잠금 화면)</td>
      <td>텍스트 한 줄</td>
      <td>“맑음 12°”</td>
    </tr>
    <tr>
      <td>원형 (잠금 화면)</td>
      <td>숫자 하나 또는 게이지</td>
      <td>기온 게이지</td>
    </tr>
    <tr>
      <td>소</td>
      <td>핵심 정보 하나 + 맥락</td>
      <td>현재 기온, 최고/최저, 아이콘</td>
    </tr>
    <tr>
      <td>중</td>
      <td>핵심 + 시간 축 또는 목록 3~4개</td>
      <td>시간별 예보 6칸</td>
    </tr>
    <tr>
      <td>대</td>
      <td>중 + 더 긴 목록 또는 차트</td>
      <td>주간 예보</td>
    </tr>
  </tbody>
</table>

<p><strong>숫자가 주인공</strong>이면 크게. 글자 크기 대비를 과감하게 둔다. 소형 위젯에서 기온은 40pt, 설명은 12pt.</p>

<h2 id="widgetkit으로-구현하기">WidgetKit으로 구현하기</h2>

<p><strong>타임라인 모델</strong></p>

<p>위젯은 뷰가 아니라 <strong>시간표</strong>를 제공한다. “지금은 이것, 10분 뒤에는 저것”을 미리 넘기면 시스템이 때맞춰 그린다.</p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">TimerEntry</span><span class="p">:</span> <span class="kt">TimelineEntry</span> <span class="p">{</span>
    <span class="k">let</span> <span class="nv">date</span><span class="p">:</span> <span class="kt">Date</span>
    <span class="k">let</span> <span class="nv">remaining</span><span class="p">:</span> <span class="kt">TimeInterval</span>
    <span class="k">let</span> <span class="nv">label</span><span class="p">:</span> <span class="kt">String</span>
<span class="p">}</span>

<span class="kd">struct</span> <span class="kt">TimerProvider</span><span class="p">:</span> <span class="kt">TimelineProvider</span> <span class="p">{</span>
    <span class="kd">func</span> <span class="nf">placeholder</span><span class="p">(</span><span class="k">in</span> <span class="nv">context</span><span class="p">:</span> <span class="kt">Context</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">TimerEntry</span> <span class="p">{</span>
        <span class="kt">TimerEntry</span><span class="p">(</span><span class="nv">date</span><span class="p">:</span> <span class="o">.</span><span class="n">now</span><span class="p">,</span> <span class="nv">remaining</span><span class="p">:</span> <span class="mi">25</span> <span class="o">*</span> <span class="mi">60</span><span class="p">,</span> <span class="nv">label</span><span class="p">:</span> <span class="s">"집중"</span><span class="p">)</span>   <span class="c1">// 위젯 갤러리용</span>
    <span class="p">}</span>
    <span class="kd">func</span> <span class="nf">getSnapshot</span><span class="p">(</span><span class="k">in</span> <span class="nv">context</span><span class="p">:</span> <span class="kt">Context</span><span class="p">,</span> <span class="nv">completion</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt">TimerEntry</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span> <span class="p">{</span>
        <span class="nf">completion</span><span class="p">(</span><span class="nf">loadCurrent</span><span class="p">())</span>
    <span class="p">}</span>
    <span class="kd">func</span> <span class="nf">getTimeline</span><span class="p">(</span><span class="k">in</span> <span class="nv">context</span><span class="p">:</span> <span class="kt">Context</span><span class="p">,</span> <span class="nv">completion</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt">Timeline</span><span class="o">&lt;</span><span class="kt">TimerEntry</span><span class="o">&gt;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span> <span class="p">{</span>
        <span class="k">let</span> <span class="nv">entry</span> <span class="o">=</span> <span class="nf">loadCurrent</span><span class="p">()</span>
        <span class="k">let</span> <span class="nv">end</span> <span class="o">=</span> <span class="n">entry</span><span class="o">.</span><span class="n">date</span><span class="o">.</span><span class="nf">addingTimeInterval</span><span class="p">(</span><span class="n">entry</span><span class="o">.</span><span class="n">remaining</span><span class="p">)</span>
        <span class="nf">completion</span><span class="p">(</span><span class="kt">Timeline</span><span class="p">(</span><span class="nv">entries</span><span class="p">:</span> <span class="p">[</span><span class="n">entry</span><span class="p">],</span> <span class="nv">policy</span><span class="p">:</span> <span class="o">.</span><span class="nf">after</span><span class="p">(</span><span class="n">end</span><span class="p">)))</span>   <span class="c1">// 끝나면 다시 요청</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>크기별 뷰</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">TimerWidgetView</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="kd">@Environment</span><span class="p">(\</span><span class="o">.</span><span class="n">widgetFamily</span><span class="p">)</span> <span class="k">var</span> <span class="nv">family</span>
    <span class="kd">@Environment</span><span class="p">(\</span><span class="o">.</span><span class="n">widgetRenderingMode</span><span class="p">)</span> <span class="k">var</span> <span class="nv">renderingMode</span>   <span class="c1">// 풀컬러 / 악센트 / 비브런트</span>
    <span class="k">let</span> <span class="nv">entry</span><span class="p">:</span> <span class="kt">TimerEntry</span>

    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="k">switch</span> <span class="n">family</span> <span class="p">{</span>
        <span class="k">case</span> <span class="o">.</span><span class="nv">accessoryInline</span><span class="p">:</span>
            <span class="kt">Text</span><span class="p">(</span><span class="s">"</span><span class="se">\(</span><span class="n">entry</span><span class="o">.</span><span class="n">label</span><span class="se">)</span><span class="s"> </span><span class="se">\(</span><span class="n">entry</span><span class="o">.</span><span class="n">remaining</span><span class="o">.</span><span class="nf">formatted</span><span class="p">(</span><span class="o">.</span><span class="nf">time</span><span class="p">(</span><span class="nv">pattern</span><span class="p">:</span> <span class="o">.</span><span class="n">minuteSecond</span><span class="p">))</span><span class="se">)</span><span class="s">"</span><span class="p">)</span>
        <span class="k">case</span> <span class="o">.</span><span class="nv">accessoryCircular</span><span class="p">:</span>
            <span class="kt">Gauge</span><span class="p">(</span><span class="nv">value</span><span class="p">:</span> <span class="n">entry</span><span class="o">.</span><span class="n">remaining</span><span class="p">,</span> <span class="nv">in</span><span class="p">:</span> <span class="mi">0</span><span class="o">...</span><span class="p">(</span><span class="mi">25</span> <span class="o">*</span> <span class="mi">60</span><span class="p">))</span> <span class="p">{</span>
                <span class="kt">Image</span><span class="p">(</span><span class="nv">systemName</span><span class="p">:</span> <span class="s">"timer"</span><span class="p">)</span>
            <span class="p">}</span>
            <span class="o">.</span><span class="nf">gaugeStyle</span><span class="p">(</span><span class="o">.</span><span class="n">accessoryCircularCapacity</span><span class="p">)</span>
        <span class="k">case</span> <span class="o">.</span><span class="nv">systemSmall</span><span class="p">:</span>
            <span class="kt">VStack</span><span class="p">(</span><span class="nv">alignment</span><span class="p">:</span> <span class="o">.</span><span class="n">leading</span><span class="p">)</span> <span class="p">{</span>
                <span class="kt">Label</span><span class="p">(</span><span class="n">entry</span><span class="o">.</span><span class="n">label</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"timer"</span><span class="p">)</span>
                    <span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">caption</span><span class="p">)</span><span class="o">.</span><span class="nf">foregroundStyle</span><span class="p">(</span><span class="o">.</span><span class="n">secondary</span><span class="p">)</span>
                <span class="kt">Spacer</span><span class="p">()</span>
                <span class="kt">Text</span><span class="p">(</span><span class="n">entry</span><span class="o">.</span><span class="n">date</span><span class="o">.</span><span class="nf">addingTimeInterval</span><span class="p">(</span><span class="n">entry</span><span class="o">.</span><span class="n">remaining</span><span class="p">),</span> <span class="nv">style</span><span class="p">:</span> <span class="o">.</span><span class="n">timer</span><span class="p">)</span>   <span class="c1">// 시스템이 초마다 갱신</span>
                    <span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="nf">system</span><span class="p">(</span><span class="nv">size</span><span class="p">:</span> <span class="mi">40</span><span class="p">,</span> <span class="nv">weight</span><span class="p">:</span> <span class="o">.</span><span class="n">light</span><span class="p">,</span> <span class="nv">design</span><span class="p">:</span> <span class="o">.</span><span class="n">rounded</span><span class="p">))</span>
                    <span class="o">.</span><span class="nf">monospacedDigit</span><span class="p">()</span>
                    <span class="o">.</span><span class="nf">minimumScaleFactor</span><span class="p">(</span><span class="mf">0.6</span><span class="p">)</span>
            <span class="p">}</span>
            <span class="o">.</span><span class="nf">containerBackground</span><span class="p">(</span><span class="o">.</span><span class="n">fill</span><span class="o">.</span><span class="n">tertiary</span><span class="p">,</span> <span class="nv">for</span><span class="p">:</span> <span class="o">.</span><span class="n">widget</span><span class="p">)</span>   <span class="c1">// iOS 17+ 필수</span>
        <span class="k">default</span><span class="p">:</span>
            <span class="kt">MediumTimerView</span><span class="p">(</span><span class="nv">entry</span><span class="p">:</span> <span class="n">entry</span><span class="p">)</span>
                <span class="o">.</span><span class="nf">containerBackground</span><span class="p">(</span><span class="o">.</span><span class="n">fill</span><span class="o">.</span><span class="n">tertiary</span><span class="p">,</span> <span class="nv">for</span><span class="p">:</span> <span class="o">.</span><span class="n">widget</span><span class="p">)</span>
        <span class="p">}</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><code class="language-plaintext highlighter-rouge">Text(_:style: .timer)</code>는 위젯이 <strong>갱신 없이</strong> 초를 센다. 타이머, 카운트다운, 경과 시간은 반드시 이것으로 한다.</p>

<p><strong>상호작용 (iOS 17+)</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">Button</span><span class="p">(</span><span class="nv">intent</span><span class="p">:</span> <span class="kt">ToggleTimerIntent</span><span class="p">())</span> <span class="p">{</span>              <span class="c1">// App Intent로 앱을 열지 않고 실행</span>
    <span class="kt">Image</span><span class="p">(</span><span class="nv">systemName</span><span class="p">:</span> <span class="n">entry</span><span class="o">.</span><span class="n">isRunning</span> <span class="p">?</span> <span class="s">"pause.fill"</span> <span class="p">:</span> <span class="s">"play.fill"</span><span class="p">)</span>
<span class="p">}</span>
<span class="o">.</span><span class="nf">buttonStyle</span><span class="p">(</span><span class="o">.</span><span class="n">plain</span><span class="p">)</span>
</code></pre></div></div>

<p><strong>딥 링크</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">.</span><span class="nf">widgetURL</span><span class="p">(</span><span class="kt">URL</span><span class="p">(</span><span class="nv">string</span><span class="p">:</span> <span class="s">"mytimer://session/</span><span class="se">\(</span><span class="n">entry</span><span class="o">.</span><span class="n">id</span><span class="se">)</span><span class="s">"</span><span class="p">))</span>   <span class="c1">// 탭하면 앱의 해당 화면으로</span>
</code></pre></div></div>

<p><strong>라이브 액티비티</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">TimerAttributes</span><span class="p">:</span> <span class="kt">ActivityAttributes</span> <span class="p">{</span>
    <span class="kd">struct</span> <span class="kt">ContentState</span><span class="p">:</span> <span class="kt">Codable</span><span class="p">,</span> <span class="kt">Hashable</span> <span class="p">{</span> <span class="k">var</span> <span class="nv">endDate</span><span class="p">:</span> <span class="kt">Date</span><span class="p">;</span> <span class="k">var</span> <span class="nv">label</span><span class="p">:</span> <span class="kt">String</span> <span class="p">}</span>
    <span class="k">var</span> <span class="nv">sessionID</span><span class="p">:</span> <span class="kt">String</span>
<span class="p">}</span>

<span class="c1">// 위젯 확장에서</span>
<span class="kt">ActivityConfiguration</span><span class="p">(</span><span class="nv">for</span><span class="p">:</span> <span class="kt">TimerAttributes</span><span class="o">.</span><span class="k">self</span><span class="p">)</span> <span class="p">{</span> <span class="n">context</span> <span class="k">in</span>
    <span class="c1">// 잠금 화면 배너</span>
    <span class="kt">HStack</span> <span class="p">{</span>
        <span class="kt">Label</span><span class="p">(</span><span class="n">context</span><span class="o">.</span><span class="n">state</span><span class="o">.</span><span class="n">label</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"timer"</span><span class="p">)</span>
        <span class="kt">Spacer</span><span class="p">()</span>
        <span class="kt">Text</span><span class="p">(</span><span class="n">context</span><span class="o">.</span><span class="n">state</span><span class="o">.</span><span class="n">endDate</span><span class="p">,</span> <span class="nv">style</span><span class="p">:</span> <span class="o">.</span><span class="n">timer</span><span class="p">)</span><span class="o">.</span><span class="nf">monospacedDigit</span><span class="p">()</span><span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">title2</span><span class="p">)</span>
    <span class="p">}</span>
    <span class="o">.</span><span class="nf">padding</span><span class="p">()</span>
<span class="p">}</span> <span class="nv">dynamicIsland</span><span class="p">:</span> <span class="p">{</span> <span class="n">context</span> <span class="k">in</span>
    <span class="kt">DynamicIsland</span> <span class="p">{</span>
        <span class="kt">DynamicIslandExpandedRegion</span><span class="p">(</span><span class="o">.</span><span class="n">leading</span><span class="p">)</span> <span class="p">{</span> <span class="kt">Label</span><span class="p">(</span><span class="n">context</span><span class="o">.</span><span class="n">state</span><span class="o">.</span><span class="n">label</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"timer"</span><span class="p">)</span> <span class="p">}</span>
        <span class="kt">DynamicIslandExpandedRegion</span><span class="p">(</span><span class="o">.</span><span class="n">trailing</span><span class="p">)</span> <span class="p">{</span> <span class="kt">Text</span><span class="p">(</span><span class="n">context</span><span class="o">.</span><span class="n">state</span><span class="o">.</span><span class="n">endDate</span><span class="p">,</span> <span class="nv">style</span><span class="p">:</span> <span class="o">.</span><span class="n">timer</span><span class="p">)</span> <span class="p">}</span>
        <span class="kt">DynamicIslandExpandedRegion</span><span class="p">(</span><span class="o">.</span><span class="n">bottom</span><span class="p">)</span> <span class="p">{</span> <span class="kt">Button</span><span class="p">(</span><span class="nv">intent</span><span class="p">:</span> <span class="kt">StopTimerIntent</span><span class="p">())</span> <span class="p">{</span> <span class="kt">Text</span><span class="p">(</span><span class="s">"중지"</span><span class="p">)</span> <span class="p">}</span> <span class="p">}</span>
    <span class="p">}</span> <span class="nv">compactLeading</span><span class="p">:</span> <span class="p">{</span>
        <span class="kt">Image</span><span class="p">(</span><span class="nv">systemName</span><span class="p">:</span> <span class="s">"timer"</span><span class="p">)</span>
    <span class="p">}</span> <span class="nv">compactTrailing</span><span class="p">:</span> <span class="p">{</span>
        <span class="kt">Text</span><span class="p">(</span><span class="n">context</span><span class="o">.</span><span class="n">state</span><span class="o">.</span><span class="n">endDate</span><span class="p">,</span> <span class="nv">style</span><span class="p">:</span> <span class="o">.</span><span class="n">timer</span><span class="p">)</span><span class="o">.</span><span class="nf">monospacedDigit</span><span class="p">()</span><span class="o">.</span><span class="nf">frame</span><span class="p">(</span><span class="nv">width</span><span class="p">:</span> <span class="mi">44</span><span class="p">)</span>
    <span class="p">}</span> <span class="nv">minimal</span><span class="p">:</span> <span class="p">{</span>
        <span class="kt">Image</span><span class="p">(</span><span class="nv">systemName</span><span class="p">:</span> <span class="s">"timer"</span><span class="p">)</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p>다이내믹 아일랜드의 compact 영역은 <strong>아이콘 하나 + 숫자 하나</strong>다. 그 이상은 들어가지 않는다.</p>

<h2 id="자주-하는-실수">자주 하는 실수</h2>

<ul>
  <li><strong>위젯을 자주 갱신하려 함</strong>: 시스템은 하루 40~70회 정도만 갱신을 허용한다. 초 단위 정보는 <code class="language-plaintext highlighter-rouge">Text(style: .timer)</code>나 <code class="language-plaintext highlighter-rouge">.relative</code>로, 나머지는 타임라인을 미리 넘긴다</li>
  <li><strong>위젯 안에 카드 그리기</strong>: 위젯이 이미 카드다. 배경은 <code class="language-plaintext highlighter-rouge">containerBackground</code>로</li>
  <li><strong>작은 위젯에 정보 다섯 개</strong>: 하나만. 나머지는 중형으로</li>
  <li><strong>틴트 모드 무시</strong>: iOS 18 틴트 홈 화면에서 위젯이 단색으로 렌더링된다. <code class="language-plaintext highlighter-rouge">widgetRenderingMode</code>를 읽어 사진은 숨기고 심볼과 텍스트만 남긴다. <code class="language-plaintext highlighter-rouge">.widgetAccentable()</code>로 강조할 요소를 표시한다</li>
  <li><strong>플레이스홀더 미제공</strong>: 위젯 갤러리와 첫 로딩에 빈 화면이 보인다. <code class="language-plaintext highlighter-rouge">placeholder(in:)</code>에 그럴듯한 가짜 데이터를</li>
  <li><strong>라이브 액티비티를 끝내지 않음</strong>: 작업이 끝났는데 아일랜드에 남아 있으면 사용자가 짜증 낸다. 끝나면 즉시 <code class="language-plaintext highlighter-rouge">end(dismissalPolicy:)</code></li>
  <li><strong>위젯에서 네트워크 직접 호출</strong>: 느리고 예산을 먹는다. 앱이 미리 저장한 데이터를 App Group으로 읽는다</li>
  <li><strong>접근성 생략</strong>: 위젯도 VoiceOver가 읽는다. 게이지와 아이콘에 레이블을</li>
</ul>

<h2 id="체크리스트">체크리스트</h2>

<ul class="task-list">
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />각 크기에서 핵심 정보가 0.5초 안에 읽힌다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />시간 정보는 <code class="language-plaintext highlighter-rouge">Text(style:)</code>로, 갱신 없이 흐른다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" /><code class="language-plaintext highlighter-rouge">placeholder</code>, <code class="language-plaintext highlighter-rouge">snapshot</code>, <code class="language-plaintext highlighter-rouge">timeline</code> 셋 다 의미 있는 데이터를 준다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />라이트 / 다크 / 틴트 모드에서 모두 읽힌다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />탭하면 앱의 <strong>해당 화면</strong>으로 간다 (앱 첫 화면이 아니라)</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />잠금 화면 위젯은 단색으로도 의미가 통한다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />라이브 액티비티는 시작과 끝이 있고, 끝나면 사라진다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />위젯이 앱 없이도 마지막 데이터를 보여 준다 (App Group)</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />VoiceOver로 위젯 내용이 읽힌다</li>
</ul>

<h2 id="함께-읽기">함께 읽기</h2>

<ul>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/dataVisualization/">데이터 시각화: 정보의 시각적 표현과 해석</a> — 위젯용 요약 차트</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/visualHierarchy/">비주얼 계층구조: 시각적 중요도의 체계화</a> — 작은 공간의 위계</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/watchOSDesign/">손목 위의 디자인: watchOS</a> — 컴플리케이션은 위젯의 사촌</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/cardBasedDesign/">카드 기반 디자인: 정보의 모듈화</a></li>
</ul>]]></content><author><name>Geppetto</name></author><category term="디자인" /><category term="iOS 디자인" /><category term="HIG" /><category term="iOS" /><category term="WidgetKit" /><summary type="html"><![CDATA[앱 밖에서 보이는 앱. 홈 화면 위젯, 잠금 화면 위젯, 라이브 액티비티, 다이내믹 아일랜드의 정보 디자인 원칙과 WidgetKit 구현.]]></summary></entry><entry><title type="html">색상과 다크 모드: 의미론적 색 체계</title><link href="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosColorDarkMode/" rel="alternate" type="text/html" title="색상과 다크 모드: 의미론적 색 체계" /><published>2026-11-15T00:04:00+09:00</published><updated>2026-11-15T00:04:00+09:00</updated><id>https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosColorDarkMode</id><content type="html" xml:base="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosColorDarkMode/"><![CDATA[<p>웹에서 색은 <code class="language-plaintext highlighter-rouge">#1C1C1E</code> 같은 값이다. iOS에서 색은 <strong>역할</strong>이다. “레이블 색”, “배경 색”, “구분선 색”처럼 역할로 정의하면, 라이트/다크 모드와 고대비 설정에 맞는 실제 값은 시스템이 고른다.</p>

<p>이 글은 iOS 색 체계의 세 층(시스템 색, 의미론적 색, 앱 색)과, 그 위에서 다크 모드를 설계하는 법을 다룬다.</p>

<h2 id="hig가-말하는-것">HIG가 말하는 것</h2>

<ul>
  <li><strong>색은 의미를 전달하되, 유일한 수단이 아니어야 한다</strong>: 빨강은 삭제, 파랑은 링크. 하지만 색각 이상 사용자를 위해 아이콘이나 텍스트가 함께 있어야 한다</li>
  <li><strong>시스템 색을 쓰면 적응은 자동</strong>: 시스템 색은 라이트/다크, 고대비, 투명도 줄이기에 맞는 변형을 모두 갖고 있다</li>
  <li><strong>앱 강조색(tint)은 하나</strong>: 앱의 상호작용 요소는 한 가지 색으로 통일한다. 사용자는 “이 색이면 누를 수 있다”고 배운다</li>
  <li><strong>다크 모드는 반전이 아니다</strong>: 라이트 모드의 그림자가 다크 모드에서는 밝기 차이로 바뀐다. 겹쳐 올라갈수록 밝아진다(elevation)</li>
  <li><strong>콘텐츠의 색은 건드리지 않는다</strong>: 사진, 사용자가 고른 색은 다크 모드에서도 그대로</li>
</ul>

<h2 id="세-층의-색">세 층의 색</h2>

<h3 id="1-시스템-색-system-colors">1. 시스템 색 (System Colors)</h3>

<p><code class="language-plaintext highlighter-rouge">systemBlue</code>, <code class="language-plaintext highlighter-rouge">systemRed</code>, <code class="language-plaintext highlighter-rouge">systemGreen</code> 같은 13가지 기본색. 라이트/다크 모드에서 <strong>다른 값</strong>을 가진다. 다크 모드의 systemBlue는 조금 더 밝고 채도가 높다. 어두운 배경에서 같은 인상을 주기 위해서다.</p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">Color</span><span class="o">.</span><span class="n">blue</span>      <span class="c1">// SwiftUI의 .blue는 systemBlue. 모드에 따라 값이 바뀐다</span>
<span class="kt">Color</span><span class="p">(</span><span class="o">.</span><span class="n">systemBlue</span><span class="p">)</span>
</code></pre></div></div>

<h3 id="2-의미론적-색-semantic-colors">2. 의미론적 색 (Semantic Colors)</h3>

<p>역할로 이름 붙은 색. UI의 뼈대를 이루며, 대부분의 화면은 이것만으로 충분하다.</p>

<table>
  <thead>
    <tr>
      <th>역할</th>
      <th>색</th>
      <th>쓰임</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>전경</td>
      <td><code class="language-plaintext highlighter-rouge">label</code> / <code class="language-plaintext highlighter-rouge">secondaryLabel</code> / <code class="language-plaintext highlighter-rouge">tertiaryLabel</code> / <code class="language-plaintext highlighter-rouge">quaternaryLabel</code></td>
      <td>텍스트와 아이콘의 4단계 위계</td>
    </tr>
    <tr>
      <td>배경</td>
      <td><code class="language-plaintext highlighter-rouge">systemBackground</code> / <code class="language-plaintext highlighter-rouge">secondarySystemBackground</code> / <code class="language-plaintext highlighter-rouge">tertiarySystemBackground</code></td>
      <td>겹쳐 올라가는 레이어</td>
    </tr>
    <tr>
      <td>그룹 배경</td>
      <td><code class="language-plaintext highlighter-rouge">systemGroupedBackground</code> / <code class="language-plaintext highlighter-rouge">secondary...</code> / <code class="language-plaintext highlighter-rouge">tertiary...</code></td>
      <td>인셋 그룹 리스트용. 바닥이 회색, 카드가 흰색</td>
    </tr>
    <tr>
      <td>채움</td>
      <td><code class="language-plaintext highlighter-rouge">systemFill</code> ~ <code class="language-plaintext highlighter-rouge">quaternarySystemFill</code></td>
      <td>입력 필드 배경, 슬라이더 트랙</td>
    </tr>
    <tr>
      <td>구분선</td>
      <td><code class="language-plaintext highlighter-rouge">separator</code> / <code class="language-plaintext highlighter-rouge">opaqueSeparator</code></td>
      <td>리스트 구분선</td>
    </tr>
    <tr>
      <td>링크</td>
      <td><code class="language-plaintext highlighter-rouge">link</code></td>
      <td>탭 가능한 텍스트</td>
    </tr>
    <tr>
      <td>회색</td>
      <td><code class="language-plaintext highlighter-rouge">systemGray</code> ~ <code class="language-plaintext highlighter-rouge">systemGray6</code></td>
      <td>6단계 회색. 다크 모드에서는 순서가 뒤집혀 보인다</td>
    </tr>
  </tbody>
</table>

<p>SwiftUI에서는 <code class="language-plaintext highlighter-rouge">.primary</code>, <code class="language-plaintext highlighter-rouge">.secondary</code>, <code class="language-plaintext highlighter-rouge">.tertiary</code>, <code class="language-plaintext highlighter-rouge">.quaternary</code>가 전경 4단계에 해당하고, 배경은 <code class="language-plaintext highlighter-rouge">Color(.systemBackground)</code>처럼 UIKit 이름을 쓴다.</p>

<h3 id="3-앱-색-custom-colors">3. 앱 색 (Custom Colors)</h3>

<p>브랜드 색은 에셋 카탈로그에 <strong>색상 세트</strong>로 넣는다. 라이트/다크, 고대비 변형을 각각 지정할 수 있다.</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Assets.xcassets/
  Brand.colorset/      Any · Dark · High Contrast · Dark High Contrast
  BrandSurface.colorset/
</code></pre></div></div>

<p>Xcode 15부터 <code class="language-plaintext highlighter-rouge">Color.brand</code>처럼 심볼이 자동 생성된다.</p>

<h2 id="다크-모드-설계">다크 모드 설계</h2>

<h3 id="깊이의-방향이-바뀐다">깊이의 방향이 바뀐다</h3>

<p>라이트 모드에서는 카드가 그림자로 떠 보인다. 다크 모드에서는 그림자가 보이지 않으므로 <strong>위로 올라올수록 밝아지는</strong> 방식으로 깊이를 표현한다.</p>

<div class="mermaid">
flowchart LR
    subgraph 라이트
      L1[systemBackground<br />흰색] --&gt; L2[카드: 흰색 + 그림자]
    end
    subgraph 다크
      D1[systemBackground<br />검정] --&gt; D2[secondarySystemBackground<br />어두운 회색 카드] --&gt; D3[tertiary...<br />더 밝은 회색]
    end
</div>

<p><code class="language-plaintext highlighter-rouge">secondarySystemBackground</code>를 카드 배경으로 쓰면 이 전환이 자동이다. 라이트에서는 연회색 카드, 다크에서는 배경보다 밝은 회색 카드가 된다.</p>

<h3 id="순수-검정-vs-어두운-회색">순수 검정 vs 어두운 회색</h3>

<ul>
  <li>iOS 기본 <code class="language-plaintext highlighter-rouge">systemBackground</code>의 다크 값은 <strong>순수 검정(#000)</strong>이다. OLED에서 전력을 아끼고 대비가 선명하다</li>
  <li>많은 앱이 어두운 회색(#1C1C1E 등)을 선호한다. 눈이 덜 피로하고 레이어 표현이 쉽다</li>
  <li>어느 쪽이든 <strong>그룹 배경 체계</strong>를 따르면 된다. <code class="language-plaintext highlighter-rouge">systemGroupedBackground</code>는 다크에서 검정, 그 위의 <code class="language-plaintext highlighter-rouge">secondarySystemGroupedBackground</code>는 #1C1C1E다</li>
</ul>

<h3 id="채도를-낮춘다">채도를 낮춘다</h3>

<p>라이트 모드의 선명한 브랜드 색은 검정 위에서 눈을 찌른다. 다크 변형은 보통 <strong>밝기를 올리고 채도를 약간 낮춘다</strong>. 시스템 색이 그렇게 되어 있으니 참고한다. 예: systemBlue 라이트 <code class="language-plaintext highlighter-rouge">#007AFF</code> → 다크 <code class="language-plaintext highlighter-rouge">#0A84FF</code>.</p>

<h3 id="흰-텍스트는-완전한-흰색이-아니다">흰 텍스트는 완전한 흰색이 아니다</h3>

<p>다크 모드의 <code class="language-plaintext highlighter-rouge">label</code>은 흰색이지만 <code class="language-plaintext highlighter-rouge">secondaryLabel</code>은 흰색의 60% 불투명도다. 불투명도로 위계를 표현하면 어떤 배경 위에서도 자연스럽다.</p>

<h2 id="swiftui로-구현하기">SwiftUI로 구현하기</h2>

<p><strong>의미론적 색만으로 만든 화면</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">ProfileCard</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="kt">VStack</span><span class="p">(</span><span class="nv">alignment</span><span class="p">:</span> <span class="o">.</span><span class="n">leading</span><span class="p">,</span> <span class="nv">spacing</span><span class="p">:</span> <span class="mi">8</span><span class="p">)</span> <span class="p">{</span>
            <span class="kt">Text</span><span class="p">(</span><span class="s">"박세진"</span><span class="p">)</span><span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">headline</span><span class="p">)</span>                       <span class="c1">// label</span>
            <span class="kt">Text</span><span class="p">(</span><span class="s">"iOS 개발자"</span><span class="p">)</span><span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">subheadline</span><span class="p">)</span>
                <span class="o">.</span><span class="nf">foregroundStyle</span><span class="p">(</span><span class="o">.</span><span class="n">secondary</span><span class="p">)</span>                      <span class="c1">// secondaryLabel</span>
            <span class="kt">Divider</span><span class="p">()</span>                                             <span class="c1">// separator</span>
            <span class="kt">HStack</span> <span class="p">{</span>
                <span class="kt">Label</span><span class="p">(</span><span class="s">"서울"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"mappin"</span><span class="p">)</span>
                <span class="kt">Spacer</span><span class="p">()</span>
                <span class="kt">Text</span><span class="p">(</span><span class="s">"가입 2024년"</span><span class="p">)</span><span class="o">.</span><span class="nf">foregroundStyle</span><span class="p">(</span><span class="o">.</span><span class="n">tertiary</span><span class="p">)</span>   <span class="c1">// tertiaryLabel</span>
            <span class="p">}</span>
            <span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">caption</span><span class="p">)</span>
        <span class="p">}</span>
        <span class="o">.</span><span class="nf">padding</span><span class="p">()</span>
        <span class="o">.</span><span class="nf">background</span><span class="p">(</span><span class="kt">Color</span><span class="p">(</span><span class="o">.</span><span class="n">secondarySystemGroupedBackground</span><span class="p">),</span>    <span class="c1">// 카드</span>
                    <span class="nv">in</span><span class="p">:</span> <span class="kt">RoundedRectangle</span><span class="p">(</span><span class="nv">cornerRadius</span><span class="p">:</span> <span class="mi">16</span><span class="p">))</span>
    <span class="p">}</span>
<span class="p">}</span>
<span class="c1">// 바깥: .background(Color(.systemGroupedBackground))</span>
</code></pre></div></div>

<p>색 값을 하나도 쓰지 않았다. 라이트/다크/고대비에서 모두 올바르게 보인다.</p>

<p><strong>앱 강조색</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">@main</span>
<span class="kd">struct</span> <span class="kt">MyApp</span><span class="p">:</span> <span class="kt">App</span> <span class="p">{</span>
    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">Scene</span> <span class="p">{</span>
        <span class="kt">WindowGroup</span> <span class="p">{</span>
            <span class="kt">RootView</span><span class="p">()</span><span class="o">.</span><span class="nf">tint</span><span class="p">(</span><span class="o">.</span><span class="n">brand</span><span class="p">)</span>    <span class="c1">// 버튼, 링크, 토글, 탭 바 선택 등 모든 상호작용 색</span>
        <span class="p">}</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><code class="language-plaintext highlighter-rouge">tint</code> 하나로 앱 전체의 “누를 수 있는 것”의 색이 정해진다. 개별 뷰에서 <code class="language-plaintext highlighter-rouge">.foregroundStyle(.blue)</code>를 쓰지 않는다.</p>

<p><strong>현재 모드 읽기와 고정</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">@Environment</span><span class="p">(\</span><span class="o">.</span><span class="n">colorScheme</span><span class="p">)</span> <span class="k">var</span> <span class="nv">scheme</span>

<span class="kt">Image</span><span class="p">(</span><span class="n">scheme</span> <span class="o">==</span> <span class="o">.</span><span class="n">dark</span> <span class="p">?</span> <span class="s">"logo_dark"</span> <span class="p">:</span> <span class="s">"logo_light"</span><span class="p">)</span>   <span class="c1">// 이미지는 에셋 카탈로그 Dark 변형이 더 낫다</span>

<span class="c1">// 특정 화면만 다크로 (카메라, 미디어 플레이어)</span>
<span class="kt">CameraView</span><span class="p">()</span><span class="o">.</span><span class="nf">preferredColorScheme</span><span class="p">(</span><span class="o">.</span><span class="n">dark</span><span class="p">)</span>
</code></pre></div></div>

<p><strong>고대비 대응이 필요한 커스텀 색</strong></p>

<p>에셋 카탈로그에서 High Contrast 변형을 채우면 끝. 코드로 분기해야 한다면:</p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">@Environment</span><span class="p">(\</span><span class="o">.</span><span class="n">colorSchemeContrast</span><span class="p">)</span> <span class="k">var</span> <span class="nv">contrast</span>
<span class="k">let</span> <span class="nv">border</span> <span class="o">=</span> <span class="n">contrast</span> <span class="o">==</span> <span class="o">.</span><span class="n">increased</span> <span class="p">?</span> <span class="kt">Color</span><span class="o">.</span><span class="nv">primary</span> <span class="p">:</span> <span class="kt">Color</span><span class="p">(</span><span class="o">.</span><span class="n">separator</span><span class="p">)</span>
</code></pre></div></div>

<p><strong>Previews로 네 가지 조합 한 번에</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">#Preview("라이트") { ProfileCard() }</span>
<span class="cp">#Preview("다크") { ProfileCard().preferredColorScheme(.dark) }</span>
<span class="cp">#Preview("다크 고대비") {</span>
    <span class="kt">ProfileCard</span><span class="p">()</span><span class="o">.</span><span class="nf">preferredColorScheme</span><span class="p">(</span><span class="o">.</span><span class="n">dark</span><span class="p">)</span>
        <span class="o">.</span><span class="nf">environment</span><span class="p">(\</span><span class="o">.</span><span class="n">colorSchemeContrast</span><span class="p">,</span> <span class="o">.</span><span class="n">increased</span><span class="p">)</span>
<span class="p">}</span>
</code></pre></div></div>

<h2 id="자주-하는-실수">자주 하는 실수</h2>

<ul>
  <li><strong><code class="language-plaintext highlighter-rouge">Color.black</code> / <code class="language-plaintext highlighter-rouge">Color.white</code></strong>: 다크 모드에서 반전되지 않는다. 텍스트는 <code class="language-plaintext highlighter-rouge">.primary</code>, 배경은 <code class="language-plaintext highlighter-rouge">Color(.systemBackground)</code></li>
  <li><strong><code class="language-plaintext highlighter-rouge">Color(red:green:blue:)</code> 하드코딩</strong>: 에셋 카탈로그로 옮긴다. 다크 변형과 고대비 변형이 생기고, 디자이너와 같은 이름으로 소통할 수 있다</li>
  <li><strong>다크 모드에서 그림자에 의존</strong>: 보이지 않는다. 배경 밝기 차이로 레이어를 표현한다</li>
  <li><strong><code class="language-plaintext highlighter-rouge">.opacity(0.5)</code>로 보조 텍스트</strong>: <code class="language-plaintext highlighter-rouge">.secondary</code>를 쓴다. 불투명도는 배경에 따라 대비가 들쭉날쭉하다</li>
  <li><strong>이미지에 글자나 UI 포함</strong>: 다크 모드에서 어색하다. 이미지는 콘텐츠만, 글자는 <code class="language-plaintext highlighter-rouge">Text</code></li>
  <li><strong>강조색 남발</strong>: 파란 글자가 세 개면 어느 것이 버튼인지 모른다. <code class="language-plaintext highlighter-rouge">tint</code>는 상호작용 요소에만</li>
  <li><strong>다크 모드를 나중에</strong>: 처음부터 의미론적 색으로 만들면 다크 모드는 추가 작업이 거의 없다. 나중에 하면 모든 색을 다시 본다</li>
</ul>

<h2 id="체크리스트">체크리스트</h2>

<ul class="task-list">
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" /><code class="language-plaintext highlighter-rouge">Color.black</code>, <code class="language-plaintext highlighter-rouge">Color.white</code>, RGB 하드코딩이 없다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />텍스트는 <code class="language-plaintext highlighter-rouge">.primary</code> / <code class="language-plaintext highlighter-rouge">.secondary</code> / <code class="language-plaintext highlighter-rouge">.tertiary</code>, 배경은 시스템 배경 색 체계</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />브랜드 색은 에셋 카탈로그에 라이트/다크/고대비 변형과 함께 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" /><code class="language-plaintext highlighter-rouge">tint</code>는 앱 루트에서 한 번 지정, 개별 뷰에서 상호작용 색을 따로 정하지 않는다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />다크 모드에서 카드와 배경이 구분된다 (그림자 아닌 밝기 차이)</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />색만으로 전달하는 상태가 없다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />라이트 / 다크 / 다크 고대비 프리뷰를 모두 확인했다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />사진과 사용자 콘텐츠의 색은 모드에 따라 바뀌지 않는다</li>
</ul>

<h2 id="함께-읽기">함께 읽기</h2>

<ul>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosAccessibility/">접근성: 모두를 위한 기본값</a> — 대비 기준과 색상 없이 구별</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/visualHierarchy/">비주얼 계층구조: 시각적 중요도의 체계화</a> — 색 4단계로 만드는 위계</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/designSystem/">디자인 시스템: 일관된 사용자 경험의 기반</a> — 색 토큰을 시스템으로</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/glassmorphism/">글라스모피즘: 투명함의 미학</a> — 재질과 색의 관계</li>
</ul>]]></content><author><name>Geppetto</name></author><category term="디자인" /><category term="iOS 디자인" /><category term="HIG" /><category term="iOS" /><summary type="html"><![CDATA[iOS의 색은 값이 아니라 역할로 정의된다. 시스템 색, 의미론적 색, tint, 에셋 카탈로그, 그리고 다크 모드와 고대비가 공짜로 따라오는 이유.]]></summary></entry><entry><title type="html">접근성: 모두를 위한 기본값</title><link href="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosAccessibility/" rel="alternate" type="text/html" title="접근성: 모두를 위한 기본값" /><published>2026-11-15T00:03:00+09:00</published><updated>2026-11-15T00:03:00+09:00</updated><id>https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosAccessibility</id><content type="html" xml:base="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosAccessibility/"><![CDATA[<p>접근성은 “장애가 있는 사용자를 위한 추가 작업”이 아니다. iOS에서 접근성은 <strong>시스템 기본값을 따르면 대부분 자동으로 얻어지고, 기본값을 덮어쓸 때 잃는 것</strong>이다.</p>

<p>이 시리즈의 모든 글에 접근성 항목이 있는 이유가 그것이다. 뉴모피즘은 대비를 잃고, 커스텀 제스처는 VoiceOver를 잃고, 고정 크기 폰트는 Dynamic Type을 잃는다.
이 글은 흩어져 있던 그 항목들을 한곳에 모은다.</p>

<h2 id="네-가지-축">네 가지 축</h2>

<p>iOS 접근성은 설정 &gt; 손쉬운 사용에 있는 수십 가지 기능으로 이뤄지지만, 앱 디자인에 영향을 주는 것은 크게 넷이다.</p>

<table>
  <thead>
    <tr>
      <th>축</th>
      <th>사용자 설정</th>
      <th>앱이 할 일</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>시각: 읽기</strong></td>
      <td>VoiceOver, 화면 읽어주기</td>
      <td>모든 요소에 레이블, 올바른 순서와 그룹</td>
    </tr>
    <tr>
      <td><strong>시각: 크기와 대비</strong></td>
      <td>더 큰 텍스트, 대비 높이기, 색상 없이 구별, 투명도 줄이기, 버튼 모양</td>
      <td>Dynamic Type, 의미론적 색, 색 외의 구분 수단</td>
    </tr>
    <tr>
      <td><strong>운동</strong></td>
      <td>스위치 제어, 음성 제어, AssistiveTouch, 동작 줄이기</td>
      <td>제스처의 대안, 충분한 터치 영역, 모션 대체</td>
    </tr>
    <tr>
      <td><strong>청각</strong></td>
      <td>자막, 모노 오디오, 햅틱</td>
      <td>소리에만 의존하지 않기, 햅틱과 시각 병행</td>
    </tr>
  </tbody>
</table>

<h2 id="hig가-말하는-것">HIG가 말하는 것</h2>

<p>HIG의 Accessibility 페이지는 세 문장으로 요약된다.</p>

<ol>
  <li><strong>단순하게 설계하라</strong>: 익숙한 상호작용, 명확한 레이블, 일관된 구조. 접근성이 좋은 디자인은 모두에게 좋은 디자인이다</li>
  <li><strong>인식할 수 있게 하라</strong>: 시각, 청각, 촉각 중 하나에만 의존하지 않는다. 색만으로, 소리만으로 정보를 전하지 않는다</li>
  <li><strong>시스템 설정을 존중하라</strong>: 사용자가 글자를 키우고 모션을 줄였다면 앱은 그 선택을 따라야 한다</li>
</ol>

<h2 id="voiceover">VoiceOver</h2>

<p>VoiceOver는 화면의 요소를 순서대로 읽어 주는 스크린 리더다. 시스템 컴포넌트는 모두 VoiceOver를 지원하므로, 앱이 할 일은 <strong>커스텀 뷰와 이미지에 의미를 붙이는 것</strong>이다.</p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// 아이콘만 있는 버튼: 레이블 필수</span>
<span class="kt">Button</span> <span class="p">{</span> <span class="nf">toggleFavorite</span><span class="p">()</span> <span class="p">}</span> <span class="nv">label</span><span class="p">:</span> <span class="p">{</span>
    <span class="kt">Image</span><span class="p">(</span><span class="nv">systemName</span><span class="p">:</span> <span class="n">isFavorite</span> <span class="p">?</span> <span class="s">"heart.fill"</span> <span class="p">:</span> <span class="s">"heart"</span><span class="p">)</span>
<span class="p">}</span>
<span class="o">.</span><span class="nf">accessibilityLabel</span><span class="p">(</span><span class="n">isFavorite</span> <span class="p">?</span> <span class="s">"즐겨찾기 해제"</span> <span class="p">:</span> <span class="s">"즐겨찾기 추가"</span><span class="p">)</span>

<span class="c1">// 의미 있는 이미지: 설명</span>
<span class="kt">Image</span><span class="p">(</span><span class="s">"chart_q3"</span><span class="p">)</span>
    <span class="o">.</span><span class="nf">accessibilityLabel</span><span class="p">(</span><span class="s">"3분기 매출 차트. 7월 1200만 원에서 9월 1800만 원으로 상승"</span><span class="p">)</span>

<span class="c1">// 장식 이미지: 숨김</span>
<span class="kt">Image</span><span class="p">(</span><span class="s">"divider_ornament"</span><span class="p">)</span>
    <span class="o">.</span><span class="nf">accessibilityHidden</span><span class="p">(</span><span class="kc">true</span><span class="p">)</span>

<span class="c1">// 여러 요소를 하나로: 카드</span>
<span class="kt">ArticleCard</span><span class="p">(</span><span class="n">article</span><span class="p">)</span>
    <span class="o">.</span><span class="nf">accessibilityElement</span><span class="p">(</span><span class="nv">children</span><span class="p">:</span> <span class="o">.</span><span class="n">combine</span><span class="p">)</span>       <span class="c1">// 제목+요약+날짜를 한 번에 읽음</span>
    <span class="o">.</span><span class="nf">accessibilityAddTraits</span><span class="p">(</span><span class="o">.</span><span class="n">isButton</span><span class="p">)</span>

<span class="c1">// 값이 있는 컨트롤</span>
<span class="kt">Slider</span><span class="p">(</span><span class="nv">value</span><span class="p">:</span> <span class="err">$</span><span class="n">volume</span><span class="p">)</span>
    <span class="o">.</span><span class="nf">accessibilityLabel</span><span class="p">(</span><span class="s">"음량"</span><span class="p">)</span>
    <span class="o">.</span><span class="nf">accessibilityValue</span><span class="p">(</span><span class="s">"</span><span class="se">\(</span><span class="kt">Int</span><span class="p">(</span><span class="n">volume</span> <span class="o">*</span> <span class="mi">100</span><span class="p">)</span><span class="se">)</span><span class="s">퍼센트"</span><span class="p">)</span>

<span class="c1">// 제스처 대안</span>
<span class="kt">SwipeCard</span><span class="p">()</span>
    <span class="o">.</span><span class="nf">accessibilityAction</span><span class="p">(</span><span class="nv">named</span><span class="p">:</span> <span class="s">"다음 카드"</span><span class="p">)</span> <span class="p">{</span> <span class="nf">next</span><span class="p">()</span> <span class="p">}</span>

<span class="c1">// 제목 표시: 로터로 제목 사이를 이동할 수 있게</span>
<span class="kt">Text</span><span class="p">(</span><span class="s">"오늘의 할 일"</span><span class="p">)</span><span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">title2</span><span class="p">)</span>
    <span class="o">.</span><span class="nf">accessibilityAddTraits</span><span class="p">(</span><span class="o">.</span><span class="n">isHeader</span><span class="p">)</span>
</code></pre></div></div>

<p><strong>읽기 순서</strong>: VoiceOver는 왼쪽 위에서 오른쪽 아래로 읽는다. 시각적 배치와 논리적 순서가 다르면 <code class="language-plaintext highlighter-rouge">accessibilitySortPriority</code>로 조정한다.</p>

<p><strong>알림</strong>: 화면이 바뀌었을 때 알려 주려면 <code class="language-plaintext highlighter-rouge">AccessibilityNotification.Announcement("저장되었습니다").post()</code>.</p>

<h2 id="dynamic-type">Dynamic Type</h2>

<p>사용자가 글자 크기를 바꾸면 앱의 모든 텍스트가 따라야 한다. 자세한 내용은 <a href="/%EB%94%94%EC%9E%90%EC%9D%B8/typography/">타이포그래피</a> 글에 있고, 여기서는 규칙만.</p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">Text</span><span class="p">(</span><span class="s">"본문"</span><span class="p">)</span><span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">body</span><span class="p">)</span>                          <span class="c1">// O: 텍스트 스타일</span>
<span class="kt">Text</span><span class="p">(</span><span class="s">"본문"</span><span class="p">)</span><span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="nf">system</span><span class="p">(</span><span class="nv">size</span><span class="p">:</span> <span class="mi">17</span><span class="p">))</span>              <span class="c1">// X: 고정 크기</span>

<span class="kd">@ScaledMetric</span><span class="p">(</span><span class="nv">relativeTo</span><span class="p">:</span> <span class="o">.</span><span class="n">body</span><span class="p">)</span> <span class="k">var</span> <span class="nv">iconSize</span> <span class="o">=</span> <span class="mi">24</span>  <span class="c1">// 비텍스트 크기도 비례</span>

<span class="c1">// 접근성 크기에서 레이아웃 전환</span>
<span class="kd">@Environment</span><span class="p">(\</span><span class="o">.</span><span class="n">dynamicTypeSize</span><span class="p">)</span> <span class="k">var</span> <span class="nv">typeSize</span>
<span class="k">let</span> <span class="nv">layout</span> <span class="o">=</span> <span class="n">typeSize</span><span class="o">.</span><span class="n">isAccessibilitySize</span> <span class="p">?</span> <span class="kt">AnyLayout</span><span class="p">(</span><span class="kt">VStackLayout</span><span class="p">())</span> <span class="p">:</span> <span class="kt">AnyLayout</span><span class="p">(</span><span class="kt">HStackLayout</span><span class="p">())</span>
</code></pre></div></div>

<p>테스트는 설정의 최대 크기(AX5)로 한다. 거기서 잘리거나 겹치는 것이 없으면 중간 크기는 괜찮다.</p>

<h2 id="대비와-색">대비와 색</h2>

<ul>
  <li><strong>대비 기준</strong>: 일반 텍스트 4.5:1, 큰 텍스트(약 18pt 이상 또는 14pt 볼드)와 UI 컴포넌트 3:1</li>
  <li><strong>의미론적 색을 쓰면 대비 높이기 설정이 자동 적용</strong>된다. <code class="language-plaintext highlighter-rouge">Color.primary</code>, <code class="language-plaintext highlighter-rouge">.secondary</code>, <code class="language-plaintext highlighter-rouge">Color(.systemBackground)</code>는 고대비 변형을 갖고 있다</li>
  <li><strong>커스텀 색은 에셋 카탈로그</strong>에 넣고 “High Contrast” 변형을 채운다</li>
  <li><strong>색 외의 수단</strong>: 오류는 빨간 테두리 + 아이콘 + 텍스트. 차트 계열은 색 + 모양</li>
</ul>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">@Environment</span><span class="p">(\</span><span class="o">.</span><span class="n">colorSchemeContrast</span><span class="p">)</span> <span class="k">var</span> <span class="nv">contrast</span>
<span class="kd">@Environment</span><span class="p">(\</span><span class="o">.</span><span class="n">accessibilityDifferentiateWithoutColor</span><span class="p">)</span> <span class="k">var</span> <span class="nv">noColor</span>

<span class="c1">// 색상 없이 구별 설정: 상태를 아이콘으로도</span>
<span class="kt">HStack</span> <span class="p">{</span>
    <span class="k">if</span> <span class="n">noColor</span> <span class="p">{</span> <span class="kt">Image</span><span class="p">(</span><span class="nv">systemName</span><span class="p">:</span> <span class="n">status</span><span class="o">.</span><span class="n">symbol</span><span class="p">)</span> <span class="p">}</span>
    <span class="kt">Circle</span><span class="p">()</span><span class="o">.</span><span class="nf">fill</span><span class="p">(</span><span class="n">status</span><span class="o">.</span><span class="n">color</span><span class="p">)</span><span class="o">.</span><span class="nf">frame</span><span class="p">(</span><span class="nv">width</span><span class="p">:</span> <span class="mi">10</span><span class="p">)</span>
    <span class="kt">Text</span><span class="p">(</span><span class="n">status</span><span class="o">.</span><span class="n">title</span><span class="p">)</span>
<span class="p">}</span>
</code></pre></div></div>

<h2 id="모션과-투명도">모션과 투명도</h2>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">@Environment</span><span class="p">(\</span><span class="o">.</span><span class="n">accessibilityReduceMotion</span><span class="p">)</span> <span class="k">var</span> <span class="nv">reduceMotion</span>
<span class="kd">@Environment</span><span class="p">(\</span><span class="o">.</span><span class="n">accessibilityReduceTransparency</span><span class="p">)</span> <span class="k">var</span> <span class="nv">reduceTransparency</span>

<span class="c1">// 동작 줄이기: 큰 이동은 페이드로</span>
<span class="nf">withAnimation</span><span class="p">(</span><span class="n">reduceMotion</span> <span class="p">?</span> <span class="o">.</span><span class="nf">easeInOut</span><span class="p">(</span><span class="nv">duration</span><span class="p">:</span> <span class="mf">0.15</span><span class="p">)</span> <span class="p">:</span> <span class="o">.</span><span class="n">spring</span><span class="p">)</span> <span class="p">{</span> <span class="n">expand</span><span class="o">.</span><span class="nf">toggle</span><span class="p">()</span> <span class="p">}</span>

<span class="c1">// 자동 재생, 패럴랙스, 반복 애니메이션은 끈다</span>
<span class="o">.</span><span class="nf">symbolEffect</span><span class="p">(</span><span class="o">.</span><span class="n">pulse</span><span class="p">,</span> <span class="nv">isActive</span><span class="p">:</span> <span class="n">isLoading</span> <span class="o">&amp;&amp;</span> <span class="o">!</span><span class="n">reduceMotion</span><span class="p">)</span>

<span class="c1">// 투명도 줄이기: 재질 대신 불투명 배경</span>
<span class="o">.</span><span class="n">background</span> <span class="p">{</span>
    <span class="k">if</span> <span class="n">reduceTransparency</span> <span class="p">{</span> <span class="kt">Color</span><span class="p">(</span><span class="o">.</span><span class="n">secondarySystemBackground</span><span class="p">)</span> <span class="p">}</span>
    <span class="k">else</span> <span class="p">{</span> <span class="kt">Rectangle</span><span class="p">()</span><span class="o">.</span><span class="nf">fill</span><span class="p">(</span><span class="o">.</span><span class="n">regularMaterial</span><span class="p">)</span> <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p>시스템 <code class="language-plaintext highlighter-rouge">Material</code>은 투명도 줄이기에 자동 대응한다. 직접 만든 반투명만 신경 쓰면 된다.</p>

<h2 id="운동과-터치">운동과 터치</h2>

<ul>
  <li><strong>44×44pt</strong>: 모든 탭 가능한 요소의 최소 크기. 아이콘이 작아도 <code class="language-plaintext highlighter-rouge">.padding</code>과 <code class="language-plaintext highlighter-rouge">.contentShape</code>로 영역을 확보한다</li>
  <li><strong>제스처의 대안</strong>: 스와이프, 길게 누르기, 핀치로만 할 수 있는 기능이 없어야 한다. 시스템 컴포넌트(<code class="language-plaintext highlighter-rouge">swipeActions</code>, <code class="language-plaintext highlighter-rouge">contextMenu</code>)는 VoiceOver가 자동으로 대안을 제공한다</li>
  <li><strong>시간 제한</strong>: 자동으로 사라지는 UI는 충분히 길게, 또는 설정에서 조절 가능하게</li>
  <li><strong>버튼 모양 설정</strong>: 켜면 텍스트 버튼에 밑줄이 생긴다. <code class="language-plaintext highlighter-rouge">Button</code>을 쓰면 자동, <code class="language-plaintext highlighter-rouge">onTapGesture</code>를 쓴 텍스트는 아무 일도 없다</li>
</ul>

<h2 id="감사-방법">감사 방법</h2>

<p><strong>Xcode Accessibility Inspector</strong>: Xcode &gt; Open Developer Tool &gt; Accessibility Inspector. 시뮬레이터를 가리키고 Audit을 실행하면 레이블 없는 요소, 대비 부족, 작은 터치 영역을 찾아 준다.</p>

<p><strong>Previews에서 한 번에</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">#Preview("접근성") {</span>
    <span class="kt">ContentView</span><span class="p">()</span>
        <span class="o">.</span><span class="nf">environment</span><span class="p">(\</span><span class="o">.</span><span class="n">dynamicTypeSize</span><span class="p">,</span> <span class="o">.</span><span class="n">accessibility5</span><span class="p">)</span>
        <span class="o">.</span><span class="nf">environment</span><span class="p">(\</span><span class="o">.</span><span class="n">colorSchemeContrast</span><span class="p">,</span> <span class="o">.</span><span class="n">increased</span><span class="p">)</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>실기기 테스트</strong>: 설정 &gt; 손쉬운 사용 &gt; 손쉬운 사용 단축키에 VoiceOver를 등록하고, 측면 버튼 세 번으로 켜고 끈다. 눈을 감고 주요 과제를 끝까지 해 본다.</p>

<p><strong>Xcode 15+ 접근성 감사 테스트</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">func</span> <span class="nf">testAccessibility</span><span class="p">()</span> <span class="k">throws</span> <span class="p">{</span>
    <span class="k">let</span> <span class="nv">app</span> <span class="o">=</span> <span class="kt">XCUIApplication</span><span class="p">()</span>
    <span class="n">app</span><span class="o">.</span><span class="nf">launch</span><span class="p">()</span>
    <span class="k">try</span> <span class="n">app</span><span class="o">.</span><span class="nf">performAccessibilityAudit</span><span class="p">()</span>   <span class="c1">// 자동 감사, 실패하면 테스트 실패</span>
<span class="p">}</span>
</code></pre></div></div>

<h2 id="자주-하는-실수">자주 하는 실수</h2>

<ul>
  <li><strong>심볼 이름이 그대로 읽힘</strong>: <code class="language-plaintext highlighter-rouge">Image(systemName: "gear")</code>만 있는 버튼은 VoiceOver가 “톱니바퀴”라고 읽는다. “설정”이라고 레이블을 붙인다</li>
  <li><strong><code class="language-plaintext highlighter-rouge">onTapGesture</code>로 만든 버튼</strong>: VoiceOver가 버튼인 줄 모른다. <code class="language-plaintext highlighter-rouge">Button</code>을 쓰거나 <code class="language-plaintext highlighter-rouge">.accessibilityAddTraits(.isButton)</code></li>
  <li><strong>접근성 레이블에 컨트롤 종류 포함</strong>: “저장 버튼”이 아니라 “저장”. 종류는 VoiceOver가 덧붙인다</li>
  <li><strong>플레이스홀더만 있는 입력 필드</strong>: 입력하면 플레이스홀더가 사라져 무엇을 입력하는지 모른다. <code class="language-plaintext highlighter-rouge">TextField("이메일", ...)</code>의 첫 인자가 레이블 역할을 하지만, 화면에 보이는 레이블도 두는 것이 좋다</li>
  <li><strong><code class="language-plaintext highlighter-rouge">accessibilityHidden</code>으로 복잡한 것 숨기기</strong>: 어려워서 숨기면 그 기능은 없는 것이다</li>
  <li><strong>접근성 테스트를 출시 직전에</strong>: 구조 문제(읽기 순서, 그룹)는 나중에 고치기 어렵다. 화면 하나 만들 때마다 VoiceOver로 한 번 훑는다</li>
</ul>

<h2 id="체크리스트">체크리스트</h2>

<ul class="task-list">
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />모든 이미지와 아이콘 버튼에 레이블이 있거나 장식으로 숨겨져 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />모든 텍스트가 Dynamic Type 텍스트 스타일을 쓴다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />AX5 크기에서 잘림, 겹침, 가로 스크롤이 없다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />텍스트 대비 4.5:1, UI 요소 3:1 이상</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />색만으로 전달하는 정보가 없다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />동작 줄이기에서 큰 이동, 자동 재생, 반복 애니메이션이 꺼진다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />투명도 줄이기에서 커스텀 반투명이 불투명으로 바뀐다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />모든 탭 가능 요소가 44×44pt 이상</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />제스처로만 할 수 있는 기능이 없다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />VoiceOver로 주요 과제를 처음부터 끝까지 완료할 수 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />Accessibility Inspector 감사에 경고가 없다</li>
</ul>

<h2 id="함께-읽기">함께 읽기</h2>

<ul>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/typography/">타이포그래피: 글자를 통한 효과적인 커뮤니케이션</a> — Dynamic Type 자세히</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosColorDarkMode/">색상과 다크 모드: 의미론적 색 체계</a> — 대비와 고대비 변형</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/gestureBasedInterface/">제스처 기반 인터페이스: 직관적 조작의 혁신</a> — 제스처의 대안</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/animationMotion/">애니메이션과 모션: 동적 사용자 경험의 핵심</a> — 동작 줄이기 대응</li>
</ul>]]></content><author><name>Geppetto</name></author><category term="디자인" /><category term="iOS 디자인" /><category term="HIG" /><category term="iOS" /><category term="접근성" /><summary type="html"><![CDATA[VoiceOver, Dynamic Type, 대비, 모션. iOS 접근성의 네 축과, 시스템 기본값을 따르면 대부분 공짜로 얻는다는 사실.]]></summary></entry><entry><title type="html">모달의 위계: 알림, 시트, 팝오버</title><link href="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosModality/" rel="alternate" type="text/html" title="모달의 위계: 알림, 시트, 팝오버" /><published>2026-11-15T00:02:00+09:00</published><updated>2026-11-15T00:02:00+09:00</updated><id>https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosModality</id><content type="html" xml:base="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosModality/"><![CDATA[<p>모달(modal)은 현재 흐름을 잠시 멈추고 다른 과제에 집중하게 하는 화면이다.
웹에서는 대부분 <code class="language-plaintext highlighter-rouge">&lt;dialog&gt;</code>나 커스텀 오버레이 하나로 처리하지만, iOS에는 <strong>끼어드는 강도에 따라 다섯 가지</strong>가 있고, HIG는 각각을 언제 쓸지 꽤 명확하게 정해 두었다.</p>

<p>HIG의 기본 태도는 <strong>모달을 최소화하라</strong>는 것이다. 모달은 사용자가 하던 일을 끊는다. 인라인으로 해결할 수 있으면 모달을 쓰지 않는다.</p>

<h2 id="다섯-가지-모달">다섯 가지 모달</h2>

<p>강도가 약한 것부터.</p>

<table>
  <thead>
    <tr>
      <th>종류</th>
      <th>끼어드는 강도</th>
      <th>쓰는 때</th>
      <th>닫는 법</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>팝오버 (Popover)</strong></td>
      <td>약함</td>
      <td>iPad에서 버튼에 붙은 작은 옵션. iPhone에서는 자동으로 시트가 된다</td>
      <td>바깥 탭</td>
    </tr>
    <tr>
      <td><strong>컨펌 다이얼로그 (Confirmation Dialog)</strong></td>
      <td>약함~중간</td>
      <td>방금 누른 동작의 선택지 제시. “삭제하시겠습니까?” 같은 파괴적 동작 확인</td>
      <td>선택 또는 취소</td>
    </tr>
    <tr>
      <td><strong>시트 (Sheet)</strong></td>
      <td>중간</td>
      <td>별도의 과제. 작성, 편집, 필터, 공유. 뒤 화면이 살짝 보인다</td>
      <td>아래로 끌기, 닫기 버튼</td>
    </tr>
    <tr>
      <td><strong>전체 화면 커버 (Full Screen Cover)</strong></td>
      <td>강함</td>
      <td>몰입이 필요한 과제. 카메라, 동영상, 온보딩, 결제</td>
      <td>명시적 닫기 버튼만</td>
    </tr>
    <tr>
      <td><strong>알림 (Alert)</strong></td>
      <td>가장 강함</td>
      <td>반드시 알아야 할 정보, 되돌릴 수 없는 결정. 가장 드물게</td>
      <td>버튼 선택만</td>
    </tr>
  </tbody>
</table>

<h2 id="선택-기준">선택 기준</h2>

<div class="mermaid">
flowchart TD
    A[흐름을 끊어야 하나?] -- 아니오 --&gt; B[인라인으로<br />상태 표시 · 배너 · 토글]
    A -- 예 --&gt; C{사용자가<br />방금 한 동작의<br />선택지인가?}
    C -- 예 --&gt; D[컨펌 다이얼로그]
    C -- 아니오 --&gt; E{새 과제인가?}
    E -- 예, 몰입 필요 --&gt; F[전체 화면 커버]
    E -- 예, 보통 --&gt; G[시트]
    E -- 아니오, 정보 전달 --&gt; H{되돌릴 수 없거나<br />지금 꼭 알아야 하나?}
    H -- 예 --&gt; I[알림]
    H -- 아니오 --&gt; B
</div>

<p><strong>알림을 쓰면 안 되는 경우</strong></p>

<ul>
  <li>성공 확인 (“저장되었습니다”): 햅틱과 인라인 상태로. 알림은 사용자가 또 한 번 탭하게 만든다</li>
  <li>마케팅, 평가 요청, 업데이트 안내: 알림이 아니라 배너나 전용 화면으로</li>
  <li>선택지가 3개 이상: 컨펌 다이얼로그나 시트로</li>
</ul>

<p><strong>시트의 높이</strong></p>

<p>iOS 16부터 시트는 여러 높이(detent)를 가질 수 있다. 지도 앱의 검색 시트처럼 절반 높이로 시작해 끌어올릴 수 있다.</p>

<ul>
  <li><code class="language-plaintext highlighter-rouge">.medium</code>: 뒤 화면을 보면서 조작해야 할 때 (지도 위 검색 결과)</li>
  <li><code class="language-plaintext highlighter-rouge">.large</code>: 독립적인 과제</li>
  <li>커스텀: 콘텐츠 높이에 맞출 때 (<code class="language-plaintext highlighter-rouge">.height(280)</code>, <code class="language-plaintext highlighter-rouge">.fraction(0.4)</code>)</li>
</ul>

<h2 id="swiftui로-구현하기">SwiftUI로 구현하기</h2>

<p><strong>시트: 작성 화면</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">NotesView</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="kd">@State</span> <span class="kd">private</span> <span class="k">var</span> <span class="nv">isComposing</span> <span class="o">=</span> <span class="kc">false</span>

    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="kt">List</span><span class="p">(</span><span class="n">notes</span><span class="p">)</span> <span class="p">{</span> <span class="kt">NoteRow</span><span class="p">(</span><span class="nv">note</span><span class="p">:</span> <span class="nv">$0</span><span class="p">)</span> <span class="p">}</span>
            <span class="o">.</span><span class="n">toolbar</span> <span class="p">{</span>
                <span class="kt">Button</span><span class="p">(</span><span class="s">"새 메모"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"square.and.pencil"</span><span class="p">)</span> <span class="p">{</span> <span class="n">isComposing</span> <span class="o">=</span> <span class="kc">true</span> <span class="p">}</span>
            <span class="p">}</span>
            <span class="o">.</span><span class="nf">sheet</span><span class="p">(</span><span class="nv">isPresented</span><span class="p">:</span> <span class="err">$</span><span class="n">isComposing</span><span class="p">)</span> <span class="p">{</span>
                <span class="kt">NavigationStack</span> <span class="p">{</span>                              <span class="c1">// 시트 안에 자기 내비게이션 바</span>
                    <span class="kt">ComposeView</span><span class="p">()</span>
                        <span class="o">.</span><span class="nf">navigationTitle</span><span class="p">(</span><span class="s">"새 메모"</span><span class="p">)</span>
                        <span class="o">.</span><span class="nf">navigationBarTitleDisplayMode</span><span class="p">(</span><span class="o">.</span><span class="n">inline</span><span class="p">)</span>
                        <span class="o">.</span><span class="n">toolbar</span> <span class="p">{</span>
                            <span class="kt">ToolbarItem</span><span class="p">(</span><span class="nv">placement</span><span class="p">:</span> <span class="o">.</span><span class="n">cancellationAction</span><span class="p">)</span> <span class="p">{</span>
                                <span class="kt">Button</span><span class="p">(</span><span class="s">"취소"</span><span class="p">)</span> <span class="p">{</span> <span class="n">isComposing</span> <span class="o">=</span> <span class="kc">false</span> <span class="p">}</span>
                            <span class="p">}</span>
                            <span class="kt">ToolbarItem</span><span class="p">(</span><span class="nv">placement</span><span class="p">:</span> <span class="o">.</span><span class="n">confirmationAction</span><span class="p">)</span> <span class="p">{</span>
                                <span class="kt">Button</span><span class="p">(</span><span class="s">"저장"</span><span class="p">)</span> <span class="p">{</span> <span class="nf">save</span><span class="p">();</span> <span class="n">isComposing</span> <span class="o">=</span> <span class="kc">false</span> <span class="p">}</span>
                            <span class="p">}</span>
                        <span class="p">}</span>
                <span class="p">}</span>
                <span class="o">.</span><span class="nf">interactiveDismissDisabled</span><span class="p">(</span><span class="n">hasUnsavedChanges</span><span class="p">)</span>   <span class="c1">// 작성 중이면 끌어서 닫기 방지</span>
            <span class="p">}</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p>취소는 왼쪽, 확인은 오른쪽. <code class="language-plaintext highlighter-rouge">cancellationAction</code>과 <code class="language-plaintext highlighter-rouge">confirmationAction</code> 배치를 쓰면 플랫폼마다 올바른 위치에 놓인다.</p>

<p><strong>반높이 시트</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">.</span><span class="nf">sheet</span><span class="p">(</span><span class="nv">isPresented</span><span class="p">:</span> <span class="err">$</span><span class="n">showFilters</span><span class="p">)</span> <span class="p">{</span>
    <span class="kt">FilterView</span><span class="p">()</span>
        <span class="o">.</span><span class="nf">presentationDetents</span><span class="p">([</span><span class="o">.</span><span class="n">medium</span><span class="p">,</span> <span class="o">.</span><span class="n">large</span><span class="p">])</span>
        <span class="o">.</span><span class="nf">presentationDragIndicator</span><span class="p">(</span><span class="o">.</span><span class="n">visible</span><span class="p">)</span>
        <span class="o">.</span><span class="nf">presentationBackgroundInteraction</span><span class="p">(</span><span class="o">.</span><span class="nf">enabled</span><span class="p">(</span><span class="nv">upThrough</span><span class="p">:</span> <span class="o">.</span><span class="n">medium</span><span class="p">))</span>  <span class="c1">// 뒤 지도 조작 가능</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>컨펌 다이얼로그: 파괴적 동작</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">.</span><span class="nf">confirmationDialog</span><span class="p">(</span><span class="s">"이 메모를 삭제하시겠습니까?"</span><span class="p">,</span>
                    <span class="nv">isPresented</span><span class="p">:</span> <span class="err">$</span><span class="n">showDeleteConfirm</span><span class="p">,</span>
                    <span class="nv">titleVisibility</span><span class="p">:</span> <span class="o">.</span><span class="n">visible</span><span class="p">)</span> <span class="p">{</span>
    <span class="kt">Button</span><span class="p">(</span><span class="s">"삭제"</span><span class="p">,</span> <span class="nv">role</span><span class="p">:</span> <span class="o">.</span><span class="n">destructive</span><span class="p">)</span> <span class="p">{</span> <span class="nf">delete</span><span class="p">()</span> <span class="p">}</span>
    <span class="kt">Button</span><span class="p">(</span><span class="s">"취소"</span><span class="p">,</span> <span class="nv">role</span><span class="p">:</span> <span class="o">.</span><span class="n">cancel</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span>
<span class="p">}</span> <span class="nv">message</span><span class="p">:</span> <span class="p">{</span>
    <span class="kt">Text</span><span class="p">(</span><span class="s">"삭제한 메모는 복구할 수 없습니다."</span><span class="p">)</span>
<span class="p">}</span>
</code></pre></div></div>

<p><code class="language-plaintext highlighter-rouge">role: .destructive</code>는 빨간색으로, <code class="language-plaintext highlighter-rouge">.cancel</code>은 분리된 아래 버튼으로 자동 표시된다.</p>

<p><strong>알림: 정말 필요할 때만</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">.</span><span class="nf">alert</span><span class="p">(</span><span class="s">"저장 공간이 부족합니다"</span><span class="p">,</span> <span class="nv">isPresented</span><span class="p">:</span> <span class="err">$</span><span class="n">showStorageAlert</span><span class="p">)</span> <span class="p">{</span>
    <span class="kt">Button</span><span class="p">(</span><span class="s">"설정 열기"</span><span class="p">)</span> <span class="p">{</span> <span class="nf">openSettings</span><span class="p">()</span> <span class="p">}</span>
    <span class="kt">Button</span><span class="p">(</span><span class="s">"나중에"</span><span class="p">,</span> <span class="nv">role</span><span class="p">:</span> <span class="o">.</span><span class="n">cancel</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span>
<span class="p">}</span> <span class="nv">message</span><span class="p">:</span> <span class="p">{</span>
    <span class="kt">Text</span><span class="p">(</span><span class="s">"사진을 저장하려면 최소 50MB의 여유 공간이 필요합니다."</span><span class="p">)</span>
<span class="p">}</span>
</code></pre></div></div>

<p>알림 제목은 문장으로, 버튼은 동사로. “확인/취소”보다 “설정 열기/나중에”가 무슨 일이 일어날지 말해 준다.</p>

<p><strong>팝오버 (iPad) / 시트 (iPhone)</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">.</span><span class="nf">popover</span><span class="p">(</span><span class="nv">isPresented</span><span class="p">:</span> <span class="err">$</span><span class="n">showOptions</span><span class="p">,</span> <span class="nv">arrowEdge</span><span class="p">:</span> <span class="o">.</span><span class="n">top</span><span class="p">)</span> <span class="p">{</span>
    <span class="kt">OptionsView</span><span class="p">()</span>
        <span class="o">.</span><span class="nf">presentationCompactAdaptation</span><span class="p">(</span><span class="o">.</span><span class="n">sheet</span><span class="p">)</span>   <span class="c1">// iPhone에서는 시트로 (기본값)</span>
        <span class="o">.</span><span class="nf">frame</span><span class="p">(</span><span class="nv">minWidth</span><span class="p">:</span> <span class="mi">320</span><span class="p">,</span> <span class="nv">minHeight</span><span class="p">:</span> <span class="mi">240</span><span class="p">)</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>전체 화면 커버</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">.</span><span class="nf">fullScreenCover</span><span class="p">(</span><span class="nv">isPresented</span><span class="p">:</span> <span class="err">$</span><span class="n">showCamera</span><span class="p">)</span> <span class="p">{</span>
    <span class="kt">CameraView</span><span class="p">(</span><span class="nv">onDismiss</span><span class="p">:</span> <span class="p">{</span> <span class="n">showCamera</span> <span class="o">=</span> <span class="kc">false</span> <span class="p">})</span>   <span class="c1">// 닫기 버튼을 직접 제공해야 한다</span>
<span class="p">}</span>
</code></pre></div></div>

<h2 id="자주-하는-실수">자주 하는 실수</h2>

<ul>
  <li><strong>시트 위에 시트</strong>: 한 번에 하나만. 시트 안에서 또 시트를 열어야 한다면 구조를 다시 본다. 시트 안에서 스택으로 들어가는 쪽이 낫다</li>
  <li><strong>닫기 버튼 없는 시트</strong>: 끌어서 닫을 수 있어도 닫기 버튼(또는 취소/완료)은 있어야 한다. VoiceOver와 스위치 제어 사용자는 끌지 못한다</li>
  <li><strong>알림으로 성공 알리기</strong>: 사용자를 멈추게 하는 비용이 성공 메시지의 가치보다 크다</li>
  <li><strong>알림 제목에 “알림”, “경고”, “오류”</strong>: 제목은 무슨 일인지 말해야 한다. “네트워크에 연결할 수 없습니다”가 “오류”보다 낫다</li>
  <li><strong>파괴적 동작에 <code class="language-plaintext highlighter-rouge">.destructive</code> 생략</strong>: 빨간색은 “되돌릴 수 없음”의 시스템 신호다</li>
  <li><strong>커스텀 모달 직접 그리기</strong>: <code class="language-plaintext highlighter-rouge">ZStack</code>에 반투명 배경을 깔고 뷰를 띄우면 시트의 제스처, 접근성, 키보드 회피, 뒤 화면 축소 효과를 전부 잃는다</li>
  <li><strong>시트에 <code class="language-plaintext highlighter-rouge">TabView</code></strong>: 시트는 임시 공간이다. 탭은 최상위에만</li>
</ul>

<h2 id="체크리스트">체크리스트</h2>

<ul class="task-list">
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />인라인으로 해결할 수 있는 것을 모달로 만들지 않았다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />알림은 되돌릴 수 없는 결정이나 꼭 알아야 할 정보에만 썼다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />모든 시트에 명시적 닫기(취소/완료) 버튼이 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />작성 중인 시트는 끌어서 닫을 때 변경 사항 손실을 막는다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />파괴적 동작은 <code class="language-plaintext highlighter-rouge">.destructive</code> 역할과 확인 단계가 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />버튼 레이블이 동사다 (“삭제”, “설정 열기”). “확인”만 있는 알림이 없다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />iPad에서 팝오버가 적절한 크기로 뜬다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />VoiceOver로 모달이 열리면 포커스가 모달로 이동한다 (시스템 모달이면 자동)</li>
</ul>

<h2 id="함께-읽기">함께 읽기</h2>

<ul>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosNavigation/">iOS 내비게이션: 탭, 스택, 스플릿 뷰</a> — 모달이 아닌 이동</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosHaptics/">햅틱: 손끝으로 전하는 피드백</a> — 알림 대신 쓸 수 있는 피드백</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/minimalism/">미니멀리즘 디자인: 적은 것이 더 많은 것이다</a> — 점진적 공개와 모달의 절제</li>
</ul>]]></content><author><name>Geppetto</name></author><category term="디자인" /><category term="iOS 디자인" /><category term="HIG" /><category term="iOS" /><summary type="html"><![CDATA[사용자의 흐름에 끼어드는 다섯 가지 방법과 각각을 써야 할 때. Alert, Confirmation Dialog, Sheet, Popover, Full Screen Cover.]]></summary></entry><entry><title type="html">iOS 내비게이션: 탭, 스택, 스플릿 뷰</title><link href="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosNavigation/" rel="alternate" type="text/html" title="iOS 내비게이션: 탭, 스택, 스플릿 뷰" /><published>2026-11-15T00:01:00+09:00</published><updated>2026-11-15T00:01:00+09:00</updated><id>https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosNavigation</id><content type="html" xml:base="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/iosNavigation/"><![CDATA[<p>내비게이션은 사용자가 “지금 어디에 있고, 어디로 갈 수 있고, 어떻게 돌아가는지”를 아는 방법이다.
웹에서는 URL과 뒤로 가기 버튼이 이 역할을 하지만, iOS에는 URL 바가 없다. 그래서 내비게이션 구조 자체가 그 역할을 해야 한다.</p>

<p>HIG는 내비게이션을 <strong>콘텐츠를 담는 그릇</strong>으로 보고, 그릇이 눈에 띄지 않을수록 좋다고 말한다. 사용자가 “어떻게 이동하지?”를 생각하는 순간 내비게이션은 실패한 것이다.</p>

<h2 id="세-가지-기본-구조">세 가지 기본 구조</h2>

<p>iOS 앱의 내비게이션은 대부분 세 가지 구조의 조합이다.</p>

<div class="mermaid">
flowchart LR
    A[앱 구조 고르기] --&gt; B{최상위 영역이<br />서로 독립적인가?}
    B -- 예, 2~5개 --&gt; C[탭 바<br />TabView]
    B -- 아니오 --&gt; D{콘텐츠가<br />계층적인가?}
    D -- 예 --&gt; E[내비게이션 스택<br />NavigationStack]
    D -- 아니오, 평면적 --&gt; F[페이지 / 단일 화면]
    C --&gt; G{iPad도<br />지원하나?}
    E --&gt; G
    G -- 예 --&gt; H[스플릿 뷰<br />NavigationSplitView<br />사이드바 적응형 탭]
</div>

<h3 id="탭-바-tab-bar">탭 바 (Tab Bar)</h3>

<ul>
  <li><strong>답하는 질문</strong>: “이 앱에는 어떤 영역들이 있는가?”</li>
  <li><strong>언제</strong>: 서로 독립적인 최상위 영역이 2~5개일 때. 시계 앱(세계 시계, 알람, 스톱워치, 타이머)이 교과서</li>
  <li><strong>규칙</strong>: 탭은 항상 보이고, 탭을 전환해도 각 탭의 상태(스크롤 위치, 들어간 깊이)는 유지된다. 탭은 모드 전환이지 동작 버튼이 아니다. “작성” 같은 동작을 탭에 넣지 않는다</li>
  <li><strong>iOS 26</strong>: 탭 바가 Liquid Glass 재질로 콘텐츠 위에 떠 있고, 스크롤하면 작아진다. 탭 바 옆에 검색 탭을 따로 둘 수 있다</li>
</ul>

<h3 id="내비게이션-스택-navigation-stack">내비게이션 스택 (Navigation Stack)</h3>

<ul>
  <li><strong>답하는 질문</strong>: “이 항목 안에는 무엇이 있는가?”</li>
  <li><strong>언제</strong>: 콘텐츠가 계층적일 때. 설정 → 일반 → 정보처럼 깊이 들어갔다가 돌아온다</li>
  <li><strong>규칙</strong>: 내비게이션 바 왼쪽에 “&lt; 이전 화면 제목”이 자동으로 생기고, 왼쪽 가장자리 스와이프로 돌아간다. 이 둘은 절대 막지 않는다</li>
  <li><strong>큰 제목</strong>: 최상위 화면은 큰 제목(Large Title), 들어갈수록 인라인 제목. 깊이를 제목 크기로도 전달한다</li>
</ul>

<h3 id="스플릿-뷰-split-view">스플릿 뷰 (Split View)</h3>

<ul>
  <li><strong>답하는 질문</strong>: “넓은 화면에서 목록과 상세를 어떻게 함께 보여 줄 것인가?”</li>
  <li><strong>언제</strong>: iPad, Mac, 가로 모드 iPhone Pro Max. 메일 앱의 사이드바-메일함-메일 세 컬럼</li>
  <li><strong>규칙</strong>: 화면이 좁아지면(iPhone, Split View) 자동으로 스택으로 접힌다. 한 코드로 두 구조를 얻는다</li>
</ul>

<h2 id="선택-기준">선택 기준</h2>

<table>
  <thead>
    <tr>
      <th>상황</th>
      <th>구조</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>독립적인 영역 3개, 각각 깊이 있음</td>
      <td>탭 바 + 각 탭 안에 스택</td>
    </tr>
    <tr>
      <td>하나의 긴 목록과 상세</td>
      <td>스택 (iPhone) / 스플릿 뷰 (iPad)</td>
    </tr>
    <tr>
      <td>설정처럼 깊은 계층만 있음</td>
      <td>스택</td>
    </tr>
    <tr>
      <td>온보딩, 튜토리얼</td>
      <td>페이지 (가로 스와이프)</td>
    </tr>
    <tr>
      <td>지도, 카메라처럼 한 화면이 전부</td>
      <td>단일 화면 + 시트로 보조 UI</td>
    </tr>
    <tr>
      <td>영역 6개 이상</td>
      <td>탭 5개 + “더 보기”는 피한다. 영역을 합치거나 사이드바(iPad)로</td>
    </tr>
  </tbody>
</table>

<p><strong>피해야 할 것</strong></p>

<ul>
  <li>햄버거 메뉴(내비게이션 드로어): iOS 관례가 아니다. 숨겨진 메뉴는 발견되지 않는다</li>
  <li>탭 바 + 하단 시트가 겹치는 구조: 엄지 영역이 충돌한다</li>
  <li>뒤로 가기를 커스텀 버튼으로 대체: 시스템 뒤로 가기와 스와이프를 잃는다</li>
  <li>깊이 5단계 이상: 사용자는 어디 있는지 잊는다. 구조를 평평하게 만들거나 시트로 분리한다</li>
</ul>

<h2 id="swiftui로-구현하기">SwiftUI로 구현하기</h2>

<p><strong>탭 + 스택 조합</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">RootView</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="kt">TabView</span> <span class="p">{</span>
            <span class="kt">Tab</span><span class="p">(</span><span class="s">"목록"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"list.bullet"</span><span class="p">)</span> <span class="p">{</span>          <span class="c1">// iOS 18+ Tab 문법</span>
                <span class="kt">NavigationStack</span> <span class="p">{</span>
                    <span class="kt">ItemListView</span><span class="p">()</span>
                        <span class="o">.</span><span class="nf">navigationTitle</span><span class="p">(</span><span class="s">"목록"</span><span class="p">)</span>
                <span class="p">}</span>
            <span class="p">}</span>
            <span class="kt">Tab</span><span class="p">(</span><span class="s">"검색"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"magnifyingglass"</span><span class="p">,</span> <span class="nv">role</span><span class="p">:</span> <span class="o">.</span><span class="n">search</span><span class="p">)</span> <span class="p">{</span>
                <span class="kt">SearchView</span><span class="p">()</span>
            <span class="p">}</span>
            <span class="kt">Tab</span><span class="p">(</span><span class="s">"설정"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"gear"</span><span class="p">)</span> <span class="p">{</span>
                <span class="kt">NavigationStack</span> <span class="p">{</span> <span class="kt">SettingsView</span><span class="p">()</span><span class="o">.</span><span class="nf">navigationTitle</span><span class="p">(</span><span class="s">"설정"</span><span class="p">)</span> <span class="p">}</span>
            <span class="p">}</span>
        <span class="p">}</span>
        <span class="o">.</span><span class="nf">tabViewStyle</span><span class="p">(</span><span class="o">.</span><span class="n">sidebarAdaptable</span><span class="p">)</span>   <span class="c1">// iPad에서 사이드바로 자동 전환</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p>각 탭이 <strong>자기 스택</strong>을 가진다. <code class="language-plaintext highlighter-rouge">TabView</code> 바깥에 <code class="language-plaintext highlighter-rouge">NavigationStack</code> 하나를 두면 탭을 바꿀 때 깊이가 섞인다.</p>

<p><strong>데이터 기반 스택 (iOS 16+)</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">ItemListView</span><span class="p">:</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="kd">@State</span> <span class="kd">private</span> <span class="k">var</span> <span class="nv">path</span><span class="p">:</span> <span class="p">[</span><span class="kt">Item</span><span class="p">]</span> <span class="o">=</span> <span class="p">[]</span>

    <span class="k">var</span> <span class="nv">body</span><span class="p">:</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="kt">NavigationStack</span><span class="p">(</span><span class="nv">path</span><span class="p">:</span> <span class="err">$</span><span class="n">path</span><span class="p">)</span> <span class="p">{</span>
            <span class="kt">List</span><span class="p">(</span><span class="n">items</span><span class="p">)</span> <span class="p">{</span> <span class="n">item</span> <span class="k">in</span>
                <span class="kt">NavigationLink</span><span class="p">(</span><span class="n">item</span><span class="o">.</span><span class="n">title</span><span class="p">,</span> <span class="nv">value</span><span class="p">:</span> <span class="n">item</span><span class="p">)</span>
            <span class="p">}</span>
            <span class="o">.</span><span class="nf">navigationDestination</span><span class="p">(</span><span class="nv">for</span><span class="p">:</span> <span class="kt">Item</span><span class="o">.</span><span class="k">self</span><span class="p">)</span> <span class="p">{</span> <span class="n">item</span> <span class="k">in</span>
                <span class="kt">ItemDetailView</span><span class="p">(</span><span class="nv">item</span><span class="p">:</span> <span class="n">item</span><span class="p">)</span>
            <span class="p">}</span>
        <span class="p">}</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><code class="language-plaintext highlighter-rouge">path</code>를 상태로 들고 있으면 딥 링크(<code class="language-plaintext highlighter-rouge">path = [item]</code>), 루트로 돌아가기(<code class="language-plaintext highlighter-rouge">path.removeAll()</code>), 상태 복원이 모두 배열 조작이 된다.</p>

<p><strong>스플릿 뷰</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">NavigationSplitView</span> <span class="p">{</span>
    <span class="kt">List</span><span class="p">(</span><span class="n">folders</span><span class="p">,</span> <span class="nv">selection</span><span class="p">:</span> <span class="err">$</span><span class="n">selectedFolder</span><span class="p">)</span> <span class="p">{</span> <span class="n">folder</span> <span class="k">in</span>
        <span class="kt">Label</span><span class="p">(</span><span class="n">folder</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="n">folder</span><span class="o">.</span><span class="n">icon</span><span class="p">)</span>
    <span class="p">}</span>
    <span class="o">.</span><span class="nf">navigationTitle</span><span class="p">(</span><span class="s">"폴더"</span><span class="p">)</span>
<span class="p">}</span> <span class="nv">content</span><span class="p">:</span> <span class="p">{</span>
    <span class="k">if</span> <span class="k">let</span> <span class="nv">selectedFolder</span> <span class="p">{</span>
        <span class="kt">NoteList</span><span class="p">(</span><span class="nv">folder</span><span class="p">:</span> <span class="n">selectedFolder</span><span class="p">,</span> <span class="nv">selection</span><span class="p">:</span> <span class="err">$</span><span class="n">selectedNote</span><span class="p">)</span>
    <span class="p">}</span>
<span class="p">}</span> <span class="nv">detail</span><span class="p">:</span> <span class="p">{</span>
    <span class="k">if</span> <span class="k">let</span> <span class="nv">selectedNote</span> <span class="p">{</span> <span class="kt">NoteEditor</span><span class="p">(</span><span class="nv">note</span><span class="p">:</span> <span class="n">selectedNote</span><span class="p">)</span> <span class="p">}</span>
    <span class="k">else</span> <span class="p">{</span> <span class="kt">ContentUnavailableView</span><span class="p">(</span><span class="s">"메모를 선택하세요"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"note.text"</span><span class="p">)</span> <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p>iPhone에서는 자동으로 스택으로 접힌다. 상세가 비었을 때의 화면(<code class="language-plaintext highlighter-rouge">ContentUnavailableView</code>)을 꼭 둔다. iPad에서는 그 화면이 처음부터 보인다.</p>

<p><strong>제목과 툴바</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="o">.</span><span class="nf">navigationTitle</span><span class="p">(</span><span class="s">"받은 편지함"</span><span class="p">)</span>
<span class="o">.</span><span class="nf">navigationBarTitleDisplayMode</span><span class="p">(</span><span class="o">.</span><span class="n">large</span><span class="p">)</span>          <span class="c1">// 최상위는 큰 제목</span>
<span class="o">.</span><span class="n">toolbar</span> <span class="p">{</span>
    <span class="kt">ToolbarItem</span><span class="p">(</span><span class="nv">placement</span><span class="p">:</span> <span class="o">.</span><span class="n">primaryAction</span><span class="p">)</span> <span class="p">{</span>    <span class="c1">// 오른쪽: 주요 동작</span>
        <span class="kt">Button</span><span class="p">(</span><span class="s">"작성"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"square.and.pencil"</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span>
    <span class="p">}</span>
    <span class="kt">ToolbarItem</span><span class="p">(</span><span class="nv">placement</span><span class="p">:</span> <span class="o">.</span><span class="n">bottomBar</span><span class="p">)</span> <span class="p">{</span>        <span class="c1">// 하단 툴바: 보조 동작</span>
        <span class="kt">Button</span><span class="p">(</span><span class="s">"필터"</span><span class="p">,</span> <span class="nv">systemImage</span><span class="p">:</span> <span class="s">"line.3.horizontal.decrease.circle"</span><span class="p">)</span> <span class="p">{</span> <span class="p">}</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<h2 id="자주-하는-실수">자주 하는 실수</h2>

<ul>
  <li><strong><code class="language-plaintext highlighter-rouge">NavigationView</code> 사용</strong>: iOS 16부터 deprecated. <code class="language-plaintext highlighter-rouge">NavigationStack</code>과 <code class="language-plaintext highlighter-rouge">NavigationSplitView</code>로 나뉘었다</li>
  <li><strong>탭마다 다른 내비게이션 바 색</strong>: 탭을 바꿀 때마다 바 색이 바뀌면 앱이 여러 개처럼 느껴진다. <code class="language-plaintext highlighter-rouge">tint</code> 하나로 통일한다</li>
  <li><strong>시트 안에 탭 바</strong>: 시트는 임시 공간이다. 탭 바는 앱의 최상위에만</li>
  <li><strong>뒤로 가기 버튼 제목을 “뒤로”로 고정</strong>: 시스템 기본은 이전 화면 제목이다. 그래야 어디로 돌아가는지 안다. 제목이 너무 길 때만 <code class="language-plaintext highlighter-rouge">.navigationBarBackButtonHidden</code>이 아니라 <code class="language-plaintext highlighter-rouge">toolbarRole(.editor)</code>로 “&lt; 뒤로”를 쓴다</li>
  <li><strong>선택 상태를 뷰에 저장</strong>: <code class="language-plaintext highlighter-rouge">selectedItem</code>을 <code class="language-plaintext highlighter-rouge">@State</code>로 하위 뷰에 두면 iPad에서 사이드바와 상세가 어긋난다. 스플릿 뷰의 선택 상태는 가장 바깥에</li>
</ul>

<h2 id="체크리스트">체크리스트</h2>

<ul class="task-list">
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />최상위 영역이 2~5개면 탭 바, 아니면 스택이나 스플릿 뷰</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />모든 스택 화면에서 왼쪽 가장자리 스와이프로 돌아갈 수 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />최상위 화면은 큰 제목, 하위 화면은 인라인 제목</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />iPad에서 목록-상세가 나란히 보인다 (스플릿 뷰 또는 <code class="language-plaintext highlighter-rouge">.sidebarAdaptable</code>)</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />상세가 비었을 때 보여 줄 화면이 있다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />탭을 전환해도 각 탭의 깊이와 스크롤 위치가 유지된다</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />딥 링크로 특정 화면에 바로 갈 수 있다 (<code class="language-plaintext highlighter-rouge">path</code> 조작)</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" />VoiceOver로 탭 바와 뒤로 가기 버튼이 올바르게 읽힌다 (시스템 컴포넌트면 자동)</li>
</ul>

<h2 id="함께-읽기">함께 읽기</h2>

<ul>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iosModality/">모달의 위계: 알림, 시트, 팝오버</a> — 스택 밖으로 잠깐 나가는 방법</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/materialDesign/">머티리얼 디자인: 디지털 세계의 물리적 메타포</a> — Android 내비게이션을 iOS로 번역하는 표</li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/responsiveDesign/">반응형 디자인: 모든 화면에 최적화된 경험</a> — 사이즈 클래스에 따른 구조 전환</li>
</ul>]]></content><author><name>Geppetto</name></author><category term="디자인" /><category term="iOS 디자인" /><category term="HIG" /><category term="iOS" /><summary type="html"><![CDATA[앱의 뼈대를 고르는 기준. 탭 바, 내비게이션 스택, 스플릿 뷰가 각각 어떤 질문에 답하는지와 SwiftUI 구현.]]></summary></entry><entry><title type="html">디자인 시스템: 일관된 사용자 경험의 기반</title><link href="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/designSystem/" rel="alternate" type="text/html" title="디자인 시스템: 일관된 사용자 경험의 기반" /><published>2024-09-21T00:00:00+09:00</published><updated>2026-11-15T00:00:00+09:00</updated><id>https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/designSystem</id><content type="html" xml:base="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/designSystem/"><![CDATA[<p>재사용 가능한 디자인 구성 요소와 그 사용 규칙을 한데 모은 체계.
디지털 제품을 만드는 모든 사람이 같은 기준으로 일관성 있게 화면을 구축할 수 있도록 돕는다.</p>

<p><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/designStyle/">디자인 스타일</a>이 “분위기”, <a href="/%EB%94%94%EC%9E%90%EC%9D%B8/disignTechniques/">디자인 기법</a>이 “방법”이라면, 디자인 시스템은 그 둘을 <strong>재사용 가능한 자산과 규칙</strong>으로 굳힌 것이다.</p>

<h2 id="왜-필요한가">왜 필요한가</h2>

<ul>
  <li>디자이너마다 조금씩 다른 결과물에 일관성을 부여한다</li>
  <li>반복해서 쓰는 컴포넌트를 정리해 새 화면을 만들 때의 수고를 줄인다</li>
  <li>우선순위가 낮은 화면에 들어가는 시간을 줄여 핵심 경험에 집중할 수 있게 한다</li>
  <li>하나의 결과물이 아닌 결과물의 집합이라서 디자이너와 개발자가 같은 언어로 협업할 수 있다</li>
  <li>브랜드 규칙을 문서가 아닌 <strong>작동하는 부품</strong>으로 유지한다</li>
  <li>서비스가 커질수록 디자인 결정의 일관성을 지켜 준다</li>
</ul>

<h2 id="일반적인-구성-요소">일반적인 구성 요소</h2>

<ul>
  <li>브랜드의 공유 가치와 목적</li>
  <li>디자인 원칙</li>
  <li>브랜드의 정체성과 언어(보이스 앤 톤)</li>
  <li>스타일 가이드: 색상, 타이포그래피, 간격, 아이콘</li>
  <li>컴포넌트와 패턴</li>
  <li>코딩 규칙 같은 개발 요소</li>
  <li>모범 사례와 이를 관리하는 정책(거버넌스)</li>
</ul>

<div class="mermaid">
flowchart TB
    A[디자인 원칙] --&gt; B[디자인 토큰<br />색 · 글꼴 · 간격 · 반경]
    B --&gt; C[컴포넌트<br />버튼 · 카드 · 입력]
    C --&gt; D[패턴<br />로딩 · 빈 화면 · 오류]
    D --&gt; E[화면 / 제품]
    F[문서와 거버넌스] -.-&gt; B
    F -.-&gt; C
    F -.-&gt; D
</div>

<h2 id="장점">장점</h2>

<ul>
  <li>일관성 향상</li>
  <li>시간 절약</li>
  <li>공통 기반 위에서의 협업</li>
  <li>리스크 최소화 (한 곳을 고치면 전체에 반영)</li>
  <li>확장성</li>
  <li>브랜드 구축</li>
</ul>

<h2 id="대표적-사례">대표적 사례</h2>

<ul>
  <li><strong>Apple Human Interface Guidelines</strong>: 플랫폼 차원의 디자인 시스템. 원칙부터 컴포넌트까지 모두 담고 있다</li>
  <li><strong>Google Material Design</strong>: 토큰, 컴포넌트, 모션 규칙과 코드 라이브러리를 함께 제공</li>
  <li><strong>IBM Carbon, Atlassian Design System, Shopify Polaris</strong>: 기업 제품군의 일관성을 위한 시스템</li>
  <li><strong>Apple Design Resources</strong>: Figma와 Sketch용 공식 UI 키트. HIG를 디자인 도구 안에서 바로 쓸 수 있게 한다</li>
</ul>

<h2 id="ios에서는">iOS에서는</h2>

<h3 id="hig가-말하는-것">HIG가 말하는 것</h3>

<p>iOS 앱을 만든다면 디자인 시스템을 <strong>처음부터 만들지 않는다</strong>. 이미 HIG라는 플랫폼 시스템 위에 서 있기 때문이다.
HIG가 제공하는 것들을 그대로 쓰고, 그 위에 앱 고유의 얇은 층을 얹는 것이 iOS식 디자인 시스템이다.</p>

<p>HIG가 이미 정해 둔 것:</p>

<ul>
  <li><strong>색상</strong>: 라이트/다크, 고대비에 자동 대응하는 의미론적 색상 (<code class="language-plaintext highlighter-rouge">label</code>, <code class="language-plaintext highlighter-rouge">systemBackground</code> 등)과 시스템 색상 (<code class="language-plaintext highlighter-rouge">systemBlue</code> 등)</li>
  <li><strong>타이포그래피</strong>: SF Pro 서체와 11단계 Dynamic Type 텍스트 스타일</li>
  <li><strong>아이콘</strong>: 6,000개가 넘는 SF Symbols. 글꼴과 함께 굵기와 크기가 맞춰진다</li>
  <li><strong>레이아웃</strong>: 세이프 에어리어, 레이아웃 마진, 44×44pt 최소 터치 영역</li>
  <li><strong>컴포넌트</strong>: 내비게이션 바, 탭 바, 리스트, 시트, 알림 등 모든 기본 부품</li>
  <li><strong>모션</strong>: 화면 전환과 피드백의 기본 타이밍</li>
</ul>

<p>앱이 추가로 정하는 것은 보통 브랜드 색, 특수 컴포넌트, 그리고 “우리 앱은 이럴 때 이렇게 한다”는 패턴 규칙 정도다.</p>

<h3 id="swiftui로-구현하기">SwiftUI로 구현하기</h3>

<p>SwiftUI에서 디자인 시스템은 네 가지 도구로 코드가 된다.</p>

<p><strong>1. 토큰은 에셋 카탈로그와 확장으로</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// Assets.xcassets에 "Brand" 색상 세트를 만들고 라이트/다크/고대비 값을 넣으면</span>
<span class="c1">// Xcode 15부터 Color.brand 심볼이 자동 생성된다</span>
<span class="kd">extension</span> <span class="kt">CGFloat</span> <span class="p">{</span>
    <span class="kd">static</span> <span class="k">let</span> <span class="nv">spacingS</span><span class="p">:</span> <span class="kt">CGFloat</span> <span class="o">=</span> <span class="mi">8</span>
    <span class="kd">static</span> <span class="k">let</span> <span class="nv">spacingM</span><span class="p">:</span> <span class="kt">CGFloat</span> <span class="o">=</span> <span class="mi">16</span>
    <span class="kd">static</span> <span class="k">let</span> <span class="nv">radiusCard</span><span class="p">:</span> <span class="kt">CGFloat</span> <span class="o">=</span> <span class="mi">16</span>
<span class="p">}</span>
</code></pre></div></div>

<p><strong>2. 컴포넌트는 스타일 프로토콜로</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">struct</span> <span class="kt">PrimaryButtonStyle</span><span class="p">:</span> <span class="kt">ButtonStyle</span> <span class="p">{</span>
    <span class="kd">func</span> <span class="nf">makeBody</span><span class="p">(</span><span class="nv">configuration</span><span class="p">:</span> <span class="kt">Configuration</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="n">configuration</span><span class="o">.</span><span class="n">label</span>
            <span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">headline</span><span class="p">)</span>
            <span class="o">.</span><span class="nf">padding</span><span class="p">(</span><span class="o">.</span><span class="n">vertical</span><span class="p">,</span> <span class="o">.</span><span class="n">spacingS</span><span class="p">)</span>
            <span class="o">.</span><span class="nf">padding</span><span class="p">(</span><span class="o">.</span><span class="n">horizontal</span><span class="p">,</span> <span class="o">.</span><span class="n">spacingM</span><span class="p">)</span>
            <span class="o">.</span><span class="nf">background</span><span class="p">(</span><span class="o">.</span><span class="n">tint</span><span class="p">,</span> <span class="nv">in</span><span class="p">:</span> <span class="kt">Capsule</span><span class="p">())</span>
            <span class="o">.</span><span class="nf">foregroundStyle</span><span class="p">(</span><span class="o">.</span><span class="n">white</span><span class="p">)</span>
            <span class="o">.</span><span class="nf">opacity</span><span class="p">(</span><span class="n">configuration</span><span class="o">.</span><span class="n">isPressed</span> <span class="p">?</span> <span class="mf">0.7</span> <span class="p">:</span> <span class="mi">1</span><span class="p">)</span>
    <span class="p">}</span>
<span class="p">}</span>

<span class="kd">extension</span> <span class="kt">ButtonStyle</span> <span class="k">where</span> <span class="k">Self</span> <span class="o">==</span> <span class="kt">PrimaryButtonStyle</span> <span class="p">{</span>
    <span class="kd">static</span> <span class="k">var</span> <span class="nv">primary</span><span class="p">:</span> <span class="kt">PrimaryButtonStyle</span> <span class="p">{</span> <span class="o">.</span><span class="nf">init</span><span class="p">()</span> <span class="p">}</span>
<span class="p">}</span>

<span class="c1">// 사용: Button("저장") { }.buttonStyle(.primary)</span>
</code></pre></div></div>

<p><strong>3. 전역 설정은 환경(Environment)으로</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">ContentView</span><span class="p">()</span>
    <span class="o">.</span><span class="nf">tint</span><span class="p">(</span><span class="o">.</span><span class="n">brand</span><span class="p">)</span>                         <span class="c1">// 모든 컨트롤의 강조색</span>
    <span class="o">.</span><span class="nf">fontDesign</span><span class="p">(</span><span class="o">.</span><span class="n">rounded</span><span class="p">)</span>                 <span class="c1">// 앱 전체 서체 느낌</span>
    <span class="o">.</span><span class="nf">environment</span><span class="p">(\</span><span class="o">.</span><span class="n">locale</span><span class="p">,</span> <span class="o">.</span><span class="n">current</span><span class="p">)</span>
</code></pre></div></div>

<p><strong>4. 패턴은 뷰 수정자로</strong></p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">extension</span> <span class="kt">View</span> <span class="p">{</span>
    <span class="kd">func</span> <span class="nf">cardStyle</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="kd">some</span> <span class="kt">View</span> <span class="p">{</span>
        <span class="k">self</span><span class="o">.</span><span class="nf">padding</span><span class="p">(</span><span class="o">.</span><span class="n">spacingM</span><span class="p">)</span>
            <span class="o">.</span><span class="nf">background</span><span class="p">(</span><span class="o">.</span><span class="n">background</span><span class="p">,</span> <span class="nv">in</span><span class="p">:</span> <span class="kt">RoundedRectangle</span><span class="p">(</span><span class="nv">cornerRadius</span><span class="p">:</span> <span class="o">.</span><span class="n">radiusCard</span><span class="p">))</span>
            <span class="o">.</span><span class="nf">shadow</span><span class="p">(</span><span class="nv">color</span><span class="p">:</span> <span class="o">.</span><span class="n">black</span><span class="o">.</span><span class="nf">opacity</span><span class="p">(</span><span class="mf">0.06</span><span class="p">),</span> <span class="nv">radius</span><span class="p">:</span> <span class="mi">8</span><span class="p">,</span> <span class="nv">y</span><span class="p">:</span> <span class="mi">2</span><span class="p">)</span>
    <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p>이 네 층을 하나의 Swift Package로 묶으면, 여러 앱이 같은 시스템을 공유할 수 있다.</p>

<h3 id="주의할-점">주의할 점</h3>

<ul>
  <li>시스템 값을 하드코딩된 값으로 덮어쓰지 않는다. <code class="language-plaintext highlighter-rouge">Color.black</code> 대신 <code class="language-plaintext highlighter-rouge">.primary</code>, <code class="language-plaintext highlighter-rouge">size: 17</code> 대신 <code class="language-plaintext highlighter-rouge">.body</code>를 쓴다. 그래야 다크 모드와 Dynamic Type이 살아 있다</li>
  <li>컴포넌트는 <strong>상태</strong>를 모두 가져야 한다. 기본, 눌림, 비활성, 로딩, 오류. 하나라도 빠지면 각 화면이 알아서 만들기 시작하고 시스템이 무너진다</li>
  <li>문서 없는 디자인 시스템은 라이브러리일 뿐이다. 언제 쓰고 언제 쓰지 않는지가 코드 옆에 있어야 한다</li>
  <li>Xcode Previews를 디자인 시스템의 <strong>살아 있는 카탈로그</strong>로 쓴다. 컴포넌트마다 라이트/다크, 큰 글자, 고대비 프리뷰를 둔다</li>
</ul>

<h2 id="웹과-ios-대응표">웹과 iOS 대응표</h2>

<table>
  <thead>
    <tr>
      <th>웹</th>
      <th>iOS / SwiftUI</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>CSS 커스텀 프로퍼티 (디자인 토큰)</td>
      <td>에셋 카탈로그 색상/이미지 세트, 상수 확장</td>
    </tr>
    <tr>
      <td>컴포넌트 라이브러리 (React 등)</td>
      <td><code class="language-plaintext highlighter-rouge">ButtonStyle</code>, <code class="language-plaintext highlighter-rouge">LabelStyle</code>, <code class="language-plaintext highlighter-rouge">ToggleStyle</code>, 커스텀 뷰</td>
    </tr>
    <tr>
      <td>테마 프로바이더 / Context</td>
      <td><code class="language-plaintext highlighter-rouge">Environment</code>, <code class="language-plaintext highlighter-rouge">.tint</code>, <code class="language-plaintext highlighter-rouge">.fontDesign</code></td>
    </tr>
    <tr>
      <td>Storybook</td>
      <td>Xcode Previews, <code class="language-plaintext highlighter-rouge">#Preview</code> 매크로</td>
    </tr>
    <tr>
      <td>npm 패키지로 배포</td>
      <td>Swift Package로 배포</td>
    </tr>
    <tr>
      <td>브라우저 기본 스타일</td>
      <td>HIG + 시스템 컨트롤 기본 스타일</td>
    </tr>
  </tbody>
</table>

<h2 id="함께-읽기">함께 읽기</h2>

<ul>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/designStyle/">디자인 스타일: UI/UX의 시각적 언어</a></li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/disignTechniques/">디자인 기법: UI/UX의 실행 도구</a></li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/typography/">타이포그래피: 글자를 통한 효과적인 커뮤니케이션</a></li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/iconDesign/">아이콘 디자인: 시각적 언어의 핵심 요소</a></li>
</ul>]]></content><author><name>Geppetto</name></author><category term="디자인" /><category term="개념" /><category term="iOS" /><summary type="html"><![CDATA[재사용 가능한 디자인 구성 요소와 그 사용 규칙을 한데 모은 체계. 디지털 제품을 만드는 모든 사람이 같은 기준으로 일관성 있게 화면을 구축할 수 있도록 돕는다.]]></summary></entry><entry><title type="html">디자인 스타일: UI/UX의 시각적 언어</title><link href="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/designStyle/" rel="alternate" type="text/html" title="디자인 스타일: UI/UX의 시각적 언어" /><published>2024-08-25T00:00:00+09:00</published><updated>2026-11-15T00:00:00+09:00</updated><id>https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/designStyle</id><content type="html" xml:base="https://saejinpark.github.io/%EB%94%94%EC%9E%90%EC%9D%B8/designStyle/"><![CDATA[<p>사용자 인터페이스(UI)와 사용자 경험(UX)을 구성하는 일관된 시각적 접근 방식.
단순한 미적 선호를 넘어서는 종합적인 디자인 철학과 방법론.</p>

<p>이 시리즈에서 다루는 스타일은 대부분 웹에서 이름이 붙었지만, 같은 원리가 iOS 앱에서도 그대로 쓰인다.
웹이 CSS로 표현하는 것을 iOS는 HIG(Human Interface Guidelines)와 SwiftUI로 표현한다는 차이만 있을 뿐이다.</p>

<h2 id="구성-요소">구성 요소</h2>

<h3 id="시각적-요소">시각적 요소</h3>
<ul>
  <li><strong>색상</strong>: 브랜드 아이덴티티를 반영하는 색상 팔레트</li>
  <li><strong>타이포그래피</strong>: 가독성과 브랜드 개성을 고려한 폰트</li>
  <li><strong>아이콘</strong>: 일관된 스타일의 그래픽 심볼</li>
  <li><strong>이미지</strong>: 제품 특성에 맞는 시각적 콘텐츠</li>
</ul>

<h3 id="레이아웃">레이아웃</h3>
<ul>
  <li><strong>그리드 시스템</strong>: 콘텐츠의 체계적 배치를 위한 구조</li>
  <li><strong>공간 활용</strong>: 여백(화이트 스페이스)의 전략적 사용</li>
</ul>

<h3 id="상호작용">상호작용</h3>
<ul>
  <li><strong>애니메이션</strong>: 사용자 행동에 대한 시각적 피드백</li>
  <li><strong>전환 효과</strong>: 화면 간 이동 시 적용되는 시각적 변화</li>
</ul>

<h3 id="질감과-깊이">질감과 깊이</h3>
<ul>
  <li><strong>평면성</strong>: 2D 디자인을 통한 단순함 강조</li>
  <li><strong>입체감</strong>: 그림자와 레이어, 재질(material)을 통한 깊이감 표현</li>
</ul>

<h2 id="목적">목적</h2>

<ol>
  <li><strong>일관성</strong>: 모든 터치포인트에서의 통일된 사용자 경험</li>
  <li><strong>브랜드 강화</strong>: 시각적 요소를 통한 브랜드 가치 전달</li>
  <li><strong>감성 전달</strong>: 제품 성격에 맞는 특정 분위기 조성</li>
  <li><strong>기능성 향상</strong>: 직관적 인터페이스를 통한 사용성 개선</li>
</ol>

<h2 id="영향-요인">영향 요인</h2>

<ul>
  <li><strong>기술 트렌드</strong>: 새로운 기술의 디자인 적용 (고해상도 디스플레이, GPU 블러 등)</li>
  <li><strong>문화적 맥락</strong>: 지역별 선호도와 문화적 특성</li>
  <li><strong>사용자 선호도</strong>: 사용자 리서치를 통해 파악된 선호 스타일</li>
  <li><strong>플랫폼 특성</strong>: 각 OS가 제시하는 디자인 언어와 기기 환경</li>
  <li><strong>기업 철학</strong>: 회사의 미션과 비전의 디자인적 표현</li>
</ul>

<h2 id="진화">진화</h2>

<p>시간에 따라 변화하는 디자인 접근 방식. 기술 발전, 사용자 기대 변화, 새로운 디자인 철학 등에 영향을 받음.
흥미로운 점은 큰 전환점마다 Apple의 OS가 기준점이 되었다는 것이다.</p>

<div class="mermaid">
timeline
    title 디자인 스타일의 진화
    2000 : 스큐어모피즘
         : 현실 세계 모방 (iOS 6까지)
    2013 : 플랫 디자인
         : 단순화 (iOS 7)
    2020 : 글라스모피즘 / 뉴모피즘
         : 반투명 재질과 부드러운 입체감 (macOS Big Sur)
    2025 : Liquid Glass
         : 빛을 굴절시키는 동적 재질 (iOS 26)
</div>

<h2 id="이-시리즈에서-다루는-스타일">이 시리즈에서 다루는 스타일</h2>

<table>
  <thead>
    <tr>
      <th>스타일</th>
      <th>한 줄 요약</th>
      <th>iOS에서의 위치</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/skeuomorphism/">스큐어모피즘</a></td>
      <td>현실 물체를 모방</td>
      <td>iOS 6 이전의 기본 언어</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/flatDesign/">플랫 디자인</a></td>
      <td>장식을 걷어낸 2D</td>
      <td>iOS 7 이후의 기본 언어</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/materialDesign/">머티리얼 디자인</a></td>
      <td>종이와 잉크의 물리 메타포</td>
      <td>Android의 언어, iOS에선 번역이 필요</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/minimalism/">미니멀리즘</a></td>
      <td>본질만 남기기</td>
      <td>HIG의 기본 태도</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/neumorphism/">뉴모피즘</a></td>
      <td>배경에서 솟아오른 부드러운 입체</td>
      <td>접근성 때문에 제한적</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/glassmorphism/">글라스모피즘</a></td>
      <td>반투명 유리 재질</td>
      <td>시스템 Material, Liquid Glass</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/typographyCentricDesign/">타이포그래피 중심</a></td>
      <td>글자가 곧 디자인</td>
      <td>SF Pro와 Dynamic Type</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/visuallyRich/">비주얼 리치</a></td>
      <td>풍부한 이미지와 모션</td>
      <td>성능과 접근성이 관건</td>
    </tr>
    <tr>
      <td><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/retro_vintage/">레트로/빈티지</a></td>
      <td>과거 인터페이스의 재해석</td>
      <td>브랜딩과 게임에서</td>
    </tr>
  </tbody>
</table>

<h2 id="ios에서는">iOS에서는</h2>

<h3 id="hig가-말하는-것">HIG가 말하는 것</h3>

<p>HIG는 특정 “스타일”을 강요하지 않는다. 대신 플랫폼이 공유하는 원칙을 제시한다.
iOS 7과 함께 제시된 세 가지 주제가 지금도 iOS 디자인 스타일의 뼈대다.</p>

<ul>
  <li><strong>명료성(Clarity)</strong>: 텍스트는 어떤 크기에서도 읽히고, 아이콘은 정확하며, 장식은 기능을 가리지 않는다</li>
  <li><strong>존중(Deference)</strong>: UI는 콘텐츠를 돋보이게 하는 배경이 된다. 반투명 재질과 블러가 콘텐츠를 비춘다</li>
  <li><strong>깊이(Depth)</strong>: 레이어와 모션이 계층을 전달하고, 화면 사이의 관계를 이해하게 한다</li>
</ul>

<p>여기에 2025년 iOS 26의 Liquid Glass가 “재질”이라는 네 번째 축을 더했다.
컨트롤이 아래 콘텐츠의 빛과 색을 굴절시키며, 스타일이 정적인 그림이 아니라 동적인 재질로 바뀐 셈이다.</p>

<h3 id="swiftui로-구현하기">SwiftUI로 구현하기</h3>

<p>SwiftUI에서 스타일은 개별 뷰의 색을 덧바르는 것이 아니라, 시스템이 제공하는 의미론적(semantic) 값을 쓰는 일에서 시작한다.</p>

<div class="language-swift highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">VStack</span><span class="p">(</span><span class="nv">alignment</span><span class="p">:</span> <span class="o">.</span><span class="n">leading</span><span class="p">,</span> <span class="nv">spacing</span><span class="p">:</span> <span class="mi">8</span><span class="p">)</span> <span class="p">{</span>
    <span class="kt">Text</span><span class="p">(</span><span class="s">"오늘의 할 일"</span><span class="p">)</span>
        <span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">title2</span><span class="o">.</span><span class="nf">weight</span><span class="p">(</span><span class="o">.</span><span class="n">semibold</span><span class="p">))</span>   <span class="c1">// Dynamic Type 텍스트 스타일</span>
        <span class="o">.</span><span class="nf">foregroundStyle</span><span class="p">(</span><span class="o">.</span><span class="n">primary</span><span class="p">)</span>          <span class="c1">// 라이트/다크 자동 대응</span>
    <span class="kt">Text</span><span class="p">(</span><span class="s">"3개 남음"</span><span class="p">)</span>
        <span class="o">.</span><span class="nf">font</span><span class="p">(</span><span class="o">.</span><span class="n">subheadline</span><span class="p">)</span>
        <span class="o">.</span><span class="nf">foregroundStyle</span><span class="p">(</span><span class="o">.</span><span class="n">secondary</span><span class="p">)</span>
<span class="p">}</span>
<span class="o">.</span><span class="nf">padding</span><span class="p">()</span>
<span class="o">.</span><span class="nf">background</span><span class="p">(</span><span class="o">.</span><span class="n">regularMaterial</span><span class="p">,</span>               <span class="c1">// 시스템 반투명 재질</span>
            <span class="nv">in</span><span class="p">:</span> <span class="kt">RoundedRectangle</span><span class="p">(</span><span class="nv">cornerRadius</span><span class="p">:</span> <span class="mi">16</span><span class="p">))</span>
<span class="o">.</span><span class="nf">tint</span><span class="p">(</span><span class="o">.</span><span class="n">indigo</span><span class="p">)</span>                               <span class="c1">// 브랜드 색 한 곳에서 지정</span>
</code></pre></div></div>

<p>브랜드 스타일은 <code class="language-plaintext highlighter-rouge">tint</code>, 커스텀 <code class="language-plaintext highlighter-rouge">ButtonStyle</code>, 에셋 카탈로그의 색상 세트로 얹는다.
시스템 값 위에 브랜드를 얹으면 다크 모드, 고대비, Dynamic Type을 공짜로 얻는다.</p>

<h3 id="주의할-점">주의할 점</h3>

<ul>
  <li>웹에서 유행하는 스타일을 그대로 옮기기 전에, 그 스타일이 <strong>시스템 컨트롤의 기대 동작</strong>을 깨뜨리지 않는지 먼저 확인한다</li>
  <li>스타일이 강해질수록 <strong>접근성 설정</strong>(투명도 줄이기, 대비 높이기, 동작 줄이기)에 대응하는 코드가 따라와야 한다</li>
  <li>App Store 심사와 사용자 모두 “iOS 앱처럼 느껴지는가”를 본다. 차별화는 색, 타이포, 모션 톤에서 하고, 내비게이션 구조는 플랫폼을 따른다</li>
</ul>

<h2 id="웹과-ios-대응표">웹과 iOS 대응표</h2>

<table>
  <thead>
    <tr>
      <th>웹</th>
      <th>iOS / SwiftUI</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>CSS 변수로 정의한 디자인 토큰</td>
      <td>에셋 카탈로그 색상 세트, <code class="language-plaintext highlighter-rouge">Font</code> 텍스트 스타일</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">prefers-color-scheme</code></td>
      <td><code class="language-plaintext highlighter-rouge">colorScheme</code> 환경값, 의미론적 색상</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">backdrop-filter: blur()</code></td>
      <td><code class="language-plaintext highlighter-rouge">Material</code> (<code class="language-plaintext highlighter-rouge">.regularMaterial</code> 등), <code class="language-plaintext highlighter-rouge">glassEffect</code></td>
    </tr>
    <tr>
      <td>브랜드 가이드 문서</td>
      <td>HIG + 앱 자체 디자인 시스템</td>
    </tr>
    <tr>
      <td>프레임워크 테마(Bootstrap 등)</td>
      <td>시스템 컨트롤 스타일 + <code class="language-plaintext highlighter-rouge">ButtonStyle</code>, <code class="language-plaintext highlighter-rouge">LabelStyle</code></td>
    </tr>
  </tbody>
</table>

<h2 id="함께-읽기">함께 읽기</h2>

<ul>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/disignTechniques/">디자인 기법: UI/UX의 실행 도구</a></li>
  <li><a href="/%EB%94%94%EC%9E%90%EC%9D%B8/designSystem/">디자인 시스템: 일관된 사용자 경험의 기반</a></li>
</ul>]]></content><author><name>Geppetto</name></author><category term="디자인" /><category term="개념" /><category term="iOS" /><summary type="html"><![CDATA[사용자 인터페이스(UI)와 사용자 경험(UX)을 구성하는 일관된 시각적 접근 방식. 단순한 미적 선호를 넘어서는 종합적인 디자인 철학과 방법론.]]></summary></entry></feed>