SuperAPI AI Directory

hig-principles

General & other

View repository

Updated 10-16 09:30

About this skill

Platform Design Principles (HIG)

Reference source:Apple Human Interface Guidelines、Material Design 3

Applicable scenarios

  • Mobile App design (iOS / Android)
  • Desktop apps (macOS / Windows)
  • Cross-platform consistency
  • Platform-native experience

Inapplicable scenarios

  • Pure Web apps (use visual-style + responsive-design)
  • Internal tools (no need for a platform-native feel)

The Four Apple HIG Principles

Reference source:Apple HIG

1. Clarity

"文字可读、图标可识别、装饰不干扰功能"

具体:
  - 字号足够大(最小 11pt iOS / 14sp Android)
  - 图标含义明确,不需要猜
  - 负空间引导注意力
  - 颜色和字体引导层级

2. Deference

"UI 服务于内容,不抢夺注意力"

具体:
  - 内容优先,界面退后
  - 透明 / 模糊背景(让内容透出)
  - 极简的 chrome(导航栏、工具栏)
  - 不用过度装饰

3. Depth

"用层级、动效、阴影传达空间关系"

具体:
  - 模态层级(push / present)
  - 视差 / 视差滚动
  - 阴影表达悬浮
  - 过渡动画表达关系

4. Consistency

"遵循平台惯例(导航模式、手势、图标含义)"

具体:
  - 用平台原生组件(不要自造)
  - 遵循平台手势(左滑返回 / 下拉刷新)
  - 系统图标含义统一
  - 不要让 Android 看起来像 iOS

Material Design 3 Principles

Reference source:Material Design 3

1. Adaptive(自适应)
   - 大小屏适配
   - 浅色/暗黑模式
   - 用户偏好(动效减少 / 大字号)

2. Expressive(表达性)
   - 通过颜色 / 字体 / 形状传达品牌
   - Dynamic Color(基于壁纸生成主题)
   - 个性化主题

3. Useful(有用)
   - 解决真实问题
   - 不是为了好看而存在

4. Accessible(无障碍)
   - 默认可访问
   - 键盘 / 触控 / 语音支持

5. Responsive(响应)
   - 用户操作有即时反馈
   - 状态变化平滑过渡

Platform comparison

| 维度 | iOS | Android | macOS | Windows |
|------|-----|---------|-------|---------|
| 默认字体 | SF Pro | Roboto | SF Pro | Segoe UI |
| 触控目标 | 44×44pt | 48×48dp | - | - |
| 圆角 | 中等(Liquid Glass 大) | 中等 | 小 | 小 |
| 导航 | Tab Bar / Nav Bar | Bottom Nav / Drawer | Toolbar / Sidebar | Ribbon |
| 返回手势 | 左滑边缘 | 系统返回键 / 边缘 | 标题栏 < | 标题栏 ← |
| 主题 | 浅/深 / Liquid Glass | 浅/深 / Dynamic Color | 浅/深 | 浅/深 |

iOS 26 Liquid Glass

2025 年起 Apple 推出 Liquid Glass 设计语言:

特点:
  - 半透明 + 模糊背景
  - 流畅响应触控
  - 跨平台一致(iOS/iPadOS/macOS/watchOS/tvOS)
  - 强调深度和层次

设计要素:
  - 玻璃质感的卡片和导航
  - 内容透过界面元素若隐若现
  - 触控时实时反馈(流体形变)
  - 大圆角(16~24pt)

Common mobile patterns

iOS patterns

导航:
  - Tab Bar(底部,最多 5 项)
  - Navigation Bar(顶部,含返回)
  - 模态(present from bottom)
  - 大标题(Large Title)

手势:
  - 左滑返回(屏幕边缘)
  - 下拉刷新
  - 长按预览(3D Touch / Haptic Touch)

交互:
  - Action Sheet(底部弹起选项)
  - Alert(中央对话框)
  - Toast(不推荐,用 Banner)

Android patterns

导航:
  - Bottom Navigation(最多 5 项)
  - Top App Bar(菜单按钮 / 操作)
  - Navigation Drawer(侧边抽屉)
  - FAB(Floating Action Button)

手势:
  - 边缘左滑返回(系统手势)
  - 下拉刷新
  - 长按多选

交互:
  - Bottom Sheet(底部上拉)
  - Snackbar(底部提示,含撤销)
  - Material Dialog

Output format

## 平台设计:[App 名称]

### 目标平台
- iOS(iOS 26+)
- Android(Android 13+)

### 应用的原则

iOS:
  ✅ 清晰:用 SF Pro,字号 ≥ 17pt
  ✅ 顺从:列表项用透明背景
  ✅ 深度:模态采用 sheet 样式
  ✅ 一致性:用原生 Tab Bar,不自造

Android:
  ✅ Adaptive:支持暗黑 + Dynamic Color
  ✅ Expressive:品牌色作为种子色
  ✅ 用 Material 3 组件
  ✅ Bottom Navigation(4 项)

### 平台差异处理

| 元素 | iOS | Android |
|------|-----|---------|
| 顶部导航 | Navigation Bar 大标题 | Top App Bar |
| 底部导航 | Tab Bar | Bottom Navigation |
| 列表项操作 | 左滑显示 | 长按显示菜单 |
| 删除确认 | Action Sheet | Material Dialog |
| 提示 | Banner(顶部) | Snackbar(底部) |

### 共享设计语言
- 品牌色:[#XXXXXX]
- 主要字体:[西文/中文]
- 圆角:12pt(iOS)/ 12dp(Android)

Workflow

1. 确定目标平台
2. 选择主导原则(HIG / Material)
3. 列出平台特定模式
4. 共享设计语言(品牌色 / 字体)
5. 列出平台差异处理
6. 输出平台设计说明
7. 转交移动端开发

Quality self-check

□ 是否选对了平台原则
□ 是否用了平台原生组件
□ 是否遵循平台手势
□ 触控目标是否符合规范(44pt iOS / 48dp Android)
□ 是否处理了平台差异
□ 是否考虑暗黑模式
□ 是否考虑系统级偏好(大字号 / 减少动画)

Common pitfalls

  1. Designing iOS as Android— losing the native feel
  2. Forcing uniformity— imposing a FAB on iOS or a Tab Bar on Android
  3. Not using native components— custom components are unfamiliar to users
  4. Ignoring gestures— iOS has no swipe-back gesture
  5. Touch targets too small— < 44pt is hard for users to tap
  6. No dark mode support— many iOS users use dark mode
  7. Not responding to system preferences— layout breaks when large font sizes are set

Supporting templates

  • templates/ios-design-template.md — iOS design template
  • templates/android-design-template.md — Android design template
  • templates/cross-platform-template.md — cross-platform template

Collaboration with other skills

上游:
  product-manager 的需求和目标平台

平行:
  visual-style → 视觉风格
  responsive-design → 不同屏幕尺寸
  accessibility → 系统级偏好

下游:
  design-handoff → 平台特定要求交接
  转交移动端前端工程师