Apple HIG Designer은(는) 무엇을 하나요?
Apple의 인간 인터페이스 가이드라인(HIG)을 따라 아름답고 네이티브한 iOS 앱을 디자인하세요. 네이티브 컴포넌트, 적절한 타이포그래피, 시맨틱 색상 및 Apple의 디자인 원칙을 사용하여 접근 가능하고 직관적인 인터페이스를 만듭니다.
이 스킬이 하는 일
네이티브 느낌이 나고 Apple 가이드라인을 따르는 iOS 앱을 디자인하고 구축하는 데 도움을 줍니다:
- iOS 컴포넌트 생성 - SwiftUI 및 UIKit 컴포넌트 만들기
- 디자인 검증 - Apple HIG 준수 여부 확인
- 접근성 보장 - VoiceOver, Dynamic Type, 색상 대비
- 디자인 원칙 적용 - 명확성, 위임, 깊이
- 시맨틱 색상 사용 - 자동 다크 모드 지원
- 타이포그래피 구현 - San Francisco 폰트 시스템
- 간격 규칙 준수 - 8pt 그리드 시스템 및 안전 영역
Apple 디자인 원칙
1. 명확성 (Clarity)
콘텐츠를 명확하고 집중되게 만듭니다.
텍스트는 모든 크기에서 읽기 쉽고, 아이콘은 정확하고 명료하며, 장식은 미묘하고 적절하며, 기능성에 초점을 맞춘 디자인을 지향합니다.
// ✅ 명확하고 집중된 콘텐츠
Text("Welcome back, Sarah")
.font(.title)
.foregroundColor(.primary)
// ❌ 불명확하고 복잡함
Text("Welcome back, Sarah!!!")
.font(.title)
.foregroundColor(.red)
.background(.yellow)
.overlay(Image(systemName: "star.fill"))
2. 위임 (Deference)
UI는 사람들이 콘텐츠를 이해하고 상호 작용하도록 돕지만, 콘텐츠와 경쟁하지 않습니다.
인터페이스는 콘텐츠에 위임하며, 콘텐츠에 초점을 맞추고 숨 쉴 공간을 주는 가벼운 시각적 처리를 사용합니다.
// ✅ 콘텐츠 중심
VStack(alignment: .leading, spacing: 8) {
Text("Article Title")
.font(.headline)
Text("Article content goes here...")
.font(.body)
.foregroundColor(.secondary)
}
.padding()
// ❌ 방해가 되는 UI
VStack(spacing: 8) {
Text("Article Title")
.font(.headline)
.foregroundColor(.white)
.background(.blue)
.border(.red, width: 3)
}
3. 깊이 (Depth)
시각적 레이어와 사실적인 움직임은 위계를 전달하고 사람들이 관계를 이해하도록 돕습니다.
뚜렷한 시각적 레이어와 사실적인 움직임은 생동감을 불어넣고 이해를 촉진합니다. 터치와 발견 가능성은 즐거움을 높이고 컨텍스트를 잃지 않고 기능에 접근할 수 있게 합니다.
// ✅ 명확한 깊이 위계
ZStack {
Color(.systemBackground)
VStack {
// 입체감 있는 카드
CardView()
.shadow(radius: 8)
}
}
// 깊이를 위한 블러 사용
Text("Content")
.background(.ultraThinMaterial)
iOS UI 컴포넌트
네비게이션 패턴
1. 네비게이션 바 (Navigation Bar)
상단의 탐색 및 액션 바입니다.
NavigationStack {
List {
Text("Item 1")
Text("Item 2")
}
.navigationTitle("Title")
.navigationBarTitleDisplayMode(.large)
.toolbar {
ToolbarItem(placement: .navigationBarTrailing) {
Button("Add") {
// Action
}
}
}
}
가이드라인:
- 최상위 뷰에는 큰 제목 사용
- 상세 뷰에는 인라인 제목 사용
- 현재 컨텍스트에 관련된 액션 유지
- 최대 2-3개의 툴바 항목
2. 탭 바 (Tab Bar)
최상위 목적지를 위한 하단 네비게이션입니다.
TabView {
HomeView()
.tabItem {
Label("Home", systemImage: "house")
}
SearchView()
.tabItem {
Label("Search", systemImage: "magnifyingglass")
}
ProfileView()
.tabItem {
Label("Profile", systemImage: "person")
}
}
가이드라인:
- 최대 3-5개 탭
- 아이콘은 SF Symbols 사용
- 레이블은 간결하게 (한 단어)
- 탭을 숨기거나 비활성화하지 않음
- 같은 뷰에 탭 바와 툴바를 함께 사용하지 않음
3. 리스트 (List)
스크롤 가능한 항목 목록입니다.
List {
Section("Today") {
ForEach(items) { item in
NavigationLink {
DetailView(item: item)
} label: {
HStack {
Image(systemName: item.icon)
.foregroundColor(.accentColor)
Text(item.title)
}
}
}
}
}
.listStyle(.insetGrouped)
리스트 스타일:
.plain- 가장자리에서 가장자리로 행.insetGrouped- 둥근 모서리, 들여쓰기된 섹션 (iOS 기본값).sidebar- 네비게이션 사이드바 용
4. 시트 (Sheet, 모달)
콘텐츠를 모달로 표시합니다.
struct ContentView: View {
@State private var showSheet = false
var body: some View {
Button("Show Details") {
showSheet = true
}
.sheet(isPresented: $showSheet) {
DetailView()
.presentationDetents([.medium, .large])
}
}
}
시트 디텐트:
.medium- 화면 절반.large- 전체 화면- 사용자 지정 높이 가능
폼 컨트롤
1. 버튼 (Button)
기본 액션 컨트롤입니다.
// 채워진 버튼 (기본 액션)
Button("Continue") {
// Action
}
.buttonStyle(.borderedProminent)
// 테두리 버튼 (보조 액션)
Button("Cancel") {
// Action
}
.buttonStyle(.bordered)
// 일반 버튼 (3차 액션)
Button("Learn More") {
// Action
}
.buttonStyle(.plain)
버튼 계층:
- Prominent - 기본 액션 (화면 당 하나)
- Bordered - 보조 액션
- Plain - 3차 액션, 링크
가이드라인:
- 최소 터치 대상: 44x44 포인트
- 버튼 레이블에는 동사 사용
- 파괴적인 액션은 확인 필요
2. 텍스트 필드 (TextField)
텍스트 입력 컨트롤입니다.
@State private var username = ""
@State private var password = ""
VStack(alignment: .leading, spacing: 16) {
// 표준 텍스트 필드
TextField("Username", text: $username)
.textFieldStyle(.roundedBorder)
.textContentType(.username)
.textInputAutocapitalization(.never)
.autocorrectionDisabled()
// 보안 필드
SecureField("Password", text: $password)
.textFieldStyle(.roundedBorder)
.textContentType(.password)
}
텍스트 콘텐츠 유형:
.username- 사용자 이름 필드.password- 비밀번호 필드.emailAddress- 이메일 필드.telephoneNumber- 전화번호.creditCardNumber- 신용카드
3. 토글 (Toggle)
부울 컨트롤 (스위치)입니다.
@State private var isEnabled = false
Toggle("Enable notifications", isOn: $isEnabled)
.toggleStyle(.switch)
가이드라인:
- 레이블은 토글이 제어하는 것을 설명
- 효과는 즉각적이어야 함
- 이진 선택에만 사용
4. 피커 (Picker)
선택 컨트롤입니다.
@State private var selectedSize = "Medium"
let sizes = ["Small", "Medium", "Large"]
// 메뉴 스타일
Picker("Size", selection: $selectedSize) {
ForEach(sizes, id: \.self) { size in
Text(size).tag(size)
}
}
.pickerStyle(.menu)
// 세그먼트 스타일 (2-5 옵션용)
Picker("Size", selection: $selectedSize) {
ForEach(sizes, id: \.self) { size in
Text(size).tag(size)
}
}
.pickerStyle(.segmented)
피커 스타일:
.menu- 드롭다운 메뉴 (기본값).segmented- 세그먼트 컨트롤 (2-5 옵션).wheel- 스크롤 가능한 휠.inline- 인라인 목록 (폼에서)
카드 및 컨테이너
카드 뷰 (Card View)
struct CardView: View {
var body: some View {
VStack(alignment: .leading, spacing: 12) {
Text("Title")
.font(.headline)
Text("Description goes here with some details about the content.")
.font(.subheadline)
.foregroundColor(.secondary)
.lineLimit(2)
Spacer()
Button("Action") {
// Action
}
.buttonStyle(.borderedProminent)
}
.padding()
.frame(width: 300, height: 200)
.background(Color(.systemBackground))
.cornerRadius(12)
.shadow(color: .black.opacity(0.1), radius: 8, x: 0, y: 4)
}
}
타이포그래피
San Francisco 폰트 시스템
최적의 가독성을 위해 설계된 Apple 시스템 폰트입니다.
// Dynamic Type 텍스트 스타일
Text("Large Title").font(.largeTitle) // 34pt
Text("Title").font(.title) // 28pt
Text("Title 2").font(.title2) // 22pt
Text("Title 3").font(.title3) // 20pt
Text("Headline").font(.headline) // 17pt semibold
Text("Body").font(.body) // 17pt regular
Text("Callout").font(.callout) // 16pt
Text("Subheadline").font(.subheadline) // 15pt
Text("Footnote").font(.footnote) // 13pt
Text("Caption").font(.caption) // 12pt
Text("Caption 2").font(.caption2) // 11pt
Dynamic Type과 사용자 지정 폰트
// Dynamic Type에 따라 크기가 조절되는 사용자 지정 폰트
Text("Custom Text")
.font(.custom("YourFont-Regular", size: 17, relativeTo: .body))
폰트 두께
Text("Light").fontWeight(.light)
Text("Regular").fontWeight(.regular)
Text("Medium").fontWeight(.medium)
Text("Semibold").fontWeight(.semibold)
Text("Bold").fontWeight(.bold)
Text("Heavy").fontWeight(.heavy)
타이포그래피 가이드라인
권장 사항:
- ✅ 일관성을 위해 시스템 폰트(San Francisco) 사용
- ✅ 접근성을 위해 Dynamic Type 지원
- ✅ 시맨틱 텍스트 스타일 사용 (.headline, .body 등)
- ✅ 본문 텍스트 최소 크기: 17pt
- ✅ 줄 간격: 글꼴 크기의 120-145%
주의 사항:
- ❌ 너무 많은 글꼴 크기 사용 금지 (시스템 스타일 고수)
- ❌ 텍스트를 11pt보다 작게 만들지 않음
- ❌ 긴 텍스트에 모두 대문자 사용 금지
- ❌ Dynamic Type 비활성화 금지
색상
시맨틱 색상
라이트/다크 모드에 자동으로 적응하는 색상입니다.
// UI 요소 색상
Color(.label) // 기본 텍스트
Color(.secondaryLabel) // 보조 텍스트
Color(.tertiaryLabel) // 3차 텍스트
Color(.quaternaryLabel) // 워터마크 텍스트
Color(.systemBackground) // 기본 배경
Color(.secondarySystemBackground) // 보조 배경
Color(.tertiarySystemBackground) // 3차 배경
Color(.systemFill) // 채우기 색상
Color(.secondarySystemFill)
Color(.tertiarySystemFill)
Color(.quaternarySystemFill)
Color(.separator) // 구분선
Color(.opaqueSeparator) // 불투명 구분선
시스템 색상
// 표준 시스템 색상 (다크 모드에 적응)
Color(.systemRed)
Color(.systemOrange)
Color(.systemYellow)
Color(.systemGreen)
Color(.systemMint)
Color(.systemTeal)
Color(.systemCyan)
Color(.systemBlue)
Color(.systemIndigo)
Color(.systemPurple)
Color(.systemPink)
Color(.systemBrown)
Color(.systemGray)
다크 모드와 사용자 지정 색상
// 적응형 색상 정의
extension Color {
static let customBackground = Color("CustomBackground")
}
// Assets.xcassets에서 색상 세트 생성:
// - Any Appearance: #FFFFFF
// - Dark Appearance: #000000
색상 대비 가이드라인
WCAG AA 준수:
- 일반 텍스트: 최소 4.5:1 대비율
- 큰 텍스트 (24pt+): 최소 3:1 대비율
- UI 컴포넌트: 3:1 대비율
사용자 지정 색상:
- Increase Contrast 활성화 상태에서 테스트
- 중요한 텍스트의 경우 7:1 목표
- 두 모드 모두에서 충분한 대비 제공
간격 및 레이아웃
8포인트 그리드 시스템
모든 간격은 8의 배수여야 합니다.
// 간격 값
.padding(8) // 8pt
.padding(16) // 16pt (표준)
.padding(24) // 24pt
.padding(32) // 32pt
.padding(40) // 40pt
.padding(48) // 48pt
// 가장자리별 패딩
.padding(.horizontal, 16)
.padding(.vertical, 24)
.padding(.top, 16)
.padding(.bottom, 16)
안전 영역 (Safe Areas)
기기 안전 영역을 존중합니다.
// 안전 영역 내 콘텐츠 (기본값)
VStack {
Text("Content")
}
// 안전 영역을 넘어 확장
VStack {
Color.blue
}
.ignoresSafeArea()
// 상단만 확장
VStack {
Color.blue
}
.ignoresSafeArea(edges: .top)
터치 대상
최소 상호 작용 크기: 44x44 포인트.
Button("Tap") {
// Action
}
.frame(minWidth: 44, minHeight: 44)
간격 가이드라인
// 컴포넌트 간격
VStack(spacing: 8) { // 좁은 간격
Text("Line 1")
Text("Line 2")
}
VStack(spacing: 16) { // 표준 간격
Text("Section 1")
Text("Section 2")
}
VStack(spacing: 24) { // 넓은 간격
SectionView()
SectionView()
}
접근성
VoiceOver 지원
시각 장애 및 저시력 사용자를 위한 화면 읽기 프로그램입니다.
// 접근성 레이블
Image(systemName: "heart.fill")
.accessibilityLabel("Favorite")
// 접근성 값
Slider(value: $volume)
.accessibilityLabel("Volume")
.accessibilityValue("\(Int(volume * 100))%")
// 접근성 힌트
Button("Share") {
share()
}
.accessibilityHint("Shares this item with others")
// 요소 그룹화
HStack {
Image(systemName: "person")
Text("John Doe")
}
.accessibilityElement(children: .combine)
// VoiceOver에서 숨기기
Image("decorative")
.accessibilityHidden(true)
Dynamic Type
사용자가 선호하는 텍스트 크기를 지원합니다.
// 시스템 폰트로 자동 지원
Text("This text scales")
.font(.body)
// 크기 제한 (필요한 경우)
Text("This text has limits")
.font(.body)
.dynamicTypeSize(...DynamicTypeSize.xxxLarge)
// Dynamic Type과 사용자 지정 폰트
Text("Custom font")
.font(.custom("YourFont", size: 17, relativeTo: .body))
색맹
색맹 사용자를 위해 디자인합니다.
// 색상에만 의존하지 않음
HStack {
Image(systemName: "checkmark.circle.fill")
.foregroundColor(.green)
Text("Success")
}
// 색상만 사용
Circle()
.fill(.green)
// ❌ 색상만
// 도형/아이콘과 함께 사용
HStack {
Image(systemName: "checkmark.circle.fill")
Circle().fill(.green)
}
// ✅ 색상 + 도형
동작 줄이기 (Reduce Motion)
사용자의 동작 선호도를 존중합니다.
@Environment(\.accessibilityReduceMotion) var reduceMotion
var animation: Animation {
reduceMotion ? .none : .spring()
}
Button("Animate") {
withAnimation(animation) {
// Animate
}
}
대비 증가 (Increase Contrast)
고대비 모드를 지원합니다.
... (원본 SKILL.md에서 잘린 부분)