组件平台选型：先定任务，再定呈现

状态：本页是文档层面的选型建议；设计暂停。表中各端“默认”都是 YUDS 建议的初始呈现，HarmonyOS 列均为运行未执行的 H 候选。平台实现与运行未验证；运行、实机与视觉验证全部未执行，目前只有文档建议和来源核查。 更新：2026-10-20（官方来源核查日期）。 所属章节：跨平台与智能交互

本页说明“同一组件在不同平台选什么呈现”，不是 SDK 选定清单，也不是把 SAP、Apple 或 Android 建议升级为所有平台的强制规则。组件的值、权限、事件、层与恢复契约仍由各自主档唯一维护。

入口：组件行为见基础组件与交互契约；平台目标、国际化与能力证据见平台适配、国际化与输入能力；贯穿任务见接入示例：共享资料清单。

1. 使用方法与优先级

1. 先定任务：是触发动作、选择候选、浏览对象还是长时间编辑？不是所有可点击集合都叫菜单。
2. 再定能力：输入值、原始稿、允许范围、原生控件能力、可访问性及服务是否匹配？原生控件不能无损表达时不可静默截断或改义。
3. 再定容器：依当前可用内容空间、键盘、文字增长、并列参照需要与任务长度选内联、popover、sheet 或完整页，不只按设备名称。
4. 最后核对生命周期：模态性、背景可达性、关闭意图、焦点/导航返回、权限与异步结果必须有明确拥有者。

发生冲突时，先守住授权、数据与交互契约，再选择另一个适配呈现；不要为了复刻平台外观改写“取消”“接受”“保存”。无法实现等价任务时声明受限/未提供并给真实替代，不宣称跨端完成。

共同基础固定：七角色＋固定 step 沿 Token 契约、主题与状态，文字三角色九档沿排版层级与文字可读性，命中与布局沿布局、响应式与信息密度。平台调用语法可不同；不新增颜色别名、不引入平台样式值作为第二份公共 token 真源。

1.1 如何读四端表

• 表中“默认”均指 YUDS 建议的初始呈现，仍受组件主档、任务与目标环境制约；不是某平台禁止其他控件。
• “原生”指选定框架中语义与能力匹配的候选，必须登记具体控件、OS/框架版本并验证。名称出现不等于 API 和可访问性已经证实。
• H 候选：HarmonyOS 暂以完整页面、内联内容和显式按钮作为概念设计候选；没有证实对应原生组件/API、默认样式、返回处理或辅助技术行为。所有 H 候选运行未执行。此标记不表示实现受支持，更不授权照搬 Android 行为。
• 同组列出多个组件时，每个组件继承同一呈现选择，但各自状态/事件仍独立；表不新增组件编号，也不改变目录登记。

2. 容器选择：不是“移动端一律 sheet”

Apple 官方 HIG 区分 sheet 的相关短任务与复杂流程替代，iOS/iPadOS 可有模态和非模态 sheet；popover 应承载少量相关功能，紧凑视图宜改用充分利用空间的呈现。这里不据此规定所有 iOS sheet 都是模态。[P09][P10]

Android Compose 官方提供 ModalBottomSheet 及其显示/隐藏状态机制；这证明一个可选实现入口，不证明所有筛选、菜单或编辑都应该使用 bottom sheet，也不证明其他技术栈的等价行为。[A12]

2.1 切换容器时必须迁移什么

保持当前会话、对象与范围、父原稿/子原稿、基准及权限代次、已发任务身份和当前可访问定位。popover 变 sheet 不接受候选、不提交、不取消远端请求。模态性变化必须采用浮层组件：对话框、抽屉与提示的 CMP-LAYER-RESP；旧触发器已不存在时按 LP-G05 选择有效返回位置，不盲目恢复焦点。

原生自动关闭与 YUDS 显式接受不兼容时，选择能保留原稿且显式接受的容器；不要把平台“保存工作”的建议解释成允许发远端业务写入。iOS 原生 popover 的自动关闭建议与 YUDS 草稿事务必须在实例中协调，必要时改 sheet/完整页。[P10]

3. 动作、输入与选择

完整行为分别见操作组件：按钮与动作入口、输入组件：文本、结构化编辑与专用输入、选择组件：值、范围与层级。

