首页 > 代码库 > 添加Action Provider

添加Action Provider


Action View有点类似,Action Provider也可以将一个Action按钮替换成一个自定义的布局。但不同的是,Action Provider能够完全控制事件的所有行为,并且还可以在点击的时候显示子菜单。

为了添加一个Action Provider,我们需要在<item>标签中指定一个actionProviderClass属性,在里面填入Action Provider的完整类名。我们可以通过继承ActionProvider类的方式来创建一个自己的Action Provider,同时,Android也提供好了几个内置的Action Provider,比如说ShareActionProvider

由于每个Action Provider都可以自由地控制事件响应,所以它们不需要在onOptionsItemSelected()方法中再去监听点击事件,而是应该在onPerformDefaultAction()方法中去执行相应的逻辑。

那么我们就先来看一下ShareActionProvider的简单用法吧,编辑menu资源文件,在里面加入ShareActionProvider的声明,如下所示:

 

1. <menu xmlns:android="http://schemas.android.com/apk/res/android"  

2.     xmlns:tools="http://schemas.android.com/tools"  

3.     tools:context="com.example.actionbartest.MainActivity" >  

4.   

5.     <item  

6.         android:id="@+id/action_share"  

7.         android:actionProviderClass="android.widget.ShareActionProvider"  

8.         android:showAsAction="ifRoom"  

9.         android:title="@string/action_share" />  

10.     ......  

11.   

12. </menu>  

注意,ShareActionProvider会自己处理它的显示和事件,但我们仍然要记得给它添加一个title,以防止它会在overflow当中出现。

接着剩下的事情就是通过Intent来定义出你想分享哪些东西了,我们只需要在onCreateOptionsMenu()中调用MenuItemgetActionProvider()方法来得到该ShareActionProvider对象,再通过setShareIntent()方法去选择构建出什么样的一个Intent就可以了。代码如下所示:

 

1. @Override  

2. public boolean onCreateOptionsMenu(Menu menu) {  

3.     MenuInflater inflater = getMenuInflater();  

4.     inflater.inflate(R.menu.main, menu);  

5.     MenuItem shareItem = menu.findItem(R.id.action_share);  

6.     ShareActionProvider provider = (ShareActionProvider) shareItem.getActionProvider();  

7.     provider.setShareIntent(getDefaultIntent());  

8.     ......  

9.     return super.onCreateOptionsMenu(menu);  

10. }  

11.   

12. private Intent getDefaultIntent() {  

13.     Intent intent = new Intent(Intent.ACTION_SEND);  

14.     intent.setType("image/*");  

15.     return intent;  

16. 

17. 

18. }  

可以看到,这里我们通过getDefaultIntent()方法来构建了一个Intent,该Intent表示会将所有可以共享图片的程度都列出来。重新运行一下程序,效果如下图所示:

 

这个ShareActionProvider点击之后是可以展开的,有点类似于overflow的效果,这就是Action Provider的子菜单。除了使用ShareActionProvider之外,我们也可以自定义一个Action Provider,比如说如果想要建立一个拥有两项子菜单的Action Provider,就可以这样写:

 

1. public class MyActionProvider extends ActionProvider {  

2.       

3.     public MyActionProvider(Context context) {  

4.         super(context);  

5.     }  

6.   

7.     @Override  

8.     public View onCreateActionView() {  

9.         return null;  

10.     }  

11.   

12.     @Override  

13.     public void onPrepareSubMenu(SubMenu subMenu) {  

14.         subMenu.clear();  

15.         subMenu.add("sub item 1").setIcon(R.drawable.ic_launcher)  

16.                 .setOnMenuItemClickListener(new OnMenuItemClickListener() {  

17.                     @Override  

18.                     public boolean onMenuItemClick(MenuItem item) {  

19.                         return true;  

20.                     }  

21.                 });  

22.         subMenu.add("sub item 2").setIcon(R.drawable.ic_launcher)  

23.                 .setOnMenuItemClickListener(new OnMenuItemClickListener() {  

24.                     @Override  

25.                     public boolean onMenuItemClick(MenuItem item) {  

26.                         return false;  

27.                     }  

28.                 });  

29.     }  

30.   

31.     @Override  

32.     public boolean hasSubMenu() {  

33.         return true;  

34.     }  

35.   

36. }  

这里我们新建了一个MyActionProvider继承自ActionProvider,为了表示这个Action Provider是有子菜单的,需要重写hasSubMenu()方法并返回true,然后在onPrepareSubMenu通过调用SubMenuadd()方法添加子菜单。

接着修改menu资源,在里面加入MyActionProvider的声明:

 

1. <menu xmlns:android="http://schemas.android.com/apk/res/android"  

2.     xmlns:tools="http://schemas.android.com/tools"  

