Ein SubspaceModifier ähnelt einem Compose-Modifikator für Elemente in einem Subspace. Mit einem SubspaceModifier können Sie 3D-Layoutknoten positionieren, drehen und ihnen Verhaltensweisen hinzufügen.
Layout
Standardmäßig ist ein Subspace auf den empfohlenen Bereich für die Anzeige einer App beschränkt. Diese Begrenzungen werden verwendet, um das Layout Ihrer Unterraumkomponenten zu messen, ähnlich wie Begrenzungen in 2D-Compose-Layouts.
Füllungsgrenzen
Mit den Modifikatoren fillMaxSize, fillMaxWidth, fillMaxHeight und fillMaxDepth füllen Inhalte (teilweise) die Grenzen ihres übergeordneten Elements aus.
Mit Füllmodifikatoren können Sie Inhalte im App-Layout unabhängig von den Displayeigenschaften des XR-Geräts gestalten.
Größe und erforderliche Größe festlegen
Mit den Modifikatoren size, width, height und depth wird die bevorzugte Größe des Inhalts angegeben. Wenn Sie die genaue Größe des Inhalts angeben möchten, verwenden Sie requiredSize, requiredWidth, requiredHeight und requiredDepth. Diese Einheiten müssen in dp angegeben werden. Verwenden Sie Meter.toDp(), um von Metern in Dezimalformate umzurechnen.
Composeable-Elemente positionieren
offset
Mit dem Modifier offset wird das Element im 3D-Raum entlang der Achsen x, y und z verschoben. Diese Einheiten müssen in dp angegeben werden. Verwenden Sie Meter.toDp(), um von Metern in dp umzurechnen.
rotate
Mit dem Modifier rotate wird das angegebene Composeable im Raum gedreht. Sie können die Richtung und den Betrag der Drehung auf verschiedene Arten angeben:
- Mit Neigung, Gier und Roll, die die Drehung um die Achsen
x,yundzangeben, - Mit einer
axisAngle, einerVector3, die die Drehachse und die Anzahl der Grad angibt, um die sie gedreht werden soll, - Mit einer
Quaternion, die die Drehung darstellt.
Aussehen von Composeable-Elementen ändern
alpha
Mit dem Modifikator alpha wird die Deckkraft des Elements und seiner untergeordneten Elemente festgelegt. Dabei steht 0f für vollständig transparent und 1.0f für vollständig undurchsichtig.
scale
Mit dem Modifikator scale wird der Inhalt des Composebles entlang der horizontalen, vertikalen und Tiefenachse skaliert.
Composables Verhaltensweisen hinzufügen
resizable
Wenn der Modifikator resizable aktiviert ist, werden UI-Steuerelemente angezeigt, mit denen der Nutzer das Element vergrößern oder verkleinern kann. Das ist vergleichbar mit der Verwendung von ResizableComponent auf einer Entity.
movable
Wenn der Modifikator movable aktiviert ist, werden der Komponente Steuerelemente hinzugefügt, mit denen der Nutzer das Element im 3D-Raum verschieben kann. Das ist vergleichbar mit der Verwendung von MovableComponent auf einem Entity.
Tests und Barrierefreiheit
semantics
Der Modifikator semantics fügt dem Layoutknoten Semantik hinzu, die für Tests und Barrierefreiheit verwendet werden kann. Weitere Informationen finden Sie unter Semantik in Jetpack Compose und SemanticsModifier.
testTag
Der Modifikator testTag ist eine Kurzschreibweise für SemanticsPropertyReceiver.testTag, mit der Test-Frameworks das Element in Tests finden können.