ToolBar教程：AppCompatActivity下用toolbar当actionbar用

参考：

　　https://developer.android.com/training/appbar/index.html

 

1，自定义toolbar主题

2，在布局xml中使用toolbar

3，在代码中启用toolbar

4，添加菜单

5，处理菜单事件

6，向上导航事件

7，定义actionView

8，actionView的菜单展开／收起 事件

9，定义actionProvider

 

1，AppCompatActivity与常见的activity不同，要用 Theme.AppCompat.xxx系列中的一个不带actionbar的主题 。并可以自定义它。

<resources>

    <!-- Base application theme. -->
    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">

        <!--设置每个菜单项及它选中时的背景色-->
        <item name="android:itemBackground">#a4f5f6</item>
        <!--<item name="android:background">#303F9F</item>-->

        <!--下面3行是ToolBar的状态栏沉浸效果-->
        <!--<item name="android:windowTranslucentStatus">false</item>-->
        <!--<item name="android:windowTranslucentNavigation">true</item>-->
        <!--<item name="android:statusBarColor">#0176da</item>-->

        <!-- Toolbar风格 -->
        <item name="toolbarStyle">@style/Theme.Toolbar.App.Style</item>

        <!--溢出菜单中的action间的分割线-->
        <item name="android:dividerHeight">1dp</item>
        <!--文本大小-->
        <item name="android:textSize">20sp</item>
        <!--文本颜色-->
        <item name="android:textColorPrimary">#ffffff</item>
        <!--设置菜单不遮挡actionbar-->
        <item name="actionOverflowMenuStyle">@style/OverflowMenuStyle</item>
        <!--配置Menu的图标-->
        <item name="actionOverflowButtonStyle">@style/ToolBar.ActionButton.Overflow</item>
    </style>


    <!--溢出菜单样式 -->
    <style name="OverflowMenuStyle" parent="Widget.AppCompat.Light.PopupMenu.Overflow">
        <!--溢出菜单的宽度-->
        <item name="android:dropDownWidth">wrap_content</item>
        <item name="android:paddingRight">5dp</item>

        <!--溢出菜单窗口的背景，它与菜单项的背景不同，如果所有菜单项加一起盖住了窗口，那么这个背景色看不到-->
        <item name="android:popupBackground">#89a81d</item>

        <!--溢出菜单不遮挡ToolBar-->
        <item name="overlapAnchor">false</item>

        <!--溢出菜单垂直偏移，水平偏移-->
        <item name="android:dropDownVerticalOffset">5dip</item>
        <item name="android:dropDownHorizontalOffset">0dip</item>
    </style>

    <!--溢出按钮样式 -->
    <style name="ToolBar.ActionButton.Overflow" parent="android:style/Widget.Holo.Light.ActionButton.Overflow">
        <item name="android:src">@android:drawable/ic_menu_add</item>
    </style>


    <!--=============下面是toolbar相关主题============-->
    <!-- Toolbar样式 -->
    <style name="Theme.Toolbar.App.Style" parent="@style/Widget.AppCompat.Toolbar">
        <item name="android:background">#33B5E5</item>
        <!--注意不要用android:titleTextAppearance,要用xmlns:app="http://schemas.android.com/apk/res-auto"下的，
                不带前缀就是app:下的-->
        <!--主标题-->
        <item name="title">title</item>
        <!--副标题-->
        <item name="subtitle">subtitle</item>

        <!--logo-->
        <item name="logo">@android:drawable/ic_menu_call</item>
        <!--主标题样式-->
        <item name="titleTextAppearance">@style/Theme.ToolBar.App.Title</item>
        <!--副标题样式-->
        <item name="subtitleTextAppearance">@style/Theme.ToolBar.App.Subtitle</item>

        <item name="android:minHeight">?attr/actionBarSize</item>
        <item name="titleMargins">4dp</item>
        <!--ToolBar的Home图标左侧间隙-->
        <item name="contentInsetStart">16dp</item>

        <!--当home图标折叠时显示的图标-->
        <item name="collapseIcon">@android:drawable/ic_menu_compass</item>
        <item name="collapseContentDescription">collapseContentDescription</item>
        <item name="android:paddingLeft">10dp</item>
        <item name="android:paddingRight">10dp</item>

    </style>

    <!--设置toolbar标题主题-->
    <style name="Theme.ToolBar.App.Title" parent="@style/TextAppearance.Widget.AppCompat.Toolbar.Title">
        <item name="android:textSize">20sp</item>
        <item name="android:textColor">#ffffff</item>
    </style>

    <!--toolbar副标题主题-->
    <style name="Theme.ToolBar.App.Subtitle" parent="@style/TextAppearance.Widget.AppCompat.Toolbar.Subtitle">
        <item name="android:textSize">9sp</item>
        <item name="android:textColor">#ff0000</item>
    </style>
