Android Fragments 详细使用

   Fragments 诞生初衷

     自从Android 3.0中引入fragments 的概念,根据词海的翻译可以译为:碎片、片段。其上的是为了解决不同屏幕分辩率的动态和灵活UI设计。大屏幕如平板小屏幕如手机，平板电脑的设计使得其有更多的空间来放更多的UI组件，而多出来的空间存放UI使其会产生更多的交互，从而诞生了fragments 。fragments 的设计不需要你来亲自管理view hierarchy 的复杂变化，通过将Activity 的布局分散到frament 中，可以在运行时修改activity 的外观，并且由activity 管理的back stack 中保存些变化。

 

      Fragments 设计理念

      在设计应用时特别是Android 应用 ，有众多的分辨率要去适应，而fragments 可以让你在屏幕不同的屏幕上动态管理UI。例如：通讯应用程序（QQ），用户列表可以在左边，消息窗口在右边的设计。而在手机屏幕用户列表填充屏幕当点击某一用户时，则弹出对话窗口的设计，如下图：

 

Fragments的生命周期 

    每一个fragments 都有自己的一套生命周期回调方法和处理自己的用户输入事件。 对应生命周期可参考下图：

 

 其中大多数程序必须使用Fragments 必须实现的三个回调方法分别为：

onCreate

   系统创建Fragments 时调用，可做执行初始化工作或者当程序被暂停或停止时用来恢复状态，跟Activity 中的onCreate相当。 

onCreateView

   用于首次绘制用户界面的回调方法，必须返回要创建的Fragments 视图UI。假如你不希望提供Fragments 用户界面则可以返回NULL。 

onPause 

    当用户离开这个Fragments 的时候调用，这时你要提交任何应该持久的变化，因为用户可能不会回来。更多的事件可以参考上图的生命周期关系图。

Fragments 的类别

    系统内置了三种Fragments ，这三种Fragments 分别有不同的应用场景分别为：

DialogFragment

 对话框式的Fragments，可以将一个fragments 对话框并到activity 管理的fragments back stack 中，允许用户回到一个前曾摒弃fragments.

ListFragments

   类似于ListActivity 的效果，并且还提供了ListActivity 类似的onListItemCLick和setListAdapter等功能。

PreferenceFragments

   类似于PreferenceActivity .可以创建类似IPAD的设置界面。 

 

Fragments 的详细使用 

    首先先来看一张DEMO 效果图：

 

    左边点击时，右边的字符会与左边选中的项的字符相同。与IPAD上的设置界面很相似，这一点是否借鉴了ipad 上的UI呢？

相就的XML文件：

<? xml version="1.0" encoding="utf-8" ?>
< LinearLayout  xmlns:android ="http://schemas.android.com/apk/res/android"
    android:layout_width ="match_parent"
    android:layout_height ="match_parent"
    android:orientation ="horizontal"   >

    < fragment  class ="com.xuzhi.fragment.FragmentDemoActivity$TitlesFragment"  android:id ="@+id/titles"  android:layout_weight ="1"
       android:layout_width ="0px"  android:layout_height ="match_parent"
        />
   
    < FrameLayout  android:id ="@+id/details"  android:layout_weight ="1"  android:layout_width ="0px"  android:layout_height ="match_parent"
       android:background ="?android:attr/detailsElementBackground"
        ></ FrameLayout >
</ LinearLayout >

 

 

主界面代码（己做注释）：

 

package  com.xuzhi.fragment;
import android.app.Activity;
import android.app.AlertDialog;
import android.app.Fragment;
import android.app.FragmentTransaction;
import android.app.ListFragment;
import android.os.Bundle;
import android.util.TypedValue;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.ScrollView;
import android.widget.TextView;

public  class FragmentDemoActivity  extends Activity {

     public  static String[] array = { "text1,", "text2", "text3", "text4",
            "text5,", "text6", "text7", "text8" };

