ফেজ অনুযায়ী মডিফায়ার ব্রেকডাউন

Jetpack Compose বিভিন্ন ফেজ জুড়ে মডিফায়ার এক্সিকিউট করে। নিচে দেওয়া ব্রেকডাউন থেকে জানা যায় যে সাধারণ মডিফায়ার কোন ফেজের অন্তর্গত এবং কখন তাদের আর্গুমেন্ট বা ল্যাম্বডা মূল্যায়ন করা হয়।

ফেজ ১: কম্পোজিশন ফেজ

এইসব মডিফায়ার @Composable বডির মধ্যে সিঙ্ক্রোনাসভাবে আর্গুমেন্ট মূল্যায়ন করে। এখানে রিড করা যেকোনও স্টেট কম্পোজেবল রিস্টার্ট স্কোপের সাথে একটি ডিপেন্ডেন্সি রেজিস্টার করে এবং পরিবর্তন করা হলে একটি সম্পূর্ণ রিকম্পোজিশন ট্রিগার করে।

  • স্ট্যাটিক ডাইমেনশন ও সাইজিং মডিফায়ার:
    • Modifier.size(dp), Modifier.width(dp), Modifier.height(dp)
    • Modifier.fillMaxSize(), Modifier.fillMaxWidth(), Modifier.fillMaxHeight()
    • Modifier.wrapContentSize(), Modifier.wrapContentWidth(), Modifier.wrapContentHeight()
    • Modifier.requiredSize(), Modifier.defaultMinSize()
    • Modifier.aspectRatio(ratio)
    • Modifier.weight(weight) ( RowScope অথবা ColumnScope-এ)
    • Modifier.width(IntrinsicSize.Min / Max)
    • Modifier.height(IntrinsicSize.Min / Max)
  • স্ট্যাটিক স্পেসিং ও ইনসেট:
    • Modifier.padding(all = dp), Modifier.padding(start, top, end, bottom)
    • Modifier.windowInsetsPadding(insets), Modifier.statusBarsPadding()
  • ডাইরেক্ট ভ্যালু ভিজ্যুয়াল মডিফায়ার:
    • Modifier.alpha(float) (কম্পোজিশন চলাকালীন স্টেট রিড করে)
    • Modifier.rotate(degrees) (কম্পোজিশনের সময় স্টেট রিড করে)
    • Modifier.scale(scaleX, scaleY) (কম্পোজিশনের সময় স্টেট রিড করে)
    • Modifier.background(color = Color, shape = Shape)
    • Modifier.border(width, color, shape)
    • Modifier.shadow(elevation, shape)
    • Modifier.clip(shape)
    • Modifier.blur(radius)
  • স্ট্যাটিক পজিশন মডিফায়ার:
    • Modifier.offset(x = dp, y = dp) (ডাইরেক্ট ভ্যালু ওভারলোড)
    • Modifier.absoluteOffset(x = dp, y = dp)
  • ডায়নামিক কম্পোজেবল মডিফায়ার:
    • Modifier.composed { ... } (কম্পোজিশনের সময় ফ্যাক্টরি বডি রান করে; পারফর্ম্যান্সের জন্য সাজেস্ট করা হয় না—পরিবর্তে কাস্টম মডিফায়ারের জন্য Modifier.Node ব্যবহার করুন)

পর্যায় ২: লেআউট পর্যায়

লেআউট ফেজ দুটি আলাদা সাব-স্টেপে বিভক্ত, যার প্রতিটির জন্য আলাদা ইনভ্যালিডেশন স্কোপ রয়েছে:

ধাপ ২ক: পরিমাপ

সাইজ (width, height) এবং সীমাবদ্ধতা নির্ধারণ করে। এখানে স্টেট রিড আবার পরিমাপ করা এবং আবার প্লেসমেন্ট ট্রিগার করে:

  • Modifier.layout { measurable, constraints -> ... }: পরিমাপ করার সময় layout(w, h)-এর আগে কোড এক্সিকিউট হয়।

ধাপ ২খ: প্লেসমেন্ট ও লেআউট কলব্যাক

