ক্যানোনিকাল লেআউট

ক্যানোনিকাল লেআউটগুলো হলো পরীক্ষিত ও বহুমুখী লেআউট, যা বিভিন্ন ধরনের ফর্ম ফ্যাক্টরে সর্বোত্তম ব্যবহারকারীর অভিজ্ঞতা প্রদান করে।

প্রমিত বিন্যাস প্রদর্শনকারী বড় পর্দার ডিভাইসগুলোর চিত্র।

আদর্শ লেআউটগুলো ছোট স্ক্রিনের ফোনের পাশাপাশি ট্যাবলেট, ফোল্ডেবল এবং ক্রোমওএস ডিভাইস সমর্থন করে। ম্যাটেরিয়াল ডিজাইনের নির্দেশনা থেকে উদ্ভূত হওয়ায়, এই লেআউটগুলো নান্দনিক হওয়ার পাশাপাশি কার্যকরীও।

অ্যান্ড্রয়েড ফ্রেমওয়ার্কে বিশেষায়িত উপাদান রয়েছে যা লেআউটগুলির বাস্তবায়নকে সহজ এবং নির্ভরযোগ্য করে তোলে।

আদর্শ লেআউটগুলো আকর্ষণীয় ও উৎপাদনশীলতা-বর্ধক ইউআই তৈরি করে, যা চমৎকার অ্যাপের ভিত্তি গড়ে তোলে।

তালিকার বিবরণ

তালিকা-বিবরণ লেআউটের ওয়্যারফ্রেম।

তালিকা-বিবরণ বিন্যাস ব্যবহারকারীদের এমন আইটেমের তালিকা অন্বেষণ করতে সক্ষম করে, যেগুলিতে বর্ণনামূলক, ব্যাখ্যামূলক বা অন্যান্য সম্পূরক তথ্য—অর্থাৎ আইটেমের বিবরণ—থাকে।

লেআউটটি অ্যাপ উইন্ডোকে পাশাপাশি দুটি প্যানে বিভক্ত করে: একটি তালিকার জন্য, অন্যটি বিস্তারিত বিবরণের জন্য। ব্যবহারকারীরা তালিকা থেকে আইটেম নির্বাচন করে সেটির বিস্তারিত বিবরণ দেখতে পারেন। বিস্তারিত অংশের ডিপ লিঙ্কগুলো ডিটেইল প্যানে অতিরিক্ত বিষয়বস্তু প্রকাশ করে।

বর্ধিত-প্রস্থের ডিসপ্লে ( উইন্ডো সাইজ ক্লাসের ব্যবহার দেখুন) একই সাথে তালিকা এবং বিস্তারিত বিবরণ উভয়ই প্রদর্শন করে। তালিকার কোনো একটি আইটেম নির্বাচন করলে, বিস্তারিত প্যানেলটি আপডেট হয়ে নির্বাচিত আইটেমটির সম্পর্কিত বিষয়বস্তু দেখায়।

মাঝারি এবং ছোট আকারের ডিসপ্লেতে, অ্যাপের সাথে ব্যবহারকারীর মিথস্ক্রিয়ার উপর নির্ভর করে তালিকা অথবা বিস্তারিত বিবরণ দেখানো হয়। যখন শুধু তালিকাটি দেখা যায়, তখন তালিকার কোনো একটি আইটেম নির্বাচন করলে তালিকার পরিবর্তে তার বিস্তারিত বিবরণ প্রদর্শিত হয়। যখন শুধু বিস্তারিত বিবরণ দেখা যায়, তখন ব্যাক বাটন চাপলে তালিকাটি পুনরায় প্রদর্শিত হয়।

