added in version 22.1.0
belongs to Maven artifact com.android.support:support-fragment:28.0.0-alpha1

FragmentTransaction

public abstract class FragmentTransaction
extends Object

java.lang.Object
   ↳ android.support.v4.app.FragmentTransaction


Static library support version of the framework's FragmentTransaction. Used to write apps that run on platforms prior to Android 3.0. When running on Android 3.0 or above, this implementation is still used; it does not try to switch to the framework's implementation. See the framework SDK documentation for a class overview.

Summary

Constants

int TRANSIT_ENTER_MASK

Bit mask that is set for all enter transitions.

int TRANSIT_EXIT_MASK

Bit mask that is set for all exit transitions.

int TRANSIT_FRAGMENT_CLOSE

Fragment is being removed from the stack

int TRANSIT_FRAGMENT_FADE

Fragment should simply fade in or out; that is, no strong navigation associated with it except that it is appearing or disappearing for some reason.

int TRANSIT_FRAGMENT_OPEN

Fragment is being added onto the stack

int TRANSIT_NONE

No animation for transition.

int TRANSIT_UNSET

Not set up for a transition.

Public constructors

FragmentTransaction()

Public methods

abstract FragmentTransaction add(Fragment fragment, String tag)

Calls add(int, Fragment, String) with a 0 containerViewId.

abstract FragmentTransaction add(int containerViewId, Fragment fragment, String tag)

Add a fragment to the activity state.

abstract FragmentTransaction add(int containerViewId, Fragment fragment)

Calls add(int, Fragment, String) with a null tag.

abstract FragmentTransaction addSharedElement(View sharedElement, String name)

Used with custom Transitions to map a View from a removed or hidden Fragment to a View from a shown or added Fragment.

abstract FragmentTransaction addToBackStack(String name)

Add this transaction to the back stack.

abstract FragmentTransaction attach(Fragment fragment)

Re-attach a fragment after it had previously been detached from the UI with detach(Fragment).

abstract int commit()

Schedules a commit of this transaction.

abstract int commitAllowingStateLoss()

Like commit() but allows the commit to be executed after an activity's state is saved.

abstract void commitNow()

Commits this transaction synchronously.

abstract void commitNowAllowingStateLoss()

Like commitNow() but allows the commit to be executed after an activity's state is saved.

abstract FragmentTransaction detach(Fragment fragment)

Detach the given fragment from the UI.

abstract FragmentTransaction disallowAddToBackStack()

Disallow calls to addToBackStack(String).

abstract FragmentTransaction hide(Fragment fragment)

Hides an existing fragment.

abstract boolean isAddToBackStackAllowed()

Returns true if this FragmentTransaction is allowed to be added to the back stack.

abstract boolean isEmpty()
abstract FragmentTransaction remove(Fragment fragment)

Remove an existing fragment.

abstract FragmentTransaction replace(int containerViewId, Fragment fragment, String tag)

Replace an existing fragment that was added to a container.

abstract FragmentTransaction replace(int containerViewId, Fragment fragment)

Calls replace(int, Fragment, String) with a null tag.

abstract FragmentTransaction runOnCommit(Runnable runnable)

Add a Runnable to this transaction that will be run after this transaction has been committed.

abstract FragmentTransaction setAllowOptimization(boolean allowOptimization)

This method was deprecated in API level 26.1.0. This has been renamed setReorderingAllowed(boolean).

abstract FragmentTransaction setBreadCrumbShortTitle(int res)

Set the short title to show as a bread crumb when this transaction is on the back stack.

abstract FragmentTransaction setBreadCrumbShortTitle(CharSequence text)

Like setBreadCrumbShortTitle(int) but taking a raw string; this method is not recommended, as the string can not be changed later if the locale changes.

abstract FragmentTransaction setBreadCrumbTitle(int res)

Set the full title to show as a bread crumb when this transaction is on the back stack.

abstract FragmentTransaction setBreadCrumbTitle(CharSequence text)

Like setBreadCrumbTitle(int) but taking a raw string; this method is not recommended, as the string can not be changed later if the locale changes.

abstract FragmentTransaction setCustomAnimations(int enter, int exit, int popEnter, int popExit)

Set specific animation resources to run for the fragments that are entering and exiting in this transaction.

abstract FragmentTransaction setCustomAnimations(int enter, int exit)

