AndroidTraining学习------Adding th

作者: 爱吃外星人 | 来源:发表于2016-08-16 16:52 被阅读120次

Adding the Action Bar

Action bar的关键功能包括以下这些：

在app中留一处专门的空间标识你的app并指明使用者所处的位
通过可预见的方式进行重要的动作
支持导航和视图切换（标签和下拉菜单）

Setting Up the Action Bar

创建一个最基本的action bar需要你的app使用一个支持action bar的activity主题。需要怎样的主题取决于你的app支持的最低安卓版本。

Support Android 3.0 and Above Only

从Android 3.0开始，action bar包含在所有使用Theme.Holo主题（或者它的子主题）的activity中，当targetSdkVersion或minSdkVersion属性设置为“11”或更高时，它是默认主题。

Support Android 2.1 and Above

当在比Android 3.0更老的版本上添加action bar时，需要你在你的应用中导入Android支持库。
一旦有了与你项目集成的支持库：
1.更新你的activity，使它继承ActionBarActivity，例如：

public class MainActivity extends ActionBarActivity{...}

2.在你的配置文件中，更新你的<application>或独立的<activity>元素，使用Theme.AppCompat主题中的一个，例如：

<activity android:theme:"@style/Theme.AppCompat.Light"...>

Adding Action Bar

Action bar允许你添加与app当前上下文有联系的最重要行动项目的按钮。那些直接出现在action bar中的图标和文字被称为动作按钮，不能在action bar或不那么重要的动作被隐藏在下拉菜单中。

Specify the Action Bar

所有的动作按钮和下拉菜单中的项目都定义在一个XML menu resource中，为了添加action到action bar中，先在你的项目的res/menu/目录中创建一个新的XML文件
为每一个你想放置在action bar中的项目添加<item>元素，例如：

    <menu xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
        <!-- Search, should appear as action button -->
        <item
            android:id="@+id/action_search"
            android:icon="@drawable/ic_action_search"
            android:showAsAction="ifRoom"
            android:title="@string/action_search" />
        <!-- Settings, should always be in the overflow -->
        <item
            android:id="@+id/action_settings"
            android:showAsAction="never"
            android:title="@string/action_settings" />
    </menu>

showAsAction属性有四个值：
always：这个值会使菜单项一直显示在Action Bar上
ifRoom：如果有足够空间，这个值会使菜单项显示在Action Bar上
never：这个值使菜单项永远不会显示在ActionBar上
withText：这个值使菜单项和它的图标，文本一起显示
注意：当为你的app创建icon或者bitmap图片时，要为不同屏幕密度下的显示效果提供多个优化的版本，这一点非常重要。
如果你要兼容Android2.1的support库，在android:命名空间下showAsAction属性不能使用。Support库提供了替代的属性，你必须定义你自己的XML命名空间并用该命名空间作为属性的前缀。（一个自定义的XML命名空间应该以你的app名称为基础，但是可以取任何你想要的名字，它的作用域仅仅在你的声明文件范围之内）比如：

<menu xmlns:android="http://schemas.android.com/apk/res/android"
          xmlns:yourapp="http://schemas.android.com/apk/res-auto"
         <!--Search,should appear as action button --->
         <item android:id="@+id/action_search"
               android:icon="@drawable/ic_action_search"
               android:title="@string/action_search"
               yourapp:showAsAction="ifRoom"/>
         ...
</menu>

Add the Action to the Action Bar

要为action bar布局菜单项，就要在activity中实现onCreateOptionsMenu()回调方法来inflate菜单资源从而获取Menu对象，例如：

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        //Inflate the menu items for use in the action bar
        MenuInflater inflater = getMenuInflater();
        inflater.inflate(R.menu.main_activity_actions, menu);
        return super.onCreateOptionsMenu(menu);
    }

Respond to Action Buttons

当用户点击某一个操作按钮或者下拉菜单时，系统会调用activity中的onOptionsItemSelected()回调方法。在该方法的实现中会调用MenuItem的getItemId()方法去判断哪个条目被点击了--返回的ID会匹配我们声明对应的<item>元素中的android:id属性的值。

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        //Handle presses on the action bar items
        switch (item.getItemId()) {
            case R.id.action_search:
                Toast.makeText(MainActivity.this, "you click the search button", Toast.LENGTH_SHORT).show();
                return true;
            case R.id.action_settings:
                Toast.makeText(MainActivity.this, "you click the settings button", Toast.LENGTH_SHORT).show();
                return true;
            default:
                return super.onOptionsItemSelected(item);
        }
    }

Add Up Button for Low-level Activities

在不是程序入口的所有其他屏中（activities不是“home”页）需要为用户提供一个导航到逻辑父屏的Up Button（向上按钮）。
当运行在Android4.1或更高的版本，或者使用Support库中的ActionBarActivity时，实现向上只需要你在manifest文件中定义父activity，并且设置action bar中的Up Button可用。比如：

    <activity android:name=".DisplayMessageActivity"
        android:label="@string/title_activity_display_message"
        android:parentActivityName=".MainActivity">
    </activity>

