Unified Title Bar Toolbar
统一标题栏工具栏
统一标题栏工具栏(Unified Title Bar Toolbar)是放进窗口标题区的命令栏,可由用户自定义,并提供常用的文档或视图操作。
生活中的例子
笔记 App 把常用工具放进可拖动的标题栏区域。工具包括侧边栏切换、搜索、共享和格式。
主要部分
- 01统一标题与拖动区域
- 02窗口命令项目分组
- 03选中感知项目状态
- 04自定义与溢出路径
什么时候用
当常用命令属于当前窗口,而且直接操作和自定义内容有助于下方工作时使用。
什么时候不要用
不要塞入低频或破坏性命令。依赖选中内容的项目可以留在原位并更新启用或选中状态;应避免不必要的布局位移,并且所有重要命令仍须能在菜单栏找到。
代码里的名称
AppKit NSToolbar / SwiftUI toolbar 上线前要检查
检查支持的 macOS 版本,以及 AppKit 或 SwiftUI 集成。检查符合平台惯例的焦点与键盘操作。再检查 VoiceOver、全键盘控制、窗口缩放和多窗口状态。需要时,也要检查恢复、多语言与减少动态效果。
预期结果:在原生 macOS 应用中使用或检查 统一标题栏工具栏 (Unified Title Bar Toolbar),并遵守平台惯例。 用户场景:笔记 App 把常用工具放进可拖动的标题栏区域。工具包括侧边栏切换、搜索、共享和格式。 macOS 概念或控件:统一标题栏工具栏 (Unified Title Bar Toolbar)。 适用理由:当常用命令属于当前窗口,而且直接操作和自定义内容有助于下方工作时使用。 不应使用的情况:不要塞入低频或破坏性命令。依赖选中内容的项目可以留在原位并更新启用或选中状态;应避免不必要的布局位移,并且所有重要命令仍须能在菜单栏找到。 平台要求:列出支持的 macOS 版本。说明哪些部分由 AppKit 或 SwiftUI 负责,以及两者如何连接。定义窗口、菜单、焦点、键盘、状态保存、恢复与多窗口行为。 平台无障碍与韧性:使用正确的无障碍功能接口(Accessibility API)。检查 VoiceOver 与全键盘控制(Full Keyboard Access)。支持多语言、对比度与减少动态效果,并在重新打开后保留用户状态。 验收标准:在支持的 macOS 版本,用键盘与 VoiceOver 检查行为。窗口缩放、焦点、状态恢复,以及 AppKit 或 SwiftUI 集成都符合 macOS 惯例。 证据与限制(证据边界):它只代表该来源的官方说法。其他平台或团队可能有不同用法。 待确认:支持的 macOS 版本、AppKit 或 SwiftUI 架构、窗口模式、沙盒与应用权限限制、数据保留规则,以及无障碍目标。
检查这份需求
请 AI 编程助手检查当前如何使用 统一标题栏工具栏 (Unified Title Bar Toolbar)。 定义:统一标题栏工具栏(Unified Title Bar Toolbar)是放进窗口标题区的命令栏,可由用户自定义,并提供常用的文档或视图操作。 生产环境检查:检查支持的 macOS 版本,以及 AppKit 或 SwiftUI 集成。检查符合平台惯例的焦点与键盘操作。再检查 VoiceOver、全键盘控制、窗口缩放和多窗口状态。需要时,也要检查恢复、多语言与减少动态效果。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。