figma-ios-navigation

Figma → 导航栏 + ViewController 基类

宿主配置：.cursor/bindings/host.json（说明见 PROJECT_BINDING）
颜色 / iconfont：分别查 color_map.json / iconfont_map.json，不要在 skill 里写死宿主类名。

⚡ QUICK_REF

识别导航栏      → 节点名含 nav/导航 OR 顶部 y≤60 且 width≥90%屏宽（规则不变）
数据来源        → design.json[node]
VC 基类         → host.json bases.view_controller
导航实现        → host.json navigation.strategy = system | custom
工具表达式      → host.json utils.*
iconfont        → iconfont_map.json
颜色/字体       → color_map.json / font_map.json

---

一、ViewController 基类（读 host.json）

生成 VC 时：

1. 基类 = host.bases.view_controller（Collection/Table 页用对应字段）
2. 类名前缀按 PROJECT_BINDING §0 / host.class_prefix
3. 若 host.vc_required_overrides 非空 → 每个 VC 都必须输出其中的方法；{has_custom_nav} 替换为 true（本页用了自定义导航）或 false
4. 若 host.base_is_objc == true → 重写基类方法必须加 @objc

vc_required_overrides 为空（vanilla）→ 不强制 isHideNavigationWhenPush 之类宿主钩子。

---

二、导航栏识别规则（优先级从高到低）

规则 1：节点命名（最高优先级）

节点 name 包含以下关键词之一（大小写不敏感）→ 判定为导航栏：

关键词（中文）	关键词（英文）	示例
导航 / 导航栏 / 导航条	navigation / navbar / nav bar / nav_bar	通用组件/导航栏/左右icon导航栏
顶栏 / 标题栏	titlebar / title bar	顶栏/深色
含 nav 且非业务词	nav-header / top-nav / navBar	nav-container

排除：节点名含 导航抽屉 / 侧边导航 / bottom navigation → 不是顶部导航栏。

规则 2：层级与位置特征（中优先级）

满足以下全部条件 → 判定为导航栏：

• 节点类型为 FRAME 或 INSTANCE
• 位于画布顶部：y ≤ 60（含状态栏高度）且 y + height ≤ 100
• 宽度接近全屏：width ≥ 屏幕宽度 × 0.9
• 高度合理：40 ≤ height ≤ 100

规则 3：子节点特征（辅助判断）

• 返回按钮：子节点名含 back / 返回 / < / arrow_left
• 标题文本：TEXT，水平居中，字号 ≥ 14pt
• 右侧按钮：子节点名含 more / share / help / ?

规则 4：INSTANCE 类型

名称含 通用组件/导航栏/* / NavBar/* / 或 host.navigation.custom_nav_class 类名 → 判定为导航栏。
系统控件/Bars_Status/* → 状态栏占位，跳过（见 to-code-conventions）。

INSTANCE 已由阶段 1 展开：读 design.json[id].children，iconfont / TEXT 按 frame.relative.x 分左/中/右。

---

三、导航栏代码写法