然后通过setDisplayHomeAsUpEnabled()将app icon设置成可用的Up按钮：

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_displaymessage);

        getSupportActionBar().setDisplayHomeAsUpEnabled(true);
        //If your minSdkVersion is 11 or higher, instead use:
        //getActionBar().setDisplayHomeAsUpEnabled(true);
    }

因为系统现在知道MainActivity时DisplayMessageActivity的父activity，当用户点击Up按钮时，系统会导航到恰当的父activity--你需要处理Up Button的点击事件。

Styling the Action Bar

Android包括少部分内置的activity主题，这些主题包括"drak"或"light"action bar样式。你可以扩展这些主题，以便更好地为action bar自定义外观。
注意：如果你在action bar中使用了Support库的API，你必须使用（或重写）Theme.AppCompat家族样式（甚至Theme.Holo家族样式，在API level 11及以上可用）。如此一来，声明的每个样式属性都必须声明两次：一次使用平台的样式属性（android:属性），一次使用Support库的样式属性（appcompat.R.attr 属性 -- 这些属性的上下文其实就是我们的app）。

Use an Android Theme

Android包括两种基本的activity主题，它们决定了action bar的颜色：

Theme.Holo for a "drak" theme.
Theme.Holo.light for a "light" theme.
这些主题可以被应用到整个app，也可以通过在manifest文件中设置<application>元素或<activity>元素的android:theme属性，对单一的activities进行设置。比如：
```
  <application android:theme="@android:style/Theme.Holo.Light".../>
```

通过声明Theme.Holo.Light.DarkActionBar可以使action bar为dark，而其余部分为light。
当使用Support库时，必须用Theme.AppCompat主题替代：

Theme.AppCompat for the "dark" theme.
Theme.AppCompat.Light for the "light" theme.
Theme.AppCompat.Light.DarkActionBar for the light theme with a dark action bar.
确保你使用的action bar icon和action bar本身有差异。

Customize the Background

为改变action bar的背景，可以通过为activity自定义一个主题，并重写actionBarStyle属性。该属性指向另一个样式，在这个样式里，我们可以通过指定一个drawable资源来重写background属性。
如果你的app使用了navigation tabs或split action bar，你也可以通过分别设置backgroundStacked和backgroundSplit属性来为bars指定背景。
警告：声明合适的父主题非常重要，你自定义的主题和样式继承它们的样式。如果没有父样式，你的action bar将会失去许多默认的样式属性，除非我们显式的对它们进行声明。

For Android 3.0 and higher only

仅当支持Android 3.0和更高版本时，你可以这样定义action bar的背景：

  <?xml version="1.0" encoding="utf-8"?>
  <resources>
      <!--the theme applied to the application or activity-->
      <style name="CustomActionBarTheme" parent="@style/Theme.AppCompat.Light.DarkActionBar">
          <item name="android:actionBarStyle">@style/MyActionBar</item>
      </style>

      <!--ActionBar styles-->
      <style name="MyActionBar" parent="@style/Widget.AppCompat.Light.ActionBar.Solid.Inverse">
          <item name="android:background">#ff0000</item>
      </style>
  </resources>

然后将我们的主题应用到整个app中或单独的activity中：

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

For Android 2.1 and higer

当你使用Support库时，上面同样的主题必须替代如下：

  <?xml version="1.0" encoding="utf-8"?>
  <resources>
      <!--the theme applied to the application or activity-->
      <style name="CustomActionBarTheme" parent="@style/Theme.AppCompat.Light.DarkActionBar">
          <item name="android:actionBarStyle">@style/MyActionBar</item>

          <!--Support libray compatibility-->
          <item name="actionBarStyle">@style/MyActionBar</item>
      </style>

      <!--ActionBar styles-->
      <style name="MyActionBar" parent="@style/Widget.AppCompat.Light.ActionBar.Solid.Inverse">
          <item name="android:background">#ff0000</item>

          <!--Support library compatibility-->
          <item name="background">@color/red</item>
      </style>
  </resources>

然后将我们的主题应用到整个app中或单独的activity中：

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

Customize the Text Color

为了修改action bar文本的颜色，你需要重写每个元素的属性：

Action bar title：创建一个自定义样式，并指定textColor属性；同时在我们自定义的actionBarStyle中指定titleTextStyle属性。
注意：被应用到titleTextStyle的自定义样式应该使用TextAppearance.Holo.Widget.ActionBar.Title 作为父样式。
Action bar tabs：在我们的activity主题中重写actionBarTabTextStyle。
Action buttons：在我们的activity主题中重写actionMenuTextColor。

For Android 3.0 and higher only

当仅支持Android3.0和更高版本时，你的Style XML文件用该这样：

  <?xml version="1.0" encoding="utf-8"?>
  <resources>
      <!--the theme applied to the application or activity-->
      <style name="CustomActionBarTheme" parent="@style/Theme.AppCompat">
          <item name="android:actionBarStyle">@style/MyActionBar</item>
          <item name="android:actionBarTabStyle">@style/MyActionBarTabText</item>
          <item name="android:actionMenuTextColor">@color/actionbar_text</item>
      </style>

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

      </style>

      <!--ActionBar tab text-->
      <style name="MyActionBarTabText" parent="@style/Widget.AppCompat.ActionBar.TabText">
          <item name="android:textColor">@color/actionbar_text</item>
      </style>

      <!--ActionBar title text-->
      <style name="MyActionBarTitleStyle" parent="TextAppearance.AppCompat.Widget.ActionBar.Title">
          <item name="android:textColor">@color/actionbar_text</item>
      </style>
  </resources>

