专栏首页老欧说安卓Android开发笔记(一百一十九)工具栏ToolBar

Android开发笔记(一百一十九)工具栏ToolBar

Toolbar

在前面的博文《Android开发笔记(二十)顶部导航栏》中,我们学习了ActionBar的用法,可是ActionBar着实是不怎么好用,比如文字风格不能定制、图标不能定制,而且还存在低版本的兼容性问题,所以实际开发中大家还是不倾向使用ActionBar。为此,Android提供了加强版的工具栏控件即Toolbar,因为Toolbar继承自ViewGroup,而且可在布局文件中像其它布局视图一样使用,所以灵活性大大的提高了。既然Android都与时俱进了,那我们也不能落后,现在就来好好学学Toolbar的用法。

导入android-support-v7-appcompat

Toolbar包含在android-support-v7-appcompat.jar包中,但app工程还不能直接使用这个jar包,因为v7-appcompat是一个完整的工程,jar包里面大量引用了工程中的图片资源,所以我们要先把v7-appcompat导入为一个库工程,然后app工程再引用这个库工程。具体步骤如下所示: 1、SDK的Extra组件中的“Android Support Library”要更新到最新版本。 2、把v7-appcompat导入为一个库工程,v7-appcompat的源路径是sdk\extras\android\support\v7\appcompat。 3、把project.properties中的target改为23(注意库工程和app工程都要改),不然会出现如下错误: Error:Error retrieving parent for item: No resource found that matches the given name 'android:TextAppearance.Material.Widget.Button.Inverse'.   Error:Error retrieving parent for item: No resource found that matches the given name 'android:Widget.Material.Button.Colored'.   4、删除values-v11与values-v14下面的styles.xml(注意库工程和app工程都要删),不然编译报错: java.lang.RuntimeException: Unable to start activity ComponentInfo{com.example.exmtoolbar/com.example.exmtoolbar.MainActivity}: java.lang.IllegalStateException: You need to use a Theme.AppCompat theme (or descendant) with this activity.

在项目中引入Toolbar

因为Toolbar与ActionBar都占着顶部导航栏的位置,所以要想引入Toolbar就得先关闭ActionBar啦,具体步骤如下所示: 1、在styles.xml中定义一个不包含ActionBar的风格样式

    <style name="AppBaseTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <item name="colorPrimary">@color/blue_light</item>
        <item name="colorPrimaryDark">@color/blue_light</item>
        <item name="colorAccent">@color/blue_light</item>
    </style>

2、修改AndroidManifest.xml,把application节点的android:theme属性值改为第一步定义的风格,如android:theme="@style/AppBaseTheme" 3、页面布局文件的根节点改为LinearLayout,且为vertical垂直方向;然后增加一个Toolbar元素,因为Toolbar本质是个ViewGroup,所以也可在它下面添加别的控件。下面是个布局例子片段:

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

4、Activity代码改为继承AppCompatActivity,注意早期的v7包是没有AppCompatActivity的,所以前面才说要先把v7包更新到最新版本。 5、同样修改AndroidManifest.xml,给该activity节点补充属性值android:theme="@style/AppBaseTheme" 6、回到Activity代码,获取一个Toolbar对象,并调用setSupportActionBar方法设置默认的导航栏为当前的Toolbar。

Toolbar的常用方法

Toolbar比ActionBar灵活,主要便是它提供了多个方法来修改控件风格,下面是Toolbar的常用方法: setLogo : 设置工具栏图标。 setTitle : 设置标题文字。 setTitleTextAppearance : 设置标题的文字风格。 setTitleTextColor : 设置标题的文字颜色。 setSubtitle : 设置副标题文字。副标题在标题下方。 setSubtitleTextAppearance : 设置副标题的文字风格。 setSubtitleTextColor : 设置副标题的文字颜色。 setNavigationIcon : 设置导航图标。导航图标在工具栏图标左边。 setNavigationOnClickListener : 设置导航图标的点击监听器。 setOverflowIcon : 设置溢出菜单的按钮图标。 showOverflowMenu : 显示溢出菜单图标。 hideOverflowMenu : 隐藏溢出菜单图标。 dismissPopupMenus : 关闭已弹出的菜单。

