রচনায় একটি থিমের অ্যানাটমি

জেটপ্যাক কম্পোজের থিমগুলি অনেকগুলি নিম্ন-স্তরের কনস্ট্রাক্ট এবং সম্পর্কিত APIগুলি নিয়ে গঠিত৷ এগুলো MaterialTheme এর সোর্স কোডে দেখা যায় এবং কাস্টম ডিজাইন সিস্টেমেও প্রয়োগ করা যেতে পারে।

থিম সিস্টেম ক্লাস

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

উদাহরণ স্বরূপ, MaterialTheme মধ্যে ColorScheme (রঙ সিস্টেম), Typography (টাইপোগ্রাফি সিস্টেম), এবং Shapes (শেপ সিস্টেম) অন্তর্ভুক্ত রয়েছে।

দ্রষ্টব্য: কম্পোজ কম্পাইলারকে তথ্য প্রদানের জন্য ক্লাসগুলি Stable বা @Immutable দিয়ে টীকা করা উচিত। আরও জানতে, লাইফ সাইকেল অফ কম্পোজেবল গাইড দেখুন।

@Immutable
data class ColorSystem(
    val color: Color,
    val gradient: List<Color>
    /* ... */
)

@Immutable
data class TypographySystem(
    val fontFamily: FontFamily,
    val textStyle: TextStyle
)
/* ... */

@Immutable
data class CustomSystem(
    val value1: Int,
    val value2: String
    /* ... */
)

/* ... */
ThemeAnatomySnippets.kt

থিম সিস্টেম রচনা স্থানীয়দের

থিম সিস্টেম ক্লাসগুলি কম্পোজিশন ট্রিকে CompositionLocal ইনস্ট্যান্স হিসাবে অন্তর্নিহিতভাবে প্রদান করা হয়। এটি থিমিং মানগুলিকে কম্পোজযোগ্য ফাংশনে স্ট্যাটিকভাবে উল্লেখ করার অনুমতি দেয়।

CompositionLocal সম্পর্কে আরও জানতে, CompositionLocal গাইডের সাথে স্থানীয়ভাবে স্কোপড ডেটা দেখুন।

দ্রষ্টব্য: আপনি compositionLocalOf বা staticCompositionLocalOf দিয়ে একটি ক্লাসের CompositionLocal তৈরি করতে পারেন। এই ফাংশনগুলির একটি defaultFactory ট্রেইলিং ল্যাম্বডা রয়েছে যা তারা প্রদান করছে একই ধরণের ফলব্যাক মান প্রদান করতে। Color.Unspecified , TextStyle.Default ইত্যাদির মতো যুক্তিসঙ্গত ডিফল্ট ব্যবহার করা ভালো ধারণা।

val LocalColorSystem = staticCompositionLocalOf {
    ColorSystem(
        color = Color.Unspecified,
        gradient = emptyList()
    )
}

val LocalTypographySystem = staticCompositionLocalOf {
    TypographySystem(
        fontFamily = FontFamily.Default,
        textStyle = TextStyle.Default
    )
}

val LocalCustomSystem = staticCompositionLocalOf {
    CustomSystem(
        value1 = 0,
        value2 = ""
    )
}

/* ... */
ThemeAnatomySnippets.kt

থিম ফাংশন

থিম ফাংশন হল এন্ট্রি পয়েন্ট এবং প্রাথমিক API। এটি থিম সিস্টেম CompositionLocal s-এর দৃষ্টান্ত তৈরি করে — বাস্তব মান ব্যবহার করে যে কোনও যুক্তি প্রয়োজন — যা CompositionLocalProvider এর সাথে কম্পোজিশন ট্রিতে দেওয়া হয়। content পরামিতি নেস্টেড কম্পোজেবলগুলিকে অনুক্রমের সাথে সম্পর্কিত থিমিং মানগুলি অ্যাক্সেস করতে দেয়।

@Composable
fun Theme(
    /* ... */
    content: @Composable () -> Unit
) {
    val colorSystem = ColorSystem(
        color = Color(0xFF3DDC84),
        gradient = listOf(Color.White, Color(0xFFD7EFFF))
    )
    val typographySystem = TypographySystem(
        fontFamily = FontFamily.Monospace,
        textStyle = TextStyle(fontSize = 18.sp)
    )
    val customSystem = CustomSystem(
        value1 = 1000,
        value2 = "Custom system"
    )
    /* ... */
    CompositionLocalProvider(
        LocalColorSystem provides colorSystem,
        LocalTypographySystem provides typographySystem,
        LocalCustomSystem provides customSystem,
        /* ... */
        content = content
    )
}
ThemeAnatomySnippets.kt

থিম অবজেক্ট

সুবিধার বৈশিষ্ট্য সহ একটি বস্তু ব্যবহার করে থিম সিস্টেম অ্যাক্সেস করা হয়। সামঞ্জস্যের জন্য, বস্তুটিকে থিম ফাংশনের মতোই নামকরণ করা হয়। বৈশিষ্ট্য শুধুমাত্র বর্তমান রচনা স্থানীয় পেতে.

// Use with eg. Theme.colorSystem.color
object Theme {
    val colorSystem: ColorSystem
        @Composable
        get() = LocalColorSystem.current
    val typographySystem: TypographySystem
        @Composable
        get() = LocalTypographySystem.current
    val customSystem: CustomSystem
        @Composable
        get() = LocalCustomSystem.current
    /* ... */
}
ThemeAnatomySnippets.kt

{% শব্দার্থে %} {% endverbatim %}