ডিভাইসের ওরিয়েন্টেশন পরিবর্তন বা অ্যাপ উইন্ডোর আকার পরিবর্তনের মতো কনফিগারেশনগত পরিবর্তনের কারণে ডিসপ্লের উইন্ডো সাইজ ক্লাস পরিবর্তিত হতে পারে। একটি লিস্ট-ডিটেইল লেআউট সেই অনুযায়ী সাড়া দেয় এবং অ্যাপের স্টেট সংরক্ষণ করে:

  • যদি তালিকা এবং বিস্তারিত প্যান উভয়ই প্রদর্শনকারী একটি প্রসারিত-প্রস্থের ডিসপ্লে মাঝারি বা কম্প্যাক্ট আকারে সংকুচিত হয়, তাহলে বিস্তারিত প্যানটি দৃশ্যমান থাকে এবং তালিকা প্যানটি লুকানো থাকে।
  • যদি একটি মাঝারি বা কমপ্যাক্ট-প্রস্থের ডিসপ্লেতে শুধু ডিটেইল পেইনটি দৃশ্যমান থাকে এবং উইন্ডো সাইজ ক্লাসটি প্রসারিত হয়ে এক্সপ্যান্ডেড হয়, তাহলে তালিকা এবং ডিটেইল একসাথে দেখানো হয়, এবং তালিকাটি নির্দেশ করে যে ডিটেইল পেইনের বিষয়বস্তুর সাথে সম্পর্কিত আইটেমটি নির্বাচিত হয়েছে।
  • যদি কোনো মাঝারি বা কম প্রস্থের ডিসপ্লেতে শুধু তালিকা প্যানেলটি দৃশ্যমান থাকে এবং সেটি প্রসারিত হয়ে বিস্তৃত হয়, তাহলে তালিকা এবং একটি প্লেসহোল্ডার ডিটেইল প্যানেল একসাথে দেখানো হয়।

মেসেজিং অ্যাপ , কন্ট্যাক্ট ম্যানেজার , ইন্টারেক্টিভ মিডিয়া ব্রাউজার বা এমন যেকোনো অ্যাপের জন্য লিস্ট-ডিটেইল আদর্শ, যেখানে কন্টেন্টকে আইটেমের তালিকা হিসেবে সাজানো যায় এবং যা অতিরিক্ত তথ্য প্রকাশ করে।

চিত্র ১. মেসেজিং অ্যাপে কথোপকথনের তালিকা এবং নির্বাচিত কথোপকথনের বিবরণ দেখানো হচ্ছে।

বাস্তবায়ন

Compose-এর ডিক্লারেটিভ প্যারাডাইম উইন্ডো সাইজ ক্লাস লজিককে সাপোর্ট করে যা নির্ধারণ করে যে তালিকা এবং বিবরণ প্যান একই সাথে দেখানো হবে কিনা (যখন প্রস্থ উইন্ডো সাইজ ক্লাস প্রসারিত হয়) বা শুধু তালিকা বা বিবরণ প্যান (যখন প্রস্থ উইন্ডো সাইজ ক্লাস মাঝারি বা কমপ্যাক্ট হয়)।

একমুখী ডেটা ফ্লো নিশ্চিত করতে, বর্তমান উইন্ডো সাইজ ক্লাস এবং বেছে নেওয়া তালিকা আইটেমের (যদি থাকে) বিবরণ সহ সব স্টেট হোইস্ট করুন, যাতে সব কম্পোজেবলের ডেটায় অ্যাক্সেস থাকে এবং সঠিকভাবে রেন্ডার করতে পারে।

ছোট উইন্ডো সাইজে শুধু বিবরণ প্যানেল দেখানোর সময়, বিবরণ প্যানেল সরিয়ে শুধু তালিকা প্যানেল দেখানোর জন্য BackHandler যোগ করুন। BackHandler সামগ্রিক অ্যাপ নেভিগেশনের অংশ নয় কারণ হ্যান্ডলার উইন্ডো সাইজ ক্লাস এবং বেছে নেওয়া বিস্তারিত অবস্থার উপর নির্ভর করে।

ListDetailPaneScaffold হল একটি হাই-লেভেল কম্পোজেবল যা তালিকা-বিবরণ লেআউটের বাস্তবায়নকে সহজ করে তোলে। এটি উইন্ডো সাইজ ক্লাসের উপর ভিত্তি করে প্যানেল লজিক অটোমেটিক ম্যানেজ করে এবং প্যানেলের মধ্যে নেভিগেশন সাপোর্ট করে।

