چیدمان کارت کلاسیک عریض با جدول

نماد رده‌بندی چهار ستاره

دستورالعمل‌های طراحی برنامه تلویزیون نوعی کارت را تعریف می‌کند که کارت کلاسیک عریض نامیده می‌شود، که تصویری را در کنار بلوک محتوای توصیفی آن نمایش می‌دهد. هنگام ساختن چیدمان‌های پیچیده دوبعدی برای صفحه‌نمایش تلویزیون، استفاده از موقعیت‌یابی سنتی مبتنی بر مختصات یا محفظه‌های 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 و نواحی نام‌گذاری‌شده، جداسازی تمیزی بین قطعه‌های چیدمان فیزیکی، مختصات ناحیه، و جای‌گذاری ترکیب‌پذیر فرزند به‌دست می‌آورید. این ساختار باعث می‌شود چیدمان شما خوانا و قابل‌نگهداری باشد و درعین‌حال از دستورالعمل‌های طراحی برنامه تلویزیون برای مؤلفه‌های ریزعکس و شرح کنارهم پیروی کند.

منابع بیشتر