3.     tools:context="com.example.actionbartest.MainActivity" >  

4.   

5.     <item  

6.         android:id="@+id/action_share"  

7.         android:actionProviderClass="com.example.actionbartest.MyActionProvider"  

8.         android:icon="@drawable/ic_launcher"  

9.         android:showAsAction="ifRoom"  

10.         android:title="@string/action_share" />  

11.     ......  

12.   

13. </menu>  

现在重新运行一下代码,结果如图所示:

 

添加导航Tabs

Tabs的应用可以算是非常广泛了,它可以使得用户非常轻松地在你的应用程序中切换不同的视图。而Android官方更加推荐使用ActionBar中提供的Tabs功能,因为它更加的智能,可以自动适配各种屏幕的大小。比如说,在平板上屏幕的空间非常充足,Tabs会和Action按钮在同一行显示,如下图所示:

 

而如果是在手机上,屏幕的空间不够大的话,TabsAction按钮则会分为两行显示,如下图所示:

 

下面我们就来看一下如何使用ActionBar提供的Tab功能,大致可以分为以下几步:

1. 实现ActionBar.TabListener接口,这个接口提供了Tab事件的各种回调,比如当用户点击了一个Tab时,你就可以进行切换Tab的操作。

2.为每一个你想添加的Tab创建一个ActionBar.Tab的实例,并且调用setTabListener()方法来设置ActionBar.TabListener。除此之外,还需要调用setText()方法来给当前Tab设置标题。

3.最后调用ActionBaraddTab()方法将创建好的Tab添加到ActionBar中。

看起来并不复杂,总共就只有三步,那么我们现在就来尝试一下吧。首先第一步需要创建一个实现ActionBar.TabListener接口的类,代码如下所示:

[

1. public class TabListener<T extends Fragment> implements ActionBar.TabListener {  

2.     private Fragment mFragment;  

3.     private final Activity mActivity;  

4.     private final String mTag;  

5.     private final Class<T> mClass;  

6.   

7.     public TabListener(Activity activity, String tag, Class<T> clz) {  

8.         mActivity = activity;  

9.         mTag = tag;  

10.         mClass = clz;  

11.     }  

12.   

13.     public void onTabSelected(Tab tab, FragmentTransaction ft) {  

14.         if (mFragment == null) {  

15.             mFragment = Fragment.instantiate(mActivity, mClass.getName());  

16.             ft.add(android.R.id.content, mFragment, mTag);  

17.         } else {  

18.             ft.attach(mFragment);  

19.         }  

20.     }  

21.   

22.     public void onTabUnselected(Tab tab, FragmentTransaction ft) {  

23.         if (mFragment != null) {  

24.             ft.detach(mFragment);  

25.         }  

26.     }  

27.   

28.     public void onTabReselected(Tab tab, FragmentTransaction ft) {  

29.     }  

30. }  

这段代码并不长,我们简单分析一下。当Tab被选中的时候会调用onTabSelected()方法,在这里我们先判断mFragment是否为空,如果为空的话就创建Fragment的实例并调用FragmentTransactionadd()方法,如果不会空的话就调用FragmentTransactionattach()方法。

而当Tab没有被选中的时候,则调用FragmentTransactiondetach()方法,将UI资源释放掉。

Tab被重新选中的时候会调用onTabReselected()方法,如果没有特殊需求的话,通常是不需要进行处理的。

接下来第二步要给每一个Tab创建一个ActionBar.Tab的实例,在此之前要先准备好每个Tab页对应的Fragment。比如说这里我们想创建两个Tab页,ArtistAlbum,那就要先准备好这两个Tab页对应的Fragment。首先新建ArtistFragment,代码如下所示:


1. public class ArtistFragment extends Fragment {  

2.   

3.     @Override  

4.     public View onCreateView(LayoutInflater inflater, ViewGroup container,  

5.             Bundle savedInstanceState) {  

6.         TextView textView = new TextView(getActivity());  

7.         textView.setText("Artist Fragment");  

8.         textView.setGravity(Gravity.CENTER_HORIZONTAL);  

9.         LinearLayout layout = new LinearLayout(getActivity());  

10.         LayoutParams params = new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);  

11.         layout.addView(textView, params);  

12.         return layout;  

13.     }  

14.   

15. }  

没有什么实质性的代码,只是在TextView中显示了Artist Fragment这个字符串。

然后如法炮制,新建AlbumFragment,代码如下所示:


1. public class AlbumFragment extends Fragment {  

2.       

3.     @Override  

4.     public View onCreateView(LayoutInflater inflater, ViewGroup container,  

5.             Bundle savedInstanceState) {  

6.         TextView textView = new TextView(getActivity());  

7.         textView.setText("Album Fragment");  

8.         textView.setGravity(Gravity.CENTER_HORIZONTAL);  

9.         LinearLayout layout = new LinearLayout(getActivity());  

10.         LayoutParams params = new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);  

11.         layout.addView(textView, params);  

12.         return layout;  

13.     }  