(x, y) স্থানাঙ্ক অবস্থান নির্ধারণ করে। প্লেসমেন্ট ব্লকের মধ্যে স্টেট রিড শুধুমাত্র রি-প্লেসমেন্ট ট্রিগার করে (পরিমাপ ও কম্পোজিশন বাদ দিয়ে):

  • Modifier.offset { IntOffset(x, y) } (ল্যাম্বডা ওভারলোড)
  • Modifier.absoluteOffset { IntOffset(x, y) } (ল্যাম্বডা ওভারলোড)
  • Modifier.layout { ... layout(w, h) { placeable.place(x, y) } }: layout(w, h) { ... } ব্লকের ভিতরে কোড।

লেআউট পাস চলাকালীন বা পরে লেআউট অবজারভেশন কলব্যাকও রান করে (এইসব কলব্যাকের মধ্যে কম্পোজিশনে রিড করা হয় এমন স্টেট লেখার কাজ এড়িয়ে চলুন, কারণ এটি করলে ব্যাকওয়ার্ড রাইট হয়):

  • Modifier.onSizeChanged { intSize -> ... }: নোডের ডাইমেনশন পরিবর্তন হলে লেআউট পরিমাপ সম্পূর্ণ হওয়ার পরে ইনভোক করা হয়।
  • Modifier.onPlaced { layoutCoordinates -> ... } এবং Modifier.onLayoutRectChanged { ... }: গ্লোবাল উইন্ডো লেআউট পাসে সাবস্ক্রাইব না করে লোকাল কোঅর্ডিনেট বা বাউন্ড রিপোর্ট করার জন্য প্লেসমেন্টের পরে ইনভোক করা হয়।
  • Modifier.onGloballyPositioned { layoutCoordinates -> ... }: কোনও নোড সরানোর পরে সম্পূর্ণ উইন্ডো লেআউট পাস শেষ হলে ইনভোক করা হয়। সম্ভব হলে onGloballyPositioned এড়িয়ে চলুন; ভিউপোর্ট ট্র্যাকিংয়ের জন্য Modifier.onVisibilityChanged, স্থানীয় বাউন্ডের জন্য Modifier.onPlaced বা Modifier.onLayoutRectChanged অথবা Modifier.Node-এর মধ্যে চাহিদা অনুযায়ী requireLayoutCoordinates() ব্যবহার করুন।

পর্যায় ৩: ড্রয়িং পর্যায়

ক্যানভাসে আঁকার সময় এইসব মডিফায়ার এক্সিকিউট হয়। এইসব ব্লকের মধ্যে স্টেট রিড করলে কম্পোজিশন ও লেআউট উভয়ই এড়িয়ে যায়, শুধুমাত্র ড্র পাস রান করে:

  • Modifier.graphicsLayer { ... }:
    • ল্যাম্বডায় প্রপার্টি আপডেট করা হয়েছে: alpha, translationX, translationY, scaleX, scaleY, rotationX, rotationY, rotationZ, shadowElevation, shape, clip, renderEffect, transformOrigin.
  • Modifier.drawBehind { ... }:
    • কম্পোজেবল কন্টেন্টের পিছনে ক্যানভাস কমান্ড আঁকে।
  • Modifier.drawWithContent { ... }:
    • drawContent()-এর সাহায্যে ড্রয়িং অর্ডার নিয়ন্ত্রণ করে।
  • Modifier.drawWithCache { ... }:
    • Path, Paint বা Brush অবজেক্ট ক্যাশে করতে সাইজ বা লেআউট পরিবর্তনের উপর আউটার ব্লক রান করে; প্রতিটি ফ্রেম ড্রয়ের উপর onDrawBehind বা onDrawWithContent রান করে।

রিকম্পোজিশন লুপের বাইরে - অবজারভেশন মডিফায়ার

অ্যাক্সেসিবিলিটি, ব্যবহারকারীর ইনপুট ও লাইফসাইকেল সংক্রান্ত পর্যবেক্ষণ ম্যানেজ করার জন্য কিছু মডিফায়ার তিনটি ফ্রেম ফেজের বাইরে কাজ করে।

সিম্যান্টিক্স ও অ্যাক্সেসিবিলিটি

অ্যাক্সেসিবিলিটি পরিষেবা (টকব্যাক) এবং পরীক্ষার জন্য শব্দার্থিক প্রপার্টি প্রসেস করে:

  • Modifier.semantics { ... }
  • Modifier.clearAndSetSemantics { ... }

ইনপুট, জেসচার ও ইভেন্ট

