[置顶] xamarin android toolbar(踩坑完全入门详解)
网上关于toolbar的教程有很多,很多新手，在使用toolbar的时候踩坑实在太多了,不好好总结一下,实在浪费。如果你想学习toolbar，你肯定会去去搜索androd toolbar，既然你能看到这篇文章，说明还是搜了xamarin android toolbar。那么这篇文章就好好总结一下toolbar在xamarin android中如何使用，减少大家踩坑的时间。
了解Toolbar
android3.0推了ActionBar这个控件，android5.0开始推出Materal Design，其中就有ToolBar控件。可能官方觉得ActionBar限制app开发设计的弹性，google非常推荐大家使用ToolBar来作为客户端的导航栏，以此来取代ActionBar。
ToolBar使用更灵活，设计更多样性。主要的优点有1.可以设置导航栏图标、Logo、标题和子标题等属性； 2可添加自定义控件；3.支持Action Menu；4.可随意设置位置
xamarin android中使用Toolbar
官方为了将toolbar这一控件向下兼容，推出了兼容版的toolbar，所以首先的引入Android.Support.V7.AppCompat。我们先来看看最终完成的整体的效果图
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@color/color_white"
android:fitsSystemWindows="true">
<android.support.v7.widget.Toolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="60dp"
android:background="@color/color_primary"
android:navigationIcon="@drawable/icon2"
android:logo="@drawable/icon"
android:subtitle="子标题"
android:title="标题"
android:titleTextColor="@color/color_white">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="自定义文本">
</TextView>
</android.support.v7.widget.Toolbar>
</LinearLayout>
记得在Activity继承AppCompatActivity，现在运行的结果是并没有看到标题、子标题、logo等属性。<style name="AppTheme" parent="AppTheme.Base"> </style> <style name="AppTheme.Base" parent="Theme.AppCompat.Light.NoActionBar"> </style>
往下看怎么解决。
坑1：设置Toolbar属性不能使用android:**** 而使用app:*****
我们没有看到这些设置的属性很正常，我们使用android:*** 找不到的属性，应该使用Toolbar这个控件自带的属性。所以我在根布局加了
xmlns:app="http://schemas.android.com/apk/rs-auto" 使用app:***来设置属性如下
<android.support.v7.widget.Toolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="60dp"
android:background="@color/color_primary"
android:navigationIcon="@drawable/icon2"
android:logo="@drawable/icon"
android:subtitle="子标题"
android:title="标题"
android:titleTextColor="@color/color_white">
现在我们能看到已经设置白色的标题文本，navigationIcon、logo、子标题。但是尴尬的是子标题的颜色subTitleTextColor属性报错，虽然可以通过代码SetSubtitleTextColor方法设置,但是这个子标题文本颜色这个subTitleTextColor属性不能通过编译有点难以理解。后来才发现subTitleTextColor属性Title要小写，jbwy，也就是这样app:subtitleTextColor添加ActionMenu 菜单项
toolbar可以添加菜单项，在Resources文件下建一个menu文件夹专门放菜单。先来看一下actionMenu.xml 菜单项文件,然后在代码实现方法。
<?xml version="1.0" encoding="utf-8" ?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item android:id="@id/menu_edit"
android:icon="@drawable/edit"
android:title="编辑"
app:showAsAction="ifRoom"/>
<item android:id="@id/menu_search"
android:icon="@drawable/search"
android:title="搜索"
app:showAsAction="ifRoom"/>
<item android:id="@id/menu_add"
android:icon="@drawable/add"
android:title="添加"
app:showAsAction="ifRoom"/>
</menu>
MainActivity代码如下：using Android.App;
using Android.Views;
using Android.Widget;
using Android.OS;
using Android.Support.V7.App;
namespace ToolbarDemo
{
[Activity(Label = "ToolbarDemo", MainLauncher = true, Icon = "@drawable/icon",Theme ="@style/AppTheme")]
public class MainActivity : AppCompatActivity
{
protected override void OnCreate(Bundle bundle)
{
base.OnCreate(bundle);
SetContentView(Resource.Layout.Main);
Android.Support.V7.Widget.Toolbar toolbar = FindViewById<Android.Support.V7.Widget.Toolbar>(Resource.Id.toolbar);
toolbar.InflateMenu(Resource.Menu.actionMenu); //填充actionMenu菜单项
toolbar.MenuItemClick += (s, e) => //菜单项单击事件
{
switch (e.Item.ItemId)
{
case Resource.Id.menu_add:
Toast.MakeText(this, "添加菜单项", ToastLength.Short).Show();
break;
case Resource.Id.menu_edit:
Toast.MakeText(this, "编辑菜单项", ToastLength.Short).Show();
break;
case Resource.Id.menu_search:
Toast.MakeText(this, "搜索菜单项", ToastLength.Short).Show();
break;
}
};
}
public override bool OnCreateOptionsMenu(IMenu menu)
{
return base.OnCreateOptionsMenu(menu);
}
}
}
关于showAsAction 展现在Action条目中的几个属性值有这几个：
- always：使菜单项一直显示在ToolBar上。
- ifRoom：如果有足够的空间，这个值会使菜单项显示在ToolBar上。
- never：使菜单项永远都不出现在ToolBar上,在…的子项中显示。
- withText：使菜单项和它的图标，菜单文本一起显示。
坑2：toolbar中使用setSupportActionBar方法菜单项不见了
如果在onCreate方法里面使用兼容包的方法SetSupportActionBar(toolbar) 后发现菜单项不显示了，这就有点尴尬了，所以要在OnCreateOptionsMenu方法中加上一句代码加载菜单项才能显示
public override bool OnCreateOptionsMenu(IMenu menu)
{
MenuInflater.Inflate(Resource.Menu.actionMenu,menu);
return base.OnCreateOptionsMenu(menu);
}
toolbar中设置菜单项图标颜色、自定义菜单图标、设置菜单项文字颜色
对于设置各种颜色，我们先来看看这张图，我是盗图的......，然后结合style文件看看如何设置这些颜色。原文地址http://blog.csdn.net/u012702547/article/details/50932090
<style name="AppTheme.NoActionBar">
<!--状态栏颜色-->
<item name="colorPrimaryDark">@color/colorPrimaryDark</item>
<!--控制各个控件被选中时的颜色-->
<item name="colorAccent">@color/colorAccent</item>
<!--页面背景色-->
<item name="android:windowBackground">@color/windowBackg</item>
<!--底部导航栏颜色-->
<item name="android:navigationBarColor">@color/navigationColor</item>
<!--Appbar背景色-->
<item name="android:colorPrimary">@color/colorPrimary</item>
<!--ToolBar上的Title颜色-->
<item name="android:textColorPrimary">@color/textColorPrimary</item>
<!--各个控制控件的默认颜色-->
<item name="android:colorControlNormal">@color/colorControlNormal</item>
</style>
设置菜单项图标颜色：
通过上面的图和代码已经知道android:colorControlNormal设置各种控件的默认颜色，在Activity中Theme中这样写就可以了：
<style name="AppTheme.Base" parent="Theme.AppCompat.Light.NoActionBar">
<item name="colorControlNormal">@color/color_white</item>
</style>
为什么要在Activity的主题里面设置？能不能直接Toolbar的主题设置，当然可以，直接通过设置Toolbar控件的android:theme=“****”就可以了。主题样式如下
<style name="ActionMenuTheme" parent="Theme.AppCompat.Light.NoActionBar">
<item name="colorControlNormal">@color/color_white</item>
<!--改变菜单项文字颜色-->
<item name="android:textColorPrimary">@color/color_red</item>
<item name="android:textSize">12sp</item>
</style>
toolbar 设置菜单项文字颜色上面的toolbar的主题ActionMenuTheme 中的<item name="adnroid:textColorPrimary">@color/color_red</item>就是这事菜单项文字的颜色。效果如下：
toolbar 溢出菜单项图标的设置
如果你觉tollbar 的溢出菜单三个点不符合的审美感觉，你可以可以自定义一个图标来修改，同样我们设置toolbar的android:theme来做这件事情
<style name="ActionMenuTheme" parent="Theme.AppCompat.Light.NoActionBar">
<item name="colorControlNormal">@color/color_white</item>
<!--改变菜单项文字颜色-->
<item name="android:textColorPrimary">@color/color_red</item>
<item name="android:textSize">12sp</item>
<!--设置溢出菜单项图标-->
<item name="actionOverflowButtonStyle">@style/ActionButton.Overflow.Custom</item>
</style>
<style name="ActionButton.Overflow.Custom" parent="android:style/Widget.Holo.Light.ActionButton.Overflow">
<item name="android:src">@drawable/add_white</item>
</style>
toolbar自定义溢出菜单样式
虽然上面我们进行了图标颜色，自定义图标，菜单文字颜色的修改，但是这和我们一般的app上的ToolBar还是有一定差距，菜单项挡住了toolbar，正常的做法应该往下移才合理一点。如图所示：
添加以下样式
<!--溢出菜单项下移-->
<style name="OverflowMenuStyle" parent="@style/Widget.AppCompat.PopupMenu.Overflow">
<!-- 是否覆盖锚点，默认为true，即盖住Toolbar -->
<item name="overlapAnchor">false</item>
<!-- 弹出层背景颜色 -->
<item name="android:popupBackground">@color/color_primary</item>
<!-- 弹出层垂直方向上的偏移，即在竖直方向上距离Toolbar的距离，值为负则会盖住Toolbar -->
<item name="android:dropDownVerticalOffset">10dp</item>
<!-- 弹出层水平方向上的偏移，即距离屏幕左边的距离，负值会导致右边出现空隙 -->
<item name="android:dropDownHorizontalOffset">-10dp</item>
</style>
然后再Activity中的Theme中添加以下style <style name="AppTheme.Base" parent="Theme.AppCompat.Light.NoActionBar">
<item name="actionOverflowMenuStyle">@style/OverflowMenuStyle</item>
<item name="actionOverflowButtonStyle">@style/ActionButton.Overflow.Custom</item>
<item name="android:textColorPrimary">@color/color_white</item>
<item name="android:textSize">15sp</item>
</style>
坑3：无法再Toolbar中设置app:popopTheme自定义溢出菜单样式
看了android的做法这个溢出菜单下移OverflowMenuStyle样式可以写在Toolbar 的属性app:popupTheme但是没有效果，如果知道怎么解决，欢迎评论指出。
坑4：toolbar菜单项无法同时显示图标和文字
根据图上所看到的，显示toolbar上的菜单项是图标，但是显示popupMenu上的只有文字没有图标，我们想要修改一下让图标和文字同时显示在popupMenu上该怎么做呢。使用withText也并有作用，这时要使用app:actionLayout属性了。在menu文件夹的菜单布局下加上app:actionLayout属性
<?xml version="1.0" encoding="utf-8" ?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item android:id="@+id/menu_edit"
android:icon="@drawable/edit"
android:title="编辑"
app:actionLayout="@layout/menu_action_edit"
app:showAsAction="withText"/>
<item android:id="@+id/menu_search"
android:icon="@drawable/search"
android:title="搜索"
app:showAsAction="always|withText"/>
<item android:id="@+id/menu_add"
android:icon="@drawable/add_small"
android:title="添加"
app:showAsAction="always|withText"
app:actionLayout="@layout/menu_action_add"
/>
</menu>
actionLayout指向的是一个布局文件，至于menu_action_add.axml。就是一个图标加文本使用drawableLeft属性。
<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:paddingLeft="10dip"
android:paddingRight="10dip"
android:gravity="center"
android:text="添加"
android:drawableLeft="@drawable/add_white"
android:textColor="@color/color_white"
android:clickable="true" />
效果图如下，google 默认在overflow中的actionMenu都只显示文字，要同时显示图标和文字，还需要想办法改变这一默认行为。overflow中的ActionMenu显不显示图标，是有MenuBuilder这个类的setOptionalIconsVisable方法决定的，在菜单展开的时候给这个方法传入true，那每个菜单项的图标和文字都会显示出来，尴尬的是要java的反射方法去做这件事，重写OnMenuOpend方法
public override bool OnMenuOpened(int featureId, IMenu menu)
{
System.Diagnostics.Debug.WriteLine(featureId);
if ( menu != null)
{
var javaObj = (Java.Lang.Object)menu;
var javaClass = javaObj.Class;
if (javaClass.SimpleName.EndsWith("MenuBuilder"))
{
try {
Java.Lang.Reflect.Method m = javaClass.GetDeclaredMethod("setOptionalIconsVisible", new Java.Lang.Class[] { Java.Lang.Boolean.Type });
m.Accessible = true;
m.Invoke(javaObj,new Java.Lang.Object[] { true});
}
catch (Java.Lang.NoSuchFieldException e)
{
System.Console.WriteLine("onMenuOpened:{0}",e.ToString());
}
}
}
return base.OnMenuOpened(featureId, menu);
}
最终效果：最后总结一句：纸上得来终觉浅，绝知此事要躬行。关于toolbar的更多属性还要仔细去琢磨。
代码下载地址http://download.csdn.net/detail/kebi007/9835823
