内容简介:
通过SlidingMenu库与Fragment来实现当前最为流行的侧滑模式。其实涉及到的知识点有:
1.SlidingMenu
2.Fragment
通过layout构建一个Fragment
通过preference 来构建Fragment
准备工作:
1. SlidingMenu 下载地址: https://github.com/jfeinstein10/SlidingMenu
2.下载好后,导入到我们eclipse(也可以新建一个项目,将SlidingMenu项目拷进去)
3. 需要将SlidingMenu设置成is libray.因为我们需要在我们的demo中导入SlidingMenu。
当然,以上步骤,如果你下载了我的源码,你可以不用做啦。呵呵
接下来就是建立我们自己的demo项目啦。
(新建项目过程省略200字,如果你下载了我的源码,你只需要需要入项目即可)
首先我们需要准备两个界面的布局,一个是SlidingMenu的布局,也就是我们侧边栏的。另外一个为我们右边正文的显示布局。
在这里需要说明一下的是, 这两个布局为Activity布局(我们可以理解成为框架的布局文件),而我们真正的Sliding和右边正文显示的内容是由Fragment提供的,那时 Fragment也有自己的布局文件,在 Fragment显示在Activity中时,会将自己的Fragment布局嵌入到Activity布局中。
对于Fragment 的内容,大家自行学习一下就行了,特别是他的生命周期千万别与Activity混淆。
frame_menu.xml
- xml version="1.0" encoding="utf-8"?>
- xmlns:android="http://schemas.android.com/apk/res/android"
- android:id="@+id/menu"
- android:layout_width="match_parent"
- android:layout_height="match_parent" />
frame_content.xml
- xml version="1.0" encoding="utf-8"?>
- xmlns:android="http://schemas.android.com/apk/res/android"
- android:id="@+id/content"
- android:layout_width="match_parent"
- android:layout_height="match_parent" />
Activity布局文件准备好了后,我们需要新建一个 Activity来继承SlidingActivity,则这个activity将会提供一个 sliding 菜单 ,和正文的显示 。
MainActivity.java
- public class MainActivity extends SlidingActivity {
-
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setTitle("SlidingMenu Demo");
- setContentView(R.layout.frame_content);
-
- // set the Behind View
- setBehindContentView(R.layout.frame_menu);
- FragmentTransaction fragmentTransaction = getFragmentManager().beginTransaction();
- MenuFragment menuFragment = new MenuFragment();
- fragmentTransaction.replace(R.id.menu, menuFragment);
- fragmentTransaction.replace(R.id.content, new ContentFragment("Welcome"));
- fragmentTransaction.commit();
-
- // customize the SlidingMenu
- SlidingMenu sm = getSlidingMenu();
- sm.setShadowWidth(50);
- sm.setShadowDrawable(R.drawable.shadow);
- sm.setBehindOffset(60);
- sm.setFadeDegree(0.35f);
- //设置slding menu的几种手势模式
- //TOUCHMODE_FULLSCREEN 全屏模式,在content页面中,滑动,可以打开sliding menu
- //TOUCHMODE_MARGIN 边缘模式,在content页面中,如果想打开slding ,你需要在屏幕边缘滑动才可以打开slding menu
- //TOUCHMODE_NONE 自然是不能通过手势打开啦
- sm.setTouchModeAbove(SlidingMenu.TOUCHMODE_MARGIN);
-
- //使用左上方icon可点,这样在onOptionsItemSelected里面才可以监听到R.id.home
- getActionBar().setDisplayHomeAsUpEnabled(true);
- }
-
- @Override
- public boolean onCreateOptionsMenu(Menu menu) {
- // Inflate the menu; this adds items to the action bar if it is present.
- getMenuInflater().inflate(R.menu.activity_main, menu);
- return true;
- }
- @Override
- public boolean onOptionsItemSelected(MenuItem item) {
- switch (item.getItemId()) {
- case android.R.id.home:
- //toggle就是程序自动判断是打开还是关闭
- toggle();
- // getSlidingMenu().showMenu();// show menu
- // getSlidingMenu().showContent();//show content
- return true;
- }
- return super.onOptionsItemSelected(item);
- }
- }
解释:
代码中有详细的解释,就不再多说了。下面有几个需要注意的地方:
1.setContentView() 设置我们正文的显示布局,这和我们正常的Activity是一样的。
2.setBehindContentView() 设置SlidingMeni的布局。
3.FragmentTransaction类主要用于管理Fragment,有添加,替换,删除等操作。尤其是beginTransaction()与commit()方法与SQL中的事务有点类似。相信大家理解不难。如果需要更多详细信息,自行搜索。
4.SlidingMenu 可以设置Sliding的一些属性,像shadowwidth , shadowDrable等等根据英语解释大家都应该知道用处。可以自行设置看看效果。
5.SlidingMenu.setTouchModeAbove().其中一共包含三中手势模式:
TOUCHMODE_FULLSCREEN 全屏模式,在正文布局中通过手势也可以打开SlidingMenu
TOUCHMODE_MARGIN 边缘模式,在正文布局的边缘处通过手势可以找开SlidingMenu
TOUCHMODE_NONE 自然是不能通过手势打开SlidingMenu了
6.toggle() 是SldingMenu自动判断当前是打开还是关闭。
7.需要注意的是继承了SlidingActivity后,需要把oncreate修改成public
8.setBehindOffset()为设置SlidingMenu打开后,右边留下的宽度。大家可以把这个值写在dimens里面去:
这样就可以带上dp单位,可以适应多分辨率了。不然有些手机上面右边留出的多,有的少。
注意:SlidingMenu非常的强大 ,可以为左右同时设置SlidingMenu,也可以设置打开Menu时的动画 。具体可以参与SlidingMenu 的源码。我们要信息,在源码面前没有秘密 。
在MainActivity中,我们看到了我们的正文是由ContentFragment来填充内容的。SlidingMenu是由MenuFragment来填充内容的。
在这里需要说明一下的是,在ContentFragment中我们是通过一般的layout文件来构成的Fragment .
MenuFragment是由prefrence Fragment来完成我们的菜单内容的。
关于这两个Fragment的布局文件也直接跳过了,帖出来也是占用我们宝贵的网络资源。我们先来看看MenuFragment代码 :
MenuFragment.java
- public class MenuFragment extends PreferenceFragment implements OnPreferenceClickListener{
- int index = -1;
- @Override
- public void onCreate(Bundle savedInstanceState) {
- // TODO Auto-generated method stub
- super.onCreate(savedInstanceState);
- //set the preference xml to the content view
- addPreferencesFromResource(R.xml.menu);
- //add listener
- findPreference("a").setOnPreferenceClickListener(this);
- findPreference("b").setOnPreferenceClickListener(this);
- findPreference("n").setOnPreferenceClickListener(this);
- }
-
- @Override
- public boolean onPreferenceClick(Preference preference) {
- String key = preference.getKey();
- if("a".equals(key)) {
- //if the content view is that we need to show . show directly
- if(index == 0) {
- ((MainActivity)getActivity()).getSlidingMenu().toggle();
- return true;
- }
- //otherwise , replace the content view via a new Content fragment
- index = 0;
- FragmentManager fragmentManager = ((MainActivity)getActivity()).getFragmentManager();
- fragmentManager.beginTransaction()
- .replace(R.id.content, new ContentFragment("This is A Menu"))
- .commit();
- }else if("b".equals(key)) {
- if(index == 1) {
- ((MainActivity)getActivity()).getSlidingMenu().toggle();
- return true;
- }
- index = 1;
- FragmentManager fragmentManager = ((MainActivity)getActivity()).getFragmentManager();
- fragmentManager.beginTransaction()
- .replace(R.id.content, new ContentFragment("This is B Menu"))
- .commit();
- }else if("n".equals(key)) {
-
- if(index == 2) {
- ((MainActivity)getActivity()).getSlidingMenu().toggle();
- return true;
- }
- index = 2;
- FragmentManager fragmentManager = ((MainActivity)getActivity()).getFragmentManager();
- fragmentManager.beginTransaction()
- .replace(R.id.content, new ContentFragment("This is N Menu"))
- .commit();
- }
- //anyway , show the sliding menu
- ((MainActivity)getActivity()).getSlidingMenu().toggle();
- return false;
- }
- }
代码解释:
1.onCreate中完成了Preference布局的添加与设置各个选项的监听
2.在onPreferenceClick()方法中,我们先判断当前正文显示的是不是该选项的内容,如果是,则不用再去跳转了。如果不是,再从FragmentManager里面看能否找出已经存在的可用的fragment。如果没有,再创建新的fragment
ContentFragment就比较简单了,我们主要是在onCreateView()方法中创建我们的view ,并返回就可以了
ContentFragment.java
- public class ContentFragment extends Fragment {
- String text = null;
-
- public ContentFragment() {
- }
-
- public ContentFragment(String text) {
- Log.e("Krislq", text);
- this.text = text;
- }
-
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setRetainInstance(true);
- Log.e("Krislq", "onCreate:"+text);
- }
-
- @Override
- public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
- Log.e("Krislq", "onCreateView:"+ text);
- //inflater the layout
- View view = inflater.inflate(R.layout.fragment_text, null);
- TextView textView =(TextView)view.findViewById(R.id.textView);
- if(!TextUtils.isEmpty(text)) {
- textView.setText(text);
- }
- return view;
- }
- }
-------------------------------------加入Viewpager-------------------------------------------------
而我们很多实际的应用场景中我们需要一个更复杂的场景,比如说需要在一个菜单选项中集成多个tab来集中显示信息。这个时候 Viewpager就派上用场了。
我们点击么二个菜单,只是显示一个简单的fragment ,这次我们将把它改造成Viewpager+Fragment模式。在运行实例的时候,可以通过点击“Menu:ViewPager”菜单来看具体的效果。
首先我们需要添加一个PagerAdapter来自动适配Tab里面的Fragment ,就像ListView中的BaseAdapter差不多,只是需要实现的方法有一些区别。
DemoFragmentAdapter.java
- public class DemoFragmentAdapter extends PagerAdapter {
- private final FragmentManager mFragmentManager;
- private FragmentTransaction mTransaction = null;
- private List<ContentFragment> mFragmentList = new ArrayList<ContentFragment>(4);
-
- public DemoFragmentAdapter(FragmentManager fm) {
- mFragmentManager = fm;
- mFragmentList.add(new ContentFragment("ViewPager#Frist"));
- mFragmentList.add(new ContentFragment("ViewPager#Second"));
- mFragmentList.add(new ContentFragment("ViewPager#Third"));
- }
- @Override
- public int getCount() {
- return mFragmentList.size();
- }
-
- @Override
- public boolean isViewFromObject(View view, Object object) {
- return ((Fragment) object).getView() == view;
- }
-
- @Override
- public Object instantiateItem(ViewGroup container, int position) {
- if (mTransaction == null) {
- mTransaction = mFragmentManager.beginTransaction();
- }
- String name = getTag(position);
- Fragment fragment = mFragmentManager.findFragmentByTag(name);
- if (fragment != null) {
- mTransaction.attach(fragment);
- } else {
- fragment = getItem(position);
- mTransaction.add(container.getId(), fragment,
- getTag(position));
- }
- return fragment;
- }
-
- @Override
- public void destroyItem(ViewGroup container, int position, Object object) {
- if (mTransaction == null) {
- mTransaction = mFragmentManager.beginTransaction();
- }
- mTransaction.detach((Fragment) object);
- }
- @Override
- public void finishUpdate(ViewGroup container) {
- if (mTransaction != null) {
- mTransaction.commitAllowingStateLoss();
- mTransaction = null;
- mFragmentManager.executePendingTransactions();
- }
- }
- public Fragment getItem(int position){
- return mFragmentList.get(position);
- }
- public long getItemId(int position) {
- return position;
- }
- protected String getTag(int position){
- return mFragmentList.get(position).getText();
- }
- }
代码解释:
instantiateItem 此方法返回一个对象,告诉PagerAdapter选择哪一个对象
destroyItem 此方法是移当前Object
finishUpdate 是在UI更新完成后的动作
isViewFromObject 判断是否由对象生成 view ,一般写法都比较固定
适配器写完了,接下来就是如何使用它了。我们知道在显示的时候是通过第二个菜单点击的。
我们重点来看一下第二个菜单点击后的动作即可:
- else if("b".equals(key)) {
- if(index == 1) {
- ((MainActivity)getActivity()).getSlidingMenu().toggle();
- return true;
- }
- index = 1;
- mFrameLayout.setVisibility(View.GONE);
- mViewPager.setVisibility(View.VISIBLE);
-
- DemoFragmentAdapter demoFragmentAdapter = new DemoFragmentAdapter(mActivity.getFragmentManager());
- mViewPager.setOffscreenPageLimit(5);
- mViewPager.setAdapter(demoFragmentAdapter);
- mViewPager.setOnPageChangeListener(onPageChangeListener);
-
- ActionBar actionBar = mActivity.getActionBar();
- actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);
- actionBar.removeAllTabs();
- actionBar.addTab(actionBar.newTab()
- .setText("First Tab")
- .setTabListener(tabListener));
-
- actionBar.addTab(actionBar.newTab()
- .setText("Second Tab")
- .setTabListener(tabListener));
- actionBar.addTab(actionBar.newTab()
- .setText("Third Tab")
- .setTabListener(tabListener));
代码解释:
1. 先还是判断,如果当前Content里面显示的就是该菜单的内容,则直接显示内容。
2.接下来是把Viewpager显示出来。在这里需要注意的是,我们的Viewpager是单独定义的,与其它 Menu显示区域是不同的,并且也是不能同时显示的。具体的布局变化请看frame_content.xml,在这里就不再列出来了。
3.紧接着就是初始化DemoFragmentAdapter,并且设置给Viewpager
4.当然我们需要将我们的ActionBar设置成TAB模式,并且 添加上TAB的标题。
在上面过程中有两个listener需要注意一下:
1. SimpleOnPageChangeListener.该监听是当我们的viewpager页面切换的时候会触发 ,在里面我们会去改变 tab的聚焦情况 。因为实现上viewpager与actionbar是独立的,需要我们手动同步 。代码如下:
-
- ViewPager.SimpleOnPageChangeListener onPageChangeListener = new ViewPager.SimpleOnPageChangeListener() {
- @Override
- public void onPageSelected(int position) {
- getActivity().getActionBar().setSelectedNavigationItem(position);
- switch (position) {
- case 0:
- getSlidingMenu().setTouchModeAbove(SlidingMenu.TOUCHMODE_FULLSCREEN);
- break;
- default:
- getSlidingMenu().setTouchModeAbove(SlidingMenu.TOUCHMODE_MARGIN);
- break;
- }
- }
-
- };
代码解释:
setSelectedNavigationItem 方法用于设置ActionBar的聚焦tab .
在接下来我们判断了SLidingMenu的手势力模式,如果ViewPager已经滑到了最左边,则我们把手势设置成全屏的,这样更往左滑动的时候,就会打开Menu .
2.tabListener 主要是用来监听当我们自己点击tab改变页面的时候,那么我们Viewpager的内容也得随着改变。代码如下:
- ActionBar.TabListener tabListener = new ActionBar.TabListener() {
- @Override
- public void onTabSelected(ActionBar.Tab tab, FragmentTransaction ft) {
- if (mViewPager.getCurrentItem() != tab.getPosition())
- mViewPager.setCurrentItem(tab.getPosition());
- }
-
- @Override
- public void onTabUnselected(ActionBar.Tab tab, FragmentTransaction ft) {
-
- }
-
- @Override
- public void onTabReselected(ActionBar.Tab tab, FragmentTransaction ft) {
-
- }
- };
-
代码解释:
Viewpager可以直接设置当前的Item .
到这里我们的讲解就算到了一段落了。
希望大用能经常使用这种模式。另外在3.0以下的系统中,support里面也提供了FragmentPagerAdapter ,使用方法比这个简单,大家就自己学着试用吧!
代码:http://download.csdn.net/detail/u011127787/5758527