首页 > 代码库 > 添加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()中调用MenuItem的getActionProvider()方法来得到该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通过调用SubMenu的add()方法添加子菜单。
接着修改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按钮在同一行显示,如下图所示:
而如果是在手机上,屏幕的空间不够大的话,Tabs和Action按钮则会分为两行显示,如下图所示:
下面我们就来看一下如何使用ActionBar提供的Tab功能,大致可以分为以下几步:
1. 实现ActionBar.TabListener接口,这个接口提供了Tab事件的各种回调,比如当用户点击了一个Tab时,你就可以进行切换Tab的操作。
2.为每一个你想添加的Tab创建一个ActionBar.Tab的实例,并且调用setTabListener()方法来设置ActionBar.TabListener。除此之外,还需要调用setText()方法来给当前Tab设置标题。
3.最后调用ActionBar的addTab()方法将创建好的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的实例并调用FragmentTransaction的add()方法,如果不会空的话就调用FragmentTransaction的attach()方法。
而当Tab没有被选中的时候,则调用FragmentTransaction的detach()方法,将UI资源释放掉。
当Tab被重新选中的时候会调用onTabReselected()方法,如果没有特殊需求的话,通常是不需要进行处理的。
接下来第二步要给每一个Tab创建一个ActionBar.Tab的实例,在此之前要先准备好每个Tab页对应的Fragment。比如说这里我们想创建两个Tab页,Artist和Album,那就要先准备好这两个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当中,这两步通常都是在Activity的onCreate()方法中执行的,代码如下:
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的。首先调用ActionBar的newTab()方法来创建一个Tab实例,接着调用了setText()方法来设置标题,然后再调用setTabListener()方法来设置事件监听器,最后再调用ActionBar的addTab()方法将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,也就是白色。
现在重新运行一下程序,结果如下图所示:
OK,ActionBar标题文字的颜色已经成功改成白色了,那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