دستورالعملهای طراحی برنامه تلویزیون نوعی کارت را تعریف میکند
که کارت کلاسیک عریض نامیده میشود،
که تصویری را در کنار بلوک محتوای توصیفی آن نمایش میدهد.
هنگام ساختن چیدمانهای پیچیده دوبعدی برای صفحهنمایش تلویزیون،
استفاده از موقعیتیابی سنتی مبتنی بر مختصات
یا محفظههای Row و Column تودرتوی عمیق میتواند خواندن،
نگهداری، و بازسازی کد را دشوار کند.
کارت کلاسیک «عریض» یک مورد استفاده ایدهآل برای Jetpack Compose Grid API است،
که به شما کمک میکند عناصر کنارهم را بهطور تمیز بااستفاده از نواحی چیدمان دوبعدی معنایی و تعریفشده توسط کاربر ساختاردهی کنید.
روالهای مطلوب
چیدمان کارت را با Grid پیادهسازی کنید.
استفاده از محفظه Grid خوانایی کد را بهبود میبخشد
با جدا کردن ابعاد چیدمان فیزیکی از جایگذاری مورد فرزند.
بهجای تکیه بر نمایههای دقیق قطعه،
نواحی نامگذاریشده معنایی را با تابع area تعریف کنید
و عناصر قابلساخت فرزند را با اصلاحکننده gridItem قرار دهید.
اندازه انعطافپذیر قطعه، مثل GridTrackSize.Auto
و minmax(0.dp, 1.fr)،
را با فاصله دقیق قطعه (gap(row = 8.dp, column = 16.dp))
ترکیب کنید تا اجزای پیچیده کارت کنارهم را بهطور واضح و منسجم سازماندهی کنید.
مواد تشکیلدهنده
Grid: یک طرحبندی محفظه دوبعدی در Jetpack Compose که عناصر قابلترکیب فرزند را براساس یک لامبدا پیکربندی در ردیفها و ستونها مرتب میکندgridItem: افزونهModifierکه عنصر میانای کاربر فرزند را باareaIdنامگذاریشده خاصی در چیدمانGridمرتبط میکندarea: تابع DSL پیکربندی درGridConfigurationScopeکهareaIdمعنایی را به محدودهها یا گسترههای ردیف و ستون خاص نگاشت میکندCard: یک محفظه ترکیبپذیر Material Design که عناصر واسط کاربر و سبکبندی مرتبط را گروهبندی میکندGridTrackSize.MinMax: ویژگی اندازهگذاری قطعه که حدود انعطافپذیر (minوmax) را برای ابعاد ردیف یا ستون تعریف میکندGridTrackSize.Auto: ویژگی اندازهگذاری قطعه که اندازه قطعه ردیف یا ستون را بهطور خودکار برای تناسب با محتوای آن تعیین میکند (column(GridTrackSize.Auto))gap: تابع پیکربندی که فاصله عمودی (row) و افقی (column) بین قطعههای شبکه را مشخص میکند
قدمها
شناسههای ناحیه را تعریف کنید، شیارهای شبکه و نواحی را پیکربندی کنید، سپس ترکیبپذیرهای فرزند را قرار دهید.
۱. تعریف شناسههای ناحیه معنایی
ابتدا، یک نمایش ایمن تایپی از مناطق داخل طرحبندی کارت کلاسیک عریض خود ایجاد کنید. کلاس enum از غلطهای املایی رشتهای جلوگیری میکند و
ایمنی زمان ترجمه را هنگام نگاشت قطعهها و قرار دادن موارد فرزند فراهم میکند.
enum class CardArea { Image, Title, Subtitle, Description, ExtraText, }
۲. پیکربندی کردن ردیابیهای شبکه دوبعدی و نواحی نامگذاریشده
در داخل لامبدای config ترکیبپذیر Grid، ستونها و ردیفهایی را که ساختار کارت را تشکیل میدهند تعریف کنید. از GridTrackSize.Auto برای ستون تصویر استفاده کنید
تا عرض ریزعکس را بهطور تمیز بپوشاند. از minmax(0.dp, 1.fr) برای ستون محتوا استفاده کنید تا بهطور انعطافپذیر در سراسر عرض باقیمانده کارت گسترش یابد. فاصله قطعهها را با gap(row = 8.dp, column = 16.dp) مشخص کنید. شناسههای CardArea را بااستفاده از تابع area به مختصات فیزیکی مسیر آنها نگاشت کنید.
Grid( config = { // Define columns: left column for image, right for content column(GridTrackSize.Auto) column(minmax(0.dp, 1.fr)) // Define row tracks for the vertical content stack row(GridTrackSize.Auto) row(GridTrackSize.Auto) row(GridTrackSize.Auto) row(GridTrackSize.Auto) // Map semantic identifiers to grid coordinates and spans area(CardArea.Image, row = 1, column = 1, rowSpan = 4) area(CardArea.Title, row = 1, column = 2) area(CardArea.Subtitle, row = 2, column = 2) area(CardArea.Description, row = 3, column = 2) area(CardArea.ExtraText, row = 4, column = 2) gap(row = 8.dp, column = 16.dp) } ) { // Child elements placed in Step 3 }
۳. قرار دادن ترکیبپذیرهای فرزند بااستفاده از اصلاحکننده gridItem
With your tracks and areas configured, place each child UI element purely by
semantic intent using the gridItem modifier. میتوانید ترکیبپذیرهای فرزند را به هر ترتیبی اعلام کنید. محفظه Grid هر عنصر را بهطور خودکار مستقیماً در منطقه دوبعدی اختصاصدادهشده به آن قرار میدهد.
@Composable fun WideClassicCard( imageContent: @Composable () -> Unit, title: String, subtitle: String, description: String, extraText: String, modifier: Modifier = Modifier, ) { Card(modifier = modifier) { Grid( config = { // Define columns: left column for image, right for content column(GridTrackSize.Auto) column(minmax(0.dp, 1.fr)) // Define row tracks for the vertical content stack row(GridTrackSize.Auto) row(GridTrackSize.Auto) row(GridTrackSize.Auto) row(GridTrackSize.Auto) // Map semantic identifiers to grid coordinates and spans area(CardArea.Image, row = 1, column = 1, rowSpan = 4) area(CardArea.Title, row = 1, column = 2) area(CardArea.Subtitle, row = 2, column = 2) area(CardArea.Description, row = 3, column = 2) area(CardArea.ExtraText, row = 4, column = 2) gap(row = 8.dp, column = 16.dp) }, ) { Box(modifier = Modifier.gridItem(CardArea.Image)) { imageContent() } Text( text = title, style = MaterialTheme.typography.titleLarge, modifier = Modifier .gridItem(CardArea.Title) .padding(top = 16.dp, end = 16.dp), ) Text( text = subtitle, style = MaterialTheme.typography.titleMedium, modifier = Modifier .gridItem(CardArea.Subtitle) .padding(end = 16.dp), ) Text( text = description, style = MaterialTheme.typography.bodyMedium, modifier = Modifier .gridItem(CardArea.Description) .padding(end = 16.dp), ) Text( text = extraText, style = MaterialTheme.typography.labelSmall, modifier = Modifier .gridItem(CardArea.ExtraText) .padding(bottom = 16.dp, end = 16.dp), ) } } }
نتایج
با سازماندهی کارت کلاسیک عریض با Grid و نواحی نامگذاریشده،
جداسازی تمیزی بین قطعههای چیدمان فیزیکی، مختصات ناحیه،
و جایگذاری ترکیبپذیر فرزند بهدست میآورید.
این ساختار باعث میشود چیدمان شما خوانا و قابلنگهداری باشد
و درعینحال از دستورالعملهای طراحی برنامه تلویزیون
برای مؤلفههای ریزعکس و شرح کنارهم پیروی کند.