AndroidTraining学习------Building-a-Dynamic-UI-with-Fragments-

Create a Fragment Class

• 如何创建一个Fragment

  • 继承Fragment类并覆盖关键的生命周期方法，和操作activity差不多。
  • 唯一的不同就是你需要在Fragment中使用onCreateView()方法去加载布局。

  “`
  import android.os.Bundle;
  import android.support.v4.app.Fragment;
  import android.view.LayoutInflater;
  import android.view.ViewGroup;
  public class ArticleFragment extends Fragment {   
  @Override   
  public View onCreateView(LayoutInflater inflater, ViewGroup container,Bundle savedInstanceState) {       
  // Inflate the layout for this fragment       
  return inflater.inflate(R.layout.article_view, container, false);   
  }
  }

#Add a Fragment to an Activity using XML
* 这里是一个将两个fragment添加到一个activity的例子

* 将布局添加到你的activity中

import android.os.Bundle;
import android.support.v4.app.FragmentActivity;

public class MainActivity extends FragmentActivity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.news_articles);
}
}

**Note：**
* 如果你使用的是v7 appcompat library，你的activity需要继承APPCompatActivity，它是FragmentActivity的一个子类。
* 当你的使用在layout XML File中定义Fragment这一方式添加fragment时，你不能在运行时移除fragment。如何你想在用户交互的时候替换fragment，你必须在activity第一次启动时添加fragment。

#Buildinga Flexible UI
我们需要在的布局中使用重复的fragment，可根据屏幕尺寸的不同进行适配。比如在手机上可能只能显示一个fragment，而在平板电脑上需要并排显示两个fragment。
利用FragmentManager类提供的方法，你就可以在运行时添加、删除和替换Activity中的Fragment，为用户提供一种动态的体验。

##Fragment added at runtime to Activity
* 如果你想添加或移除Fragment和其他事物，你必须使用FragmentManager创建一个FragmentTransaction，这是一个可以添加、删除和替换Fragment和其他事物的Fragemnt API。
* 在处理Fragment（特别是在运行时添加Fragment）时，请谨记以下重要规则：必须在布局中为 Fragment 提供 View 容器，以便保存 Fragment 的布局。
* 要用一个Fragment替换另一个Fragment，Activity的布局中需要包含一个作为Fragment容器的空FrameLayout。

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/fragment_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

* 在Activity内部，使用Support Library API调用getSupportFragmentManager()以获取FragmentManager，然后调用beginTransaction()创建FragmentTransaction，同时调用add()添加Fragment。

import android.os.Bundle;
import android.support.v4.app.FragmentActivity;

public class MainActivity extends FragmentActivity {
    &Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.news_articles);

        // 确认 Activity 使用的布局版本包含
        // fragment_container FrameLayout
        if (findViewById(R.id.fragment_container) != null) {

            // 不过，如果我们要从先前的状态还原，
            // 则无需执行任何操作而应返回
            // 否则就会得到重叠的 Fragment 。
            if (savedInstanceState != null) {
                return;
            }

            // 创建一个要放入 Activity 布局中的新 Fragment
            HeadlinesFragment firstFragment = new HeadlinesFragment();

            // 如果此 Activity 是通过 Intent 发出的特殊指令来启动的，
            // 请将该 Intent 的 extras 以参数形式传递给该 Fragment
            firstFragment.setArguments(getIntent().getExtras());

            // 将该 Fragment 添加到“fragment_container”FrameLayout 中
            getSupportFragmentManager().beginTransaction()
                    .add(R.id.fragment_container, firstFragment).commit();
        }
    }
}

##用一个 Fragment 替换另一个 Fragment
* 替换Fragment的步骤和添加Fragment的步骤差不多，只不过add()换成replace()
* 当你执行替换或移除 Fragment 等 Fragment 事务时，最好能让用户向后导航和“撤消”所做更改。要通过 Fragment 事务允许用户向后导航，你必须调用 addToBackStack()，然后再执行 FragmentTransaction。
* 当你移除或替换 Fragment 并向返回堆栈添加事务时，已移除的 Fragment 会停止（而不是销毁）。如果用户向后导航，还原该 Fragment，它会重新启动。如果你没有向返回堆栈添加事务，那么该 Fragment 在移除或替换时就会被销毁。

// 创建 Fragment 并为其添加一个参数，用来指定应显示的文章
ArticleFragment newFragment = new ArticleFragment();
Bundle args = new Bundle();
args.putInt(ArticleFragment.ARG_POSITION, position);
newFragment.setArguments(args);

FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();

// 将 fragment_container View 中的内容替换为此 Fragment ，
// 然后将该事务添加到返回堆栈，以便用户可以向后导航
transaction.replace(R.id.fragment_container, newFragment);
transaction.addToBackStack(null);

// 执行事务
transaction.commit();

#Communication with Other Fragment
* Fragment无法直接与Fragment通信，但是可以通过Activity进行通信。
##Define an Interface
为了让Fragment和Activity通信需要一下几步：
* 在Fragment中定义一个接口，并且在Activity中实现这个接口
* Fragment在onAttach()方法中捕获接口的实现
* 调用接口方法与activity进行通信
这里是一个Fragment和Activity通信的例子

public class HeadlinesFragment extends ListFragment {
OnHeadlineSelectedListener mCallback;

// Container Activity must implement this interface
public interface OnHeadlineSelectedListener {
    public void onArticleSelected(int position);
}

@Override
public void onAttach(Activity activity) {
    super.onAttach(activity);

    // This makes sure that the container activity has implemented
    // the callback interface. If not, it throws an exception
    try {
        mCallback = (OnHeadlineSelectedListener) activity;
    } catch (ClassCastException e) {
        throw new ClassCastException(activity.toString()
                + " must implement OnHeadlineSelectedListener");
    }
}

...

}

现在Fragment通过调用onArticleSelected()方法（或者interface中其他的方法）就可以传递messages给activity了。
例如，以下Fragment中的方法当用户点击一个菜单项时被调用。fragment通过回调接口传递事件给父级activity。

@Override
public void onListItemClick(ListView l, View v, int position, long id) {
    // Send the event to the host activity
    mCallback.onArticleSelected(position);
}

##Implement the Interface
为了接收到来自fragment的事件，activity必须实现定义在Fragment的接口。

public static class MainActivity extends Activity
implements HeadlinesFragment.OnHeadlineSelectedListener{
…

public void onArticleSelected(int position) {
    // The user selected the headline of an article from the HeadlinesFragment
    // Do something here to display that article
}

}

##Deliver a Message to a Fragment
activity可以通过findFragmentById获取Fragment实例，然后直接调用fragment的public方法。
举个例子，假如上述的例子中的activity包含另一个fragment用于显示item指定的回调方法中返回的数据。这样，activity可以将回调方法中收到的数据传递到其他的fragment中，并显示出来。

public static class MainActivity extends Activity
implements HeadlinesFragment.OnHeadlineSelectedListener{
…

public void onArticleSelected(int position) {
    // The user selected the headline of an article from the HeadlinesFragment
    // Do something here to display that article

    ArticleFragment articleFrag = (ArticleFragment)
            getSupportFragmentManager().findFragmentById(R.id.article_fragment);

    if (articleFrag != null) {
        // If article frag is available, we're in two-pane layout...

        // Call a method in the ArticleFragment to update its content
        articleFrag.updateArticleView(position);
    } else {
        // Otherwise, we're in the one-pane layout and must swap frags...

        // Create fragment and give it an argument for the selected article
        ArticleFragment newFragment = new ArticleFragment();
        Bundle args = new Bundle();
        args.putInt(ArticleFragment.ARG_POSITION, position);
        newFragment.setArguments(args);

        FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();

        // Replace whatever is in the fragment_container view with this fragment,
        // and add the transaction to the back stack so the user can navigate back
        transaction.replace(R.id.fragment_container, newFragment);
        transaction.addToBackStack(null);

        // Commit the transaction
        transaction.commit();
    }
}

}
“`