子空间修饰符

SubspaceModifier 类似于 Subspace 中可组合项的 Compose 修饰符。借助 SubspaceModifier，您可以在 3D 空间中操纵可组合项，从而帮助您定位、旋转 3D 布局节点并为其添加行为。

布局

默认情况下，Subspace 受建议的应用查看空间的限制。在测量子空间组件的布局时，系统会使用这些边界，这与 2D Compose 布局中的边界类似。

填充边界

修饰符 fillMaxSize、fillMaxWidth、fillMaxHeight 和 fillMaxDepth 可使内容（部分）填充其父元素的边界。 使用填充修饰符有助于您的应用布局独立于 XR 设备显示特征的内容。

设置大小和所需的大小

修饰符 size、width、height 和 depth 用于声明内容的偏好大小。如需声明内容的精确大小，请使用 requiredSize、requiredWidth、requiredHeight 和 requiredDepth。这些单位必须以 dp 为单位指定；如需从米转换为 dp，请使用 Meter.toDp()。

位置可组合项

offset

offset 修饰符可沿 x、y 和 z 轴在 3D 空间中移动可组合项。这些单位必须以 dp 为单位指定；如需从米转换为 dp，请使用 Meter.toDp()。

rotate

rotate 修饰符可在空间中旋转给定的可组合项。您可以通过多种方式指定旋转方向和旋转量：

  • 使用俯仰、偏航和滚动（分别指定围绕 x、y 和 z 轴的旋转），
  • 使用 axisAngle（表示旋转轴的 Vector3）以及应围绕该轴旋转的度数，
  • 使用表示旋转的 Quaternion。

更改可组合项的外观

alpha

alpha 修饰符用于设置元素及其子级的不透明度，其中 0f 表示完全透明，1.0f 表示完全不透明。

scale

scale 修饰符沿水平轴、垂直轴和深度轴缩放可组合项的内容。

测试和无障碍功能

semantics

semantics 修饰符会向布局节点添加语义，以便用于测试和无障碍功能。请参阅 Jetpack Compose 中的语义和 SemanticsModifier。

testTag

testTag 修饰符是 SemanticsPropertyReceiver.testTag 的简写形式，可让测试框架在测试中找到相应元素。