</resources>

2，在layout.xml中添加toolbar

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    tools:context="com.txw.e.toolbardemo.MainActivity">

    <android.support.v7.widget.Toolbar
        android:id="@+id/toolbar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        />

    <!--app:contentInsetStart="3dp"-->
    <!--app:title="Title"-->
    <!--app:subtitle="subtitle"-->
    <!--app:logo="@android:drawable/ic_menu_directions"-->
    <!--app:titleTextAppearance="@style/Theme.ToolBar.Base.Title"-->
    <!--app:subtitleTextAppearance="@style/Theme.ToolBar.Base.Subtitle"-->

    <!--app:title等属性也可以定义在style.xml中，注意是app命名空间下的，不是android:title，后者不显示。
               xmlns:app="http://schemas.android.com/apk/res-auto"
       -->

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_below="@id/toolbar"
        android:text="Hello toolbar!" />

</RelativeLayout>

3，在layout对应的activity或fragment的onCreate中：

下面是activity示例

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);
    Toolbar myToolbar = (Toolbar) findViewById(R.id.my_toolbar);
    setSupportActionBar(myToolbar);
}

下面是fragment示例

public class MainView extends Fragment {

    public Toolbar                 actionBar;
    public void initActionBar(View rootView){
        //用toolbar实现 actionbar
        actionBar = (Toolbar) rootView.findViewById(R.id.toolbar);
        Drawable overflow = actionBar.getResources().getDrawable(R.drawable.ab_overflow_btn);

        actionBar.setTitleTextColor(Color.WHITE);
        actionBar.setOverflowIcon(overflow);

        AppCompatActivity aca = (AppCompatActivity) getActivity();
        aca.setSupportActionBar(actionBar);

    }
    //...
}

4，添加action item，注意其中的  app:showAsAction 不是android:showAsAction 其它与actionbar类似。

<menu xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:app="http://schemas.android.com/apk/res-auto"
      xmlns:tools="http://schemas.android.com/tools"
      tools:context="com.e.weixin.MainActivity">

    <item
        android:id="@+id/action_search"
        android:icon="@android:drawable/ic_menu_search"
        android:title="search"
        app:actionViewClass="android.support.v7.widget.SearchView"
        app:showAsAction="always|collapseActionView"/>


    <item android:id="@+id/action_share"
        android:icon="@android:drawable/ic_menu_share"
         android:title="share"
         app:showAsAction="ifRoom"
         app:actionProviderClass="android.support.v7.widget.ShareActionProvider"/>
    <item
        android:id="@+id/action_expand"
        android:icon="@android:drawable/ic_menu_add"
        android:title="展开／收起"
        app:showAsAction="never|collapseActionView"/>
    <item
        android:id="@+id/action_home_as_up"
        android:icon="@android:drawable/ic_menu_upload"
        android:title="向上导航"
        app:showAsAction="never"/>
    <item
        android:id="@+id/action_scan"
        android:icon="@android:drawable/ic_menu_send"
        android:title="scan"
        app:showAsAction="never"/>
    <item
        android:id="@+id/action_get_money"
        android:icon="@android:drawable/ic_menu_crop"
        android:title="sq"
        app:showAsAction="never"/>
    <item
        android:id="@+id/action_help_and_feedback"
        android:icon="@android:drawable/ic_menu_help"
        android:title="help"
        app:showAsAction="never"/>