不把 iOS 的复选语义强制绘制成 Web 方框，也不把 Android 的菜单样式直接当 HarmonyOS 原生标准。表内没有要求所有平台具有同名组件 API。

4. 导航、浮层与内容容器

主档：导航组件：位置、切换与返回、浮层组件：对话框、抽屉与提示、容器组件：分组、展开与工作区组织、数据表与交互网格契约。

Android 的列表—详情官方布局支持按空间呈现不同数量的面板；表中“宽窗双区、窄窗顺序”为 YUDS 选型推导，不指定库版本、最低宽度或保证自动状态恢复。[A13]

5. 反馈与专业能力的降级

主档：反馈组件：让状态和结果可理解及所列专业组件所属章节。纯展示组件不因跨端表而获得写事务。

这些扩展只是索引性选型，不宣布专业族实现完备。每个实例仍需查各主档的非用途、数据安全及能力门槛。

6. 三个容易选错的组合

1. 筛选不是命令菜单：分类只有少量互斥值可直接单选；搜索、日期区间、多选组合属于筛选任务。窄窗改 sheet/完整筛选页，保留原稿、应用和清除边界；关闭不偷偷应用。
2. 值帮助不是详情页缩略版：用户要选择候选时保留候选身份与接受语义；需要深入核查则进入明确详情再回选择会话。打开详情不能自动接受候选。
3. 保存失败不是更强的模态需求：先在当前表单保持输入、错误与真实恢复；只有必须决定的独立冲突/离开任务才阻断。不要在每个网络错误上叠 alert 遮住错误字段。

对照装配与完整回程：接入示例：共享资料清单。

7. 选型记录与验证门槛

每个实例记录：组件主档／任务、平台与版本、呈现候选、为何不用其他呈现、原生能力缺口、背景可达性、显式与手势关闭、值/草稿所有者、焦点或导航返回、增长与键盘、权限变化、真实回执、替代路径及证据状态。

以下检查应分别报告，不互相换算：

• 文档一致性：采用主档术语且没有改变事件、颜色与文字职责。
• 结构验证：实际框架的名称、角色、值、选中、错误与层身份。
• 任务验证：普通输入和辅助技术都能完成打开、选择、接受/取消、保存、结果与返回。
• 变化验证：窗口变化、最大目标字号、IME、后台恢复、撤权、未知结果和迟到回执。
• 不适用：写明哪项任务不存在或能力未提供、为何、替代是否等价；不能用“不适用”掩盖承诺任务不可达。

当前上述运行、实机与视觉验证全部未执行；只存在文档建议和来源核查。

8. 官方依据与采用边界

既有平台来源详见平台补充来源 ↗。P01—P08、A01—A11 仍按原记录的读取范围使用；H01—H03 未验证，不能推导华为平台默认。下列来源于 2026-10-20 核查，不新增最低 OS 或 SDK 版本承诺。

• P09 Apple Sheets：官方 HIG ↗。HTML 为 JS 壳，随后获取并读取其官方 Markdown 正文。采用相关短任务/复杂任务替代与模态区别；不照抄外观、尺寸或示例保存语义。
• P10 Apple Popovers：官方 HIG ↗。HTML 为 JS 壳，官方 Markdown 正文已读。采用小范围功能、紧凑视图替代、避免嵌套与意外关闭保护；YUDS 显式接受和远端写入边界优先，不将自动关闭等同保存请求。
• A12 Android Compose Bottom sheets：官方组件指南 ↗。正文已读，包含 ModalBottomSheet 与 SheetState；仅作为 Compose 候选，未验证项目采用版本或默认无障碍行为。
• A13 Android Build a list-detail layout：官方布局指南 ↗。官方正文已读取；用作空间适配的列表详情组织参考，不将代码示例视为 YUDS 任务状态恢复或返回契约的实现证据。
• S01 SAP Page Layouts and Floorplans v1-136：官方页面 ↗。已读取正文。借鉴布局与任务模板分层，不采用 SAP 组件的尺寸/品牌/业务规则，不宣称版本为全站最新。

上表的逐组件默认是结合 YUDS 已有合同的编辑决策，不逐行归因于这些官方文件。官方未覆盖的细节按 YUDS 建议标注，并等待真实平台证据。

相关页面：质量基线、门禁与验收证据。