For Android 2.1 and higher

当时使用Support库时，我们的style XML文件应该是这样的：
<?xml version="1.0" encoding="utf-8"?>
<resources>

<style name="CustomActionBarTheme" parent="@style/Theme.AppCompat">
<item name="android:actionBarStyle">@style/MyActionBar</item>
<item name="android:actionBarTabStyle">@style/MyActionBarTabText</item>
<item name="android:actionMenuTextColor">@color/actionbar_text</item>

          <!--Support libray compatibility-->
          <item name="actionBarStyle">@style/MyActionBar</item>
          <item name="actionBarTabTextStyle">@style/MyActionBarTabText</item>
          <item name="actionMenuTextColor">@color/actionbar_text</item>
      </style>

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

          <!--Support library compatibility-->
          <item name="titleTextStyle">@style/MyActionBarTitleStyle</item>
      </style>

      <!--ActionBar tab text-->
      <style name="MyActionBarTabText" parent="@style/Widget.AppCompat.ActionBar.TabText">
          <item name="android:textColor">@color/actionbar_text</item>
      </style>

      <!--ActionBar title text-->
      <style name="MyActionBarTitleStyle" parent="TextAppearance.AppCompat.Widget.ActionBar.Title">
          <item name="android:textColor">@color/actionbar_text</item>
      </style>
  </resources>

Overlaying the Action Bar

默认情况下，action bar显示在activity窗口的顶部，会稍微减少其他布局的可用空间。如果在用户交互的过程中，你想要隐藏或显示action bar可以调用hide()和show()来实现。然而，这将导致activity会基于它的新尺寸重新计算和重新绘制布局。
为避免在显示和隐藏action bar时重新调整布局大小，我们可以在action bar上启用叠加模式（overlay mode），布局可以使用所有的可用空间，就好像action bar不存在一样，并且系统会将action bar叠加在布局之上。这样布局顶部就会有点被遮挡，但是现在action bar隐藏或显示时，系统就不需要重新调整布局的大小而是无缝过渡。

Enable Overlay Mode

要为action bar 启用overlay mode，我们需要创建一个自定义主题，该主题继承与一个已存在的action bar 主题，并且把android:windowActionBarOverlay属性设置为true。

For Android 3.0 and higher only

如果minSDKVersion设为11或更高版本，我们的自定义主题应该使用Theme.Holo 主题（或者它的一个子主题）作为父主题。比如：

  <resources>
      <!--the theme applied to the application or activity-->
      <style name="CustomActionBarTheme" parent="@style/Theme.Holo">
          <item name="android:windowActionBarOverlay">true</item>
      </style>
  </resources>

For Android 2.1 and higher

如果你的app为了兼容运行在Android 3.0之下的设备而使用了Support库，你的自定义主题应该使用Theme.AppCompat主题（或它的一个子主题）作为父主题。比如：

  <resources>
      <!--the theme applied to the application or activity-->
      <style name="CustomActionBarTheme" parent="@style/Theme.AppCompat">
          <item name="android:windowActionBarOverlay">true</item>
       
          <!--Support library compatibility-->
          <item name="windowActionBarOverlay">true</item>
      </style>
  </resources>

注意，这个主题包括两种不同的windowActionBarOverlay样式定义：一个带有android:前缀，一个没有。带有android:前缀的适用于包括该样式的Android系统版本，不带前缀的适用于从Support读取样式的旧版本。

Specify Layout Top-margin

当action bar启用了overlay mode，可能会遮挡某些本应该可见的布局。为了确保这些布局始终处于action bar的下面，可以通过使用actionBarSize来指定顶部margin或padding的高度来实现。比如：

  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:tools="http://schemas.android.com/tools"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:paddingTop="?android:attr/actionBarSize">
  </LinearLayout>

如果你在action bar中使用了Support库，你需要删除android:前缀。比如：

  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:tools="http://schemas.android.com/tools"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:paddingTop="?android:attr/actionBarSize">
  </LinearLayout>

在这种情况下，不带前缀的?attr/actionBarSize适用于包括Android3.0和更高版本的所有版本。

AndroidTraining学习------Adding th

Adding the Action Bar

Setting Up the Action Bar

Support Android 3.0 and Above Only

Support Android 2.1 and Above

Adding Action Bar

Specify the Action Bar

Add the Action to the Action Bar

Respond to Action Buttons

Add Up Button for Low-level Activities

Styling the Action Bar

Use an Android Theme

Customize the Background

For Android 3.0 and higher only

For Android 2.1 and higer

Customize the Text Color

For Android 3.0 and higher only

For Android 2.1 and higher

Overlaying the Action Bar

Enable Overlay Mode

For Android 3.0 and higher only

For Android 2.1 and higher

Specify Layout Top-margin

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

我爱编程