Android ActionBar和ToolBar的使用

时间 2019-11-11

标签 android actionbar toolbar 使用栏目 Android 繁體版

原文原文链接

参考

一、android中的ActionBar和ToolBar
二、『Material Design入门学习笔记』主题与AppCompatActivity（附demo）
三、Android开发：最详细的 Toolbar 开发实践总结
四、Toolbar设置详解----掉坑总结html

前言

自android5.0开始，AppCompatActivity代替ActionBarActivity，并且ToolBar也代替了ActionBar，下面就是ActionBar和ToolBar的使用android

ActionBar

一、截图

image.pngapp

二、使用

2.一、AppCompatActivity和其对应的Themeide

AppCompatActivity使用的是v7的ActionBar（和默认的ActionBar使用起来略有区别，一会代码中会有体现）
Theme的话继承于Theme.AppCompat.Light.DarkActionBar，系统提供的深色系的actionbar，那么按钮，文字，和菜单是白色的

//Activity
public class ActionBarActivity extends AppCompatActivity

//style
<!--默认全部activity的actionbar的theme-->
    <style name="AppCompatActivity_ActionBarTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="colorPrimary">@color/colorPrimary</item>
        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
        <item name="colorAccent">@color/colorAccent</item>
        <item name="android:textAllCaps">false</item>
    </style>

2.二、ActionBar的使用函数

获取actionbar： $\color{red}{这里v7的是getSupportActionBar()，默认的是getActionBar()}$

//AppCompatActivity use v7 action bar
        actionBar = this.getSupportActionBar();
        //Activity use action bar
        //actionBar = this.getActionBar();

        if(actionBar == null){
            return;
        }

设置主副标题

//主标题
        actionBar.setTitle("ActionBar Title");
        //副标题
        actionBar.setSubtitle("Sub Title");

设置navigation up按钮：可见+可用+更换图标

//左侧按钮：可见+可用+更换图标
        actionBar.setDisplayHomeAsUpEnabled(true);
        actionBar.setHomeButtonEnabled(true);
        //actionBar.setHomeAsUpIndicator(R.mipmap.back_white);

设置navigation up按钮的监听：复写onSupportNavigateUp()， $\color{red}{可是若是有menu复写onOptionsItemSelected函数的话，则onSupportNavigateUp()将不会被调用}$

/**
     * 复写：左侧按钮点击动做
     * android.R.id.home
     * v7 actionbar back event
     * 注意：若是复写了onOptionsItemSelected方法，则onSupportNavigateUp无用
     * */
    @Override
    public boolean onSupportNavigateUp() {
        finish();
        return super.onSupportNavigateUp();
    }

    /**
     * 复写：左侧按钮点击动做
     * android.R.id.home
     * actionbar back event
     * 注意：若是复写了onOptionsItemSelected方法，则onSupportNavigateUp无用
    @Override
    public boolean onNavigateUp() {
        finish();
        return super.onNavigateUp();
    }* */

设置logo（icon等）：用logo代替icon，不知道为何不灵？？

//设置logo
        actionBar.setLogo(android.R.mipmap.sym_def_app_icon);
        actionBar.setDisplayUseLogoEnabled(true);
        //设置icon：use logo instead of an icon
        //actionBar.setIcon(R.mipmap.ic_launcher);

设置菜单menu和对应监听：android.R.id.home就是左侧的navigation up按钮

/**
     * 复写：添加菜单布局
     * */
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(R.menu.menu, menu);
        return true;
    }

    /**
     * 复写：设置菜单监听
     * */
    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        switch (item.getItemId()) {
                //actionbar navigation up 按钮
            case android.R.id.home:
                finish();
                break;

            case R.id.action_refresh:
                Toast.makeText(this, "Refresh selected", Toast.LENGTH_SHORT).show();
                break;
            case R.id.action_add:
                Toast.makeText(this, "Add selected", Toast.LENGTH_SHORT).show();
                break;
            case R.id.action_settings:
                Toast.makeText(this, "Settings selected", Toast.LENGTH_SHORT).show();
                break;
            default:
                break;
        }
        return true;
    }

