Android自定義ActionBar的風(fēng)格

編寫:Vincent 4J - 原文:http://developer.android.com/training/basics/actionbar/styling.html

Action bar 為用戶提供一種熟悉可預(yù)測的方式來展示操作和導(dǎo)航，但是這并不意味著我們的 app 要看起來和其他 app 一樣。如果想將 action bar 的風(fēng)格設(shè)計的合乎我們產(chǎn)品的定位，只需簡單地使用 Android 的 樣式和主題 資源。

Android 包括一少部分內(nèi)置的 activity 主題，這些主題中包含 “dark” 或 “l(fā)ight” 的 action bar 樣式。我們也可以擴(kuò)展這些主題，以便于更好的為 action bar 自定義外觀。

注意：如果我們?yōu)?action bar 使用了 Support 庫的 API，那我們必須使用（或重寫） Theme.AppCompat 家族樣式（甚至 Theme.Holo 家族，在 API level 11 或更高版本中可用）。如此一來，聲明的每一個樣式屬性都必須被聲明兩次：一次使用系統(tǒng)平臺的樣式屬性（android: 屬性），另一次使用 Support 庫中的樣式屬性（appcompat.R.attr 屬性 - 這些屬性的上下文其實(shí)就是我們的 app）。更多細(xì)節(jié)請查看下面的示例。

使用一個 Android 主題

Android 包含兩個基本的 activity 主題，這兩個主題決定了 action bar 的顏色：

• Theme.Holo，一個 “dark” 的主題
• Theme.Holo.Light，一個 “l(fā)ight” 的主題

這些主題即可以被應(yīng)用到 app 全局，也可以通過在 manifest 文件中設(shè)置 <application> 元素 或 <activity>元素的 android:theme 屬性，對單一的 activity 進(jìn)行設(shè)置。

例如：

<application android:theme="@android:style/Theme.Holo.Light" ... />

可以通過聲明 activity 的主題為 Theme.Holo.Light.DarkActionBar 來達(dá)到如下效果：action bar 為dark，其他部分為light。

當(dāng)使用 Support 庫時，必須使用 Theme.AppCompat 主題替代：

• Theme.AppCompat，一個“dark”的主題
• Theme.AppCompat.Light，一個“l(fā)ight”的主題
• Theme.AppCompat.Light.DarkActionBar，一個帶有“dark” action bar 的“l(fā)ight”主題

一定要確保我們使用的 action bar icon 的顏色與 action bar 本身的顏色有差異。Action Bar Icon Pack 為 Holo “dark”和“l(fā)ight”的 action bar 提供了標(biāo)準(zhǔn)的 action icon。

自定義背景

為改變 action bar的背景，可以通過為 activity 創(chuàng)建一個自定義主題，并重寫 actionBarStyle 屬性來實(shí)現(xiàn)。actionBarStyle 屬性指向另一個樣式；在該樣式里，通過指定一個 drawable 資源來重寫 background 屬性。

如果我們的 app 使用了 navigation tabs 或 split action bar ，也可以通過分別設(shè)置 backgroundStacked 和 backgroundSplit 屬性來為這些條指定背景。

Note：為自定義主題和樣式聲明一個合適的父主題，這點(diǎn)很重要。如果沒有父樣式，action bar將會失去很多默認(rèn)的樣式屬性，除非我們自己顯式的對他們進(jìn)行聲明。

僅支持 Android 3.0 和更高

當(dāng)僅支持 Android 3.0 和更高版本時，可以通過如下方式定義 action bar 的背景：

res/values/themes.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 應(yīng)用于程序或者活動的主題 -->
    <style name="CustomActionBarTheme"
           parent="@android:style/Theme.Holo.Light.DarkActionBar">
        <item name="android:actionBarStyle">@style/MyActionBar</item>
    </style>

    <!-- ActionBar 樣式 -->
    <style name="MyActionBar"
           parent="@android:style/Widget.Holo.Light.ActionBar.Solid.Inverse">
        <item name="android:background">@drawable/actionbar_background</item>
    </style>
</resources>

然后，將主題應(yīng)用到 app 全局或單個的 activity 之中：

<application android:theme="@style/CustomActionBarTheme" ... />

支持 Android 2.1 和更高

當(dāng)使用 Support 庫時，上面同樣的主題必須被替代成如下：

