一. Getting Started
1.3 Building a Dynamic UI with Fragments
使用Fragment创建一个动态的布局。
Fragment是为了解决不同屏幕尺寸的界面适配问题，它可以是 Activity 的一部分，类似于嵌套到 Activity 之上。同时 Fragment 有自己的生命周期，在 Activity 上可以动态增加或者减少甚至替换 Fragment，一个 Activity 可以添加一个或多个 Fragment。
1.3.1 Creating a Fragment
Fragment 可以看作是 Activity 的模块化部分，它有自己的生命周期，接收自己的输入事件。
另外在 Activity 中可以动态添加或者删除 Fragment。
建议使用 v4 库中的 Fragment，因为它适配了 Android 4.2 以前的设备使用。另外 v7 库已经添加了 v4 库的依赖。
Fragment 创建和使用
-
Create a Fragment Class
创建一个类继承Fragment类，v4 包，重写生命周期onCreateView()并设置布局。每一个Fragment对应一个布局，使用FragmentActivity或其子类来放置Fragment。
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);
}
}
Fragment 也有其生命周期，当其 Activity 进入 onPause() 时，Fragment 也会进入 onPause()。
-
Add a Fragment to an Activity using XML
创建布局文件，添加Fragment，res/layout-large/news_articles.xml
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="horizontal"
android:layout_width="fill_parent"
android:layout_height="fill_parent">
<fragment android:name="com.example.android.fragments.HeadlinesFragment"
android:id="@+id/headlines_fragment"
android:layout_weight="1"
android:layout_width="0dp"
android:layout_height="match_parent" />
<fragment android:name="com.example.android.fragments.ArticleFragment"
android:id="@+id/article_fragment"
android:layout_weight="2"
android:layout_width="0dp"
android:layout_height="match_parent" />
</LinearLayout>
接着在 FragmentActivity 关联布局就可以了，如果你使用 v7 包，继承 AppCompatActivity 就可以，它是 FragmentActivity 的子类。
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);
}
}
Tips: 使用布局文件加载的 Fragment 不能在 Activity 运行时删除，如果想要动态替换 Fragment，必须在 Activity 首次启动时将 Fragment 加入进来。
1.3.2 Building a Flexible UI
构建灵活的 UI
使用 FragmentManager 类可以管理 Activity 中的 Fragment，动态添加或替换 Fragment 都需要用到这个类。
在运行时为 Activity 添加 Fragment
- 添加或移除
Fragment时，需要使用 FragmentManager 创建 FragmentTransaction，FragmentTransaction类提供了添加、移除或替换Fragment相应的 API； - 如果想动态替换或移除
Fragment，你的Activity应在onCreate()中添加一个初始Fragment； - 动态处理
Fragment时，Activity必须存在一个容器，类似FrameLayout等。
实例步骤：
- 在
Activity的布局为Fragmet创建容器
res/layout/news_articles.xml:
<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中调用 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);
// 判断 Fragment 的容器是否完成实例化
if (findViewById(R.id.fragment_container) != null) {
// 如果 savedInstanceState 存在其它状态则说明不是第一次实例化该 Activity
// 我们只需要 Activity 第一次创建时实例化 Fragment
if (savedInstanceState != null) {
return;
}
// 实例化 HeadlinesFragment
HeadlinesFragment firstFragment = new HeadlinesFragment();
// 如果该 Activity 接收 Intent 信息，将 Intent 作为参数传递给 fragment。
firstFragment.setArguments(getIntent().getExtras());
// 添加 Fragment 到容器 'fragment_container' FrameLayout
getSupportFragmentManager().beginTransaction()
.add(R.id.fragment_container, firstFragment).commit();
}
}
}
- 切记，执行完对
Fragment的一系列操作后，必须使用 commit()
进行提交。
替换 Fragment
- 替换的方法与添加类似，不过方法改为
replace()； - 当执行替换或移除时，通常最好能让用户执行返回操作。实现返回前一个
Fragment需要调用 addToBackStack()，然后再通过commit()提交给 FragmentTransaction。
Tips:如果移除或替换一个 fragment 时提交到了返回栈，那么系统会停止（而非销毁）之前的 fragment。返回时会重启该 fragment。如果不提交到返回栈，移除或替换 fragment 系统会将其删除。
public class ReplaceFragmentActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_replace_fragment);
if(findViewById(R.id.fragment_container) != null){
if(savedInstanceState != null){
return;
}
// 添加初始 Fragment
HeadlinesFragment headlinesFragment = new HeadlinesFragment();
headlinesFragment.setArguments(getIntent().getExtras());
getSupportFragmentManager().beginTransaction()
.add(R.id.fragment_container,headlinesFragment).commit();
}
}
public void replaceFragment(View view){
// 替换 Fragment 并提交到回退栈
ArticleFragment articleFragment = new ArticleFragment();
FragmentTransaction fragmentTransaction = getSupportFragmentManager().beginTransaction();
fragmentTransaction.replace(R.id.fragment_container,articleFragment);
fragmentTransaction.addToBackStack(null);
fragmentTransaction.commit();
}
}
addToBackStack() 方法的参数是字符串，用于指定该操作的名称，除非使用 FragmentManager.BackStackEntry API 执行高级Fragment操作，否则并不需要该名称。
1.3.3 Communicating with Other Fragments
Communicating with Other Fragments
为了重用 Fragment UI 组件，应将每个 Fragment 都构建为一个独立的、确定了自身布局和逻辑的的组件。
Fragment 之间的通信一般都是通过 Activity 实现的，两个 Fragment 通常不应直接进行通信。
Define an Interface（创建接口使 Fragmen 与 Activity 通信）
如果想要 Fragment 与宿主 Activity 通信，需要在 Fragment 中定义接口，然后在 Activity 中实现该接口。
具体步骤：
- 在 fragment 中创建接口并实例化接口对象，然后在 fragment 的
onAttach()生命周期函数内将接口对象赋值给宿主 activity。
public class HeadlinesFragment extends ListFragment {
OnHeadlineSelectedListener mCallback;
private ArrayAdapter<String> adapter;
@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
List<String> data = new ArrayList<String>();
for (int i = 0; i < 30; i++) {
data.add("smyh" + i);
}
//将数组加到ArrayAdapter当中
adapter = new ArrayAdapter<String>(getActivity(),
android.R.layout.simple_list_item_1, data);
//绑定适配器时，必须通过ListFragment.setListAdapter()接口，而不是ListView.setAdapter()或其它方法
setListAdapter(adapter);
}
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState) {
// Inflate the layout for this fragment
return inflater.inflate(R.layout.fragment_headlines, container, false);
}
// Container Activity must implement this interface
public interface OnHeadlineSelectedListener {
public void onArticleSelected(int position);
}
@Override
public void onAttach(Activity activity) {
super.onAttach(activity);
// 这个可以保证 Activity 必须实现该接口，不然会被 catch 出
try {
mCallback = (OnHeadlineSelectedListener) activity;
} catch (ClassCastException e) {
throw new ClassCastException(activity.toString()
+ " must implement OnHeadlineSelectedListener");
}
}
}
此外，ListFragment 的布局必须包含一个 id 为 android:list 的 ListView，否则无法运行。
<ListView
android:id="@id/android:list"
android:layout_width="match_parent"
android:layout_height="match_parent">
</ListView>
- 在 fragment 中使用接口对象传递相应的数据，例如传递 list 的 position：
@Override
public void onListItemClick(ListView l, View v, int position, long id) {
super.onListItemClick(l, v, position, id);
mCallback.onArticleSelected(position);
}
- 宿主 activity 中实现 fragment 中的接口，实现相关功能：
public class CommitFragmentActivity extends AppCompatActivity implements HeadlinesFragment.OnHeadlineSelectedListener {
@Override
public void onArticleSelected(int position) {
Toast.makeText(this, position+"", Toast.LENGTH_SHORT).show();
}
}
Deliver a Message to a Fragment（通过 Activity 和 Bundle 使 Fragment 直接通信）
宿主 Activity 可以通过 findFragmentById() 获取子 Fragment 的实例，接下来就可以调用 Fragment 中的 public 方法。
下面例子实现了点击 HeadlinesFragment 中的 item 后，跳转到 ArticleFragment 中的过程：
public void onArticleSelected(int position) {
Toast.makeText(this, position+"", Toast.LENGTH_SHORT).show();
ArticleFragment articleFragment = (ArticleFragment) getSupportFragmentManager().
findFragmentById(R.id.article_fragment);
if(articleFragment != null){
// 如果 articleFragment 不为 null，说明当前屏幕这两个 fragment 同时存在
articleFragment.updateArticleView(position);
} else {
FragmentTransaction fragmentTransaction = getSupportFragmentManager().beginTransaction();
// 创建 ArticleFragment 并设置 Bundle 数值并放入
ArticleFragment newFragment = new ArticleFragment();
Bundle args = new Bundle();
args.putInt(ArticleFragment.ARG_POSITION,position);
newFragment.setArguments(args);
fragmentTransaction.replace(R.id.fragment_container,newFragment);
fragmentTransaction.addToBackStack(null);
fragmentTransaction.commit();
}
}
在 ArticleFragment 中获取传递来的 position 信息：
public class ArticleFragment extends Fragment {
public static final String ARG_POSITION = "ARG_POSITION";
private TextView mArtcleNumber;
private int position;
@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
if(null != getArguments()){
position = getArguments().getInt(ARG_POSITION);
}
}
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState) {
// Inflate the layout for this fragment
View view = inflater.inflate(R.layout.fragment_article, container, false);
mArtcleNumber = view.findViewById(R.id.tv_artcle_number);
mArtcleNumber.setText(position+"");
return view;
}
public void updateArticleView(int position){
Log.i("Result",position+"");
mArtcleNumber.setText(position+"");
}
}
简单总结：
Fragmen 向 Activity 传递消息主要用接口的形式，Activity 向 Fragment 发送消息通过调用 Fragment 的 public 方法的形式，Fragment 之间通信是通过 Activity 用 Bundle 的方式。
