MaterialKolor 开源项目教程

MaterialKolor 开源项目教程

MaterialKolor🎨 A Compose multiplatform library for generating dynamic Material3 color schemes from a seed color项目地址:https://gitcode.com/gh_mirrors/ma/MaterialKolor

项目介绍

MaterialKolor 是一个强大的 Kotlin 多平台库，专为创建基于任何颜色的动态 Material Design 3 调色板而设计。灵感来源于 m3.material.io，它可以让你像在 Material Design 3 主题构建器中一样自定义你的颜色方案。这个库不仅适用于 Android，还能在 iOS、JVM（桌面）和 JavaScript（浏览器）上运行。

项目快速启动

添加依赖

首先，在你的项目的 build.gradle.kts 文件中添加 MaterialKolor 依赖：

dependencies {
    implementation("com.github.jordond:materialkolor:1.0.0")
}

初始化主题

在你的应用中初始化 MaterialKolor 主题：

import com.github.jordond.materialkolor.DynamicMaterialTheme

fun main() {
    val theme = DynamicMaterialTheme(seedColor = 0xFF6200EE)
    // 使用 theme 进行 UI 渲染
}

应用案例和最佳实践

动态主题切换

MaterialKolor 允许用户根据品牌标识色或用户偏好动态调整 UI 色彩。例如，根据品牌标识色生成应用主题：

val brandColor = 0xFF6200EE
val theme = DynamicMaterialTheme(seedColor = brandColor)
// 应用 theme 到 UI

夜间模式

通过深浅色调切换实现视觉体验：

val isNightMode = true
val theme = DynamicMaterialTheme(seedColor = 0xFF6200EE, isDarkMode = isNightMode)
// 应用 theme 到 UI

用户自定义颜色方案

用户可以选择自己喜欢的颜色生成主题：

val userSelectedColor = 0xFF4CAF50
val theme = DynamicMaterialTheme(seedColor = userSelectedColor)
// 应用 theme 到 UI

典型生态项目

kmPalette

kmPalette 是一个结合 MaterialKolor 使用的库，可以从图像中提取颜色生成色彩主题：

import com.github.jordond.materialkolor.kmPalette

val imageUrl = "https://example.com/image.jpg"
val palette = kmPalette.fromImage(imageUrl)
val theme = DynamicMaterialTheme(seedColor = palette.dominantColor)
// 应用 theme 到 UI

通过这些步骤，你可以快速上手并充分利用 MaterialKolor 库，为你的应用带来更加生动和个性化的色彩体验。

MaterialKolor🎨 A Compose multiplatform library for generating dynamic Material3 color schemes from a seed color项目地址:https://gitcode.com/gh_mirrors/ma/MaterialKolor