Set specific animation resources to run for the fragments that are entering and exiting in this transaction.

abstract FragmentTransaction setPrimaryNavigationFragment(Fragment fragment)

Set a currently active fragment in this FragmentManager as the primary navigation fragment.

abstract FragmentTransaction setReorderingAllowed(boolean reorderingAllowed)

Sets whether or not to allow optimizing operations within and across transactions.

abstract FragmentTransaction setTransition(int transit)

Select a standard transition animation for this transaction.

abstract FragmentTransaction setTransitionStyle(int styleRes)

Set a custom style resource that will be used for resolving transit animations.

abstract FragmentTransaction show(Fragment fragment)

Shows a previously hidden fragment.

Inherited methods

From class java.lang.Object

Constants

TRANSIT_ENTER_MASK

added in version 22.1.0
int TRANSIT_ENTER_MASK

Bit mask that is set for all enter transitions.

Constant Value: 4096 (0x00001000)

TRANSIT_EXIT_MASK

added in version 22.1.0
int TRANSIT_EXIT_MASK

Bit mask that is set for all exit transitions.

Constant Value: 8192 (0x00002000)

TRANSIT_FRAGMENT_CLOSE

added in version 22.1.0
int TRANSIT_FRAGMENT_CLOSE

Fragment is being removed from the stack

Constant Value: 8194 (0x00002002)

TRANSIT_FRAGMENT_FADE

added in version 22.1.0
int TRANSIT_FRAGMENT_FADE

Fragment should simply fade in or out; that is, no strong navigation associated with it except that it is appearing or disappearing for some reason.

Constant Value: 4099 (0x00001003)

TRANSIT_FRAGMENT_OPEN

added in version 22.1.0
int TRANSIT_FRAGMENT_OPEN

Fragment is being added onto the stack

Constant Value: 4097 (0x00001001)

TRANSIT_NONE

added in version 22.1.0
int TRANSIT_NONE

No animation for transition.

Constant Value: 0 (0x00000000)

TRANSIT_UNSET

added in version 22.1.0
int TRANSIT_UNSET

Not set up for a transition.

Constant Value: -1 (0xffffffff)

Public constructors

FragmentTransaction

added in version 22.1.0
FragmentTransaction ()

Public methods

add

added in version 22.1.0
FragmentTransaction add (Fragment fragment, 
                String tag)

Calls add(int, Fragment, String) with a 0 containerViewId.

Parameters
fragment Fragment

tag String

Returns
FragmentTransaction

add

added in version 22.1.0
FragmentTransaction add (int containerViewId, 
                Fragment fragment, 
                String tag)

Add a fragment to the activity state. This fragment may optionally also have its view (if Fragment.onCreateView returns non-null) into a container view of the activity.

Parameters
containerViewId int: Optional identifier of the container this fragment is to be placed in. If 0, it will not be placed in a container.

fragment Fragment: The fragment to be added. This fragment must not already be added to the activity.

tag String: Optional tag name for the fragment, to later retrieve the fragment with FragmentManager.findFragmentByTag(String).

Returns
FragmentTransaction Returns the same FragmentTransaction instance.

add

added in version 22.1.0
FragmentTransaction add (int containerViewId, 
                Fragment fragment)

Calls add(int, Fragment, String) with a null tag.

Parameters
containerViewId int

fragment Fragment

Returns
FragmentTransaction

addSharedElement

added in version 22.1.0
FragmentTransaction addSharedElement (View sharedElement, 
                String name)

Used with custom Transitions to map a View from a removed or hidden Fragment to a View from a shown or added Fragment. sharedElement must have a unique transitionName in the View hierarchy.

Parameters
sharedElement View: A View in a disappearing Fragment to match with a View in an appearing Fragment.

name String: The transitionName for a View in an appearing Fragment to match to the shared element.

Returns
FragmentTransaction

addToBackStack

added in version 22.1.0
FragmentTransaction addToBackStack (String name)

Add this transaction to the back stack. This means that the transaction will be remembered after it is committed, and will reverse its operation when later popped off the stack.

Parameters
name String: An optional name for this back stack state, or null.

Returns
FragmentTransaction

attach

added in version 22.1.0
FragmentTransaction attach (Fragment fragment)

Re-attach a fragment after it had previously been detached from the UI with detach(Fragment). This causes its view hierarchy to be re-created, attached to the UI, an