     /**  Called when the activity is first created.  */
    @Override
     public  void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState); 
        setContentView(R.layout.main);
    }

        
     public  static  class TitlesFragment  extends ListFragment {

         boolean mDualPane;
         int mCurCheckPosition = 0;
        
        @Override
         public  void onCreate(Bundle savedInstanceState) {
             //  TODO Auto-generated method stub
             super.onCreate(savedInstanceState);
            System.out.println("Fragment-->onCreate");
        }
        
        @Override
         public View onCreateView(LayoutInflater inflater, ViewGroup container,
                Bundle savedInstanceState) {
             //  TODO Auto-generated method stub
            System.out.println("Fragment-->onCreateView");
             return  super.onCreateView(inflater, container, savedInstanceState);
        }
        
        @Override
         public  void onPause() {
             //  TODO Auto-generated method stub
             super.onPause();
            System.out.println("Fragment-->onPause");
        }
        
        
        @Override
         public  void onStop() {
             //  TODO Auto-generated method stub
             super.onStop();
            
            System.out.println("Fragment-->onStop");
        }
        
        @Override
         public  void onAttach(Activity activity) {
             //  TODO Auto-generated method stub
             super.onAttach(activity);
            System.out.println("Fragment-->onAttach");
        }
        
        @Override
         public  void onStart() {
             //  TODO Auto-generated method stub
             super.onStart();
            System.out.println("Fragment-->onStart");
        }
        
        @Override
         public  void onResume() {
             //  TODO Auto-generated method stub
             super.onResume();
            System.out.println("Fragment-->onResume");
        }
        
        @Override
         public  void onDestroy() {
             //  TODO Auto-generated method stub
             super.onDestroy();
            System.out.println("Fragment-->onDestroy");
        }
        
        

        @Override
         public  void onActivityCreated(Bundle savedInstanceState) {
             //  TODO Auto-generated method stub
             super.onActivityCreated(savedInstanceState);
            System.out.println("Fragment-->onActivityCreted");
            setListAdapter( new ArrayAdapter<String>(getActivity(),
                    android.R.layout.simple_list_item_1, array));

            View detailsFrame = getActivity().findViewById(R.id.details);

            mDualPane = detailsFrame !=  null
                    && detailsFrame.getVisibility() == View.VISIBLE;

             if (savedInstanceState !=  null) {
                mCurCheckPosition = savedInstanceState.getInt("curChoice", 0);  // 从保存的状态中取出数据
            }

             if (mDualPane) {
                getListView().setChoiceMode(ListView.CHOICE_MODE_SINGLE);

                showDetails(mCurCheckPosition);
            }
        }

        @Override
         public  void onSaveInstanceState(Bundle outState) {
             //  TODO Auto-generated method stub
             super.onSaveInstanceState(outState);

            outState.putInt("curChoice", mCurCheckPosition); // 保存当前的下标
        }

        @Override
         public  void onListItemClick(ListView l, View v,  int position,  long id) {
             //  TODO Auto-generated method stub
             super.onListItemClick(l, v, position, id);
            showDetails(position);
        }

         void showDetails( int index) {
            mCurCheckPosition = index; 
             if (mDualPane) {
                getListView().setItemChecked(index,  true);
                DetailsFragment details = (DetailsFragment) getFragmentManager()
                        .findFragmentById(R.id.details); 
                 if (details ==  null || details.getShownIndex() != index) {
                    details = DetailsFragment.newInstance(mCurCheckPosition); 

                     // 得到一个fragment 事务（类似sqlite的操作）
                    FragmentTransaction ft = getFragmentManager()
                            .beginTransaction();
                    ft.replace(R.id.details, details); // 将得到的fragment 替换当前的viewGroup内容，add则不替换会依次累加
                    ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); // 设置动画效果
                    ft.commit(); // 提交
                }
            }  else {
                 new AlertDialog.Builder(getActivity()).setTitle(
                        android.R.string.dialog_alert_title).setMessage(
                        array[index]).setPositiveButton(android.R.string.ok,
                         null).show();
            }
        }
    }

     /**
     * 作为界面的一部分，为fragment 提供一个layout
     *  @author  terry
     *
      */
     public  static  class DetailsFragment  extends Fragment {

         public  static DetailsFragment newInstance( int index) { 
            DetailsFragment details =  new DetailsFragment();
            Bundle args =  new Bundle();
            args.putInt("index", index);
            details.setArguments(args);
             return details;
        }

         public  int getShownIndex() {
             return getArguments().getInt("index", 0);
        }

        @Override
         public View onCreateView(LayoutInflater inflater, ViewGroup container,
                Bundle savedInstanceState) {
             //  TODO Auto-generated method stub
             if (container ==  null)
                 return  null;

            ScrollView scroller =  new ScrollView(getActivity());
            TextView text =  new TextView(getActivity());

             int padding = ( int) TypedValue.applyDimension(
                    TypedValue.COMPLEX_UNIT_DIP, 4, getActivity()
                            .getResources().getDisplayMetrics());
            text.setPadding(padding, padding, padding, padding);
            scroller.addView(text);

            text.setText(array[getShownIndex()]);
             return scroller;
        }
    }
}

 注意：

1. 如果你想在Fragment 里面创建menu，则必须在onCreate的时候设置让它可以存在optionMenu才可以创建，代码为：
   

    
       public  
       static  
       class DetailsFragment  
       extends Fragment { 
       
    
       
            @Override 
       
             
       public  
       void onCreate(Bundle savedInstanceState) { 
       
                 
       // 
        TODO Auto-generated method stub 
       
                 
       super.onCreate(savedInstanceState); 
       
                setHasOptionsMenu( 
       true); 
       
            } 
       
    } 
      

   之后的操作即可以像平常Android的menu用法一样,代码为：
   

        @Override 
       
             
       public  
       void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { 
       
                 
       // 
        TODO Auto-generated method stub 
       
                 
       super.onCreateOptionsMenu(menu, inflater); 
       
                 menu.add("Menu 1a").setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM); 
       
                    menu.add("Menu 1b").setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM); 
       
            } 
       
             
       
            @Override 
       
             
       public  
       boolean onOptionsItemSelected(MenuItem item) { 
       
                 
       // 
        TODO Auto-generated method stub 
       
                Toast.makeText(getActivity(), "index is"+getShownIndex()+" && menu text is "+item.getTitle(), 1000).show(); 
       
                 
       return  
       super.onOptionsItemSelected(item); 
       
            } 
      

 更多详细的使用方法，请参考SDK和APIDEMO中相关的例子和解释。

DEMO下载：

Android FramentDEMO