Android 樣式系統(tǒng) | 主題背景屬性

在 Android 樣式系統(tǒng)系列的前幾篇文章中,我們介紹了主題背景與樣式的區(qū)別,以及為什么說通過主題背景和公共主題背景屬性來分解您要實現(xiàn)的內(nèi)容是一個不錯的主意,請點擊鏈接回顧:

這會讓我們通過創(chuàng)建更少的布局或樣式,以隔離主題背景中的修改。在實際開發(fā)中,您通常希望根據(jù)主題背景改變顏色,因此您應(yīng)該始終通過主題背景屬性來引用顏色。

這意味著您可以將如下代碼視為有代碼異味 (Code smell):

<!-- Copyright 2019 Google LLC.  
   SPDX-License-Identifier: Apache-2.0 -->
<View …
  android:background="@color/white"/>

相反,您應(yīng)該使用主題背景屬性,它允許您按主題更改顏色,例如,在 深色主題 中提供一個不同的值:

<!-- Copyright 2019 Google LLC.
   SPDX-License-Identifier: Apache-2.0 -->
<View …
  android:background="?attr/colorSurface"/>

即使您當(dāng)前不支持其他主題 (什么,您的應(yīng)用還沒有支持深色主題?),我們依然建議您采用這種方法,因為這樣會讓新主題的采用變得更加簡單。

合格的 Colors 文件

您可以通過在不同的配置中添加不同的值來改變顏色 (例如,在 res/values/colors.xml 中和在 res/values-night/colors.xml 中的備選值里均定義 @color/foo),但我們依然建議您使用主題背景屬性來替代它們。對顏色層級的區(qū)分,會迫使您給顏色賦予語義化名稱,換句話說,您應(yīng)該不會在給顏色命名為 @color/white 的同時,又為深色模式提供一個深色變體,這會讓人感到非常困惑。所以,您可能會想要使用一個語義化名稱,例如 @color/background。這種方法帶來的問題是它合并了顏色聲明和具體的值,因此,它并沒有指出顏色是可以或者能夠隨主題背景而變化的。

@colors 的變化也會鼓勵您創(chuàng)造更多顏色。如果在不同的情境下要使用具有相同值的、新的語義化命名的顏色 (即,不是背景色但應(yīng)該使用相同顏色),這時候您仍需要在 colors 文件中創(chuàng)建新的條目。通過使用主題背景屬性,我們可以將語義顏色的聲明從提供它們的值中區(qū)分開來,而且讓使用方更清楚地了解到顏色會隨主題背景而變化 (因為它們使用 ?attr/ 語法)。將顏色聲明保持為字面值,您就可以自定義應(yīng)用使用的顏色調(diào)色板,并在主題背景級別修改它們,這會讓 color.xml 較小且易維護。

這種方法的額外好處是,布局/樣式引用這些顏色時復(fù)用性變得更高。由于主題背景可以被覆蓋或者改變,因此這間接表示: 您不需要創(chuàng)建其他布局或樣式就可以更改某些顏色——您可以在相同的布局中使用不同的主題背景。

始終使用?

在某些情況下,您或許不想按照主題背景更改顏色。例如,在 Material Design 規(guī)范文檔 中提到,您可能希望在淺色和深色主題中均使用同一類型的顏色。

在這種特殊情況下,直接引用顏色資源是再合適不過的:

<!-- Copyright 2019 Google LLC.  
   SPDX-License-Identifier: Apache-2.0 -->
<FloatingActionButton …
  app:backgroundTint="@color/owl_pink_500"/>

當(dāng)前發(fā)展?fàn)顩r

當(dāng)使用 ColorStateLists 時,您可能也不會在您的布局/樣式中直接引用主題背景屬性。

<!-- Copyright 2019 Google LLC.  
   SPDX-License-Identifier: Apache-2.0 -->
<View …
  android:background="@color/primary_20"/>

如果 primary_20 是一個 ColorStateList,它本身引用主題背景屬性來獲取色值也可能是合理的 (請參見下文)。ColorStateLists 通常為不同的狀態(tài) (按下,禁用等) 提供不同的顏色,但它還有另外一種可用于主題化功能您可在選取的顏色上指定透明度值:

<!-- Copyright 2019 Google LLC.  
   SPDX-License-Identifier: Apache-2.0 -->
<selector …
  <item android:alpha="0.20" android:color="?attr/colorPrimary" />
</selector>

這種單項 ColorStateList (即只提供單個默認顏色,而非每種狀態(tài)的不同顏色) 有助于減少您需要維護的顏色資源數(shù)量。它并沒有定義一個新的顏色資源的方式來手動為您 (每一個配置文件) 的 primary 顏色設(shè)置 alpha 值,而是通過改變當(dāng)前主題背景中的 colorPrimary 的方式。如果您的原始顏色發(fā)生了變化,則只需要在一個地方進行更新,無需調(diào)整所有已更新的地方。

雖然此技術(shù)很有用,但仍有一些注意事項:

  1. 如果指定的顏色也具有 alpha 值,則 alpha 會被合并。例如,將 50% 的 alpha 應(yīng)用于 50% 的不透明白色中,將產(chǎn)生 25% 的白色:
<!-- Copyright 2019 Google LLC.  
   SPDX-License-Identifier: Apache-2.0 -->
<selector …
  <item android:alpha="0.50" android:color="#80ffffff" />
</selector>

因此,最好將主題背景顏色指定為完全不透明,然后使用 ColorStateLists 修改它們的 alpha。

  1. 僅在 API 23 中添加了 alpha 組件,因此,如果您的最小 sdk 低于這個版本,請確保使用支持此行為的 AppCompatResources.getColorStateList (并始終使用 android:alpha 命名空間,而絕不使用 app:alpha 命名空間)。

  2. 通常,我們使用簡寫法,將顏色設(shè)置為 Drawable,例如:

<!-- Copyright 2019 Google LLC.  
   SPDX-License-Identifier: Apache-2.0 -->
<View …
  android:background="@color/foo"/>

View 的背景是一個 Drawable,此簡寫把給定的顏色強轉(zhuǎn)成了一個 ColorDrawable。但是沒有辦法把 ColorStateList 轉(zhuǎn)換成 Drawable (API 29 之前使用 ColorStateListDrawable 解決這個問題)。

但是,我們可以通過迂回的方式繞過此限制:

<!-- Copyright 2019 Google LLC.  
   SPDX-License-Identifier: Apache-2.0 -->
<View …
  android:background="@drawable/a_solid_white_rectangle_shape_drawable"
  app:backgroundTint="@color/some_color_state_list"/>

請確保您的 backgroundTint 支持您的 View 所需的狀態(tài),例如,如果被禁用時需要更改。

強制執(zhí)行

即使您已經(jīng)說服自己使用主題背景屬性和 ColorStateList,但如何在代碼庫或者團隊中使用呢?您可以在 Code review 期間嘗試保持警惕,但它的擴展性不是很好。更好的方法是依靠工具來解決此問題。

《Making Android Lint Theme Aware》這篇文章簡述了如何通過添加 Lint 檢查來尋找直接引用顏色的用法,并涵蓋了文中提及到的所有建議。

間接使用

使用主題背景屬性和 ColorStateList 將顏色分解為主題背景的方法,可使您的布局和樣式更加靈活,提高代碼復(fù)用性并保持代碼庫的精簡和易維護性。

我們將在后續(xù)文章中介紹更多主題背景的用法以及它們之間的相互影響,感興趣的讀者請繼續(xù)關(guān)注。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

友情鏈接更多精彩內(nèi)容