তিন-ফেজ ফ্রেম রেন্ডারিং পাইপলাইনের বাইরে কাজ করে, OS মোশন ইভেন্ট এবং ব্যবহারকারীর ইন্টার‍্যাকশন গ্রহণ করে:

  • Modifier.pointerInput(key) { detectTapGestures { ... } } / detectDragGestures / awaitPointerEventScope
  • Modifier.clickable(enabled, onClickLabel) { ... }
  • Modifier.combinedClickable { ... }
  • Modifier.toggleable { ... }
  • Modifier.selectable { ... }
  • Modifier.draggable(...) / Modifier.scrollable(...) / Modifier.draggable2D(...)
  • Modifier.onFocusChanged { focusState -> ... }
  • Modifier.onKeyEvent { keyEvent -> ... }
  • Modifier.onVisibilityChanged { isVisible -> ... }: কনফিগার করা বিলম্বের পরে, একটি কোরুটিনে, কম্পোজেবলের দৃশ্যমানতা পরিবর্তিত হলে কলব্যাকটি চালু করা হয়।

দ্রুত রেফারেন্স: ভ্যালু বনাম ল্যাম্বডা ফেজ

ল্যাম্বডায় স্টেট ভ্যালু রিড করলে, রিড করার প্রসেসটি পরবর্তী ফেজে পিছিয়ে যায়, যা স্টেট পরিবর্তন হলে আগের ফেজগুলি স্কিপ করে:

মডিফায়ার / প্যাটার্ন সরাসরি মান (কম্পোজিশন) ল্যাম্বডা ভ্যারিয়েন্ট (বিলম্বিত ফেজ) যখন স্ট্যাটাস পরিবর্তন হয়
অফসেট Modifier.offset(x, y) Modifier.offset { IntOffset(x, y) } লেআউট (প্লেসমেন্ট) (কম্পোজিশন এড়িয়ে যায়)
আলফা / অস্বচ্ছতা Modifier.alpha(alpha) Modifier.graphicsLayer { this.alpha = alpha } ড্রয়িং (কম্পোজিশন ও লেআউট এড়িয়ে যায়)
রোটেশন Modifier.rotate(degrees) Modifier.graphicsLayer { rotationZ = degrees } ড্রয়িং (কম্পোজিশন ও লেআউট এড়িয়ে যায়)
স্কেল Modifier.scale(scale) Modifier.graphicsLayer { scaleX = s; scaleY = s } ড্রয়িং (কম্পোজিশন ও লেআউট এড়িয়ে যায়)
অনুবাদ Modifier.padding(...) Modifier.graphicsLayer { translationX = ... } ড্রয়িং (কম্পোজিশন ও লেআউট এড়িয়ে যায়)
ব্যাকগ্রাউন্ডের রঙ Modifier.background(color) Modifier.drawBehind { drawRect(color) } ড্রয়িং (কম্পোজিশন ও লেআউট এড়িয়ে যায়)
স্ক্রল / প্যারালাক্স Modifier.offset(scroll.dp) Modifier.offset { IntOffset(0, scroll) } লেআউট (প্লেসমেন্ট) (কম্পোজিশন এড়িয়ে যায়)

Modifier.Node ইন্টারফেস ম্যাপিং

হাই-পারফর্ম্যান্স Modifier.Node API ব্যবহার করে কাস্টম মডিফায়ারের জন্য, ফেজ সরাসরি নোড ক্যাপাবিলিটি ইন্টারফেসে ম্যাপ করে:

পর্যায় Modifier.Node ইন্টারফেস Core Methods
লেআউট (পরিমাপ ও প্লেস) LayoutModifierNode measure(measurable, constraints)
লেআউট (গ্লোবাল কোঅর্ডিনেট) GlobalPositionAwareModifierNode (চাহিদা অনুযায়ী requireLayoutCoordinates() পছন্দ করুন) onGloballyPositioned(coordinates)
লেআউট (প্লেসমেন্ট) LayoutAwareModifierNode onRemeasured(size), onPlaced(coordinates)
Drawing DrawModifierNode draw(ContentDrawScope)
ইনপুট / পয়েন্টার PointerInputModifierNode onPointerEvent(...), onCancelPointerInput()
শব্দার্থবিদ্যা SemanticsModifierNode applySemantics(SemanticsPropertyReceiver)
ফোকাস FocusEventModifierNode onFocusEvent(focusState)