14.   

15. }  

Fragment都准备好了之后,接下来就可以开始创建Tab实例了,创建好了之后则再调用addTab()方法添加到ActionBar当中,这两步通常都是在ActivityonCreate()方法中执行的,代码如下:


1. @Override  

2. protected void onCreate(Bundle savedInstanceState) {  

3.     super.onCreate(savedInstanceState);  

4.     setTitle("天气");  

5.     ActionBar actionBar = getActionBar();  

6.     actionBar.setDisplayHomeAsUpEnabled(true);  

7.     setOverflowShowingAlways();  

8.     actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);  

9.     Tab tab = actionBar  

10.             .newTab()  

11.             .setText(R.string.artist)  

12.             .setTabListener(  

13.                     new TabListener<ArtistFragment>(this"artist",  

14.                             ArtistFragment.class));  

15.     actionBar.addTab(tab);  

16.     tab = actionBar  

17.             .newTab()  

18.             .setText(R.string.album)  

19.             .setTabListener(  

20.                     new TabListener<AlbumFragment>(this"album",  

21.                             AlbumFragment.class));  

22.     actionBar.addTab(tab);  

23. }  

可以看到,这里是使用连缀的写法来创建Tab的。首先调用ActionBarnewTab()方法来创建一个Tab实例,接着调用了setText()方法来设置标题,然后再调用setTabListener()方法来设置事件监听器,最后再调用ActionBaraddTab()方法将Tab添加到ActionBar中。
好了,这样的话代码就编写完了,重新运行一下程序,效果如下图所示:

 

自定义ActionBar样式

虽说ActionBar给用户提供了一种全局统一的界面风格和操作方式,但这并不意味着所有应用程序的ActionBar都必须要长得一模一样。如果你需要修改ActionBar的样式来更加好地适配你的应用,可以非常简单地通过Android样式和主题来实现。

其实Android内置的几个Activity主题中就已经包含了"dark""light"这样的ActionBar样式了,同时你也可以继承这些主题,然后进行更深一步的定制。

1. 使用主题

Android中有两个最基本的Activity主题可以用于指定ActionBar的颜色,分别是:

· Theme.Holo,这是一个深色系的主题。

· Theme.Holo.Light,这是一个浅色系的主题。

深色系主题样式的效果如下图所示:

 

浅色系主题样式的效果如下图所示:

 

你可以将这些主题应用到你的整个应用程序,也可以只应用于某个Activity。通过在AndroidManifest.xml文件中给<application><activity>标签指定android:theme属性就可以实现了。比如:


1. <application android:theme="@android:style/Theme.Holo.Light" ... />  

如果你只想让ActionBar使用深色系的主题,而Activity的内容部分仍然使用浅色系的主题,可以通过声明Theme.Holo.Light.DarkActionBar这个主题来实现,效果如下图所示:

 

2. 自定义背景

如果想要修改ActionBar的背景,我们可以通过创建一个自定义主题并重写actionBarStyle属性来实现。这个属性可以指向另外一个样式,然后我们在这个样式中重写background这个属性就可以指定一个drawable资源或颜色,从而实现自定义背景的功能。

编辑styles.xml文件,在里面加入一个自定义的主题,如下所示:

1. <resources>  

2.   

3.     <style name="CustomActionBarTheme" parent="@android:style/Theme.Holo.Light">  

4.         <item name="android:actionBarStyle">@style/MyActionBar</item>  

5.     </style>  

6.     <style name="MyActionBar" parent="@android:style/Widget.Holo.Light.ActionBar">  

7         <item name="android:background">#f4842d</item>  

8.     </style>  


9. </resources>  

可以看到,这里我们定义了一个CustomActionBarTheme主题,并让它继承自Theme.Holo.Light。然后在其内部重写了actionBarStyle这个属性,然后将这个属性指向了MyActionBar这个样式,我们在这个样式中又重写了background属性,并给它指定了一个背景色。

现在重新运行一下程序,效果如下图所示:

 

这样我们就成功修改ActionBar的背景色了。不过现在看上去还有点怪怪的,因为只是ActionBar的背景色改变了,Tabs的背景色还是原来的样子,这样就感觉不太协调。那么下面我们马上就来修改一下Tabs的背景色,编辑styles.xml文件,如下所示:

 

1. <resources>  

2.   

3.     <style name="CustomActionBarTheme" parent="@android:style/Theme.Holo.Light">  

4.         <item name="android:actionBarStyle">@style/MyActionBar</item>  

5.     </style>  

6.   

7.     <style name="MyActionBar" parent="@android:style/Widget.Holo.Light.ActionBar">  

