SubspaceModifier مشابه Compose modifier برای Composableها در Subspace است. SubspaceModifier به شما امکان میدهد Composableها را در فضای سهبعدی دستکاری کنید و به شما در موقعیتیابی، چرخش و افزودن رفتارها به گرههای طرحبندی سهبعدی کمک میکند.
طرح بندی
به طور پیشفرض، یک Subspace توسط فضای توصیهشده برای مشاهده یک برنامه محدود میشود. این مرزها هنگام اندازهگیری طرحبندی اجزای Subspace شما، مشابه مرزها در طرحبندیهای Compose دوبعدی ، استفاده میشوند.
مرزها را پر کنید
اصلاحکنندههای fillMaxSize ، fillMaxWidth ، fillMaxHeight و fillMaxDepth باعث میشوند محتوا (تا حدی) مرزهای والد خود را پر کند. استفاده از اصلاحکنندههای fill به برنامه شما کمک میکند تا محتوایی را که مستقل از ویژگیهای نمایشگر دستگاه XR است، طرحبندی کند.
اندازه و اندازه مورد نیاز را تنظیم کنید
اصلاحکنندههای size ، width ، height و depth اندازه ترجیحی محتوا را اعلام میکنند. برای اعلام اندازه دقیق محتوا، requiredSize ، requiredWidth ، requiredHeight و requiredDepth استفاده کنید. این واحدها باید در dp مشخص شوند؛ برای تبدیل از متر به dp، از Meter.toDp() استفاده کنید.
موقعیتهای قابل ترکیب
offset
اصلاحکنندهی offset ، عنصر ترکیبپذیر را در فضای سهبعدی در امتداد محورهای x ، y و z حرکت میدهد. این واحدها باید در dp مشخص شوند؛ برای تبدیل از متر به dp، از Meter.toDp() استفاده کنید.
rotate
اصلاحگر rotate عنصر ترکیبپذیر داده شده را در فضا میچرخاند. میتوانید جهت و میزان چرخش را به روشهای مختلف مشخص کنید:
- با استفاده از پیچ، یاو و رول که به ترتیب چرخش حول محورهای
x،yوzرا مشخص میکنند، - با استفاده از
axisAngleکه یکVector3است و محور چرخش را نشان میدهد، و میزان درجهای که باید حول آن بچرخد، - با استفاده از یک
Quaternionکه چرخش را نشان میدهد.
ظاهر ترکیبات را تغییر دهید
alpha
اصلاحکننده alpha میزان شفافیت عنصر و فرزندانش را تنظیم میکند، که در آن 0f نشان دهنده شفافیت کامل و 1.0f نشان دهنده مات بودن کامل است.
scale
اصلاحکنندهی scale ، محتوای کامپوننت را در امتداد محورهای افقی، عمودی و عمق مقیاسبندی میکند.
آزمایش و دسترسیپذیری
semantics
اصلاحکنندهی semantics ، برای استفاده در آزمایش و دسترسیپذیری، به گرهی layout، semantics اضافه میکند. به Semantics در Jetpack Compose و SemanticsModifier مراجعه کنید.
testTag
اصلاحکننده testTag مخفف SemanticsPropertyReceiver.testTag است که به چارچوبهای تست اجازه میدهد عنصر را در تستها پیدا کنند.