Compose লেআউট মডেল আপনাকে AlignmentLine ব্যবহার করে কাস্টম অ্যালাইনমেন্ট লাইন তৈরি করতে দেয় যা পেরেন্ট লেআউট ব্যবহার করে চাইল্ড লেআউট অ্যালাইন ও পজিশন করতে পারে। যেমন, Row তার চাইল্ড কাস্টম অ্যালাইনমেন্ট লাইন ব্যবহার করে
সেগুলিকে অ্যালাইন করতে পারে।
কোনও লেআউট নির্দিষ্ট AlignmentLine-এর জন্য ভ্যালু প্রদান করলে, লেআউটের
প্যারেন্ট, সংশ্লিষ্ট Placeable ইনস্ট্যান্সে Placeable.get
অপারেটর ব্যবহার করে, পরিমাপ করার পরে এই ভ্যালু পড়তে পারে। AlignmentLine-এর অবস্থানের উপর ভিত্তি করে,
অভিভাবকরা তখন বাচ্চাদের অবস্থান নির্ধারণ করতে পারেন।
Compose-এ কিছু কম্পোজেবল আগে থেকেই অ্যালাইনমেন্ট লাইন সহ আসে। যেমন,
BasicText কম্পোজেবল FirstBaseline এবং LastBaseline
অ্যালাইনমেন্ট লাইন এক্সপোজ করে।
নিচের উদাহরণে, firstBaselineToTop নামের একটি কাস্টম LayoutModifier
FirstBaseline পড়ে যাতে Text-এর প্রথম বেসলাইন থেকে শুরু করে
প্যাডিং যোগ করা যায়।
fun Modifier.firstBaselineToTop( firstBaselineToTop: Dp, ) = layout { measurable, constraints -> // Measure the composable val placeable = measurable.measure(constraints) // Check the composable has a first baseline check(placeable[FirstBaseline] != AlignmentLine.Unspecified) val firstBaseline = placeable[FirstBaseline] // Height of the composable with padding - first baseline val placeableY = firstBaselineToTop.roundToPx() - firstBaseline val height = placeable.height + placeableY layout(placeable.width, height) { // Where the composable gets placed placeable.placeRelative(0, placeableY) } } @Preview @Composable private fun TextWithPaddingToBaseline() { MaterialTheme { Text("Hi there!", Modifier.firstBaselineToTop(32.dp)) } }
উদাহরণে FirstBaseline পড়তে, পরিমাপের পর্যায়ে
placeable [FirstBaseline] ব্যবহার করা হয়।
নিম্নলিখিত উদাহরণে paddingFrom ব্যবহার করে
Text-এর প্রথম বেসলাইন উপর থেকে ৩২ dp-তে প্লেস করা হয়েছে, যেমন firstBaselineToTop উদাহরণে দেখানো হয়েছে। টেক্সটের প্রথম ও শেষ বেসলাইন থেকে
প্যাড করতে, paddingFromBaseline ব্যবহার করুন।
@Composable private fun TextWithPaddingFromBaseline() { MaterialTheme { Text("Hi there!", Modifier.paddingFrom(FirstBaseline, before = 32.dp)) } }
Text-এর প্রথম বেসলাইনের আগে
৩২ ডিপি প্যাডিং থাকতে হবে।একটি সারির চিল্ড্রেন আইটেম অ্যালাইন করুন
Row-এ, alignByBaseline এবং alignBy মডিফায়ারগুলি
অ্যালাইনমেন্ট লাইনে চিলড্রেনকে একে অপরের সাথে অ্যালাইন করে। দুটি মডিফায়ারই
RowScope-এর মেম্বার, তাই আপনি এগুলি শুধুমাত্র RowScope-এর মধ্যে ব্যবহার করতে পারবেন, যেমন
Row-এর কন্টেন্ট। প্রতিটি চাইল্ডের ক্ষেত্রে মডিফায়ার প্রয়োগ করুন যা অবশ্যই অ্যালাইন করতে হবে। কোনও বাচ্চার এটি না থাকলে,
এবং align না থাকলে, Row-এর verticalAlignment অনুসরণ করে।
নিচের উদাহরণে, আলাদা সাইজের দুটি টেক্সটকে তাদের প্রথম বেসলাইনে অ্যালাইন করা হয়েছে:
@Composable private fun TitleWithSubtitle() { MaterialTheme { Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { Text( "Title", modifier = Modifier.alignByBaseline(), style = MaterialTheme.typography.headlineMedium ) Text( "Subtitle", modifier = Modifier.alignByBaseline(), style = MaterialTheme.typography.bodySmall ) } } }
Text এলিমেন্ট
তাদের প্রথম বেসলাইনে অ্যালাইন করা হয়েছে।alignByBaseline ও alignBy(FirstBaseline) একই। অ্যালাইনমেন্ট লাইন নয় এমন কোনও পজিশনে
অ্যালাইন করতে, alignBy-এ একটি ব্লক পাস করুন। ব্লকটি
পরিমাপ করা চাইল্ড গ্রহণ করে এবং চাইল্ডের উপর থেকে যে লাইনে অ্যালাইন করতে হবে তার দূরত্ব পিক্সেল হিসেবে
ফেরত দেয়। নিচের উদাহরণে, একটি ছোট বক্সের মাঝের অংশটি
তার পাশের টেক্সটের বেসলাইনে বসে:
@Composable private fun BoxMiddleOnBaseline() { MaterialTheme { Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { Box( modifier = Modifier .size(8.dp) .background(Color.Gray) // Aligns the middle of the box with the text baseline. .alignBy { it.measuredHeight / 2 } ) Text( "Label", modifier = Modifier.alignByBaseline() ) } } }
Box যার উল্লম্ব কেন্দ্র
সংলগ্ন Text-এর বেসলাইনের সাথে সারিবদ্ধ।যেসব বাচ্চা এই মডিফায়ার ব্যবহার করে তারা একটি গ্রুপ তৈরি করে। Row গ্রুপের অন্তত একটি চাইল্ডকে এমনভাবে প্লেস করে যেন এটির Alignment.Top আছে এবং অন্যদের এমনভাবে পজিশন করে যাতে তাদের লাইন ম্যাচ করে। গ্রুপে একা থাকা কোনও বাচ্চাকে এমনভাবে রাখা হয় যেন
তার Alignment.Top আছে, তাই এটি কোনও কিছুর সাথে অ্যালাইন করে না। alignBy হল
align-এর একটি ফর্ম, তাই দুটি মডিফায়ার একই চাইল্ডের উপর একসাথে কাজ করে না।
paddingFrom এবং alignBy আলাদা আলাদা সমস্যার সমাধান করে: paddingFrom নিজের অ্যালাইনমেন্ট লাইনের উপর ভিত্তি করে
একটি এলিমেন্টে প্যাডিং যোগ করে এবং alignBy একে অপরের সাথে
সিবলিং অ্যালাইন করে।
Column-এ, alignBy একটি VerticalAlignmentLine বা ব্লক নেয় এবং
চাইল্ডকে অনুভূমিকভাবে অ্যালাইন করে। ColumnScope-এর কোনও alignByBaseline নেই।
কাস্টম অ্যালাইনমেন্ট লাইন তৈরি করুন
কাস্টম Layout কম্পোজেবল বা কাস্টম
LayoutModifier তৈরি করার সময়, আপনি কাস্টম অ্যালাইনমেন্ট লাইন প্রদান করতে পারেন যাতে অন্যান্য
পেরেন্ট কম্পোজেবল সেগুলি ব্যবহার করে সেই অনুযায়ী চিলড্রেন কম্পোজেবল অ্যালাইন ও পজিশন করতে
পারে।
নিম্নলিখিত উদাহরণে একটি কাস্টম BarChart কম্পোজেবল দেখানো হয়েছে যা দুটি
অ্যালাইনমেন্ট লাইন, MaxChartValue এবং MinChartValue দেখায়, যাতে অন্যান্য কম্পোজেবল
চার্টের সর্বাধিক এবং সর্বনিম্ন ডেটা ভ্যালুর সাথে অ্যালাইন করতে পারে। দুটি টেক্সট এলিমেন্ট,
সর্বাধিক এবং সর্বনিম্ন, কাস্টম অ্যালাইনমেন্ট লাইনের কেন্দ্রে অ্যালাইন করা হয়েছে।
BarChart টেক্সটের সাথে কম্পোজেবল
সর্বাধিক এবং সর্বনিম্ন ডেটা ভ্যালুর সাথে অ্যালাইন করা হয়েছে।কাস্টম অ্যালাইনমেন্ট লাইন আপনার প্রোজেক্টে টপ-লেভেল ভেরিয়েবল হিসেবে সংজ্ঞায়িত করা হয়।
/** * AlignmentLine defined by the maximum data value in a [BarChart] */ private val MaxChartValue = HorizontalAlignmentLine(merger = { old, new -> min(old, new) }) /** * AlignmentLine defined by the minimum data value in a [BarChart] */ private val MinChartValue = HorizontalAlignmentLine(merger = { old, new -> max(old, new) })
আমাদের উদাহরণ তৈরি করার জন্য কাস্টম অ্যালাইনমেন্ট লাইনগুলি
HorizontalAlignmentLine ধরনের, কারণ
সেগুলি চিলড্রেনকে উল্লম্বভাবে অ্যালাইন করতে ব্যবহার করা হয়। একাধিক লে-আউট এই অ্যালাইনমেন্ট লাইনের জন্য কোনও ভ্যালু প্রদান করলে,
মার্জ নীতি প্যারামিটার হিসেবে পাস করা হয়। যেহেতু
Compose লেআউট সিস্টেম কোঅর্ডিনেট এবং Canvas
কোঅর্ডিনেট [0, 0], উপরের বাঁদিকের কোণ এবং x ও y অক্ষ
নিচের দিকে পজিটিভ, তাই MaxChartValue ভ্যালু সবসময়
MinChartValue-এর থেকে ছোট হবে। তাই, সর্বাধিক চার্ট ডেটা ভ্যালু বেসলাইনের জন্য মার্জ নীতি হল min এবং সর্বনিম্ন চার্ট ডেটা ভ্যালু বেসলাইনের জন্য মার্জ নীতি হল max।
কাস্টম Layout বা LayoutModifier তৈরি করার সময়, MeasureScope.layout পদ্ধতিতে কাস্টম অ্যালাইনমেন্ট
লাইন নির্দিষ্ট করুন, যা একটি
alignmentLines: Map<AlignmentLine, Int> প্যারামিটার নেয়।
@Composable private fun BarChart( dataPoints: List<Int>, modifier: Modifier = Modifier, ) { val maxValue: Float = remember(dataPoints) { dataPoints.maxOrNull()!! * 1.2f } BoxWithConstraints(modifier = modifier) { val density = LocalDensity.current with(density) { // ... // Calculate baselines val maxYBaseline = // ... val minYBaseline = // ... Layout( content = {}, modifier = Modifier.drawBehind { // ... } ) { _, constraints -> with(constraints) { layout( width = if (hasBoundedWidth) maxWidth else minWidth, height = if (hasBoundedHeight) maxHeight else minHeight, // Custom AlignmentLines are set here. These are propagated // to direct and indirect parent composables. alignmentLines = mapOf( MinChartValue to minYBaseline.roundToInt(), MaxChartValue to maxYBaseline.roundToInt() ) ) {} } } } } }
এই কম্পোজেবলের ডাইরেক্ট ও ইনডাইরেক্ট পেরেন্ট অ্যালাইনমেন্ট লাইন
ব্যবহার করতে পারে। নিম্নলিখিত কম্পোজেবল একটি কাস্টম লেআউট তৈরি করে যা প্যারামিটার হিসেবে দুটি Text স্লট ও ডেটা পয়েন্ট নেয় এবং দুটি টেক্সটকে চার্টের ডেটার সর্বাধিক ও সর্বনিম্ন ভ্যালুর সাথে অ্যালাইন করে। এই কম্পোজেবলের প্রিভিউ
ছবি ৫-এ দেখানো হয়েছে।
@Composable private fun BarChartMinMax( dataPoints: List<Int>, maxText: @Composable () -> Unit, minText: @Composable () -> Unit, modifier: Modifier = Modifier, ) { Layout( content = { maxText() minText() // Set a fixed size to make the example easier to follow BarChart(dataPoints, Modifier.size(200.dp)) }, modifier = modifier ) { measurables, constraints -> check(measurables.size == 3) val placeables = measurables.map { it.measure(constraints.copy(minWidth = 0, minHeight = 0)) } val maxTextPlaceable = placeables[0] val minTextPlaceable = placeables[1] val barChartPlaceable = placeables[2] // Obtain the alignment lines from BarChart to position the Text val minValueBaseline = barChartPlaceable[MinChartValue] val maxValueBaseline = barChartPlaceable[MaxChartValue] layout(constraints.maxWidth, constraints.maxHeight) { maxTextPlaceable.placeRelative( x = 0, y = maxValueBaseline - (maxTextPlaceable.height / 2) ) minTextPlaceable.placeRelative( x = 0, y = minValueBaseline - (minTextPlaceable.height / 2) ) barChartPlaceable.placeRelative( x = max(maxTextPlaceable.width, minTextPlaceable.width) + 20, y = 0 ) } } } @Preview @Composable private fun ChartDataPreview() { MaterialTheme { BarChartMinMax( dataPoints = listOf(4, 24, 15), maxText = { Text("Max") }, minText = { Text("Min") }, modifier = Modifier.padding(24.dp) ) } }
আপনার জন্য সাজেস্ট করা হয়েছে
- মনে রাখবেন: জাভাস্ক্রিপ্ট বন্ধ থাকলে লিঙ্ক টেক্সট দেখানো হয়
- Compose-এ গ্রাফিক
- কাস্টম লেআউট {:#custom-layouts }
- Compose লেআউটে ইন্ট্রিনসিক পরিমাপ