设置tab和对应监听

//增长actionbar 下面的tab按钮
        actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);
        actionBar.addTab(actionBar.newTab().setText("Tab 1").setTabListener(new ActionBar.TabListener() {
            @Override
            public void onTabSelected(ActionBar.Tab tab, FragmentTransaction fragmentTransaction) {
                Toast.makeText(ActionBarActivity.this, "Tab 1 select",Toast.LENGTH_SHORT).show();
            }
            @Override
            public void onTabUnselected(ActionBar.Tab tab, FragmentTransaction fragmentTransaction) { }
            @Override
            public void onTabReselected(ActionBar.Tab tab, FragmentTransaction fragmentTransaction) { }
        }));
        actionBar.addTab(actionBar.newTab().setText("Tab 2").setTabListener(new ActionBar.TabListener() {
            @Override
            public void onTabSelected(ActionBar.Tab tab, FragmentTransaction fragmentTransaction) {
                Toast.makeText(ActionBarActivity.this, "Tab 2 select",Toast.LENGTH_SHORT).show();
            }
            @Override
            public void onTabUnselected(ActionBar.Tab tab, FragmentTransaction fragmentTransaction) { }
            @Override
            public void onTabReselected(ActionBar.Tab tab, FragmentTransaction fragmentTransaction) { }
        }));

或者彻底自定义

//自定义
        actionBar.setCustomView(R.layout.actionbar_title);
        actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM);

隐藏、显示actionbar

case R.id.btn_hide:
                if(actionBar != null){
                    /**
                     * 隐藏actionbar
                     * 一、有actionbar状况下：actionBar.hide();
                     * 二、直接使用Theme.Holo.NoActionBar
                     * 三、theme中添加属性
                     *      <item name="windowActionBar">false</item>
                     *      <item name="windowNoTitle">true</item>
                     * 四、在setContent以前 Window feature must be requested before adding content
                     *    AppCompatActivity: supportRequestWindowFeature(Window.FEATURE_NO_TITLE)，
                     *    Activity: requestWindowFeature(Window.FEATURE_NO_TITLE);
                     *
                     * */
                    actionBar.hide();
                }
                break;

            case R.id.btn_show:
                if(actionBar != null){
                    actionBar.show();
                }
                break;

-------------------------------------分割线-------------------------------布局

Menu（共通的菜单，不细说）

一、showAsAction属性

always表示永远显示在ActionBar中，若是屏幕空间不够则没法显示
ifRoom表示屏幕空间够的状况下显示在ActionBar中，不够的话就显示在overflow中
never则表示永远显示在overflow中
withText：这个值使菜单项和它的图标，文本一块儿显示

二、布局

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:android="http://schemas.android.com/apk/res/android">
    <!--showAsAction属性
        always表示永远显示在ActionBar中，若是屏幕空间不够则没法显示
        ifRoom表示屏幕空间够的状况下显示在ActionBar中，不够的话就显示在overflow中
        never则表示永远显示在overflow中
        withText：这个值使菜单项和它的图标，文本一块儿显示-->

    <!--menuCategory：同种菜单项的种类。该属性可取4个值：container、system、secondary和alternative。-->

    <!--orderInCategor:同种类菜单的排列顺序。该属性须要设置一个整数值-->

    <item
        android:id="@+id/action_refresh"
        android:icon="@mipmap/refresh"
        android:title="Refresh"
        app:showAsAction="always" />
    <item
        android:id="@+id/action_add"
        android:icon="@mipmap/add"
        android:title="Add"
        app:showAsAction="ifRoom" />
    <item
        android:id="@+id/action_settings"
        android:icon="@mipmap/settings"
        android:title="Settings"
        app:showAsAction="never">
    </item>