ListDetailPaneScaffold ব্যবহার করে এখানে একটি ন্যূনতম বাস্তবায়ন দেখানো হল:

@OptIn(ExperimentalMaterial3AdaptiveApi::class)
@Composable
fun MyListDetailPaneScaffold() {
    val navigator = rememberListDetailPaneScaffoldNavigator()
    ListDetailPaneScaffold(
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        listPane = {
            // Listing Pane
        },
        detailPane = {
            // Details Pane
        }
    )
}

এই উদাহরণের মূল উপাদানগুলি নিচে দেওয়া হল:

  • rememberListDetailPaneScaffoldNavigator: তালিকা ও বিবরণ পেনের মধ্যে নেভিগেশন ম্যানেজ করার জন্য একটি নেভিগেটর তৈরি করে।
  • listPane: আইটেমের তালিকা দেখায়।
  • detailPane: বেছে নেওয়া আইটেমের কন্টেন্ট দেখায়।

প্রয়োগের বিস্তারিত উদাহরণের জন্য, দেখুন:

খাওয়ানো

ফিড লেআউটের ওয়্যারফ্রেম।

একটি ফিড লেআউট বিপুল পরিমাণ কন্টেন্ট দ্রুত ও সুবিধাজনকভাবে দেখার জন্য সমতুল্য কন্টেন্ট উপাদানগুলোকে একটি কনফিগারযোগ্য গ্রিডে সাজিয়ে রাখে।

আকার ও অবস্থান বিষয়বস্তুর উপাদানগুলোর মধ্যে সম্পর্ক স্থাপন করে।

উপাদানগুলোকে একই আকারের করে এবং একসাথে স্থাপন করে কন্টেন্ট গ্রুপ তৈরি করা হয়। কাছাকাছি থাকা উপাদানগুলোর চেয়ে কোনো উপাদানকে বড় করে সেটির প্রতি দৃষ্টি আকর্ষণ করা হয়।

কার্ড এবং তালিকা হলো ফিড লেআউটের সাধারণ উপাদান।

একটি ফিড লেআউট প্রায় যেকোনো আকারের ডিসপ্লে সমর্থন করে, কারণ এর গ্রিড একটি একক স্ক্রলিং কলাম থেকে একাধিক কলামের স্ক্রলিং কন্টেন্ট ফিডে রূপান্তরিত হতে পারে।

ফিডগুলো বিশেষ করে সংবাদ এবং সোশ্যাল মিডিয়া অ্যাপের জন্য খুবই উপযোগী।

চিত্র ২. সোশ্যাল মিডিয়া অ্যাপ, যেখানে পোস্টগুলো বিভিন্ন আকারের কার্ডে দেখানো হচ্ছে।

বাস্তবায়ন

ফিডে গ্রিডে সাজানো ভার্টিক্যাল স্ক্রলিং কন্টেনারে প্রচুর সংখ্যক কন্টেন্ট এলিমেন্ট থাকে। লেজি লিস্ট কলাম বা সারিতে দক্ষতার সাথে অনেক আইটেম রেন্ডার করে। লেজি গ্রিড গ্রিডে আইটেম রেন্ডার করে, আইটেমের সাইজ ও স্প্যান কনফিগার করতে সাহায্য করে।

গ্রিড আইটেমের জন্য অনুমোদিত ন্যূনতম প্রস্থ সেট করতে উপলভ্য ডিসপ্লে এরিয়ার উপর ভিত্তি করে গ্রিড লেআউটের কলাম কনফিগার করুন। গ্রিড আইটেম সংজ্ঞায়িত করার সময়, কিছু আইটেমকে অন্যদের তুলনায় বেশি গুরুত্ব দিতে কলাম স্প্যান অ্যাডজাস্ট করুন।

ফিডের সম্পূর্ণ প্রস্থ জুড়ে দেখানোর জন্য ডিজাইন করা বিভাগ হেডার, ডিভাইডার বা অন্যান্য আইটেমের জন্য, লেআউটের সম্পূর্ণ প্রস্থ জুড়ে দেখানোর জন্য maxLineSpan ব্যবহার করুন।