8.         <item name="android:background">#f4842d</item>  

9.         <item name="android:backgroundStacked">#d27026</item>  

10.     </style>  

11.   

12. </resources>  

可以看到,这里又重写了backgroundStacked属性,这个属性就是用于指定Tabs背景色的。那么再次重新运行程序,效果如下图所示:

 

3. 自定义文字颜色

现在整个ActionBar的颜色是属于偏暗系的,而ActionBar中文字的颜色又偏偏是黑色的,所以看起来并不舒服,那么接下来我们就学习一下如果自定义文字颜色,将文字颜色改成白色。

修改styles.xml文件,如下所示:

1. <resources>  

2.   

3.     ......  

4.   

5.     <style name="MyActionBar" parent="@android:style/Widget.Holo.Light.ActionBar">  

6.         ......  

7.         <item name="android:titleTextStyle">@style/MyActionBarTitleText</item>  

8.     </style>  

9.   

10.     <style name="MyActionBarTitleText" parent="@android:style/TextAppearance.Holo.Widget.ActionBar.Title">  

11.         <item name="android:textColor">#fff</item>  

12.     </style>  

13.   

14. </resources>  

可以看到,这里在MyActionBar样式里面重写了titleTextStyle属性,并将它指向了另一个自定义样式MyActionBarTitleText,接着我们在这个样式中指定textColor的颜色是#fff,也就是白色。

现在重新运行一下程序,结果如下图所示:

 

OKActionBar标题文字的颜色已经成功改成白色了,那Tab标题的文字又该怎么修改呢?继续编辑styles.xml文件,如下所示:

1. <resources>  

2.   

3.     <style name="CustomActionBarTheme" parent="@android:style/Theme.Holo.Light">  

4.         <item name="android:actionBarStyle">@style/MyActionBar</item>  

5.         <item name="android:actionBarTabTextStyle">@style/MyActionBarTabText</item>  

6.     </style>  

7.       

8.     <style name="MyActionBarTabText"  

9.            parent="@android:style/Widget.Holo.ActionBar.TabText">  

10.         <item name="android:textColor">#fff</item>  

11.     </style>  

12.   

13. </resources>  

这里我们在CustomActionBarTheme主题中重写actionBarTabTextStyle属性,并将它指向一个新建的MyActionBarTabText样式,然后在这个样式中重写textColor属性,将颜色指定为白色即可。

重新运行一下程序,结果如下图所示:

 

4. 自定义Tab Indicator

为了可以明确分辨出我们当前选中的是哪一个Tab项,通常情况下都会在选中Tab的下面加上一条横线作为标识,这被称作Tab Indicator。那么上图中的Tab Indicator是蓝色的,明显和整体风格不相符,所以我们接下来就学习一下如何自定义Tab Indicator

首先我们需要重写actionBarTabStyle这个属性,然后将它指向一个新建的Tab样式,然后重写background这个属性即可。需要注意的是,background必须要指定一个state-list drawable文件,这样在各种不同状态下才能显示出不同的效果。

那么在开始之前,首先我们需要准备四张图片,分别用于表示Tab的四种状态,如下所示:

                           

这四张图片分别表示Tab选中未按下,选中且按下,未选中未按下,未选中且按下这四种状态,那么接着新建res/drawable/actionbar_tab_indicator.xml文件,代码如下所示:

[html] view plaincopy

1. <?xml version="1.0" encoding="utf-8"?>  

2. <selector xmlns:android="http://schemas.android.com/apk/res/android">  

3.   

4.     <item  android:state_selected="false"  

5.           android:state_pressed="false"  

6.           android:drawable="@drawable/tab_unselected" />  

7.     <item android:state_selected="true"  

8.           android:state_pressed="false"  

9.           android:drawable="@drawable/tab_selected" />  

10.     <item android:state_selected="false"  

11.           android:state_pressed="true"  

12.           android:drawable="@drawable/tab_unselected_pressed" />  

13.     <item android:state_selected="true"  

14.           android:state_pressed="true"  

15.           android:drawable="@drawable/tab_selected_pressed" />  

16.   

17. </selector>  

四种状态分别引用了四张图片,这样就把state-list drawable文件写好了。接着修改style.xml文件,代码如下所示:


1. <resources>  

2.   

3.     <style name="CustomActionBarTheme" parent="@android:style/Theme.Holo.Light">  

4.         ......  

5.         <item name="android:actionBarTabStyle">@style/MyActionBarTabs</item>  

6.     </style>  

7.       

8.     <style name="MyActionBarTabs" parent="@android:style/Widget.Holo.ActionBar.TabView">  

9.         <item name="android:background">@drawable/actionbar_tab_indicator</item>  

10.     </style>  

11.   

12. </resources>  

添加Action Provider