</menu>

-------------------------------------分割线-------------------------------学习

ToolBar

了解了ActionBar的话，那么ToolBar和其差很少，更增强大，更加符合MD风格，而后就代替ActionBar，使用起来差很少，可是又UI上的坑字体

一、截图：颜色不正常的

image.pngthis

二、使用

2.一、隐藏ActionBar有4中方式spa

一、若是继承了theme有actionbar的则，在setContentView方法以前设置：v7的supportRequestWindowFeature(Window.FEATURE_NO_TITLE);或者非v7的requestWindowFeature(Window.FEATURE_NO_TITLE);
二、theme直接继承没有actionbar的，好比说：Theme.AppCompat.Light.NoActionBar
三、theme中没设置属性没有actionbar：<item name="windowActionBar">false</item>
<item name="windowNoTitle">true</item>
四、actionBar.hide();

2.二、AppCompatActivity和其对应的Theme

//activity
public class ToolBarActivity extends AppCompatActivity

//style
    <!--默认全部activity的toolbar的theme-->
    <!--<style name="AppCompatActivity_ToolBarTheme" parent="Theme.AppCompat.Light.NoActionBar">-->
    <style name="AppCompatActivity_ToolBarTheme" parent="Theme.AppCompat.Light">
        <!--不要actionbar，不要title-->
        <item name="windowActionBar">false</item>
        <item name="windowNoTitle">true</item>

        <item name="colorPrimary">@color/colorPrimary</item>
        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
        <item name="colorAccent">@color/colorAccent</item>
        <item name="android:textAllCaps">false</item>
    </style>

ToolBar的使用

toolbar在layout中布局代码：
$\color{red}{这里面有UI的坑，就是深色toolbar，文字也是黑色的，难看}$

<!--这里是代替actionbar的，固然能够设置在baseactivity中通用，而后include进来-->
    <android.support.v7.widget.Toolbar
        android:id="@+id/toolbar"
        xmlns:android="http://schemas.android.com/apk/res/android"
        android:orientation="vertical"
        android:layout_width="match_parent"
        android:background="?attr/colorPrimary"
        android:layout_height="wrap_content"
        android:minHeight="?attr/actionBarSize">

    </android.support.v7.widget.Toolbar>

获取toolbar并取代actionbar，这里设置toolbar的标题必须在setSupportActionBar以前，不然无用

//隐藏默认actionbar
        ActionBar actionBar = getSupportActionBar();
        if(actionBar != null){
            actionBar.hide();
        }

        //获取toolbar
        toolBar = findViewById(R.id.toolbar);
        //主标题，必须在setSupportActionBar以前设置，不然无效，若是放在其余位置，则直接setTitle便可
        toolBar.setTitle("ToolBar Title");
        //用toolbar替换actionbar
        setSupportActionBar(toolBar);

设置副标题

//副标题+颜色
        toolBar.setSubtitle("Sub Title");

设置navigation up按钮的图标和点击监听

//左侧按钮：可见+更换图标+点击监听
        getSupportActionBar().setDisplayHomeAsUpEnabled(true);//显示toolbar的返回按钮
        //toolBar.setNavigationIcon(R.mipmap.back_white);
        toolBar.setNavigationOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                finish();
            }
        });

设置logo

//设置logo
        toolBar.setLogo(android.R.mipmap.sym_def_app_icon);

设置菜单menu及其监听

/**
     * 复写：添加菜单布局
     * */
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(R.menu.menu, menu);
        return true;
    }

    /**
     * 复写：设置菜单监听
     * */
    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        switch (item.getItemId()) {
            case R.id.action_refresh:
                Toast.makeText(this, "Refresh selected", Toast.LENGTH_SHORT).show();
                break;
            case R.id.action_add:
                Toast.makeText(this, "Add selected", Toast.LENGTH_SHORT).show();
                break;
            case R.id.action_settings:
                Toast.makeText(this, "Settings selected", Toast.LENGTH_SHORT).show();
                break;
            default:
                break;
        }
        return true;
    }