res/values/themes.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 應(yīng)用于程序或者活動的主題 -->
    <style name="CustomActionBarTheme"
           parent="@style/Theme.AppCompat.Light.DarkActionBar">
        <item name="android:actionBarStyle">@style/MyActionBar</item>

        <!-- 支持庫兼容 -->
        <item name="actionBarStyle">@style/MyActionBar</item>
    </style>

    <!-- ActionBar 樣式 -->
    <style name="MyActionBar"
           parent="@style/Widget.AppCompat.Light.ActionBar.Solid.Inverse">
        <item name="android:background">@drawable/actionbar_background</item>

        <!-- 支持庫兼容 -->
        <item name="background">@drawable/actionbar_background</item>
    </style>
</resources>

然后，將主題應(yīng)用到 app 全局或單個的 activity 之中：

<application android:theme="@style/CustomActionBarTheme" ... />

自定義文本顏色

修改 action bar 中的文本顏色，需要分別設(shè)置每個元素的屬性：

• Action bar 的標(biāo)題：創(chuàng)建一種自定義樣式，并指定 textColor 屬性；同時，在自定義的 actionBarStyle 中為 titleTextStyle 屬性指定為剛才的自定義樣式。

注意：被應(yīng)用到 titleTextStyle 的自定義樣式應(yīng)該使用 TextAppearance.Holo.Widget.ActionBar.Title 作為父樣式。

• Action bar tabs：在 activity 主題中重寫 actionBarTabTextStyle
• Action 按鈕：在 activity 主題中重寫 actionMenuTextColor

僅支持 Android 3.0 和更高

當(dāng)僅支持 Android 3.0 和更高時，樣式 XML 文件應(yīng)該是這樣的：

res/values/themes.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 應(yīng)用于程序或者活動的主題 -->
    <style name="CustomActionBarTheme"
           parent="@style/Theme.Holo">
        <item name="android:actionBarStyle">@style/MyActionBar</item>
        <item name="android:actionBarTabTextStyle">@style/MyActionBarTabText</item>
        <item name="android:actionMenuTextColor">@color/actionbar_text</item>
    </style>

    <!-- ActionBar 樣式 -->
    <style name="MyActionBar"
           parent="@style/Widget.Holo.ActionBar">
        <item name="android:titleTextStyle">@style/MyActionBarTitleText</item>
    </style>

    <!-- ActionBar 標(biāo)題文本 -->
    <style name="MyActionBarTitleText"
           parent="@style/TextAppearance.Holo.Widget.ActionBar.Title">
        <item name="android:textColor">@color/actionbar_text</item>
    </style>

    <!-- ActionBar Tab標(biāo)簽 文本樣式 -->
    <style name="MyActionBarTabText"
           parent="@style/Widget.Holo.ActionBar.TabText">
        <item name="android:textColor">@color/actionbar_text</item>
    </style>
</resources>

支持 Android 2.1 和更高

當(dāng)使用 Support 庫時，樣式 XML 文件應(yīng)該是這樣的：

res/values/themes.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 應(yīng)用于程序或者活動的主題 -->
    <style name="CustomActionBarTheme"
           parent="@style/Theme.AppCompat">
        <item name="android:actionBarStyle">@style/MyActionBar</item>
        <item name="android:actionBarTabTextStyle">@style/MyActionBarTabText</item>
        <item name="android:actionMenuTextColor">@color/actionbar_text</item>

        <!-- 支持庫兼容 -->
        <item name="actionBarStyle">@style/MyActionBar</item>
        <item name="actionBarTabTextStyle">@style/MyActionBarTabText</item>
        <item name="actionMenuTextColor">@color/actionbar_text</item>
    </style>

    <!-- ActionBar 樣式 -->
    <style name="MyActionBar"
           parent="@style/Widget.AppCompat.ActionBar">
        <item name="android:titleTextStyle">@style/MyActionBarTitleText</item>

        <!-- 支持庫兼容 -->
        <item name="titleTextStyle">@style/MyActionBarTitleText</item>
    </style>

    <!-- ActionBar 標(biāo)題文本 -->
    <style name="MyActionBarTitleText"
           parent="@style/TextAppearance.AppCompat.Widget.ActionBar.Title">
        <item name="android:textColor">@color/actionbar_text</item>
        <!-- 文本顏色屬性textColor是可以配合支持庫向后兼容的 -->
    </style>

    <!-- ActionBar Tab標(biāo)簽文本樣式 -->
    <style name="MyActionBarTabText"
           parent="@style/Widget.AppCompat.ActionBar.TabText">
        <item name="android:textColor">@color/actionbar_text</item>
        <!-- 文本顏色屬性textColor是可以配合支持庫向后兼容的 -->
    </style>
