چیدمان‌های ابزاره متعارف

با شناسایی محتوای اصلی خود، چیدمان‌های ابزاره مؤثر بسازید. چیدمان شما تعیین می‌کند که اطلاعات و عناصر تعاملی در ابزارک شما چگونه سازمان‌دهی شوند. ‫Android چندین چیدمان ازپیش‌ساخته‌شده برای نوار ابزار، نوشتار، فهرست، و ابزاره‌های نوع جدولی ارائه می‌دهد تا این فرایند را ساده‌تر کند.

نوشتار

چیدمان‌های نوشتاری برای نمایش اطلاعات مختصر ایده‌آل هستند. با افزودن اختیاری تصویر در کنار نوشتار، جذابیت بصری ابزاره‌تان را بهبود دهید.

فقط نوشتار

برای عنوان‌ها، به‌روزرسانی‌های وضعیت، شرح‌های کوتاه، یا هر سناریویی که یک خط نوشتار به‌طور مؤثر پیام را منتقل می‌کند ایده‌آل است.

نوشتار و تصویر

برای تأثیر بصری بیشتر، تصویری اضافه کنید. برای اطلاعات بیشتر، به نقطه‌های گسست مراجعه کنید تا با نحوه تطبیق دادن این چیدمان برای اندازه‌های مختلف صفحه‌نمایش آشنا شوید.

نوارابزارها

از چیدمان‌های نوارابزار استفاده کنید تا دسترسی سریع به کارهای پرکاربرد در برنامه‌تان را دراختیار کاربران قرار دهید، در چیدمانی انعطاف‌پذیر که با اندازه‌های مختلف ابزاره سازگار می‌شود.

نوارابزار جستجو

چیدمان نوارابزار جستجو به‌طور عمدی طراحی شده است تا تمرکز را به جستجو به‌عنوان کنش اصلی در نوارابزار جلب کند. دکمه‌های مفید اضافی می‌توانند دسترسی سریع به عملکردهای پرکاربرد را فراهم کنند.

نوارابزار

نوارابزارها نمانام‌سازی برنامه را ارائه می‌دهند و پس‌از آن دکمه‌هایی برای پرکاربردترین تکالیف که برای تنظیمات قابل‌تغییر یا پیوندهای تکلیف ایده‌آل هستند. هنگام تغییر اندازه، گزینه‌هایی که کمتر استفاده می‌شوند ممکن است به‌نفع کنش‌های رایج‌تر پنهان شوند. از نقطه‌های گسست برای افزودن دکمه جدید قابل‌تک‌ضرب حداقل ۴۸dp درصورت وجود فضا استفاده کنید.

فهرست

از چیدمان‌های فهرست برای سازمان‌دهی چندین مورد در قالبی واضح و قابل‌اسکن استفاده کنید. این برای سرخط اخبار، فهرست کارهای انجام‌دادنی، یا پیام‌ها ایده‌آل است. محتوا را در فهرست ساختاریافته و قابل‌اسکن سازمان‌دهی کنید. براساس نیازهای محتوایتان، بین ارائه با ظرف یا بدون ظرف انتخاب کنید.

فهرست نوشتار و تصویر

نوشتار قابل‌اسکن و فهرست‌های تصویر برای نمایش دادن چندین نوع محتوا، مثل سرخط‌های خبری، فهرست‌های پخش با جلد آلبوم، یا پیام‌ها عالی هستند.

بازبینه

چیدمان بازبینه برای نمایش تکالیف عالی است و هدف‌های واضحی برای ضربه زدن ارائه می‌دهد تا کاربران بتوانند به‌سرعت موارد را به‌عنوان انجام‌شده علامت‌گذاری کنند.

فهرست کنش

با فهرست‌های کنش، گروه‌بندی کنترل بصری ارائه دهید، که در آن وضعیت‌های روشن/خاموش بصری بازخورد فوری درباره وضعیت‌های مورد ارائه می‌دهند.

تصویر لبه‌به‌لبه

این چیدمان که برای نمایش تصاویر فراگیر و تمام‌رنگ در Android 17 و بالاتر ایده‌آل است، از پیمایش سریع استفاده می‌کند تا مطمئن شود هر عنصر فرزند کاملاً با ارتفاع محتوی ابزاره تراز می‌شود.

شناسه عرضه جهانی (GRid)

تصاویر را در یک شبکه فشرده، انعطاف‌پذیر، و ازنظر بصری غنی با برچسب‌های اختیاری ارائه دهید. از ستون‌ها و ردیف‌هایی استفاده کنید که با اندازه‌های مختلف صفحه‌نمایش تطبیق پیدا می‌کنند.

فقط تصویر

بااستفاده از شبکه‌های فقط تصویری، گالری‌های تصویری پیمایشی و تأثیرگذار ازنظر دیداری ایجاد کنید. ردیف‌ها و ستون‌ها به‌طور خودکار با اندازه‌های مختلف صفحه‌نمایش سازگار می‌شوند تا به‌صورت بهینه ارائه شوند.