কম্প্যাক্ট-প্রস্থের ডিসপ্লেতে, যেখানে একাধিক কলাম দেখানোর জন্য পর্যাপ্ত জায়গা নেই, সেখানে LazyVerticalGrid ঠিক LazyColumn-এর মতো কাজ করে।

LazyVerticalGrid ব্যবহার করে এখানে একটি ন্যূনতম বাস্তবায়ন দেখানো হল:

@Composable
fun MyFeed(names: List<String>) {
    LazyVerticalGrid(
        // GridCells.Adaptive automatically adapts column count based on available width
        columns = GridCells.Adaptive(minSize = 180.dp),
    ) {
        items(names) { name ->
            Text(name)
        }
    }
}

অ্যাডাপ্টিভ ফিডের মূল চাবিকাঠি হল columns কনফিগারেশন। GridCells.Adaptive(minSize = 180.dp) এমন একটি গ্রিড তৈরি করে যেখানে প্রতিটি কলামের প্রস্থ কমপক্ষে 180.dp হয়। গ্রিডটি তখন উপলভ্য স্পেসে যতগুলি কলাম ফিট করতে পারে ততগুলি কলাম দেখায়।

প্রয়োগের উদাহরণ দেখতে, Compose স্যাম্পেল সহ ফিড দেখুন।

সহায়ক প্যানেল

সহায়ক প্যান লেআউটের ওয়্যারফ্রেম।

সাপোর্টিং পেইন লেআউট অ্যাপের বিষয়বস্তুকে প্রাথমিক এবং মাধ্যমিক প্রদর্শন অঞ্চলে বিন্যস্ত করে।

প্রাথমিক ডিসপ্লে এলাকাটি অ্যাপ উইন্ডোর বেশিরভাগ অংশ (সাধারণত প্রায় দুই-তৃতীয়াংশ) জুড়ে থাকে এবং এতে মূল বিষয়বস্তু থাকে। দ্বিতীয় ডিসপ্লে এলাকাটি একটি পেইন যা অ্যাপ উইন্ডোর বাকি অংশ জুড়ে থাকে এবং মূল বিষয়বস্তুকে সমর্থনকারী কন্টেন্ট উপস্থাপন করে।

ল্যান্ডস্কেপ ওরিয়েন্টেশনে, বর্ধিত-প্রস্থের ডিসপ্লেতে সাপোর্টিং পেইন লেআউটগুলো ভালোভাবে কাজ করে (দেখুন 'উইন্ডো সাইজ ক্লাস ব্যবহার করুন ')। মাঝারি বা কম-প্রস্থের ডিসপ্লেগুলো প্রাথমিক এবং মাধ্যমিক উভয় ডিসপ্লে এলাকা দেখানো সমর্থন করে, যদি কন্টেন্টটি আরও সংকীর্ণ ডিসপ্লে স্পেসের সাথে খাপ খাইয়ে নেওয়া যায়, অথবা যদি অতিরিক্ত কন্টেন্টটি প্রাথমিকভাবে একটি বটম বা সাইড শীটে লুকিয়ে রাখা যায় যা মেনু বা বাটনের মতো কোনো কন্ট্রোলের মাধ্যমে অ্যাক্সেসযোগ্য।

প্রাথমিক এবং গৌণ বিষয়বস্তুর সম্পর্কের দিক থেকে একটি সাপোর্টিং পেইন লেআউট একটি লিস্ট-ডিটেইল লেআউট থেকে ভিন্ন। গৌণ পেইনের বিষয়বস্তু শুধুমাত্র প্রাথমিক বিষয়বস্তুর সাপেক্ষেই অর্থবহ হয়; উদাহরণস্বরূপ, একটি সাপোর্টিং পেইন টুল উইন্ডো নিজে থেকে অপ্রাসঙ্গিক। তবে, একটি লিস্ট-ডিটেইল লেআউটের ডিটেইল পেইনের সম্পূরক বিষয়বস্তু প্রাথমিক বিষয়বস্তু ছাড়াও অর্থবহ হয়, যেমন, একটি প্রোডাক্ট লিস্টিং থেকে কোনো পণ্যের বিবরণ।