</resources>

自定義 Tab Indicator

為 activity 創(chuàng)建一個自定義主題，通過重寫 actionBarTabStyle 屬性來改變 navigation tabs 使用的指示器。actionBarTabStyle 屬性指向另一個樣式資源；在該樣式資源里，通過指定一個state-list drawable 來重寫 background 屬性。

注意：一個state-list drawable 是重要的，它可以通過不同的背景來指出當(dāng)前選擇的 tab 與其他 tab 的區(qū)別。更多關(guān)于如何創(chuàng)建一個 drawable 資源來處理多個按鈕狀態(tài)，請閱讀 State List 文檔。

例如，這是一個狀態(tài)列表 drawable，為一個 action bar tab 的多種不同狀態(tài)分別指定背景圖片：

res/drawable/actionbar_tab_indicator.xml

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">

<!-- 按鈕沒有按下的狀態(tài) -->

    <!-- 沒有焦點(diǎn)的狀態(tài) -->
    <item android:state_focused="false" android:state_selected="false"
          android:state_pressed="false"
          android:drawable="@drawable/tab_unselected" />
    <item android:state_focused="false" android:state_selected="true"
          android:state_pressed="false"
          android:drawable="@drawable/tab_selected" />

    <!-- 有焦點(diǎn)的狀態(tài) (例如D-Pad控制或者鼠標(biāo)經(jīng)過) -->
    <item android:state_focused="true" android:state_selected="false"
          android:state_pressed="false"
          android:drawable="@drawable/tab_unselected_focused" />
    <item android:state_focused="true" android:state_selected="true"
          android:state_pressed="false"
          android:drawable="@drawable/tab_selected_focused" />


<!--  按鈕按下的狀態(tài)D -->

    <!-- 沒有焦點(diǎn)的狀態(tài) -->
    <item android:state_focused="false" android:state_selected="false"
          android:state_pressed="true"
          android:drawable="@drawable/tab_unselected_pressed" />
    <item android:state_focused="false" android:state_selected="true"
        android:state_pressed="true"
        android:drawable="@drawable/tab_selected_pressed" />

    <!--有焦點(diǎn)的狀態(tài) (例如D-Pad控制或者鼠標(biāo)經(jīng)過)-->
    <item android:state_focused="true" android:state_selected="false"
          android:state_pressed="true"
          android:drawable="@drawable/tab_unselected_pressed" />
    <item android:state_focused="true" android:state_selected="true"
          android:state_pressed="true"
          android:drawable="@drawable/tab_selected_pressed" />
</selector>

僅支持 Android 3.0 和更高

當(dāng)僅支持 Android 3.0 和更高時，樣式 XML 文件應(yīng)該是這樣的：

res/values/themes.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 應(yīng)用于程序或活動的主題 -->
    <style name="CustomActionBarTheme"
           parent="@style/Theme.Holo">
        <item name="android:actionBarTabStyle">@style/MyActionBarTabs</item>
    </style>

    <!-- ActionBar tabs 標(biāo)簽樣式 -->
    <style name="MyActionBarTabs"
           parent="@style/Widget.Holo.ActionBar.TabView">
        <!-- 標(biāo)簽指示器 -->
        <item name="android:background">@drawable/actionbar_tab_indicator</item>
    </style>
</resources>

支持 Android 2.1 和更高

當(dāng)使用 Support 庫時，樣式 XML 文件應(yīng)該是這樣的：

res/values/themes.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- 應(yīng)用于程序或活動的主題 -->
    <style name="CustomActionBarTheme"
           parent="@style/Theme.AppCompat">
        <item name="android:actionBarTabStyle">@style/MyActionBarTabs</item>

        <!-- 支持庫兼容 -->
        <item name="actionBarTabStyle">@style/MyActionBarTabs</item>
    </style>

    <!-- ActionBar tabs 樣式 -->
    <style name="MyActionBarTabs"
           parent="@style/Widget.AppCompat.ActionBar.TabView">
        <!-- 標(biāo)簽指示器 -->
        <item name="android:background">@drawable/actionbar_tab_indicator</item>

        <!-- 支持庫兼容 -->
        <item name="background">@drawable/actionbar_tab_indicator</item>
    </style>
</resources>

更多資源

• 關(guān)于 action bar 的更多樣式屬性，請查看 Action Bar 指南
• 學(xué)習(xí)更多樣式的工作機(jī)制，請查看 樣式和主題 指南
• 全面的 action bar 樣式，請嘗試 Android Action Bar 樣式生成器