SearchView

v7包在带来Toolbar的同时,也带来了一个加强版的SearchView。有关原SearchView的使用说明参见《Android开发笔记(二十)顶部导航栏》,新旧两个SearchView的用法其实大同小异,当然新版的功能会更强大些,下面是android.widget.SearchView与android.support.v7.widget.SearchView的主要区别: 二者在调用时的区别: 1、菜单布局文件中,旧SearchView的写法是android:actionViewClass="android.widget.SearchView",而新SearchView的写法是app:actionViewClass="android.support.v7.widget.SearchView" 2、代码中获取SearchView对象,新控件还可通过v7类MenuItemCompat的getActionView方法来获取。

SearchView searchView = (SearchView) MenuItemCompat.getActionView(menuItem);

二者在功能上的区别: 1、编辑框其实是个SearchAutoComplete控件,该控件在旧SearchView中是隐藏的,在新SearchView中是开放的,所以我们可随意修改v7编辑框的显示风格。 2、基于上一点,新控件可取到SearchAutoComplete的对象,因此我们可给该对象注册自动完成的字符串适配器,在用户输入文字时,界面会自动弹出符合搜索条件的关键词列表; 3、setAppSearchData方法在旧SearchView中是隐藏的,在新SearchView中是开放的,所以旧控件只能传递搜索文本给结果页面,而新控件允许传递其他的额外信息给搜索结果页面。

Toolbar运行问题处理集锦

更换导航栏还是存在一些兼容问题的,下面是博主发现的几个情况及其解决办法: 1、溢出菜单的菜单项已经设置为android:showAsAction="ifRoom",但即使工具栏上还有空间,该菜单项也不会显示在工具栏上。解决办法: 在菜单布局文件的menu根节点增加属性xmlns:app="http://schemas.android.com/apk/res-auto",然后把android:showAsAction="ifRoom"改为app:showAsAction="ifRoom"。 2、溢出菜单列表在菜单文字左侧显示图标的方法,使用ActionBar时正常,使用Toolbar时反而不会显示图标了。解决办法: ActionBar的featureId是8,Toolbar的featureId是108,所以在图标显示方法内部,要同时判断这两个数值,而不能像以前那样仅仅判断Window.FEATURE_ACTION_BAR。修改之后的图标显示方法如下:

    //显示OverflowMenu的Icon 
	public static void setOverflowIconVisible(int featureId, Menu menu) {
		//ActionBar的featureId是8,Toolbar的featureId是108
        if (featureId%100 == Window.FEATURE_ACTION_BAR && menu != null) {
            if (menu.getClass().getSimpleName().equals("MenuBuilder")) {
                try {
                    Method m = menu.getClass().getDeclaredMethod(
                            "setOptionalIconsVisible", Boolean.TYPE);
                    m.setAccessible(true);
                    m.invoke(menu, true);
                } catch (Exception e) {
                    Log.d(TAG, e.getMessage());
                }
            }
        }
    }

3、代码中调用getActionView方法获取SearchView对象时,发现取到的SearchView为空。解决办法: 把菜单布局文件里的android:actionViewClass="android.support.v7.widget.SearchView"改为app:actionViewClass="android.support.v7.widget.SearchView"。 下面是新版Toolbar与SearchView的使用截图:

下面是新版Toolbar与SearchView的使用代码示例:

import java.util.Date;

import com.example.exmtoolbar.util.Utils;

import android.support.v4.view.MenuItemCompat;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.SearchView;
import android.support.v7.widget.Toolbar;
import android.util.Log;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.ArrayAdapter;
import android.widget.TextView;
import android.widget.Toast;
import android.app.SearchManager;
import android.app.SearchableInfo;
import android.content.ComponentName;
import android.content.Context;
import android.graphics.Color;
import android.os.Bundle;

public class MainActivity extends AppCompatActivity  {