পেইন সমর্থন করার ব্যবহারের ক্ষেত্রগুলির মধ্যে রয়েছে:

চিত্র ৩. একটি সহায়ক প্যানে পণ্যের বিবরণসহ শপিং অ্যাপ।

বাস্তবায়ন

Compose উইন্ডো সাইজ ক্লাস লজিককে সাপোর্ট করে, যা আপনাকে একই সাথে মূল কন্টেন্ট এবং সহায়ক কন্টেন্ট দেখাবেন নাকি সহায়ক কন্টেন্টকে অন্য কোনও লোকেশনে দেখাবেন তা নির্ধারণ করতে দেয়।

বর্তমান উইন্ডো সাইজ ক্লাস এবং মূল কন্টেন্ট ও সহায়ক কন্টেন্টের ডেটা সম্পর্কিত তথ্য সহ সব স্টেট হোইস্ট করুন।

কম্প্যাক্ট-প্রস্থের ডিসপ্লের জন্য, মূল কন্টেন্টের নিচে বা স্ক্রিনের নিচে অ্যাটাচ করা শিটের মধ্যে সহায়ক কন্টেন্ট রাখুন। মাঝারি ও বড় প্রস্থের জন্য, মূল কন্টেন্টের পাশে সহায়ক কন্টেন্ট রাখুন, কন্টেন্ট ও উপলভ্য জায়গার উপর ভিত্তি করে উপযুক্ত সাইজ বেছে নিন। মাঝারি প্রস্থের জন্য, ডিসপ্লে স্পেস মূল এবং সহায়ক কন্টেন্টের মধ্যে সমানভাবে ভাগ করুন। প্রস্থ বাড়ানোর জন্য, মূল কন্টেন্টকে ৭০% স্পেস দিন, সহায়ক কন্টেন্টকে ৩০% স্পেস দিন।

SupportingPaneScaffold হল একটি হাই-লেভেল কম্পোজেবল যা সাপোর্টিং প্যানেল লেআউটের বাস্তবায়নকে সহজ করে তোলে। কম্পোজেবল অটোমেটিক উইন্ডো সাইজ ক্লাসের উপর ভিত্তি করে প্যান লজিক ম্যানেজ করে, বড় স্ক্রিনে পাশাপাশি প্যান দেখায় বা ছোট স্ক্রিনে সাপোর্টিং প্যান লুকায়। SupportingPaneScaffold এছাড়াও, প্যানেলের মধ্যে নেভিগেট করার সুবিধা দেয়।

নিম্নলিখিতটি হল একটি ন্যূনতম প্রয়োগ:

@OptIn(ExperimentalMaterial3AdaptiveApi::class)
@Composable
fun MySupportingPaneScaffold() {
    // Creates and remembers a navigator to control pane visibility and navigation
    val navigator = rememberSupportingPaneScaffoldNavigator()
    SupportingPaneScaffold(
        // Directive and value help control pane visibility based on screen size and state
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        mainPane = {
            // Main Pane for the primary content
        },
        supportingPane = {
            //Supporting Pane for supplementary content
        }
    )
}
উদাহরণে উল্লেখ করা মূল উপাদান:

  • rememberSupportingPaneScaffoldNavigator: কম্পোজেবল যা প্যানেলের দৃশ্যমানতা ম্যানেজ করার জন্য একটি নেভিগেটর তৈরি করে (যেমন, কমপ্যাক্ট স্ক্রিনে সাপোর্টিং প্যানেল লুকানো বা দেখানো)
  • mainPane: কম্পোজেবল যা প্রাথমিক কন্টেন্ট দেখায়
  • supportingPane: কম্পোজেবল যা সাপ্লিমেন্টারি কন্টেন্ট দেখায়

প্রয়োগের বিস্তারিত উদাহরণের জন্য, দেখুন:

অতিরিক্ত সম্পদ