加载自定义toolbar：直接在toolbar的layout中写便可，能够是文字居中等等
隐藏、显示toolbar

case R.id.btn_hide:
                if(toolBar != null){
                    toolBar.setVisibility(View.GONE);
                }
                break;

            case R.id.btn_show:
                if(toolBar != null){
                    toolBar.setVisibility(View.VISIBLE);
                }
                break;

三、截图：颜色正常的

四、用ToolBar 的Theme和PopupTheme来控制颜色正常，或自定义颜色

4.一、ToolBar显然颜色不对，那找找为啥ActionBar的时候对的，直觉告诉我是theme的问题，因而找Theme.AppCompat.Light.DarkActionBar，点击进去看会看到

actionBarPopupThem是Light的，就是menu菜单点击弹出那个
actionBarTheme是深色系的，那么控制按钮图标和主副标题颜色就是白色的

<style name="Base.Theme.AppCompat.Light.DarkActionBar" parent="Base.Theme.AppCompat.Light">
        <item name="actionBarPopupTheme">@style/ThemeOverlay.AppCompat.Light</item>
        <item name="actionBarWidgetTheme">@null</item>
        <item name="actionBarTheme">@style/ThemeOverlay.AppCompat.Dark.ActionBar</item>

        <!-- Panel attributes -->
        <item name="listChoiceBackgroundIndicator">@drawable/abc_list_selector_holo_dark</item>

        <item name="colorPrimaryDark">@color/primary_dark_material_dark</item>
        <item name="colorPrimary">@color/primary_material_dark</item>
    </style>

4.二、新建Toolbar的theme和popuptheme：这里面就是继承刚刚找到的东西，固然也能够再自定义颜色咯

<!--给toolbar单独设置的theme，让toolbar上按钮颜和文字颜色变化的-->
    <style name="MyDarkToolBarTheme" parent="ThemeOverlay.AppCompat.Dark.ActionBar">
        <!--toolbar图标颜色-->
        <!--<item name="colorControlNormal">@color/colorAccent</item>-->
        <!--toolbar的title颜色-->
        <!--<item name="android:textColorPrimary">@color/colorAccent</item>-->
        <!--toolbar的subtitle颜色-->
        <!--<item name="subtitleTextColor">@color/colorAccent</item>-->
    </style>

    <!--给toolbar的menu内单独设置的theme，让toolbar上按钮颜和文字颜色变化的-->
    <style name="MyLightPopupTheme" parent="ThemeOverlay.AppCompat.Light">
        <!--设置背景-->
        <!--<item name="android:background">@android:color/white</item>-->
        <!--设置字体颜色-->
        <!--<item name="android:textColor">@color/colorAccent</item>-->
        <!--设置不覆盖锚点-->
        <!--<item name="overlapAnchor">false</item>-->
    </style>

4.三、添加Toolbar的theme和popuptheme

//需添加
xmlns:app="http://schemas.android.com/apk/res-auto"

<!--这里是代替actionbar的，固然能够设置在baseactivity中通用，而后include进来-->
    <android.support.v7.widget.Toolbar
        省略...
        app:theme="@style/MyDarkToolBarTheme"
        app:popupTheme="@style/MyLightPopupTheme">

    </android.support.v7.widget.Toolbar>

大功告成

以上就是ActionBar和ToolBar的入门使用，后面配合上系统的StatusBar和NavigationBar，并实现沉浸式还有的烦，但这些都属于基础部分，得打牢UI基础。

友情连接>>> Android 沉浸式风格（为毛叫沉浸式这么唬人）

做者：Kandy_JS 连接：https://www.jianshu.com/p/81d0bcb282cb 来源：简书著做权归做者全部。商业转载请联系做者得到受权，非商业转载请注明出处。