	private final static String TAG = "MainActivity";
	private TextView tv_desc;
	private String[] mFormatArray = {"yyyy-MM-dd HH:mm:ss", "yyyy-MM-dd",
			"yyyy年MM月dd日HH时mm分ss秒", "yyyy年MM月dd日"};
	private String mFormat = mFormatArray[0];
	private Date mNowTime = new Date();

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		tv_desc = (TextView) findViewById(R.id.tv_desc);
		
		Toolbar tl_head = (Toolbar) findViewById(R.id.tl_head);
		tl_head.setBackgroundResource(R.color.blue_light);
		tl_head.setLogo(R.drawable.ic_launcher);
		tl_head.setTitle("标题");
		tl_head.setSubtitle("副标题");
		tl_head.setNavigationIcon(R.drawable.ic_back);
		setSupportActionBar(tl_head);
	}

	private void initSearchView(Menu menu) {
		MenuItem menuItem = menu.findItem(R.id.menu_search);
		SearchView searchView = (SearchView) MenuItemCompat.getActionView(menuItem);
	    if(searchView == null){
	        Log.d(TAG, "Fail to get SearchView.");
	    } else {
	    	//新旧SearchView公用代码开始
	    	searchView.setIconifiedByDefault(true);
	    	searchView.setSubmitButtonEnabled(true);
	        SearchManager searchManager = (SearchManager) getSystemService(Context.SEARCH_SERVICE);
	        ComponentName cn = new ComponentName(this, SearchResultActvity.class);
	        SearchableInfo info = searchManager.getSearchableInfo(cn); 
	        if(info == null){ 
	            Log.d(TAG, "Fail to get SearchResultActvity."); 
	        }      
	        searchView.setSearchableInfo(info);
	    	//新旧SearchView公用代码结束
	        
	        sac_text = (SearchView.SearchAutoComplete) searchView.findViewById(R.id.search_src_text);
	        sac_text.setTextColor(Color.WHITE);
	        sac_text.setHintTextColor(Color.WHITE);

			searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
				@Override
				public boolean onQueryTextSubmit(String query) {
					return false;
				}

				@Override
				public boolean onQueryTextChange(String newText) {
					doSearch(newText);
					return true;
				}
			});
	        
	        Bundle bundle = new Bundle();
	        bundle.putString("hi", "hello");
	        searchView.setAppSearchData(bundle);
	    }
	}
	
	private SearchView.SearchAutoComplete sac_text;
	private String[] hintArray = {"ab", "abc", "abcde", "abHtp", "aaeet", "aab"};
	private void doSearch(String text) {
		if (text.indexOf("a") == 0) {
			ArrayAdapter<String> adapter = new ArrayAdapter<String>(
					this, R.layout.list_auto, hintArray);
			sac_text.setAdapter(adapter);
	        sac_text.setOnItemClickListener(new OnItemClickListener() {
				@Override
				public void onItemClick(AdapterView<?> parent, View view,
						int position, long id) {
					TextView tv_item = (TextView) view;
					sac_text.setText(tv_item.getText());
				}
	        });
		}
	}

    @Override  
    public boolean onMenuOpened(int featureId, Menu menu) {
    	//显示菜单项左侧的图标
        Utils.setOverflowIconVisible(featureId, menu);  
        return super.onMenuOpened(featureId, menu);  
    }  
  
	@Override
	public boolean onCreateOptionsMenu(Menu menu) {
		getMenuInflater().inflate(R.menu.main, menu);
		//对搜索框做初始化
		initSearchView(menu);
		return true;
	}

	@Override
	public boolean onOptionsItemSelected(MenuItem item) {
		int id = item.getItemId();
		if (id == android.R.id.home) {
			finish();
		} else if (id == R.id.menu_refresh) {
			mNowTime = new Date();
			tv_desc.setText("当前刷新时间: "+Utils.getFormatDateTime(mNowTime, mFormat));
			return true;
		} else if (id == R.id.menu_about) {
			Toast.makeText(this, "这个是工具栏的演示demo", Toast.LENGTH_LONG).show();
			return true;
		} else if (id == R.id.menu_quit) {
			finish();
		}
		return super.onOptionsItemSelected(item);
	}

}

下面是搜索结果页面的代码:

import android.app.SearchManager;
import android.content.Intent;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.Toolbar;
import android.util.Log;
import android.view.Menu;
import android.view.MenuItem;
import android.widget.TextView;

public class SearchResultActvity extends AppCompatActivity {
	private static final String TAG = "SearchResultActvity";
	private TextView tv_search_result;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_search_result);
		tv_search_result = (TextView) findViewById(R.id.tv_search_result);
		doSearchQuery(getIntent()); 
		
		Toolbar tl_result = (Toolbar) findViewById(R.id.tl_result);
		tl_result.setBackgroundResource(R.color.blue_light);
		tl_result.setLogo(R.drawable.ic_launcher);
		tl_result.setTitle("搜索结果页");
		tl_result.setNavigationIcon(R.drawable.ic_back);
		setSupportActionBar(tl_result);
	}

    private void doSearchQuery(Intent intent){  
        if(intent == null) {
            return; 
        } else {
            //如果是通过ACTION_SEARCH来调用,即如果通过搜索调用
            if(Intent.ACTION_SEARCH.equals(intent.getAction())){
            	//获取额外信息
            	Bundle bundle = intent.getBundleExtra(SearchManager.APP_DATA);
            	String value = bundle.getString("hi");
            	//获取搜索内容
                String queryString = intent.getStringExtra(SearchManager.QUERY);
                tv_search_result.setText("您输入的搜索文字是:"+queryString+", 额外信息:"+value);
            }  
        }
    }  

	@Override
	public boolean onCreateOptionsMenu(Menu menu) {
		getMenuInflater().inflate(R.menu.null_menu, menu);
		return true;
	}

	@Override
	public boolean onOptionsItemSelected(MenuItem item) {
		int id = item.getItemId();
		if (id == android.R.id.home) {
			Log.d(TAG, "finish activity");
			finish();
		}
		return super.onOptionsItemSelected(item);
	}
}

点击下载本文用到的工具栏Toolbar的工程代码 点此查看Android开发笔记的完整目录

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 程序员带你学习安卓开发-XML文档的创建与解析

    这是程序员带你学习安卓开发系列教程。本文章致力于面向对象程序员可以快速学习开发安卓技术。

    做全栈攻城狮
  • Flutter组件学习(二)—— Image

    上一节中,我们讲了 Flutter 中 Text 组件的一些用法以及 API,本节我们继续学习 Flutter 中的 Image 组件,同样先上图:

    用户2802329
  • Android中的序列化:Parcelable和Serializable

    用户1205080
  • 用Android最火的快速开发框架XUtils,进行文件下载

    更多原创教程,关注微信公众平台:做全栈攻城狮。及做全栈攻城狮官网:www.8z5.net

    做全栈攻城狮
  • Android程序员 安卓7.0的新特性新功能 优化渲染来电

    上篇介绍了安卓7.0中的多窗口支持、通知增强及即时编译的新特性。这次文章继续讲解android 7.0的新特性新功能.

    做全栈攻城狮
  • 安卓开发-使用异步网络请求框架、多线程文件下载

    相信对于前面的教程,大家已经很熟悉安卓网络编程了。这篇文章主要讲解一下异步网络编程和文件下载。学习编程重在写代码,只有自己的代码量上去了,自己才能完全理解。所以...

    做全栈攻城狮
  • [译] 为用户提供安全可靠的体验

    我们不遗余力地关注 Google Play Store 的安全性和隐私,以确保 Android 用户拥有发现和安装他们喜欢的应用程序和游戏的积极体验。我们定期更...

    Android 开发者
  • Wine 3.0发布:支持Android图形驱动、Direct3D 11、AES加密

    2018 年伊始,Wine(Wine Is Not an Emulator) 项目发布了年度更新,释出了最新的 3.0 稳定版本。 Wine 是一个在 Linu...

    Debian社区
  • React Native APP签名打包release版本APK

    首先React Native开发的APP是无法通过Android Studio进行打包的,因为AS打包的APK,也是和debug版本一样,需要进行依托local...

    做全栈攻城狮
  • React Native开发APP中的常用命令,如有遗漏请补充(不断更新...)

    做全栈攻城狮

扫码关注云+社区

领取腾讯云代金券