阅读 545

Accompanist组件库中文指南 - AppCompat Theme篇

这是我参与更文挑战的第10天,活动详情查看: 更文挑战
本文翻译自 Accompanist 官方文档 - AppCompat Theme

目前有一个正在进行的 Jetpack Compose中文手册 项目,旨在帮助开发者更好的理解和掌握 Compose 框架,目前仍还在开荒中,欢迎大家进行关注与加入!

这篇文章由本人翻译撰写,目前已经发布到该手册中,欢迎进行查阅。

请关注微信公众号 Jetpack Compose 博物馆 获取更多 Compose 技术信息。

概述

这个库将允许开发者将传统 AppCompat XML 主题配置复用到 Jetpack Compose

Jetpack Compose 的基础主题配置采用 MaterialTheme, 可以通过配置 ColorsShapesTypography 等参数来定制你的主题效果,具体操作过程与工作原理详见 主题 章节。

MaterialTheme(
    typography = type,
    colors = colors,
    shapes = shapes
) {
    // Surface, Scaffold, etc
}
复制代码

AppCompat XML 主题配置允许开发者通过 XML 标签属性进行类似但更粗略的主题设置。

<style name="Theme.MyApp" parent="Theme.AppCompat.DayNight">
    <item name="colorPrimary">@color/purple_500</item>
    <item name="colorAccent">@color/green_200</item>
</style>
复制代码

这个库尝试拉近 AppCompat XML 主题配置与 Jetpack Compose 主题配置的距离。允许 Jetpack Compose 主题配置 MaterialTheme 可以基于 Activity 的 XML 主题配置。

AppCompatTheme {
    // MaterialTheme.colors, MaterialTheme.shapes, MaterialTheme.typography
    // will now contain copies of the context's theme
}
复制代码

每当你打算将一个现有应用的某个 UI 容器迁移至 Jetpack Compose,这个库所提供的主题配置能力将会使迁移过程变得非常容易。

⚠️ 注意

如果你在你的应用中使用了 Material Design Components, 你应该使用 MDC Compose Theme Adapter,它将会更精细地读取你的主题配置。

定制化主题

通过使用 AppCompatTheme() 将会自动读取当前宿主 context 的 AppCompat XML 主题配置,并将其写入到 MaterialTheme 中。 如果你想读取 AppCompat XML 主题配置的数据信息,进行数据修改后再传入 MaterialTheme ,可以使用 createAppCompatTheme() 来完成。

val context = LocalContext.current
var (colors, type) = context.createAppCompatTheme()

// Modify colors or type as required. Then pass them
// through to MaterialTheme...

MaterialTheme(
    colors = colors,
    typography = type
) {
    // rest of layout
}
复制代码

生成主题

通过一个 AppCompat XML 主题配置来生成 MaterialTheme 其实并不完美,因为 AppCompat XML 主题配置没有提供与 MaterialTheme 相同的定制能力。接下来我们来看看 MaterialTheme 所提供的定制能力。

Colors

AppCompat XML 主题配置只有一个有限的顶级配色属性集合,这意味着 AppCompatTheme() 在一些特定场景中不得不生成一个替代配色。当前属性映射表如下

MaterialTheme 配色AppCompat 配置
primarycolorPrimary
primaryVariantcolorPrimaryDark
onPrimary⚠️Calculated black/white
secondarycolorAccent
secondaryVariantcolorAccent
onSecondary⚠️Calculated black/white
surfaceDefault
onSurfaceandroid:textColorPrimary, else ⚠️calculated black/white
backgroundandroid:colorBackground
onBackgroundandroid:textColorPrimary, else ⚠️ calculated black/white
errorcolorError
onError⚠️Calculated black/white

表中所提到的 ⚠️Calculated black/white ,这意味着当前配色的具体值取决于哪种颜色与相应的背景颜色形成的对比值大。

Typography

AppCompat XML 主题配置没有提供类似与headline6、body1这种语义上的文本样式表示,而是依赖于特殊组件或使用场景下的文本样式标识。因此,我们从 AppCompat XML 主题配置中能够读取到的唯一事物只有默认的 app:fontFamilyandroid:fontFamily 。举个例子。

<style name="Theme.MyApp" parent="Theme.AppCompat">
    <item name="fontFamily">@font/my_font</item>
</style>
复制代码

Compose 当前还不支持可动态从外部下载的字体,所以主题中的任何字体引用都需要来自你的本地资源。详情查看这里获取更多有关信息。

Shape

AppCompat XML 主题配置没有 Shape 主题配置的概念,因此我们使用的是 MaterialTheme 默认的 Shape 主题配置。如果你想提供定制的 Shape 主题配置信息,可以通过 AppCompatThemeshapes 参数进行配置。

局限性

目前该库在实现上还是存在一些局限性的

  • 这依赖于你的 Activity / Context 的主题配置是否拓展了某个 AppCompat XML 主题。
  • Compose 还不支持 Variable fonts,这意味着 android:fontVariationSettings 的值目前被忽略。
  • 你可以根据需要在 Compose 中修改产生的MaterialTheme,但这只在Compose中有效。你所做的任何改变都不会反映在 Activity 主题配置中。

下载

repositories {
    mavenCentral()
}

dependencies {
    implementation "com.google.accompanist:accompanist-appcompat-theme:<version>"
}
复制代码

每个版本可以在 快照仓库 中被找到,每次提交时都会更新。

文章分类
Android