</menu> 

5，处理事件与actionbar相似。

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
        case R.id.action_settings:
            // User chose the "Settings" item, show the app settings UI...
            return true;

        case R.id.action_favorite:
            // User chose the "Favorite" action, mark the current item
            // as a favorite...
            return true;

        default:
            // If we got here, the user's action was not recognized.
            // Invoke the superclass to handle it.
            return super.onOptionsItemSelected(item);

    }
} 

6，处理向上导航事件，先设置activity上下级，然后得到ActionBar，然后用它处理向上导航事件。

<application ... >
    ...

    <!-- The main/home activity (it has no parent activity) -->

    <activity
        android:name="com.example.myfirstapp.MainActivity" ...>
        ...
    </activity>

    <!-- A child of the main activity -->
    <activity
        android:name="com.example.myfirstapp.MyChildActivity"
        android:label="@string/title_activity_child"
        android:parentActivityName="com.example.myfirstapp.MainActivity" >

        <!-- Parent activity meta-data to support 4.0 and lower -->
        <meta-data
            android:name="android.support.PARENT_ACTIVITY"
            android:value="com.example.myfirstapp.MainActivity" />
    </activity>
</application>

处理代码 

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

    // my_child_toolbar is defined in the layout file
    Toolbar myChildToolbar =
        (Toolbar) findViewById(R.id.my_child_toolbar);
    setSupportActionBar(myChildToolbar);

    // Get a support ActionBar corresponding to this toolbar
    ActionBar ab = getSupportActionBar();

    // Enable the Up button
    ab.setDisplayHomeAsUpEnabled(true);
}

7，自定义 action view

在menu.xml对应有action项中

<item
        android:id="@+id/action_search"
        android:icon="@android:drawable/ic_menu_search"
        android:title="search"
        app:actionViewClass="android.support.v7.widget.SearchView"
        app:showAsAction="always|collapseActionView"/>

在代码中

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.main_activity_actions, menu);

    MenuItem searchItem = menu.findItem(R.id.action_search);
    SearchView searchView =
            (SearchView) MenuItemCompat.getActionView(searchItem);

    // Configure the search info and add any event listeners...

    return super.onCreateOptionsMenu(menu);
}

8，响应action view 展开／收起 事件。要指定collapseActionView和app:actionViewClass。

<item
        android:id="@+id/action_expand"
        android:icon="@android:drawable/ic_menu_add"
        android:title="展开／收起"
        app:actionViewClass="android.support.v7.widget.SearchView"
        app:showAsAction="always|collapseActionView"/>

 

　　指定了 collapseActionView 属性后，才可响应actionView的展开／收起事件。在按对应的item之前(action view展开之前)，一直显示在android:icon="xxx" 中指定的图标。

　　如果在activity中重写了onOptionsItemSelected() ，注意要调用 super.onOptionsItemSelected() 才能展开action view事件。

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.options, menu);
    // ...

    // Define the listener
    OnActionExpandListener expandListener = new OnActionExpandListener() {
        @Override
        public boolean onMenuItemActionCollapse(MenuItem item) {
            // Do something when action item collapses
            return true;  // Return true to collapse action view
        }

        @Override
        public boolean onMenuItemActionExpand(MenuItem item) {
            // Do something when expanded
            return true;  // Return true to expand action view
        }
    };

    // Get the MenuItem for the action item
    MenuItem actionMenuItem = menu.findItem(R.id.myActionItem);

    // Assign the listener to that action item
    MenuItemCompat.setOnActionExpandListener(actionMenuItem, expandListener);

    // Any other things you have to do when creating the options menu…

    return true;
}

9，添加及自定义action provider

<item android:id="@+id/action_share"
        android:icon="@android:drawable/ic_menu_share"
         android:title="share"
         app:showAsAction="ifRoom"
         app:actionProviderClass="android.support.v7.widget.ShareActionProvider"/>

　　For information about creating a custom action provider, see the ActionProvider reference. For information about configuring a ShareActionProvider, see the reference for that class.