تصویر و نوشتار

همچنین می‌توانید برچسب‌ها و توضیحات نوشتاری را اضافه کنید و محتوای شبکه تصویری‌تان را با زمینه و اطلاعات بیشتر غنی‌تر کنید.

نمونه‌های کد

جدول زیر هر چیدمان متعارف را به پیاده‌سازی Jetpack Glance مربوطه در مخزن GitHub نمونه‌های پلاتفرم Android نگاشت می‌کند.

چیدمان متعارف فایل‌های مرجع راهنما
چیدمان فهرست کنش‌ها
  • کنش‌های مورد فهرست را با بازخوانی‌های کنش Glance مدیریت کنید و از به‌روزرسانی‌های صحیح وضعیت مطمئن شوید.
بررسی چیدمان فهرست
  • بااستفاده از پارامترهای کنش یا فراخوانی‌های برگشتی برای به‌روزرسانی موارد مجموعه، تغییر وضعیت چارگوش انتخاب را پیاده‌سازی کنید.
  • از پاسخ‌های تماس کنش «نگاه سریع»، مثل `actionRunCallback`،‏ `ActionCallback(actionParametersOf(...))‎`، یا `actionStartActivity(...)‎`، برای پارامترهای `onClick` ابزارک استفاده کنید تا رویدادهای کلیک را مثل تک‌ضرب زدن روی چارگوش انتخاب مدیریت کنید.
چیدمان نوارابزار گویا
  • از خطاهای وارد کردن `ColorProvider` اجتناب کنید: `androidx.glance.unit.ColorProvider` را وارد کنید و از `androidx.glance.color.ColorProvider(dayColor, nightColor)` استفاده کنید.
  • برای رنگ‌های پس‌زمینه یکدست، به‌جای `ColorProvider` مستقیماً از `GlanceModifier.background(Color)` استفاده کنید.
چیدمان جدولی تصویر
  • از رنگ‌های یکدست (`GlanceModifier.background`) یا ترسیم‌پذیرهای محلی برای موارد تصویر استفاده کنید، مگراینکه کتابخانه بارگیری تصویر پیکربندی یا درخواست شده باشد.
Image Text List Layout
  • موارد استفاده رایج: فیدهای خبری، فهرست‌های مقاله، سوابق تمرین، فیدهای پیام، و فهرست‌های ریزعکس عمودی.
  • هنگام ترکیب تصاویر کوچک با نوشتار اصلی/فرعی، ارتفاع ردیف فهرست و برش نوشتار را متعادل کنید.
چیدمان نوشتار طولانی
  • اگر مقادیر `Dp` را ضرب می‌کنید، مثلاً `2 * padding`، androidx.compose.ui.unit.times را وارد کنید.
  • قوانین اندازه‌گذاری را دنبال کنید: مطمئن شوید که ابعاد از `dimens.xml` برای حاشیه داخلی و مقیاس‌بندی تایپوگرافی استفاده می‌شود.
چیدمان نوارابزار جستجو
  • از خطاهای وارد کردن `ColorProvider` اجتناب کنید: `androidx.glance.unit.ColorProvider` را وارد کنید و از `androidx.glance.color.ColorProvider(dayColor, nightColor)` استفاده کنید.
  • برای رنگ‌های پس‌زمینه یکپارچه به‌جای ColorProvider مستقیماً از `GlanceModifier.background(Color)` استفاده کنید.
چیدمان تصویر لبه‌به‌لبه / پیمایش چسبنده
  • برای «پیمایش چسبان»، `verticalScrollMode = VerticalScrollMode.SnapScrollMatchHeight(size.height)` را در LazyColumn تنظیم کنید.
  • اگر پیمایش سریع را پیاده‌سازی می‌کنید، Glance نسخه 1.3.0-alpha02 یا بالاتر، کیت توسعه نرم‌افزار کامپایل نسخه ۳۷ (Baklava) یا بالاتر، و افزایه Android Gradle (AGP) نسخه ۹.۱.۰ یا بالاتر لازم است.
  • `override val sizeMode: SizeMode = SizeMode.Exact` را در کلاس ارائه‌دهنده ابزاره تنظیم کنید.
چیدمان نوارابزار استاندارد
  • برای جلوگیری از خطاهای وارد کردن `ColorProvider`، به «عیب‌یابی» مراجعه کنید: از `androidx.glance.color.ColorProvider(dayColor, nightColor)` استفاده کنید.
  • برای رنگ‌های پس‌زمینه یکپارچه، به‌جای `ColorProvider` مستقیماً از `GlanceModifier.background(Color)` استفاده کنید.
نوشتار با چیدمان تصویر
  • از قوانین اندازه‌بندی چیدمان واکنش‌گرا پیروی کنید تا نوشتار و تصویر را براساس ابعاد ابزاره دردسترس، در کنار هم یا روی هم قرار دهید.