XR 组件:工具栏
了解 Material 3 Expressive 组件如何适配扩展现实设备
TIP
XR 指南主要面向设计师。如需了解代码中的实现,请参阅设计套件。
扩展现实(XR)界面有特殊的设计要求,例如需要在 3D 空间中呈现应用。Material 提供了 XR 工具栏,并附带自定义规范和指南。更多详情请参阅 XR 开发者文档。
变体
工具栏轨道器轨道器是控制空间面板内内容的浮动元素。详细了解轨道器只有一种变体,其设计对应悬浮工具栏悬浮工具栏浮动在页面内容之上,可提供上下文相关的动态操作。详细了解工具栏。该控件可配置为水平或垂直方向。前往 XR 工具栏 API 参考

- 水平悬浮工具栏
- 垂直悬浮工具栏
结构

- 容器
- 置入的组件
颜色与海拔
XR 通过颜色表达 UI 元素和轨道器的海拔。借助空间海拔,工具栏会沿 Z 轴显示在空间面板在 Android XR 中,空间面板是用于 UI 元素、交互组件和沉浸式内容的容器。详细了解空间面板上方。抬高后的工具栏可使用以下任一颜色选项:

- 表面容器
- 表面容器(高)
- 表面容器(最高)
- 第三色容器
尺寸


用法
将工具栏置于轨道器轨道器是控制空间面板内内容的浮动元素。详细了解轨道器中,可获得更具沉浸感的体验。目前,该空间特性仅在全空间全空间是 Android XR 的沉浸模式,支持空间组件。详细了解全空间中可用。在主空间主空间兼容移动应用和大屏应用,但不支持空间组件。详细了解主空间中,请使用与主体内容位于同一平面的常规工具栏,以模拟 2D 体验。
行为
局部环境(推荐)
置于局部环境时,工具栏轨道器位于其所控制空间面板的底部中央。
当布局或内容变化时,它会重新定位。
全局环境
置于全局环境时,工具栏轨道器位于应用底部中央。
当布局或内容变化时,它仍锚定于应用。
展开与折叠
包含五个以上操作项的工具栏轨道器可展开和折叠,以显示或隐藏额外内容。
展开时,工具栏轨道器会保持在相邻空间面板的边界内。
也可将较复杂的工具栏拆分为多个工具栏。
其他工具栏
在某些情况下,全空间应用中可出现多个工具栏轨道器,这些控件可置于全局环境或局部环境中。
放置
偏移与嵌入定位
在全空间中,工具栏轨道器可放置在空间面板旁边,或与空间面板重叠。

- 向外偏移 20dp,或
- 向内嵌入 12dp

水平对齐


垂直对齐


空间面板对齐
默认情况下,工具栏轨道器与空间面板居中对齐。可根据特定的用户需求调整其放置位置,例如优化人体工学体验或适配从右到左(RTL)语言。

避免将垂直工具栏轨道器放置在空间面板之间。
这会破坏界面结构,并可能使用户难以找到该工具栏。
