注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好。
原文链接:http://developer.android.com/training/basics/fragments/fragment-ui.html
当你在设计你的应用时,为了支持不同的屏幕尺寸,你可以在不同的布局配置中重用你的fragment,以此在可用的屏幕空间上获得最优化的用户体验。
例如,在一个手持设备上,以单一窗格每次只显示一个fragment也许是一个不错的选择。相对应的,你也许希望在屏幕更大的平板设备上并排显示多个fragment,为用户显示更多的信息。
图1. 两个fragment,在不同屏幕尺寸上隶属于同一个activity的显示效果。在大屏幕上,两个fragment可以同时并排显示。但在手持设备上,同一时间只能容纳一个fragment,所以当用户进行操作时,必须令fragment相互替换。
FragmentManager类提供了允许你在运行时为一个activity添加,删除和替换fragments的方法,以此来创建一个动态的用户体验。
一). 在运行时为一个activity添加一个fragment
与上一节课中在XML布局文件内通过<fragment>标签为一个activity定义一个fragment有所不同,你可以在运行时为一个activity添加一个fragment。如果你计划着在activity的生命周期过程中改变fragment,那么这么做是必要的。
为了实现诸如添加或删除一个fragment的事务,你必须使用FragmentManager来创建一个FragmentTransaction,它提供了添加,删除,替换fragment的APIs,同时还有其他fragment相关的事务。
如果你的activity允许fragments可以被删除或者替换,你应该在activity的onCreate()方法中,将初始化好的fragment添加至activity。
一个处理fragment时(尤其是你在运行时添加一个fragment)的关键的规则是:该fragment必须在布局中有一个View容器,fragment的布局将会放置于其中。
下面的布局是上一节课中所展示的布局的另一个形式,它在同一时刻只显示一个fragment。为了将一个fragment替换成另外一个,这个activity的布局包含了一个空的FrameLayout,它的作用相当于一个fragment容器。
注意到这里的文件名和上一节课中的那个例子是一样的,但是布局文件的目录路径中不包含“large”这一适配符,所以当当设备的屏幕比“large”这一规格要小时(此时屏幕无法同时装下两个fragment),这个布局就会被使用。
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中,如果使用的是Support Library APIs,可以调用getSupportFragmentManager()来获得一个FragmentManager。之后调用beginTransaction()来创建一个FragmentTransaction,然后调用add()来添加一个fragment。
你可以通过使用相同的FragmentTransaction,来为这个activity执行多个fragment事务。当你决定要做出这样的改变,你必须在最后执行commit()。
例如:这是一个如何添加一个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); // Check that the activity is using the layout version with // the fragment_container FrameLayout if (findViewById(R.id.fragment_container) != null) { // However, if we're being restored from a previous state, // then we don't need to do anything and should return or else // we could end up with overlapping fragments. if (savedInstanceState != null) { return; } // Create a new Fragment to be placed in the activity layout HeadlinesFragment firstFragment = new HeadlinesFragment(); // In case this activity was started with special instructions from an // Intent, pass the Intent's extras to the fragment as arguments firstFragment.setArguments(getIntent().getExtras()); // Add the fragment to the 'fragment_container' FrameLayout getSupportFragmentManager().beginTransaction() .add(R.id.fragment_container, firstFragment).commit(); } } }
因为这个fragment已经在运行时被添加至FrameLayout这一容器,而不是在activity的布局中通过<fragment>标签进行定义的,所以activity可以用一个不同的fragment去替换它。
二). 用一个不同的fragment进行替换
替换一个fragment的过程和添加一个基本类似,区别在于需要的是replace()方法而不是add()方法。
记住当你执行一个fragment事务(比如替换或删除)时,最好允许用户可以进行撤销操作。为了实现用户的撤销,你必须在提交FragmentTransaction之前,执行addToBackStack()方法。
Note:
当你删除或者替换了一个fragment,然后将这个事务添加至后退栈(back stack),被删除的fragment会被停止(不是被销毁)。如果用户执行后退来恢复这个fragment,它会重新启动。如果你不将这个事务添加至后退栈,这个fragment会在被替换或被删除时直接被销毁。
一个替换fragment的例子:
// Create fragment and give it an argument specifying the article it should show 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();
addToBackStack()方法接受一个可选的string参数,它用来为这个事务指定一个唯一的名字。这个名字不是必须的,除非你打算使用FragmentManager.BackStackEntry中的APIs来执行一些高阶fragment操作。